com.mongodb.reactivestreams.client

Interface MongoClient

All Superinterfaces:

java.lang.AutoCloseable, java.io.Closeable

@Immutable
public interface MongoClient
extends java.io.Closeable

A client-side representation of a MongoDB cluster. Instances can represent either a standalone MongoDB instance, a replica set, or a sharded cluster. Instance of this class are responsible for maintaining an up-to-date state of the cluster, and possibly cache resources related to this, including background threads for monitoring, and connection pools.

Instance of this class server as factories for MongoDatabase instances.

Since:

1.0

Method Summary

Modifier and Type	Method and Description
void	close() Close the client, which will close all underlying cached resources, including, for example, sockets and background monitoring threads.
MongoDatabase	getDatabase(java.lang.String name) Gets the database with the given name.
com.mongodb.async.client.MongoClientSettings	getSettings() Deprecated. this method is being removed
org.reactivestreams.Publisher<java.lang.String>	listDatabaseNames() Get a list of the database names
org.reactivestreams.Publisher<java.lang.String>	listDatabaseNames(ClientSession clientSession) Get a list of the database names
ListDatabasesPublisher<Document>	listDatabases() Gets the list of databases
<TResult> ListDatabasesPublisher<TResult>	listDatabases(java.lang.Class<TResult> clazz) Gets the list of databases
ListDatabasesPublisher<Document>	listDatabases(ClientSession clientSession) Gets the list of databases
<TResult> ListDatabasesPublisher<TResult>	listDatabases(ClientSession clientSession, java.lang.Class<TResult> clazz) Gets the list of databases
org.reactivestreams.Publisher<ClientSession>	startSession(ClientSessionOptions options) Creates a client session.

Method Detail

getDatabase

MongoDatabase getDatabase(java.lang.String name)

Gets the database with the given name.

Parameters:

name - the name of the database

Returns:

the database

close

void close()

Close the client, which will close all underlying cached resources, including, for example, sockets and background monitoring threads.

Specified by:

close in interface java.lang.AutoCloseable

Specified by:

close in interface java.io.Closeable

getSettings

@Deprecated
com.mongodb.async.client.MongoClientSettings getSettings()

Deprecated. this method is being removed

Gets the settings that this client uses to connect to server.

Note: MongoClientSettings is immutable.

Returns:

the settings

listDatabaseNames

org.reactivestreams.Publisher<java.lang.String> listDatabaseNames()

Get a list of the database names

Returns:

an iterable containing all the names of all the databases

MongoDB documentation

List Databases

listDatabaseNames

org.reactivestreams.Publisher<java.lang.String> listDatabaseNames(ClientSession clientSession)

Get a list of the database names

Parameters:

clientSession - the client session with which to associate this operation

Returns:

an iterable containing all the names of all the databases

Since:

1.7

MongoDB documentation

List Databases

Since server release

3.6

listDatabases

ListDatabasesPublisher<Document> listDatabases()

Gets the list of databases

Returns:

the fluent list databases interface

listDatabases

<TResult> ListDatabasesPublisher<TResult> listDatabases(java.lang.Class<TResult> clazz)

Gets the list of databases

Type Parameters:

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

Parameters:

clazz - the class to cast the database documents to

Returns:

the fluent list databases interface

listDatabases

ListDatabasesPublisher<Document> listDatabases(ClientSession clientSession)

Gets the list of databases

Parameters:

clientSession - the client session with which to associate this operation

Returns:

the fluent list databases interface

Since:

1.7

Since server release

3.6

listDatabases

<TResult> ListDatabasesPublisher<TResult> listDatabases(ClientSession clientSession,
                                                        java.lang.Class<TResult> clazz)

Gets the list of databases

Type Parameters:

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

Parameters:

clientSession - the client session with which to associate this operation

clazz - the class to cast the database documents to

Returns:

the fluent list databases interface

Since:

1.7

Since server release

3.6

startSession

org.reactivestreams.Publisher<ClientSession> startSession(ClientSessionOptions options)

Creates a client session.

Parameters:

options - the options for the client session

Returns:

a publisher for the client session.

Since:

1.7

Since server release

3.6