com.mongodb.reactivestreams.client

Interface MongoDatabase

@ThreadSafe
public interface MongoDatabase

The MongoDatabase interface.

Note: Additions to this interface will not be considered to break binary compatibility.

Since:

1.0

Method Summary

Methods

Modifier and Type	Method and Description
org.reactivestreams.Publisher<Success>	createCollection(String collectionName) Create a new collection with the given name.
org.reactivestreams.Publisher<Success>	createCollection(String collectionName, com.mongodb.client.model.CreateCollectionOptions options) Create a new collection with the selected options
org.reactivestreams.Publisher<Success>	createView(String viewName, String viewOn, List<? extends org.bson.conversions.Bson> pipeline) Creates a view with the given name, backing collection/view name, and aggregation pipeline that defines the view.
org.reactivestreams.Publisher<Success>	createView(String viewName, String viewOn, List<? extends org.bson.conversions.Bson> pipeline, com.mongodb.client.model.CreateViewOptions createViewOptions) Creates a view with the given name, backing collection/view name, aggregation pipeline, and options that defines the view.
org.reactivestreams.Publisher<Success>	drop() Drops this database.
org.bson.codecs.configuration.CodecRegistry	getCodecRegistry() Get the codec registry for the MongoDatabase.
MongoCollection<org.bson.Document>	getCollection(String collectionName) Gets a collection.
<TDocument> MongoCollection<TDocument>	getCollection(String collectionName, Class<TDocument> clazz) Gets a collection, with a specific default document class.
String	getName() Gets the name of the database.
com.mongodb.ReadConcern	getReadConcern() Get the read concern for the MongoCollection.
com.mongodb.ReadPreference	getReadPreference() Get the read preference for the MongoDatabase.
com.mongodb.WriteConcern	getWriteConcern() Get the write concern for the MongoDatabase.
org.reactivestreams.Publisher<String>	listCollectionNames() Gets the names of all the collections in this database.
ListCollectionsPublisher<org.bson.Document>	listCollections() Finds all the collections in this database.
<TResult> ListCollectionsPublisher<TResult>	listCollections(Class<TResult> clazz) Finds all the collections in this database.
org.reactivestreams.Publisher<org.bson.Document>	runCommand(org.bson.conversions.Bson command) Executes command in the context of the current database.
<TResult> org.reactivestreams.Publisher<TResult>	runCommand(org.bson.conversions.Bson command, Class<TResult> clazz) Executes command in the context of the current database.
org.reactivestreams.Publisher<org.bson.Document>	runCommand(org.bson.conversions.Bson command, com.mongodb.ReadPreference readPreference) Executes command in the context of the current database.
<TResult> org.reactivestreams.Publisher<TResult>	runCommand(org.bson.conversions.Bson command, com.mongodb.ReadPreference readPreference, Class<TResult> clazz) Executes command in the context of the current database.
MongoDatabase	withCodecRegistry(org.bson.codecs.configuration.CodecRegistry codecRegistry) Create a new MongoDatabase instance with a different codec registry.
MongoDatabase	withReadConcern(com.mongodb.ReadConcern readConcern) Create a new MongoDatabase instance with a different read concern.
MongoDatabase	withReadPreference(com.mongodb.ReadPreference readPreference) Create a new MongoDatabase instance with a different read preference.
MongoDatabase	withWriteConcern(com.mongodb.WriteConcern writeConcern) Create a new MongoDatabase instance with a different write concern.

Method Detail

getName

String getName()

Gets the name of the database.

Returns:

the database name

getCodecRegistry

org.bson.codecs.configuration.CodecRegistry getCodecRegistry()

Get the codec registry for the MongoDatabase.

Returns:

the CodecRegistry

getReadPreference

com.mongodb.ReadPreference getReadPreference()

Get the read preference for the MongoDatabase.

Returns:

the ReadPreference

getWriteConcern

com.mongodb.WriteConcern getWriteConcern()

Get the write concern for the MongoDatabase.

Returns:

the WriteConcern

getReadConcern

com.mongodb.ReadConcern getReadConcern()

Get the read concern for the MongoCollection.

Returns:

the ReadConcern

Since:

1.2

Since server release

3.2

withCodecRegistry

MongoDatabase withCodecRegistry(org.bson.codecs.configuration.CodecRegistry codecRegistry)

Create a new MongoDatabase instance with a different codec registry.

Parameters:

codecRegistry - the new CodecRegistry for the collection

Returns:

a new MongoDatabase instance with the different codec registry

withReadPreference

MongoDatabase withReadPreference(com.mongodb.ReadPreference readPreference)

Create a new MongoDatabase instance with a different read preference.

Parameters:

readPreference - the new ReadPreference for the collection

Returns:

a new MongoDatabase instance with the different readPreference

withWriteConcern

MongoDatabase withWriteConcern(com.mongodb.WriteConcern writeConcern)

Create a new MongoDatabase instance with a different write concern.

Parameters:

writeConcern - the new WriteConcern for the collection

Returns:

a new MongoDatabase instance with the different writeConcern

withReadConcern

MongoDatabase withReadConcern(com.mongodb.ReadConcern readConcern)

Create a new MongoDatabase instance with a different read concern.

Parameters:

readConcern - the new ReadConcern for the collection

Returns:

a new MongoDatabase instance with the different ReadConcern

Since:

1.2

Since server release

3.2

getCollection

MongoCollection<org.bson.Document> getCollection(String collectionName)

Gets a collection.

Parameters:

collectionName - the name of the collection to return

Returns:

the collection

getCollection

<TDocument> MongoCollection<TDocument> getCollection(String collectionName,
                                                   Class<TDocument> clazz)

Gets a collection, with a specific default document class.

Type Parameters:

TDocument - the type of the class to use instead of Document.

Parameters:

collectionName - the name of the collection to return

clazz - the default class to cast any documents returned from the database into.

Returns:

the collection

runCommand

org.reactivestreams.Publisher<org.bson.Document> runCommand(org.bson.conversions.Bson command)

Executes command in the context of the current database.

Parameters:

command - the command to be run

Returns:

a publisher containing the command result

runCommand

org.reactivestreams.Publisher<org.bson.Document> runCommand(org.bson.conversions.Bson command,
                                                          com.mongodb.ReadPreference readPreference)

Executes command in the context of the current database.

Parameters:

command - the command to be run

readPreference - the ReadPreference to be used when executing the command

Returns:

a publisher containing the command result

runCommand

<TResult> org.reactivestreams.Publisher<TResult> runCommand(org.bson.conversions.Bson command,
                                                          Class<TResult> clazz)

Executes command in the context of the current database.

Type Parameters:

TResult - the type of the class to use instead of Document.

Parameters:

command - the command to be run

clazz - the default class to cast any documents returned from the database into.

Returns:

a publisher containing the command result

runCommand

<TResult> org.reactivestreams.Publisher<TResult> runCommand(org.bson.conversions.Bson command,
                                                          com.mongodb.ReadPreference readPreference,
                                                          Class<TResult> clazz)

Executes command in the context of the current database.

Type Parameters:

TResult - the type of the class to use instead of Document.

Parameters:

command - the command to be run

readPreference - the ReadPreference to be used when executing the command

clazz - the default class to cast any documents returned from the database into.

Returns:

a publisher containing the command result

drop

org.reactivestreams.Publisher<Success> drop()

Drops this database.

Returns:

a publisher identifying when the database has been dropped

MongoDB documentation

Drop database

listCollectionNames

org.reactivestreams.Publisher<String> listCollectionNames()

Gets the names of all the collections in this database.

Returns:

a publisher with all the names of all the collections in this database

listCollections

ListCollectionsPublisher<org.bson.Document> listCollections()

Finds all the collections in this database.

Returns:

the fluent list collections interface

MongoDB documentation

listCollections

listCollections

<TResult> ListCollectionsPublisher<TResult> listCollections(Class<TResult> clazz)

Finds all the collections in this database.

Type Parameters:

TResult - the target document type of the iterable.

Parameters:

clazz - the class to decode each document into

Returns:

the fluent list collections interface

MongoDB documentation

listCollections

createCollection

org.reactivestreams.Publisher<Success> createCollection(String collectionName)

Create a new collection with the given name.

Parameters:

collectionName - the name for the new collection to create

Returns:

a publisher identifying when the collection has been created

MongoDB documentation

Create Command

createCollection

org.reactivestreams.Publisher<Success> createCollection(String collectionName,
                                                      com.mongodb.client.model.CreateCollectionOptions options)

Create a new collection with the selected options

Parameters:

collectionName - the name for the new collection to create

options - various options for creating the collection

Returns:

a publisher identifying when the collection has been created

MongoDB documentation

Create Command

createView

org.reactivestreams.Publisher<Success> createView(String viewName,
                                                String viewOn,
                                                List<? extends org.bson.conversions.Bson> pipeline)

Creates a view with the given name, backing collection/view name, and aggregation pipeline that defines the view.

Parameters:

viewName - the name of the view to create

viewOn - the backing collection/view for the view

pipeline - the pipeline that defines the view

Returns:

an observable identifying when the collection view has been created

Since:

1.3

MongoDB documentation

Create Command

Since server release

3.4

createView

org.reactivestreams.Publisher<Success> createView(String viewName,
                                                String viewOn,
                                                List<? extends org.bson.conversions.Bson> pipeline,
                                                com.mongodb.client.model.CreateViewOptions createViewOptions)

Creates a view with the given name, backing collection/view name, aggregation pipeline, and options that defines the view.

Parameters:

viewName - the name of the view to create

viewOn - the backing collection/view for the view

pipeline - the pipeline that defines the view

createViewOptions - various options for creating the view

Returns:

an observable identifying when the collection view has been created

Since:

1.3

MongoDB documentation

Create Command

Since server release

3.4