com.mongodb

Class MongoClientSettings.Builder

java.lang.Object

com.mongodb.MongoClientSettings.Builder

Enclosing class:

MongoClientSettings

@NotThreadSafe
public static final class MongoClientSettings.Builder
extends java.lang.Object

A builder for MongoClientSettings so that MongoClientSettings can be immutable, and to support easier construction through chaining.

Method Summary

Modifier and Type	Method and Description
MongoClientSettings.Builder	addCommandListener(CommandListener commandListener) Adds the given command listener.
MongoClientSettings.Builder	applicationName(java.lang.String applicationName) Sets the logical name of the application using this MongoClient.
MongoClientSettings.Builder	applyConnectionString(ConnectionString connectionString) Takes the settings from the given ConnectionString and applies them to the builder
MongoClientSettings.Builder	applyToClusterSettings(Block<ClusterSettings.Builder> block) Applies the ClusterSettings.Builder block and then sets the clusterSettings.
MongoClientSettings.Builder	applyToConnectionPoolSettings(Block<ConnectionPoolSettings.Builder> block) Applies the ConnectionPoolSettings.Builder block and then sets the connectionPoolSettings.
MongoClientSettings.Builder	applyToServerSettings(Block<ServerSettings.Builder> block) Applies the ServerSettings.Builder block and then sets the serverSettings.
MongoClientSettings.Builder	applyToSocketSettings(Block<SocketSettings.Builder> block) Applies the SocketSettings.Builder block and then sets the socketSettings.
MongoClientSettings.Builder	applyToSslSettings(Block<SslSettings.Builder> block) Applies the SslSettings.Builder block and then sets the sslSettings.
MongoClientSettings.Builder	autoEncryptionSettings(AutoEncryptionSettings autoEncryptionSettings) Sets the auto-encryption settings
MongoClientSettings	build() Build an instance of MongoClientSettings.
MongoClientSettings.Builder	codecRegistry(CodecRegistry codecRegistry) Sets the codec registry
MongoClientSettings.Builder	commandListenerList(java.util.List<CommandListener> commandListeners) Sets the the command listeners
MongoClientSettings.Builder	compressorList(java.util.List<MongoCompressor> compressorList) Sets the compressors to use for compressing messages to the server.
MongoClientSettings.Builder	credential(MongoCredential credential) Sets the credential.
MongoClientSettings.Builder	readConcern(ReadConcern readConcern) Sets the read concern.
MongoClientSettings.Builder	readPreference(ReadPreference readPreference) Sets the read preference.
MongoClientSettings.Builder	retryReads(boolean retryReads) Sets whether reads should be retried if they fail due to a network error.
MongoClientSettings.Builder	retryWrites(boolean retryWrites) Sets whether writes should be retried if they fail due to a network error.
MongoClientSettings.Builder	streamFactoryFactory(StreamFactoryFactory streamFactoryFactory) Sets the factory to use to create a StreamFactory.
MongoClientSettings.Builder	uuidRepresentation(UuidRepresentation uuidRepresentation) Sets the UUID representation to use when encoding instances of UUID and when decoding BSON binary values with subtype of 3.
MongoClientSettings.Builder	writeConcern(WriteConcern writeConcern) Sets the write concern.

Methods inherited from class java.lang.Object

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

Method Detail

applyConnectionString

public MongoClientSettings.Builder applyConnectionString(ConnectionString connectionString)

Takes the settings from the given ConnectionString and applies them to the builder

Parameters:

connectionString - the connection string containing details of how to connect to MongoDB

Returns:

this

applyToClusterSettings

public MongoClientSettings.Builder applyToClusterSettings(Block<ClusterSettings.Builder> block)

Applies the ClusterSettings.Builder block and then sets the clusterSettings.

Parameters:

block - the block to apply to the ClusterSettings.

Returns:

this

See Also:

MongoClientSettings.getClusterSettings()

applyToSocketSettings

public MongoClientSettings.Builder applyToSocketSettings(Block<SocketSettings.Builder> block)

Applies the SocketSettings.Builder block and then sets the socketSettings.

Parameters:

block - the block to apply to the SocketSettings.

Returns:

this

See Also:

MongoClientSettings.getSocketSettings()

applyToConnectionPoolSettings

public MongoClientSettings.Builder applyToConnectionPoolSettings(Block<ConnectionPoolSettings.Builder> block)

Applies the ConnectionPoolSettings.Builder block and then sets the connectionPoolSettings.

Parameters:

block - the block to apply to the ConnectionPoolSettings.

Returns:

this

See Also:

MongoClientSettings.getConnectionPoolSettings()

applyToServerSettings

public MongoClientSettings.Builder applyToServerSettings(Block<ServerSettings.Builder> block)

Applies the ServerSettings.Builder block and then sets the serverSettings.

Parameters:

block - the block to apply to the ServerSettings.

Returns:

this

See Also:

MongoClientSettings.getServerSettings()

applyToSslSettings

public MongoClientSettings.Builder applyToSslSettings(Block<SslSettings.Builder> block)

Applies the SslSettings.Builder block and then sets the sslSettings.

Parameters:

block - the block to apply to the SslSettings.

Returns:

this

See Also:

MongoClientSettings.getSslSettings()

readPreference

public MongoClientSettings.Builder readPreference(ReadPreference readPreference)

Sets the read preference.

Parameters:

readPreference - read preference

Returns:

this

See Also:

MongoClientSettings.getReadPreference()

writeConcern

public MongoClientSettings.Builder writeConcern(WriteConcern writeConcern)

Sets the write concern.

Parameters:

writeConcern - the write concern

Returns:

this

See Also:

MongoClientSettings.getWriteConcern()

retryWrites

public MongoClientSettings.Builder retryWrites(boolean retryWrites)

Sets whether writes should be retried if they fail due to a network error.

Starting with the 3.11.0 release, the default value is true

Parameters:

retryWrites - sets if writes should be retried if they fail due to a network error.

Returns:

this

See Also:

MongoClientSettings.getRetryWrites()

retryReads

public MongoClientSettings.Builder retryReads(boolean retryReads)

Sets whether reads should be retried if they fail due to a network error.

Parameters:

retryReads - sets if reads should be retried if they fail due to a network error.

Returns:

this

Since:

3.11

See Also:

MongoClientSettings.getRetryReads()

readConcern

public MongoClientSettings.Builder readConcern(ReadConcern readConcern)

Sets the read concern.

Parameters:

readConcern - the read concern

Returns:

this

credential

public MongoClientSettings.Builder credential(MongoCredential credential)

Sets the credential.

Parameters:

credential - the credential

Returns:

this

codecRegistry

public MongoClientSettings.Builder codecRegistry(CodecRegistry codecRegistry)

Sets the codec registry

Parameters:

codecRegistry - the codec registry

Returns:

this

See Also:

MongoClientSettings.getCodecRegistry()

streamFactoryFactory

public MongoClientSettings.Builder streamFactoryFactory(StreamFactoryFactory streamFactoryFactory)

Sets the factory to use to create a StreamFactory.

Parameters:

streamFactoryFactory - the stream factory factory

Returns:

this

addCommandListener

public MongoClientSettings.Builder addCommandListener(CommandListener commandListener)

Adds the given command listener.

Parameters:

commandListener - the command listener

Returns:

this

commandListenerList

public MongoClientSettings.Builder commandListenerList(java.util.List<CommandListener> commandListeners)

Sets the the command listeners

Parameters:

commandListeners - the list of command listeners

Returns:

this

applicationName

public MongoClientSettings.Builder applicationName(@Nullable
                                                   java.lang.String applicationName)

Sets the logical name of the application using this MongoClient. The application name may be used by the client to identify the application to the server, for use in server logs, slow query logs, and profile collection.

Parameters:

applicationName - the logical name of the application using this MongoClient. It may be null. The UTF-8 encoding may not exceed 128 bytes.

Returns:

this

See Also:

MongoClientSettings.getApplicationName()

compressorList

public MongoClientSettings.Builder compressorList(java.util.List<MongoCompressor> compressorList)

Sets the compressors to use for compressing messages to the server. The driver will use the first compressor in the list that the server is configured to support.

Parameters:

compressorList - the list of compressors to request

Returns:

this

See Also:

MongoClientSettings.getCompressorList()

uuidRepresentation

public MongoClientSettings.Builder uuidRepresentation(UuidRepresentation uuidRepresentation)

Sets the UUID representation to use when encoding instances of UUID and when decoding BSON binary values with subtype of 3.

See MongoClientSettings.getUuidRepresentation() for recommendations on settings this value

Parameters:

uuidRepresentation - the UUID representation, which may not be null

Returns:

this

Since:

3.12

autoEncryptionSettings

public MongoClientSettings.Builder autoEncryptionSettings(AutoEncryptionSettings autoEncryptionSettings)

Sets the auto-encryption settings

Parameters:

autoEncryptionSettings - the auto-encryption settings

Returns:

this

Since:

3.11

See Also:

MongoClientSettings.getAutoEncryptionSettings()

build

public MongoClientSettings build()

Build an instance of MongoClientSettings.

Returns:

the settings from this builder