com.mongodb.gridfs

类 GridFSInputFile

java.lang.Object

com.mongodb.gridfs.GridFSFile

com.mongodb.gridfs.GridFSInputFile

所有已实现的接口:

DBObject, BSONObject

public class GridFSInputFile
extends GridFSFile

This class represents a GridFS file to be written to the database. Operations include:

• Writing data obtained from an InputStream
• Getting an OutputStream to stream the data out to

MongoDB documentation

GridFS

构造器概要

构造器

限定符	构造器和说明
protected	GridFSInputFile(GridFS gridFS) Minimal constructor that does not rely on the presence of an InputStream.
protected	GridFSInputFile(GridFS gridFS, java.io.InputStream inputStream, java.lang.String filename) Default constructor setting the GridFS file name and providing an input stream containing data to be written to the file.
protected	GridFSInputFile(GridFS gridFS, java.io.InputStream inputStream, java.lang.String filename, boolean closeStreamOnPersist) Default constructor setting the GridFS file name and providing an input stream containing data to be written to the file.
protected	GridFSInputFile(GridFS gridFS, java.lang.String filename) Constructor that only provides a file name, but does not rely on the presence of an InputStream.

方法概要

限定符和类型	方法和说明
protected DBObject	createChunk(java.lang.Object id, int currentChunkNumber, byte[] writeBuffer) Creates a new chunk of this file.
java.io.OutputStream	getOutputStream() After retrieving this OutputStream, this object will be capable of accepting successively written data to the output stream.
void	save() Calls save(long) with the existing chunk size.
void	save(long chunkSize) This method first calls saveChunks(long) if the file data has not been saved yet.
int	saveChunks() Saves all data into chunks from configured InputStream input stream to GridFS.
int	saveChunks(long chunkSize) Saves all data into chunks from configured InputStream input stream to GridFS.
void	setChunkSize(long chunkSize) Set the chunk size.
void	setContentType(java.lang.String contentType) Sets the content type (MIME type) on the GridFS entry.
void	setFilename(java.lang.String filename) Sets the file name on the GridFS entry.
void	setId(java.lang.Object id) Sets the ID of this GridFS file.

从类继承的方法 com.mongodb.gridfs.GridFSFile

containsField, containsKey, get, getAliases, getChunkSize, getContentType, getFilename, getGridFS, getId, getLength, getMD5, getMetaData, getUploadDate, isPartialObject, keySet, markAsPartialObject, numChunks, put, putAll, putAll, removeField, setGridFS, setMetaData, toMap, toString, validate

从类继承的方法 java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

构造器详细资料

GridFSInputFile

protected GridFSInputFile(GridFS gridFS,
                          java.io.InputStream inputStream,
                          java.lang.String filename,
                          boolean closeStreamOnPersist)

Default constructor setting the GridFS file name and providing an input stream containing data to be written to the file.

参数:

gridFS - The GridFS connection handle.

inputStream - Stream used for reading data from.

filename - Name of the file to be created.

closeStreamOnPersist - indicate the passed in input stream should be closed once the data chunk persisted

GridFSInputFile

protected GridFSInputFile(GridFS gridFS,
                          java.io.InputStream inputStream,
                          java.lang.String filename)

Default constructor setting the GridFS file name and providing an input stream containing data to be written to the file.

参数:

gridFS - The GridFS connection handle.

inputStream - Stream used for reading data from.

filename - Name of the file to be created.

GridFSInputFile

protected GridFSInputFile(GridFS gridFS,
                          java.lang.String filename)

Constructor that only provides a file name, but does not rely on the presence of an InputStream. An OutputStream can later be obtained for writing using the getOutputStream() method.

参数:

gridFS - The GridFS connection handle.

filename - Name of the file to be created.

GridFSInputFile

protected GridFSInputFile(GridFS gridFS)

Minimal constructor that does not rely on the presence of an InputStream. An OutputStream can later be obtained for writing using the getOutputStream() method.

参数:

gridFS - The GridFS connection handle.

方法详细资料

setId

public void setId(java.lang.Object id)

Sets the ID of this GridFS file.

参数:

id - the file's ID.

setFilename

public void setFilename(java.lang.String filename)

Sets the file name on the GridFS entry.

参数:

filename - File name.

setContentType

public void setContentType(java.lang.String contentType)

Sets the content type (MIME type) on the GridFS entry.

参数:

contentType - Content type.

setChunkSize

public void setChunkSize(long chunkSize)

Set the chunk size. This must be called before saving any data.

参数:

chunkSize - The size in bytes.

save

public void save()

Calls save(long) with the existing chunk size.

覆盖:

save 在类中 GridFSFile

抛出:

MongoException - if there's a problem saving the file.

save

public void save(long chunkSize)

This method first calls saveChunks(long) if the file data has not been saved yet. Then it persists the file entry to GridFS.

参数:

chunkSize - Size of chunks for file in bytes.

抛出:

MongoException - if there's a problem saving the file.

saveChunks

public int saveChunks()
               throws java.io.IOException

Saves all data into chunks from configured InputStream input stream to GridFS.

返回:

Number of the next chunk.

抛出:

java.io.IOException - on problems reading the new entry's InputStream.

MongoException - if there's a failure

另请参阅:

saveChunks(long)

saveChunks

public int saveChunks(long chunkSize)
               throws java.io.IOException

Saves all data into chunks from configured InputStream input stream to GridFS. A non-default chunk size can be specified. This method does NOT save the file object itself, one must call save() to do so.

参数:

chunkSize - Size of chunks for file in bytes.

返回:

Number of the next chunk.

抛出:

java.io.IOException - on problems reading the new entry's InputStream.

MongoException - if there's a failure

getOutputStream

public java.io.OutputStream getOutputStream()

After retrieving this OutputStream, this object will be capable of accepting successively written data to the output stream. To completely persist this GridFS object, you must finally call the OutputStream.close() method on the output stream. Note that calling the save() and saveChunks() methods will throw Exceptions once you obtained the OutputStream.

返回:

Writable stream object.

createChunk

protected DBObject createChunk(java.lang.Object id,
                               int currentChunkNumber,
                               byte[] writeBuffer)

Creates a new chunk of this file. Can be over-ridden, if input files need to be split into chunks using a different mechanism.

参数:

id - the file ID

currentChunkNumber - the unique id for this chunk

writeBuffer - the byte array containing the data for this chunk

返回:

a DBObject representing this chunk.