com.mongodb.reactivestreams.client.gridfs

Interface GridFSBucket

@ThreadSafe
public interface GridFSBucket

Represents a GridFS Bucket

Since:

1.3

Method Summary

Modifier and Type	Method and Description
org.reactivestreams.Publisher<Success>	delete(org.bson.BsonValue id) Given a id, delete this stored file's files collection document and associated chunks from a GridFS bucket.
org.reactivestreams.Publisher<Success>	delete(ClientSession clientSession, org.bson.BsonValue id) Given a id, delete this stored file's files collection document and associated chunks from a GridFS bucket.
org.reactivestreams.Publisher<Success>	delete(ClientSession clientSession, org.bson.types.ObjectId id) Given a id, delete this stored file's files collection document and associated chunks from a GridFS bucket.
org.reactivestreams.Publisher<Success>	delete(org.bson.types.ObjectId id) Given a id, delete this stored file's files collection document and associated chunks from a GridFS bucket.
GridFSDownloadPublisher	downloadToPublisher(org.bson.BsonValue id) Downloads the contents of the stored file specified by id into the Publisher.
GridFSDownloadPublisher	downloadToPublisher(ClientSession clientSession, org.bson.BsonValue id) Downloads the contents of the stored file specified by id into the Publisher.
GridFSDownloadPublisher	downloadToPublisher(ClientSession clientSession, org.bson.types.ObjectId id) Downloads the contents of the stored file specified by id into the Publisher.
GridFSDownloadPublisher	downloadToPublisher(ClientSession clientSession, String filename) Downloads the contents of the latest version of the stored file specified by filename into the Publisher.
GridFSDownloadPublisher	downloadToPublisher(ClientSession clientSession, String filename, com.mongodb.client.gridfs.model.GridFSDownloadOptions options) Downloads the contents of the stored file specified by filename and by the revision in options into the Publisher.
GridFSDownloadPublisher	downloadToPublisher(org.bson.types.ObjectId id) Downloads the contents of the stored file specified by id into the Publisher.
GridFSDownloadPublisher	downloadToPublisher(String filename) Downloads the contents of the stored file specified by filename into the Publisher.
GridFSDownloadPublisher	downloadToPublisher(String filename, com.mongodb.client.gridfs.model.GridFSDownloadOptions options) Downloads the contents of the stored file specified by filename and by the revision in options into the Publisher.
org.reactivestreams.Publisher<Long>	downloadToStream(org.bson.BsonValue id, AsyncOutputStream destination) Deprecated. prefer downloadToPublisher(BsonValue) instead
org.reactivestreams.Publisher<Long>	downloadToStream(ClientSession clientSession, org.bson.BsonValue id, AsyncOutputStream destination) Deprecated. prefer downloadToPublisher(ClientSession, BsonValue) instead
org.reactivestreams.Publisher<Long>	downloadToStream(ClientSession clientSession, org.bson.types.ObjectId id, AsyncOutputStream destination) Deprecated. prefer downloadToPublisher(ClientSession, ObjectId) instead
org.reactivestreams.Publisher<Long>	downloadToStream(ClientSession clientSession, String filename, AsyncOutputStream destination) Deprecated. prefer downloadToPublisher(ClientSession, String) instead
org.reactivestreams.Publisher<Long>	downloadToStream(ClientSession clientSession, String filename, AsyncOutputStream destination, com.mongodb.client.gridfs.model.GridFSDownloadOptions options) Deprecated. prefer downloadToPublisher(ClientSession, String, GridFSDownloadOptions) instead
org.reactivestreams.Publisher<Long>	downloadToStream(org.bson.types.ObjectId id, AsyncOutputStream destination) Deprecated. prefer downloadToPublisher(ObjectId) instead
org.reactivestreams.Publisher<Long>	downloadToStream(String filename, AsyncOutputStream destination) Deprecated. prefer downloadToPublisher(String) instead
org.reactivestreams.Publisher<Long>	downloadToStream(String filename, AsyncOutputStream destination, com.mongodb.client.gridfs.model.GridFSDownloadOptions options) Deprecated. prefer downloadToPublisher(String, GridFSDownloadOptions) instead
org.reactivestreams.Publisher<Success>	drop() Drops the data associated with this bucket from the database.
org.reactivestreams.Publisher<Success>	drop(ClientSession clientSession) Drops the data associated with this bucket from the database.
GridFSFindPublisher	find() Finds all documents in the files collection.
GridFSFindPublisher	find(org.bson.conversions.Bson filter) Finds all documents in the collection that match the filter.
GridFSFindPublisher	find(ClientSession clientSession) Finds all documents in the files collection.
GridFSFindPublisher	find(ClientSession clientSession, org.bson.conversions.Bson filter) Finds all documents in the collection that match the filter.
String	getBucketName() The bucket name.
int	getChunkSizeBytes() Sets the chunk size in bytes.
boolean	getDisableMD5() Returns true if computing MD5 checksums when uploading files is disabled.
com.mongodb.ReadConcern	getReadConcern() Get the read concern for the GridFSBucket.
com.mongodb.ReadPreference	getReadPreference() Get the read preference for the GridFSBucket.
com.mongodb.WriteConcern	getWriteConcern() Get the write concern for the GridFSBucket.
GridFSDownloadStream	openDownloadStream(org.bson.BsonValue id) Deprecated. prefer downloadToPublisher(BsonValue) instead
GridFSDownloadStream	openDownloadStream(ClientSession clientSession, org.bson.BsonValue id) Deprecated. prefer downloadToPublisher(ClientSession, BsonValue) instead
GridFSDownloadStream	openDownloadStream(ClientSession clientSession, org.bson.types.ObjectId id) Deprecated. prefer downloadToPublisher(ClientSession, ObjectId) instead
GridFSDownloadStream	openDownloadStream(ClientSession clientSession, String filename) Deprecated. prefer downloadToPublisher(ClientSession, String) instead
GridFSDownloadStream	openDownloadStream(ClientSession clientSession, String filename, com.mongodb.client.gridfs.model.GridFSDownloadOptions options) Deprecated. prefer downloadToPublisher(ClientSession, String, GridFSDownloadOptions) instead
GridFSDownloadStream	openDownloadStream(org.bson.types.ObjectId id) Deprecated. prefer downloadToPublisher(ObjectId) instead
GridFSDownloadStream	openDownloadStream(String filename) Deprecated. prefer downloadToPublisher(String) instead
GridFSDownloadStream	openDownloadStream(String filename, com.mongodb.client.gridfs.model.GridFSDownloadOptions options) Deprecated. prefer downloadToPublisher(String, GridFSDownloadOptions) instead
GridFSUploadStream	openUploadStream(org.bson.BsonValue id, String filename) Deprecated. prefer uploadFromPublisher(BsonValue, String, Publisher) instead
GridFSUploadStream	openUploadStream(org.bson.BsonValue id, String filename, com.mongodb.client.gridfs.model.GridFSUploadOptions options) Deprecated. prefer uploadFromPublisher(BsonValue, String, Publisher, GridFSUploadOptions) instead
GridFSUploadStream	openUploadStream(ClientSession clientSession, org.bson.BsonValue id, String filename) Deprecated. prefer uploadFromPublisher(ClientSession, BsonValue, String, Publisher) instead
GridFSUploadStream	openUploadStream(ClientSession clientSession, org.bson.BsonValue id, String filename, com.mongodb.client.gridfs.model.GridFSUploadOptions options) Deprecated. prefer uploadFromPublisher(ClientSession, BsonValue, String, Publisher, GridFSUploadOptions) instead
GridFSUploadStream	openUploadStream(ClientSession clientSession, String filename) Deprecated. prefer uploadFromPublisher(ClientSession, String, Publisher) instead
GridFSUploadStream	openUploadStream(ClientSession clientSession, String filename, com.mongodb.client.gridfs.model.GridFSUploadOptions options) Deprecated. prefer uploadFromPublisher(ClientSession, String, Publisher, GridFSUploadOptions) instead
GridFSUploadStream	openUploadStream(String filename) Deprecated. prefer uploadFromPublisher(String, Publisher) instead
GridFSUploadStream	openUploadStream(String filename, com.mongodb.client.gridfs.model.GridFSUploadOptions options) Deprecated. prefer uploadFromPublisher(String, Publisher, GridFSUploadOptions) instead
org.reactivestreams.Publisher<Success>	rename(org.bson.BsonValue id, String newFilename) Renames the stored file with the specified id.
org.reactivestreams.Publisher<Success>	rename(ClientSession clientSession, org.bson.BsonValue id, String newFilename) Renames the stored file with the specified id.
org.reactivestreams.Publisher<Success>	rename(ClientSession clientSession, org.bson.types.ObjectId id, String newFilename) Renames the stored file with the specified id.
org.reactivestreams.Publisher<Success>	rename(org.bson.types.ObjectId id, String newFilename) Renames the stored file with the specified id.
GridFSUploadPublisher<Success>	uploadFromPublisher(org.bson.BsonValue id, String filename, org.reactivestreams.Publisher<ByteBuffer> source) Uploads the contents of the given Publisher to a GridFS bucket.
GridFSUploadPublisher<Success>	uploadFromPublisher(org.bson.BsonValue id, String filename, org.reactivestreams.Publisher<ByteBuffer> source, com.mongodb.client.gridfs.model.GridFSUploadOptions options) Uploads the contents of the given Publisher to a GridFS bucket.
GridFSUploadPublisher<Success>	uploadFromPublisher(ClientSession clientSession, org.bson.BsonValue id, String filename, org.reactivestreams.Publisher<ByteBuffer> source) Uploads the contents of the given Publisher to a GridFS bucket.
GridFSUploadPublisher<Success>	uploadFromPublisher(ClientSession clientSession, org.bson.BsonValue id, String filename, org.reactivestreams.Publisher<ByteBuffer> source, com.mongodb.client.gridfs.model.GridFSUploadOptions options) Uploads the contents of the given Publisher to a GridFS bucket.
GridFSUploadPublisher<org.bson.types.ObjectId>	uploadFromPublisher(ClientSession clientSession, String filename, org.reactivestreams.Publisher<ByteBuffer> source) Uploads the contents of the given Publisher to a GridFS bucket.
GridFSUploadPublisher<org.bson.types.ObjectId>	uploadFromPublisher(ClientSession clientSession, String filename, org.reactivestreams.Publisher<ByteBuffer> source, com.mongodb.client.gridfs.model.GridFSUploadOptions options) Uploads the contents of the given Publisher to a GridFS bucket.
GridFSUploadPublisher<org.bson.types.ObjectId>	uploadFromPublisher(String filename, org.reactivestreams.Publisher<ByteBuffer> source) Uploads the contents of the given Publisher to a GridFS bucket.
GridFSUploadPublisher<org.bson.types.ObjectId>	uploadFromPublisher(String filename, org.reactivestreams.Publisher<ByteBuffer> source, com.mongodb.client.gridfs.model.GridFSUploadOptions options) Uploads the contents of the given Publisher to a GridFS bucket.
org.reactivestreams.Publisher<Success>	uploadFromStream(org.bson.BsonValue id, String filename, AsyncInputStream source) Deprecated. prefer uploadFromPublisher(BsonValue, String, Publisher) instead
org.reactivestreams.Publisher<Success>	uploadFromStream(org.bson.BsonValue id, String filename, AsyncInputStream source, com.mongodb.client.gridfs.model.GridFSUploadOptions options) Deprecated. prefer uploadFromPublisher(BsonValue, String, Publisher, GridFSUploadOptions) instead
org.reactivestreams.Publisher<Success>	uploadFromStream(ClientSession clientSession, org.bson.BsonValue id, String filename, AsyncInputStream source) Deprecated. prefer uploadFromPublisher(ClientSession, BsonValue, String, Publisher) instead
org.reactivestreams.Publisher<Success>	uploadFromStream(ClientSession clientSession, org.bson.BsonValue id, String filename, AsyncInputStream source, com.mongodb.client.gridfs.model.GridFSUploadOptions options) Deprecated. prefer uploadFromPublisher(ClientSession, BsonValue, String, Publisher, GridFSUploadOptions) instead
org.reactivestreams.Publisher<org.bson.types.ObjectId>	uploadFromStream(ClientSession clientSession, String filename, AsyncInputStream source) Deprecated. prefer uploadFromPublisher(ClientSession, String, Publisher) instead
org.reactivestreams.Publisher<org.bson.types.ObjectId>	uploadFromStream(ClientSession clientSession, String filename, AsyncInputStream source, com.mongodb.client.gridfs.model.GridFSUploadOptions options) Deprecated. prefer uploadFromPublisher(ClientSession, String, Publisher, GridFSUploadOptions) instead
org.reactivestreams.Publisher<org.bson.types.ObjectId>	uploadFromStream(String filename, AsyncInputStream source) Deprecated. prefer uploadFromPublisher(String, Publisher) instead
org.reactivestreams.Publisher<org.bson.types.ObjectId>	uploadFromStream(String filename, AsyncInputStream source, com.mongodb.client.gridfs.model.GridFSUploadOptions options) Deprecated. prefer uploadFromPublisher(String, Publisher, GridFSUploadOptions) instead
GridFSBucket	withChunkSizeBytes(int chunkSizeBytes) Create a new GridFSBucket instance with a new chunk size in bytes.
GridFSBucket	withDisableMD5(boolean disableMD5) Create a new GridFSBucket instance with the set disable MD5 value.
GridFSBucket	withReadConcern(com.mongodb.ReadConcern readConcern) Create a new MongoDatabase instance with a different read concern.
GridFSBucket	withReadPreference(com.mongodb.ReadPreference readPreference) Create a new GridFSBucket instance with a different read preference.
GridFSBucket	withWriteConcern(com.mongodb.WriteConcern writeConcern) Create a new GridFSBucket instance with a different write concern.

Method Detail

getBucketName

String getBucketName()

The bucket name.

Returns:

the bucket name

getChunkSizeBytes

int getChunkSizeBytes()

Sets the chunk size in bytes. Defaults to 255.

Returns:

the chunk size in bytes.

getWriteConcern

com.mongodb.WriteConcern getWriteConcern()

Get the write concern for the GridFSBucket.

Returns:

the WriteConcern

getReadPreference

com.mongodb.ReadPreference getReadPreference()

Get the read preference for the GridFSBucket.

Returns:

the ReadPreference

getReadConcern

com.mongodb.ReadConcern getReadConcern()

Get the read concern for the GridFSBucket.

Returns:

the ReadConcern

MongoDB documentation

Read Concern

Since server release

3.2

getDisableMD5

boolean getDisableMD5()

Returns true if computing MD5 checksums when uploading files is disabled.

Returns:

true if computing MD5 checksums when uploading files is disabled.

Since:

1.9

withChunkSizeBytes

GridFSBucket withChunkSizeBytes(int chunkSizeBytes)

Create a new GridFSBucket instance with a new chunk size in bytes.

Parameters:

chunkSizeBytes - the new chunk size in bytes.

Returns:

a new GridFSBucket instance with the different chunk size in bytes

withReadPreference

GridFSBucket withReadPreference(com.mongodb.ReadPreference readPreference)

Create a new GridFSBucket instance with a different read preference.

Parameters:

readPreference - the new ReadPreference for the database

Returns:

a new GridFSBucket instance with the different readPreference

withWriteConcern

GridFSBucket withWriteConcern(com.mongodb.WriteConcern writeConcern)

Create a new GridFSBucket instance with a different write concern.

Parameters:

writeConcern - the new WriteConcern for the database

Returns:

a new GridFSBucket instance with the different writeConcern

withReadConcern

GridFSBucket withReadConcern(com.mongodb.ReadConcern readConcern)

Create a new MongoDatabase instance with a different read concern.

Parameters:

readConcern - the new ReadConcern for the database

Returns:

a new GridFSBucket instance with the different ReadConcern

MongoDB documentation

Read Concern

Since server release

3.2

withDisableMD5

GridFSBucket withDisableMD5(boolean disableMD5)

Create a new GridFSBucket instance with the set disable MD5 value.

Parameters:

disableMD5 - true if computing MD5 checksums when uploading files should be disabled.

Returns:

a new GridFSBucket instance with the new disable MD5 value.

Since:

1.9

openUploadStream

@Deprecated
GridFSUploadStream openUploadStream(String filename)

Deprecated. prefer uploadFromPublisher(String, Publisher) instead

Opens a AsyncOutputStream that the application can write the contents of the file to.

As the application writes the contents to the returned Stream, the contents are uploaded as chunks in the chunks collection. When the application signals it is done writing the contents of the file by calling close on the returned Stream, a files collection document is created in the files collection.

Parameters:

filename - the filename for the stream

Returns:

the GridFSUploadStream that provides the ObjectId for the file to be uploaded and the Stream to which the application will write the contents.

openUploadStream

@Deprecated
GridFSUploadStream openUploadStream(String filename,
                                                com.mongodb.client.gridfs.model.GridFSUploadOptions options)

Deprecated. prefer uploadFromPublisher(String, Publisher, GridFSUploadOptions) instead

Opens a AsyncOutputStream that the application can write the contents of the file to.

As the application writes the contents to the returned Stream, the contents are uploaded as chunks in the chunks collection. When the application signals it is done writing the contents of the file by calling close on the returned Stream, a files collection document is created in the files collection.

Parameters:

filename - the filename for the stream

options - the GridFSUploadOptions

Returns:

the GridFSUploadStream that provides the ObjectId for the file to be uploaded and the Stream to which the application will write the contents.

openUploadStream

@Deprecated
GridFSUploadStream openUploadStream(org.bson.BsonValue id,
                                                String filename)

Deprecated. prefer uploadFromPublisher(BsonValue, String, Publisher) instead

Opens a AsyncOutputStream that the application can write the contents of the file to.

As the application writes the contents to the returned Stream, the contents are uploaded as chunks in the chunks collection. When the application signals it is done writing the contents of the file by calling close on the returned Stream, a files collection document is created in the files collection.

Parameters:

id - the custom id value of the file

filename - the filename for the stream

Returns:

the GridFSUploadStream that provides the ObjectId for the file to be uploaded and the Stream to which the application will write the contents.

openUploadStream

@Deprecated
GridFSUploadStream openUploadStream(org.bson.BsonValue id,
                                                String filename,
                                                com.mongodb.client.gridfs.model.GridFSUploadOptions options)

Deprecated. prefer uploadFromPublisher(BsonValue, String, Publisher, GridFSUploadOptions) instead

Opens a AsyncOutputStream that the application can write the contents of the file to.

As the application writes the contents to the returned Stream, the contents are uploaded as chunks in the chunks collection. When the application signals it is done writing the contents of the file by calling close on the returned Stream, a files collection document is created in the files collection.

Parameters:

id - the custom id value of the file

filename - the filename for the stream

options - the GridFSUploadOptions

Returns:

the GridFSUploadStream that provides the ObjectId for the file to be uploaded and the Stream to which the application will write the contents.

openUploadStream

@Deprecated
GridFSUploadStream openUploadStream(ClientSession clientSession,
                                                String filename)

Deprecated. prefer uploadFromPublisher(ClientSession, String, Publisher) instead

Opens a AsyncOutputStream that the application can write the contents of the file to.

As the application writes the contents to the returned Stream, the contents are uploaded as chunks in the chunks collection. When the application signals it is done writing the contents of the file by calling close on the returned Stream, a files collection document is created in the files collection.

Parameters:

clientSession - the client session with which to associate this operation

filename - the filename for the stream

Returns:

the GridFSUploadStream that provides the ObjectId for the file to be uploaded and the Stream to which the application will write the contents.

Since:

1.7

Since server release

3.6

openUploadStream

@Deprecated
GridFSUploadStream openUploadStream(ClientSession clientSession,
                                                String filename,
                                                com.mongodb.client.gridfs.model.GridFSUploadOptions options)

Deprecated. prefer uploadFromPublisher(ClientSession, String, Publisher, GridFSUploadOptions) instead

Opens a AsyncOutputStream that the application can write the contents of the file to.

As the application writes the contents to the returned Stream, the contents are uploaded as chunks in the chunks collection. When the application signals it is done writing the contents of the file by calling close on the returned Stream, a files collection document is created in the files collection.

Parameters:

clientSession - the client session with which to associate this operation

filename - the filename for the stream

options - the GridFSUploadOptions

Returns:

the GridFSUploadStream that provides the ObjectId for the file to be uploaded and the Stream to which the application will write the contents.

Since:

1.7

Since server release

3.6

openUploadStream

@Deprecated
GridFSUploadStream openUploadStream(ClientSession clientSession,
                                                org.bson.BsonValue id,
                                                String filename)

Deprecated. prefer uploadFromPublisher(ClientSession, BsonValue, String, Publisher) instead

Opens a AsyncOutputStream that the application can write the contents of the file to.

As the application writes the contents to the returned Stream, the contents are uploaded as chunks in the chunks collection. When the application signals it is done writing the contents of the file by calling close on the returned Stream, a files collection document is created in the files collection.

Parameters:

clientSession - the client session with which to associate this operation

id - the custom id value of the file

filename - the filename for the stream

Returns:

the GridFSUploadStream that provides the ObjectId for the file to be uploaded and the Stream to which the application will write the contents.

Since:

1.7

Since server release

3.6

openUploadStream

@Deprecated
GridFSUploadStream openUploadStream(ClientSession clientSession,
                                                org.bson.BsonValue id,
                                                String filename,
                                                com.mongodb.client.gridfs.model.GridFSUploadOptions options)

Deprecated. prefer uploadFromPublisher(ClientSession, BsonValue, String, Publisher, GridFSUploadOptions) instead

Opens a AsyncOutputStream that the application can write the contents of the file to.

As the application writes the contents to the returned Stream, the contents are uploaded as chunks in the chunks collection. When the application signals it is done writing the contents of the file by calling close on the returned Stream, a files collection document is created in the files collection.

Parameters:

clientSession - the client session with which to associate this operation

id - the custom id value of the file

filename - the filename for the stream

options - the GridFSUploadOptions

Returns:

the GridFSUploadStream that provides the ObjectId for the file to be uploaded and the Stream to which the application will write the contents.

Since:

1.7

Since server release

3.6

uploadFromStream

@Deprecated
org.reactivestreams.Publisher<org.bson.types.ObjectId> uploadFromStream(String filename,
                                                                                    AsyncInputStream source)

Deprecated. prefer uploadFromPublisher(String, Publisher) instead

Uploads the contents of the given AsyncInputStream to a GridFS bucket.

Reads the contents of the user file from the source and uploads it as chunks in the chunks collection. After all the chunks have been uploaded, it creates a files collection document for filename in the files collection.

Parameters:

filename - the filename for the stream

source - the Stream providing the file data

Returns:

a Publisher with a single element, the ObjectId of the uploaded file.

uploadFromStream

@Deprecated
org.reactivestreams.Publisher<org.bson.types.ObjectId> uploadFromStream(String filename,
                                                                                    AsyncInputStream source,
                                                                                    com.mongodb.client.gridfs.model.GridFSUploadOptions options)

Deprecated. prefer uploadFromPublisher(String, Publisher, GridFSUploadOptions) instead

Uploads the contents of the given AsyncInputStream to a GridFS bucket.

Reads the contents of the user file from the source and uploads it as chunks in the chunks collection. After all the chunks have been uploaded, it creates a files collection document for filename in the files collection.

Parameters:

filename - the filename for the stream

source - the Stream providing the file data

options - the GridFSUploadOptions

Returns:

a Publisher with a single element, the ObjectId of the uploaded file.

uploadFromStream

@Deprecated
org.reactivestreams.Publisher<Success> uploadFromStream(org.bson.BsonValue id,
                                                                    String filename,
                                                                    AsyncInputStream source)

Deprecated. prefer uploadFromPublisher(BsonValue, String, Publisher) instead

Uploads the contents of the given AsyncInputStream to a GridFS bucket.

Reads the contents of the user file from the source and uploads it as chunks in the chunks collection. After all the chunks have been uploaded, it creates a files collection document for filename in the files collection.

Parameters:

id - the custom id value of the file

filename - the filename for the stream

source - the Stream providing the file data

Returns:

a Publisher with a single element, representing when the successful upload of the source.

uploadFromStream

@Deprecated
org.reactivestreams.Publisher<Success> uploadFromStream(org.bson.BsonValue id,
                                                                    String filename,
                                                                    AsyncInputStream source,
                                                                    com.mongodb.client.gridfs.model.GridFSUploadOptions options)

Deprecated. prefer uploadFromPublisher(BsonValue, String, Publisher, GridFSUploadOptions) instead

Uploads the contents of the given AsyncInputStream to a GridFS bucket.

Reads the contents of the user file from the source and uploads it as chunks in the chunks collection. After all the chunks have been uploaded, it creates a files collection document for filename in the files collection.

Parameters:

id - the custom id value of the file

filename - the filename for the stream

source - the Stream providing the file data

options - the GridFSUploadOptions

Returns:

a Publisher with a single element, representing when the successful upload of the source.

uploadFromStream

@Deprecated
org.reactivestreams.Publisher<org.bson.types.ObjectId> uploadFromStream(ClientSession clientSession,
                                                                                    String filename,
                                                                                    AsyncInputStream source)

Deprecated. prefer uploadFromPublisher(ClientSession, String, Publisher) instead

Uploads the contents of the given AsyncInputStream to a GridFS bucket.

Reads the contents of the user file from the source and uploads it as chunks in the chunks collection. After all the chunks have been uploaded, it creates a files collection document for filename in the files collection.

Parameters:

clientSession - the client session with which to associate this operation

filename - the filename for the stream

source - the Stream providing the file data

Returns:

a Publisher with a single element, the ObjectId of the uploaded file.

Since:

1.7

Since server release

3.6

uploadFromStream

@Deprecated
org.reactivestreams.Publisher<org.bson.types.ObjectId> uploadFromStream(ClientSession clientSession,
                                                                                    String filename,
                                                                                    AsyncInputStream source,
                                                                                    com.mongodb.client.gridfs.model.GridFSUploadOptions options)

Deprecated. prefer uploadFromPublisher(ClientSession, String, Publisher, GridFSUploadOptions) instead

Uploads the contents of the given AsyncInputStream to a GridFS bucket.

Reads the contents of the user file from the source and uploads it as chunks in the chunks collection. After all the chunks have been uploaded, it creates a files collection document for filename in the files collection.

Parameters:

clientSession - the client session with which to associate this operation

filename - the filename for the stream

source - the Stream providing the file data

options - the GridFSUploadOptions

Returns:

a Publisher with a single element, the ObjectId of the uploaded file.

Since:

1.7

Since server release

3.6

uploadFromStream

@Deprecated
org.reactivestreams.Publisher<Success> uploadFromStream(ClientSession clientSession,
                                                                    org.bson.BsonValue id,
                                                                    String filename,
                                                                    AsyncInputStream source)

Deprecated. prefer uploadFromPublisher(ClientSession, BsonValue, String, Publisher) instead

Uploads the contents of the given AsyncInputStream to a GridFS bucket.

Reads the contents of the user file from the source and uploads it as chunks in the chunks collection. After all the chunks have been uploaded, it creates a files collection document for filename in the files collection.

Parameters:

clientSession - the client session with which to associate this operation

id - the custom id value of the file

filename - the filename for the stream

source - the Stream providing the file data

Returns:

a Publisher with a single element, representing when the successful upload of the source.

Since:

1.7

Since server release

3.6

uploadFromStream

@Deprecated
org.reactivestreams.Publisher<Success> uploadFromStream(ClientSession clientSession,
                                                                    org.bson.BsonValue id,
                                                                    String filename,
                                                                    AsyncInputStream source,
                                                                    com.mongodb.client.gridfs.model.GridFSUploadOptions options)

Deprecated. prefer uploadFromPublisher(ClientSession, BsonValue, String, Publisher, GridFSUploadOptions) instead

Uploads the contents of the given AsyncInputStream to a GridFS bucket.

Reads the contents of the user file from the source and uploads it as chunks in the chunks collection. After all the chunks have been uploaded, it creates a files collection document for filename in the files collection.

Parameters:

clientSession - the client session with which to associate this operation

id - the custom id value of the file

filename - the filename for the stream

source - the Stream providing the file data

options - the GridFSUploadOptions

Returns:

a Publisher with a single element, representing when the successful upload of the source.

Since:

1.7

Since server release

3.6

openDownloadStream

@Deprecated
GridFSDownloadStream openDownloadStream(org.bson.types.ObjectId id)

Deprecated. prefer downloadToPublisher(ObjectId) instead

Opens a AsyncInputStream from which the application can read the contents of the stored file specified by id.

Parameters:

id - the ObjectId of the file to be put into a stream.

Returns:

the stream

openDownloadStream

@Deprecated
GridFSDownloadStream openDownloadStream(org.bson.BsonValue id)

Deprecated. prefer downloadToPublisher(BsonValue) instead

Opens a AsyncInputStream from which the application can read the contents of the stored file specified by id.

Parameters:

id - the custom id value of the file, to be put into a stream.

Returns:

the stream

openDownloadStream

@Deprecated
GridFSDownloadStream openDownloadStream(String filename)

Deprecated. prefer downloadToPublisher(String) instead

Opens a AsyncInputStream from which the application can read the contents of the latest version of the stored file specified by the filename.

Parameters:

filename - the name of the file to be downloaded

Returns:

the stream

openDownloadStream

@Deprecated
GridFSDownloadStream openDownloadStream(String filename,
                                                    com.mongodb.client.gridfs.model.GridFSDownloadOptions options)

Deprecated. prefer downloadToPublisher(String, GridFSDownloadOptions) instead

Opens a AsyncInputStream from which the application can read the contents of the stored file specified by filename and the revision in options.

Parameters:

filename - the name of the file to be downloaded

options - the download options

Returns:

the stream

openDownloadStream

@Deprecated
GridFSDownloadStream openDownloadStream(ClientSession clientSession,
                                                    org.bson.types.ObjectId id)

Deprecated. prefer downloadToPublisher(ClientSession, ObjectId) instead

Opens a AsyncInputStream from which the application can read the contents of the stored file specified by id.

Parameters:

clientSession - the client session with which to associate this operation

id - the ObjectId of the file to be put into a stream.

Returns:

the stream

Since:

1.7

Since server release

3.6

openDownloadStream

@Deprecated
GridFSDownloadStream openDownloadStream(ClientSession clientSession,
                                                    org.bson.BsonValue id)

Deprecated. prefer downloadToPublisher(ClientSession, BsonValue) instead

Opens a AsyncInputStream from which the application can read the contents of the stored file specified by id.

Parameters:

clientSession - the client session with which to associate this operation

id - the custom id value of the file, to be put into a stream.

Returns:

the stream

Since:

1.7

Since server release

3.6

openDownloadStream

@Deprecated
GridFSDownloadStream openDownloadStream(ClientSession clientSession,
                                                    String filename)

Deprecated. prefer downloadToPublisher(ClientSession, String) instead

Opens a AsyncInputStream from which the application can read the contents of the latest version of the stored file specified by the filename.

Parameters:

clientSession - the client session with which to associate this operation

filename - the name of the file to be downloaded

Returns:

the stream

Since:

1.7

Since server release

3.6

openDownloadStream

@Deprecated
GridFSDownloadStream openDownloadStream(ClientSession clientSession,
                                                    String filename,
                                                    com.mongodb.client.gridfs.model.GridFSDownloadOptions options)

Deprecated. prefer downloadToPublisher(ClientSession, String, GridFSDownloadOptions) instead

Opens a AsyncInputStream from which the application can read the contents of the stored file specified by filename and the revision in options.

Parameters:

clientSession - the client session with which to associate this operation

filename - the name of the file to be downloaded

options - the download options

Returns:

the stream

Since:

1.7

Since server release

3.6

downloadToStream

@Deprecated
org.reactivestreams.Publisher<Long> downloadToStream(org.bson.types.ObjectId id,
                                                                 AsyncOutputStream destination)

Deprecated. prefer downloadToPublisher(ObjectId) instead

Downloads the contents of the stored file specified by id and writes the contents to the destination AsyncOutputStream.

Parameters:

id - the ObjectId of the file to be written to the destination stream

destination - the destination stream

Returns:

a Publisher with a single element, representing the amount of data written

downloadToStream

@Deprecated
org.reactivestreams.Publisher<Long> downloadToStream(org.bson.BsonValue id,
                                                                 AsyncOutputStream destination)

Deprecated. prefer downloadToPublisher(BsonValue) instead

Downloads the contents of the stored file specified by id and writes the contents to the destination AsyncOutputStream.

Parameters:

id - the custom id of the file, to be written to the destination stream

destination - the destination stream

Returns:

a Publisher with a single element, representing the amount of data written

downloadToStream

@Deprecated
org.reactivestreams.Publisher<Long> downloadToStream(String filename,
                                                                 AsyncOutputStream destination)

Deprecated. prefer downloadToPublisher(String) instead

Downloads the contents of the latest version of the stored file specified by filename and writes the contents to the destination Stream.

Parameters:

filename - the name of the file to be downloaded

destination - the destination stream

Returns:

a Publisher with a single element, representing the amount of data written

downloadToStream

@Deprecated
org.reactivestreams.Publisher<Long> downloadToStream(String filename,
                                                                 AsyncOutputStream destination,
                                                                 com.mongodb.client.gridfs.model.GridFSDownloadOptions options)

Deprecated. prefer downloadToPublisher(String, GridFSDownloadOptions) instead

Downloads the contents of the stored file specified by filename and by the revision in options and writes the contents to the destination Stream.

Parameters:

filename - the name of the file to be downloaded

destination - the destination stream

options - the download options

Returns:

a Publisher with a single element, representing the amount of data written

downloadToStream

@Deprecated
org.reactivestreams.Publisher<Long> downloadToStream(ClientSession clientSession,
                                                                 org.bson.types.ObjectId id,
                                                                 AsyncOutputStream destination)

Deprecated. prefer downloadToPublisher(ClientSession, ObjectId) instead

Downloads the contents of the stored file specified by id and writes the contents to the destination AsyncOutputStream.

Parameters:

clientSession - the client session with which to associate this operation

id - the ObjectId of the file to be written to the destination stream

destination - the destination stream

Returns:

a Publisher with a single element, representing the amount of data written

Since:

1.7

Since server release

3.6

downloadToStream

@Deprecated
org.reactivestreams.Publisher<Long> downloadToStream(ClientSession clientSession,
                                                                 org.bson.BsonValue id,
                                                                 AsyncOutputStream destination)

Deprecated. prefer downloadToPublisher(ClientSession, BsonValue) instead

Downloads the contents of the stored file specified by id and writes the contents to the destination AsyncOutputStream.

Parameters:

clientSession - the client session with which to associate this operation

id - the custom id of the file, to be written to the destination stream

destination - the destination stream

Returns:

a Publisher with a single element, representing the amount of data written

Since:

1.7

Since server release

3.6

downloadToStream

@Deprecated
org.reactivestreams.Publisher<Long> downloadToStream(ClientSession clientSession,
                                                                 String filename,
                                                                 AsyncOutputStream destination)

Deprecated. prefer downloadToPublisher(ClientSession, String) instead

Downloads the contents of the latest version of the stored file specified by filename and writes the contents to the destination Stream.

Parameters:

clientSession - the client session with which to associate this operation

filename - the name of the file to be downloaded

destination - the destination stream

Returns:

a Publisher with a single element, representing the amount of data written

Since:

1.7

Since server release

3.6

downloadToStream

@Deprecated
org.reactivestreams.Publisher<Long> downloadToStream(ClientSession clientSession,
                                                                 String filename,
                                                                 AsyncOutputStream destination,
                                                                 com.mongodb.client.gridfs.model.GridFSDownloadOptions options)

Deprecated. prefer downloadToPublisher(ClientSession, String, GridFSDownloadOptions) instead

Downloads the contents of the stored file specified by filename and by the revision in options and writes the contents to the destination Stream.

Parameters:

clientSession - the client session with which to associate this operation

filename - the name of the file to be downloaded

destination - the destination stream

options - the download options

Returns:

a Publisher with a single element, representing the amount of data written

Since:

1.7

Since server release

3.6

uploadFromPublisher

GridFSUploadPublisher<org.bson.types.ObjectId> uploadFromPublisher(String filename,
                                                                   org.reactivestreams.Publisher<ByteBuffer> source)

Uploads the contents of the given Publisher to a GridFS bucket.

Reads the contents of the user file from the source and uploads it as chunks in the chunks collection. After all the chunks have been uploaded, it creates a files collection document for filename in the files collection.

Parameters:

filename - the filename for the stream

source - the Publisher providing the file data

Returns:

a Publisher with a single element, the ObjectId of the uploaded file.

Since:

1.13

uploadFromPublisher

GridFSUploadPublisher<org.bson.types.ObjectId> uploadFromPublisher(String filename,
                                                                   org.reactivestreams.Publisher<ByteBuffer> source,
                                                                   com.mongodb.client.gridfs.model.GridFSUploadOptions options)

Uploads the contents of the given Publisher to a GridFS bucket.

Reads the contents of the user file from the source and uploads it as chunks in the chunks collection. After all the chunks have been uploaded, it creates a files collection document for filename in the files collection.

Parameters:

filename - the filename for the stream

source - the Publisher providing the file data

options - the GridFSUploadOptions

Returns:

a Publisher with a single element, the ObjectId of the uploaded file.

Since:

1.13

uploadFromPublisher

GridFSUploadPublisher<Success> uploadFromPublisher(org.bson.BsonValue id,
                                                   String filename,
                                                   org.reactivestreams.Publisher<ByteBuffer> source)

Uploads the contents of the given Publisher to a GridFS bucket.

Reads the contents of the user file from the source and uploads it as chunks in the chunks collection. After all the chunks have been uploaded, it creates a files collection document for filename in the files collection.

Parameters:

id - the custom id value of the file

filename - the filename for the stream

source - the Publisher providing the file data

Returns:

a Publisher with a single element, representing when the successful upload of the source.

Since:

1.13

uploadFromPublisher

GridFSUploadPublisher<Success> uploadFromPublisher(org.bson.BsonValue id,
                                                   String filename,
                                                   org.reactivestreams.Publisher<ByteBuffer> source,
                                                   com.mongodb.client.gridfs.model.GridFSUploadOptions options)

Uploads the contents of the given Publisher to a GridFS bucket.

Reads the contents of the user file from the source and uploads it as chunks in the chunks collection. After all the chunks have been uploaded, it creates a files collection document for filename in the files collection.

Parameters:

id - the custom id value of the file

filename - the filename for the stream

source - the Publisher providing the file data

options - the GridFSUploadOptions

Returns:

a Publisher with a single element, representing when the successful upload of the source.

Since:

1.13

uploadFromPublisher

GridFSUploadPublisher<org.bson.types.ObjectId> uploadFromPublisher(ClientSession clientSession,
                                                                   String filename,
                                                                   org.reactivestreams.Publisher<ByteBuffer> source)

Uploads the contents of the given Publisher to a GridFS bucket.

Reads the contents of the user file from the source and uploads it as chunks in the chunks collection. After all the chunks have been uploaded, it creates a files collection document for filename in the files collection.

Parameters:

clientSession - the client session with which to associate this operation

filename - the filename for the stream

source - the Publisher providing the file data

Returns:

a Publisher with a single element, the ObjectId of the uploaded file.

Since:

1.13

Since server release

3.6

uploadFromPublisher

GridFSUploadPublisher<org.bson.types.ObjectId> uploadFromPublisher(ClientSession clientSession,
                                                                   String filename,
                                                                   org.reactivestreams.Publisher<ByteBuffer> source,
                                                                   com.mongodb.client.gridfs.model.GridFSUploadOptions options)

Uploads the contents of the given Publisher to a GridFS bucket.

Reads the contents of the user file from the source and uploads it as chunks in the chunks collection. After all the chunks have been uploaded, it creates a files collection document for filename in the files collection.

Parameters:

clientSession - the client session with which to associate this operation

filename - the filename for the stream

source - the Publisher providing the file data

options - the GridFSUploadOptions

Returns:

a Publisher with a single element, the ObjectId of the uploaded file.

Since:

1.13

Since server release

3.6

uploadFromPublisher

GridFSUploadPublisher<Success> uploadFromPublisher(ClientSession clientSession,
                                                   org.bson.BsonValue id,
                                                   String filename,
                                                   org.reactivestreams.Publisher<ByteBuffer> source)

Uploads the contents of the given Publisher to a GridFS bucket.

Reads the contents of the user file from the source and uploads it as chunks in the chunks collection. After all the chunks have been uploaded, it creates a files collection document for filename in the files collection.

Parameters:

clientSession - the client session with which to associate this operation

id - the custom id value of the file

filename - the filename for the stream

source - the Publisher providing the file data

Returns:

a Publisher with a single element, representing when the successful upload of the source.

Since:

1.13

Since server release

3.6

uploadFromPublisher

GridFSUploadPublisher<Success> uploadFromPublisher(ClientSession clientSession,
                                                   org.bson.BsonValue id,
                                                   String filename,
                                                   org.reactivestreams.Publisher<ByteBuffer> source,
                                                   com.mongodb.client.gridfs.model.GridFSUploadOptions options)

Uploads the contents of the given Publisher to a GridFS bucket.

Reads the contents of the user file from the source and uploads it as chunks in the chunks collection. After all the chunks have been uploaded, it creates a files collection document for filename in the files collection.

Parameters:

clientSession - the client session with which to associate this operation

id - the custom id value of the file

filename - the filename for the stream

source - the Publisher providing the file data

options - the GridFSUploadOptions

Returns:

a Publisher with a single element, representing when the successful upload of the source.

Since:

1.13

Since server release

3.6

downloadToPublisher

GridFSDownloadPublisher downloadToPublisher(org.bson.types.ObjectId id)

Downloads the contents of the stored file specified by id into the Publisher.

Parameters:

id - the ObjectId of the file to be written to the destination stream

Returns:

a Publisher with a single element, representing the amount of data written

Since:

1.13

downloadToPublisher

GridFSDownloadPublisher downloadToPublisher(org.bson.BsonValue id)

Downloads the contents of the stored file specified by id into the Publisher.

Parameters:

id - the custom id of the file, to be written to the destination stream

Returns:

a Publisher with a single element, representing the amount of data written

Since:

1.13

downloadToPublisher

GridFSDownloadPublisher downloadToPublisher(String filename)

Downloads the contents of the stored file specified by filename into the Publisher.

Parameters:

filename - the name of the file to be downloaded

Returns:

a Publisher with a single element, representing the amount of data written

Since:

1.13

downloadToPublisher

GridFSDownloadPublisher downloadToPublisher(String filename,
                                            com.mongodb.client.gridfs.model.GridFSDownloadOptions options)

Downloads the contents of the stored file specified by filename and by the revision in options into the Publisher.

Parameters:

filename - the name of the file to be downloaded

options - the download options

Returns:

a Publisher with a single element, representing the amount of data written

Since:

1.13

downloadToPublisher

GridFSDownloadPublisher downloadToPublisher(ClientSession clientSession,
                                            org.bson.types.ObjectId id)

Downloads the contents of the stored file specified by id into the Publisher.

Parameters:

clientSession - the client session with which to associate this operation

id - the ObjectId of the file to be written to the destination stream

Returns:

a Publisher with a single element, representing the amount of data written

Since:

1.13

Since server release

3.6

downloadToPublisher

GridFSDownloadPublisher downloadToPublisher(ClientSession clientSession,
                                            org.bson.BsonValue id)

Downloads the contents of the stored file specified by id into the Publisher.

Parameters:

clientSession - the client session with which to associate this operation

id - the custom id of the file, to be written to the destination stream

Returns:

a Publisher with a single element, representing the amount of data written

Since:

1.13

Since server release

3.6

downloadToPublisher

GridFSDownloadPublisher downloadToPublisher(ClientSession clientSession,
                                            String filename)

Downloads the contents of the latest version of the stored file specified by filename into the Publisher.

Parameters:

clientSession - the client session with which to associate this operation

filename - the name of the file to be downloaded

Returns:

a Publisher with a single element, representing the amount of data written

Since:

1.13

Since server release

3.6

downloadToPublisher

GridFSDownloadPublisher downloadToPublisher(ClientSession clientSession,
                                            String filename,
                                            com.mongodb.client.gridfs.model.GridFSDownloadOptions options)

Downloads the contents of the stored file specified by filename and by the revision in options into the Publisher.

Parameters:

clientSession - the client session with which to associate this operation

filename - the name of the file to be downloaded

options - the download options

Returns:

a Publisher with a single element, representing the amount of data written

Since:

1.13

Since server release

3.6

find

GridFSFindPublisher find()

Finds all documents in the files collection.

Returns:

the GridFS find iterable interface

MongoDB documentation

Find

find

GridFSFindPublisher find(org.bson.conversions.Bson filter)

Finds all documents in the collection that match the filter.

Below is an example of filtering against the filename and some nested metadata that can also be stored along with the file data:

  
      Filters.and(Filters.eq("filename", "mongodb.png"), Filters.eq("metadata.contentType", "image/png"));
  
  

Parameters:

filter - the query filter

Returns:

the GridFS find iterable interface

See Also:

Filters

find

GridFSFindPublisher find(ClientSession clientSession)

Finds all documents in the files collection.

Parameters:

clientSession - the client session with which to associate this operation

Returns:

the GridFS find iterable interface

Since:

1.7

MongoDB documentation

Find

Since server release

3.6

find

GridFSFindPublisher find(ClientSession clientSession,
                         org.bson.conversions.Bson filter)

Finds all documents in the collection that match the filter.

Below is an example of filtering against the filename and some nested metadata that can also be stored along with the file data:

  
      Filters.and(Filters.eq("filename", "mongodb.png"), Filters.eq("metadata.contentType", "image/png"));
  
  

Parameters:

clientSession - the client session with which to associate this operation

filter - the query filter

Returns:

the GridFS find iterable interface

Since:

1.7

See Also:

Filters

Since server release

3.6

delete

org.reactivestreams.Publisher<Success> delete(org.bson.types.ObjectId id)

Given a id, delete this stored file's files collection document and associated chunks from a GridFS bucket.

Parameters:

id - the ObjectId of the file to be deleted

Returns:

a Publisher with a single element, representing that the file has been deleted

delete

org.reactivestreams.Publisher<Success> delete(org.bson.BsonValue id)

Given a id, delete this stored file's files collection document and associated chunks from a GridFS bucket.

Parameters:

id - the ObjectId of the file to be deleted

Returns:

a Publisher with a single element, representing that the file has been deleted

delete

org.reactivestreams.Publisher<Success> delete(ClientSession clientSession,
                                              org.bson.types.ObjectId id)

Given a id, delete this stored file's files collection document and associated chunks from a GridFS bucket.

Parameters:

clientSession - the client session with which to associate this operation

id - the ObjectId of the file to be deleted

Returns:

a Publisher with a single element, representing that the file has been deleted

Since:

1.7

Since server release

3.6

delete

org.reactivestreams.Publisher<Success> delete(ClientSession clientSession,
                                              org.bson.BsonValue id)

Given a id, delete this stored file's files collection document and associated chunks from a GridFS bucket.

Parameters:

clientSession - the client session with which to associate this operation

id - the ObjectId of the file to be deleted

Returns:

a Publisher with a single element, representing that the file has been deleted

Since:

1.7

Since server release

3.6

rename

org.reactivestreams.Publisher<Success> rename(org.bson.types.ObjectId id,
                                              String newFilename)

Renames the stored file with the specified id.

Parameters:

id - the id of the file in the files collection to rename

newFilename - the new filename for the file

Returns:

a Publisher with a single element, representing that the file has been renamed

rename

org.reactivestreams.Publisher<Success> rename(org.bson.BsonValue id,
                                              String newFilename)

Renames the stored file with the specified id.

Parameters:

id - the id of the file in the files collection to rename

newFilename - the new filename for the file

Returns:

a Publisher with a single element, representing that the file has been renamed

rename

org.reactivestreams.Publisher<Success> rename(ClientSession clientSession,
                                              org.bson.types.ObjectId id,
                                              String newFilename)

Renames the stored file with the specified id.

Parameters:

clientSession - the client session with which to associate this operation

id - the id of the file in the files collection to rename

newFilename - the new filename for the file

Returns:

a Publisher with a single element, representing that the file has been renamed

Since:

1.7

Since server release

3.6

rename

org.reactivestreams.Publisher<Success> rename(ClientSession clientSession,
                                              org.bson.BsonValue id,
                                              String newFilename)

Renames the stored file with the specified id.

Parameters:

clientSession - the client session with which to associate this operation

id - the id of the file in the files collection to rename

newFilename - the new filename for the file

Returns:

a Publisher with a single element, representing that the file has been renamed

Since:

1.7

Since server release

3.6

drop

org.reactivestreams.Publisher<Success> drop()

Drops the data associated with this bucket from the database.

Returns:

a Publisher with a single element, representing that the collections have been dropped

drop

org.reactivestreams.Publisher<Success> drop(ClientSession clientSession)

Drops the data associated with this bucket from the database.

Parameters:

clientSession - the client session with which to associate this operation

Returns:

a Publisher with a single element, representing that the collections have been dropped

Since:

1.7

Since server release

3.6