com.mongodb.gridfs

Class GridFS

java.lang.Object

com.mongodb.gridfs.GridFS

public class GridFS
extends Object

Implementation of GridFS v1.0 GridFS 1.0 spec

MongoDB documentation

gridfs

Field Summary

Fields

Modifier and Type	Field and Description
protected String	_bucketName Deprecated. Please use getBucketName() for access.
protected DBCollection	_chunkCollection Deprecated. Please use getChunksCollection() for access.
protected DB	_db Deprecated. Please use getDB() for access.
protected DBCollection	_filesCollection Deprecated. Please use getFilesCollection() for access.
static String	DEFAULT_BUCKET bucket to use for the collection namespaces
static int	DEFAULT_CHUNKSIZE file's chunk size
static long	MAX_CHUNKSIZE Deprecated. You can calculate max chunkSize with a similar formula Mongo.getMaxBsonObjectSize() - 500*1000. Please ensure that you left enough space for metadata (500kb is enough).

Constructor Summary

Constructors

Constructor and Description
GridFS(DB db) Creates a GridFS instance for the default bucket "fs" in the given database.
GridFS(DB db, String bucket) Creates a GridFS instance for the specified bucket in the given database.

Method Summary

Methods

Modifier and Type	Method and Description
protected GridFSDBFile	_fix(Object o) Deprecated. This method is NOT a part of public API and will be dropped in 3.x versions.
GridFSInputFile	createFile() This method creates an empty GridFSInputFile instance.
GridFSInputFile	createFile(byte[] data) creates a file entry.
GridFSInputFile	createFile(File f) creates a file entry.
GridFSInputFile	createFile(InputStream in) creates a file entry.
GridFSInputFile	createFile(InputStream in, boolean closeStreamOnPersist) creates a file entry.
GridFSInputFile	createFile(InputStream in, String filename) creates a file entry.
GridFSInputFile	createFile(InputStream in, String filename, boolean closeStreamOnPersist) creates a file entry.
GridFSInputFile	createFile(String filename)
List<GridFSDBFile>	find(DBObject query) finds a list of files matching the given query
List<GridFSDBFile>	find(DBObject query, DBObject sort) finds a list of files matching the given query
GridFSDBFile	find(ObjectId id) finds one file matching the given id.
List<GridFSDBFile>	find(String filename) finds a list of files matching the given filename
List<GridFSDBFile>	find(String filename, DBObject sort) finds a list of files matching the given filename
GridFSDBFile	findOne(DBObject query) finds one file matching the given query
GridFSDBFile	findOne(ObjectId id) finds one file matching the given id.
GridFSDBFile	findOne(String filename) finds one file matching the given filename
String	getBucketName() gets the bucket name used in the collection's namespace
protected DBCollection	getChunksCollection() Gets the DBCollection in which the binary chunks are stored.
DB	getDB() gets the db used
DBCursor	getFileList() gets the list of files stored in this gridfs, sorted by filename
DBCursor	getFileList(DBObject query) gets a filtered list of files stored in this gridfs, sorted by filename
DBCursor	getFileList(DBObject query, DBObject sort) gets a filtered list of files stored in this gridfs, sorted by param sort
protected DBCollection	getFilesCollection() Gets the DBCollection in which the file’s metadata is stored.
void	remove(DBObject query) removes all files matching the given query
void	remove(ObjectId id) removes the file matching the given id
void	remove(String filename) removes all files matching the given filename

Methods inherited from class java.lang.Object

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

Field Detail

DEFAULT_CHUNKSIZE

public static final int DEFAULT_CHUNKSIZE

file's chunk size

See Also:

Constant Field Values

MAX_CHUNKSIZE

@Deprecated
public static final long MAX_CHUNKSIZE

Deprecated. You can calculate max chunkSize with a similar formula Mongo.getMaxBsonObjectSize() - 500*1000. Please ensure that you left enough space for metadata (500kb is enough).

file's max chunk size

See Also:

Constant Field Values

DEFAULT_BUCKET

public static final String DEFAULT_BUCKET

bucket to use for the collection namespaces

See Also:

Constant Field Values

_db

@Deprecated
protected final DB _db

Deprecated. Please use getDB() for access.

_bucketName

@Deprecated
protected final String _bucketName

Deprecated. Please use getBucketName() for access.

_filesCollection

@Deprecated
protected final DBCollection _filesCollection

Deprecated. Please use getFilesCollection() for access.

_chunkCollection

@Deprecated
protected final DBCollection _chunkCollection

Deprecated. Please use getChunksCollection() for access.

Constructor Detail

GridFS

public GridFS(DB db)

Creates a GridFS instance for the default bucket "fs" in the given database. Set the preferred WriteConcern on the give DB with DB.setWriteConcern

Parameters:

db - database to work with

Throws:

MongoException

See Also:

WriteConcern

GridFS

public GridFS(DB db,
      String bucket)

Creates a GridFS instance for the specified bucket in the given database. Set the preferred WriteConcern on the give DB with DB.setWriteConcern

Parameters:

db - database to work with

bucket - bucket to use in the given database

Throws:

MongoException

See Also:

WriteConcern

Method Detail

getFileList

public DBCursor getFileList()

gets the list of files stored in this gridfs, sorted by filename

Returns:

cursor of file objects

getFileList

public DBCursor getFileList(DBObject query)

gets a filtered list of files stored in this gridfs, sorted by filename

Parameters:

query - filter to apply

Returns:

cursor of file objects

getFileList

public DBCursor getFileList(DBObject query,
                   DBObject sort)

gets a filtered list of files stored in this gridfs, sorted by param sort

Parameters:

query - filter to apply

sort - sorting to apply

Returns:

cursor of file objects

find

public GridFSDBFile find(ObjectId id)

finds one file matching the given id. Equivalent to findOne(id)

Parameters:

id -

Returns:

Throws:

MongoException

findOne

public GridFSDBFile findOne(ObjectId id)

finds one file matching the given id.

Parameters:

id -

Returns:

Throws:

MongoException

findOne

public GridFSDBFile findOne(String filename)

finds one file matching the given filename

Parameters:

filename -

Returns:

Throws:

MongoException

findOne

public GridFSDBFile findOne(DBObject query)

finds one file matching the given query

Parameters:

query -

Returns:

Throws:

MongoException

find

public List<GridFSDBFile> find(String filename)

finds a list of files matching the given filename

Parameters:

filename -

Returns:

Throws:

MongoException

find

public List<GridFSDBFile> find(String filename,
                      DBObject sort)

finds a list of files matching the given filename

Parameters:

filename -

sort -

Returns:

Throws:

MongoException

find

public List<GridFSDBFile> find(DBObject query)

finds a list of files matching the given query

Parameters:

query -

Returns:

Throws:

MongoException

find

public List<GridFSDBFile> find(DBObject query,
                      DBObject sort)

finds a list of files matching the given query

Parameters:

query -

sort -

Returns:

Throws:

MongoException

_fix

@Deprecated
protected GridFSDBFile _fix(Object o)

Deprecated. This method is NOT a part of public API and will be dropped in 3.x versions.

remove

public void remove(ObjectId id)

removes the file matching the given id

Parameters:

id -

Throws:

MongoException

remove

public void remove(String filename)

removes all files matching the given filename

Parameters:

filename -

Throws:

MongoException

remove

public void remove(DBObject query)

removes all files matching the given query

Parameters:

query -

Throws:

MongoException

createFile

public GridFSInputFile createFile(byte[] data)

creates a file entry. After calling this method, you have to call save() on the GridFSInputFile file

Parameters:

data - the file's data

Returns:

createFile

public GridFSInputFile createFile(File f)
                           throws IOException

creates a file entry. After calling this method, you have to call save() on the GridFSInputFile file

Parameters:

f - the file object

Returns:

Throws:

IOException

createFile

public GridFSInputFile createFile(InputStream in)

creates a file entry. after calling this method, you have to call save() on the GridFSInputFile file

Parameters:

in - an inputstream containing the file's data

Returns:

createFile

public GridFSInputFile createFile(InputStream in,
                         boolean closeStreamOnPersist)

creates a file entry. after calling this method, you have to call save() on the GridFSInputFile file

Parameters:

in - an inputstream containing the file's data

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

Returns:

createFile

public GridFSInputFile createFile(InputStream in,
                         String filename)

creates a file entry. After calling this method, you have to call save() on the GridFSInputFile file

Parameters:

in - an inputstream containing the file's data

filename - the file name as stored in the db

Returns:

createFile

public GridFSInputFile createFile(InputStream in,
                         String filename,
                         boolean closeStreamOnPersist)

creates a file entry. After calling this method, you have to call save() on the GridFSInputFile file

Parameters:

in - an inputstream containing the file's data

filename - the file name as stored in the db

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

Returns:

createFile

public GridFSInputFile createFile(String filename)

Parameters:

filename - the file name as stored in the db

Returns:

See Also:

GridFS#createFile()} on how to use this method

createFile

public GridFSInputFile createFile()

This method creates an empty GridFSInputFile instance. On this instance an OutputStream can be obtained using the GridFSInputFile.getOutputStream() method. You can still call GridFSInputFile.setContentType(String) and GridFSInputFile.setFilename(String). The file will be completely written and closed after calling the OutputStream.close() method on the output stream.

Returns:

GridFS file handle instance.

getBucketName

public String getBucketName()

gets the bucket name used in the collection's namespace

Returns:

getDB

public DB getDB()

gets the db used

Returns:

getFilesCollection

protected DBCollection getFilesCollection()

Gets the DBCollection in which the file’s metadata is stored.

Returns:

the collection

getChunksCollection

protected DBCollection getChunksCollection()

Gets the DBCollection in which the binary chunks are stored.

Returns:

the collection