Package com.mongodb.async.client

Class MongoClients

java.lang.Object

com.mongodb.async.client.MongoClients

public final class MongoClients
extends Object

A factory for MongoClient instances.

Since:

3.0

Method Summary

Modifier and Type	Method	Description
static MongoClient	create()	Creates a new client with the default connection string "mongodb://localhost".
static MongoClient	create(MongoClientSettings settings)	Deprecated. use create(com.mongodb.MongoClientSettings) instead
static MongoClient	create(MongoClientSettings settings, MongoDriverInformation mongoDriverInformation)	Deprecated. use create(com.mongodb.MongoClientSettings, MongoDriverInformation) instead
static MongoClient	create(ConnectionString connectionString)	Create a new client with the given connection string.
static MongoClient	create(ConnectionString connectionString, MongoDriverInformation mongoDriverInformation)	Create a new client with the given connection string.
static MongoClient	create(MongoClientSettings settings)	Create a new client with the given client settings.
static MongoClient	create(MongoClientSettings settings, MongoDriverInformation mongoDriverInformation)	Creates a new client with the given client settings.
static MongoClient	create(String connectionString)	Create a new client with the given connection string as if by a call to create(ConnectionString).
static CodecRegistry	getDefaultCodecRegistry()	Gets the default codec registry.

Methods inherited from class java.lang.Object

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

Method Detail

create

public static MongoClient create()

Creates a new client with the default connection string "mongodb://localhost".

Returns:

the client

create

@Deprecated
public static MongoClient create(MongoClientSettings settings)

Deprecated. use create(com.mongodb.MongoClientSettings) instead

Create a new client with the given client settings.

Parameters:

settings - the settings

Returns:

the client

create

public static MongoClient create(String connectionString)

Create a new client with the given connection string as if by a call to create(ConnectionString).

Parameters:

connectionString - the connection

Returns:

the client

See Also:

create(ConnectionString)

create

public static MongoClient create(ConnectionString connectionString)

Create a new client with the given connection string.

For each of the settings classed configurable via MongoClientSettings, the connection string is applied by calling the applyConnectionString method on an instance of setting's builder class, building the setting, and adding it to an instance of MongoClientSettings.Builder.

The connection string's stream type is then applied by setting the StreamFactory to an instance of NettyStreamFactory,

Parameters:

connectionString - the settings

Returns:

the client

Throws:

IllegalArgumentException - if the connection string's stream type is not one of "netty" or "nio2"

See Also:

ConnectionString.getStreamType(), MongoClientSettings.Builder, ClusterSettings.Builder.applyConnectionString(ConnectionString), ConnectionPoolSettings.Builder.applyConnectionString(ConnectionString), ServerSettings.Builder.applyConnectionString(ConnectionString), SslSettings.Builder.applyConnectionString(ConnectionString), SocketSettings.Builder.applyConnectionString(ConnectionString)

create

@Deprecated
public static MongoClient create(MongoClientSettings settings,
                                 @Nullable
                                 MongoDriverInformation mongoDriverInformation)

Deprecated. use create(com.mongodb.MongoClientSettings, MongoDriverInformation) instead

Creates a new client with the given client settings.

Note: Intended for driver and library authors to associate extra driver metadata with the connections.

Parameters:

settings - the settings

mongoDriverInformation - any driver information to associate with the MongoClient

Returns:

the client

Since:

3.4

create

public static MongoClient create(ConnectionString connectionString,
                                 @Nullable
                                 MongoDriverInformation mongoDriverInformation)

Create a new client with the given connection string.

Note: Intended for driver and library authors to associate extra driver metadata with the connections.

Parameters:

connectionString - the settings

mongoDriverInformation - any driver information to associate with the MongoClient

Returns:

the client

Throws:

IllegalArgumentException - if the connection string's stream type is not one of "netty" or "nio2"

See Also:

create(ConnectionString)

create

public static MongoClient create(MongoClientSettings settings)

Create a new client with the given client settings.

Parameters:

settings - the settings

Returns:

the client

Since:

3.7

create

public static MongoClient create(MongoClientSettings settings,
                                 @Nullable
                                 MongoDriverInformation mongoDriverInformation)

Creates a new client with the given client settings.

Note: Intended for driver and library authors to associate extra driver metadata with the connections.

Parameters:

settings - the settings

mongoDriverInformation - any driver information to associate with the MongoClient

Returns:

the client

Since:

3.7

getDefaultCodecRegistry

public static CodecRegistry getDefaultCodecRegistry()

Gets the default codec registry. It includes the following providers:

• ValueCodecProvider
• BsonValueCodecProvider
• DBRefCodecProvider
• DocumentCodecProvider
• IterableCodecProvider
• MapCodecProvider
• GeoJsonCodecProvider
• GridFSFileCodecProvider
• Jsr310CodecProvider

Returns:

the default codec registry

Since:

3.1

See Also:

MongoClientSettings.getCodecRegistry()