Package com.mongodb.connection

Class ClusterSettings.Builder

java.lang.Object

com.mongodb.connection.ClusterSettings.Builder

Enclosing class:

ClusterSettings

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

A builder for the cluster settings.

Method Summary

Modifier and Type	Method and Description
ClusterSettings.Builder	addClusterListener(ClusterListener clusterListener) Adds a cluster listener.
ClusterSettings.Builder	applyConnectionString(ConnectionString connectionString) Take the settings from the given ConnectionString and add them to the builder
ClusterSettings	build() Build the settings from the builder.
ClusterSettings.Builder	description(java.lang.String description) Sets the user defined description of the MongoClient.
ClusterSettings.Builder	hosts(java.util.List<ServerAddress> hosts) Sets the hosts for the cluster.
ClusterSettings.Builder	maxWaitQueueSize(int maxWaitQueueSize) This is the maximum number of concurrent operations allowed to wait for a server to become available.
ClusterSettings.Builder	mode(ClusterConnectionMode mode) Sets the mode for this cluster.
ClusterSettings.Builder	requiredClusterType(ClusterType requiredClusterType) Sets the required cluster type for the cluster.
ClusterSettings.Builder	requiredReplicaSetName(java.lang.String requiredReplicaSetName) Sets the required replica set name for the cluster.
ClusterSettings.Builder	serverSelectionTimeout(long serverSelectionTimeout, java.util.concurrent.TimeUnit timeUnit) Sets the timeout to apply when selecting a server.
ClusterSettings.Builder	serverSelector(ServerSelector serverSelector) Sets the final server selector for the cluster to apply before selecting a server

Methods inherited from class java.lang.Object

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

Method Detail

description

public ClusterSettings.Builder description(java.lang.String description)

Sets the user defined description of the MongoClient.

Parameters:

description - the user defined description of the MongoClient

Returns:

this

hosts

public ClusterSettings.Builder hosts(java.util.List<ServerAddress> hosts)

Sets the hosts for the cluster. Any duplicate server addresses are removed from the list.

Parameters:

hosts - the seed list of hosts

Returns:

this

mode

public ClusterSettings.Builder mode(ClusterConnectionMode mode)

Sets the mode for this cluster.

Parameters:

mode - the cluster connection mode

Returns:

this;

requiredReplicaSetName

public ClusterSettings.Builder requiredReplicaSetName(java.lang.String requiredReplicaSetName)

Sets the required replica set name for the cluster.

Parameters:

requiredReplicaSetName - the required replica set name.

Returns:

this

requiredClusterType

public ClusterSettings.Builder requiredClusterType(ClusterType requiredClusterType)

Sets the required cluster type for the cluster.

Parameters:

requiredClusterType - the required cluster type

Returns:

this

serverSelector

public ClusterSettings.Builder serverSelector(ServerSelector serverSelector)

Sets the final server selector for the cluster to apply before selecting a server

Parameters:

serverSelector - the server selector to apply as the final selector.

Returns:

this

serverSelectionTimeout

public ClusterSettings.Builder serverSelectionTimeout(long serverSelectionTimeout,
                                                      java.util.concurrent.TimeUnit timeUnit)

Sets the timeout to apply when selecting a server. If the timeout expires before a server is found to handle a request, a MongoTimeoutException will be thrown. The default value is 30 seconds.

A value of 0 means that it will timeout immediately if no server is available. A negative value means to wait indefinitely.

Parameters:

serverSelectionTimeout - the timeout

timeUnit - the time unit

Returns:

this

maxWaitQueueSize

public ClusterSettings.Builder maxWaitQueueSize(int maxWaitQueueSize)

This is the maximum number of concurrent operations allowed to wait for a server to become available. All further operations will get an exception immediately.

Default is 500.

Parameters:

maxWaitQueueSize - the number of threads that are allowed to be waiting for a connection.

Returns:

this

addClusterListener

public ClusterSettings.Builder addClusterListener(ClusterListener clusterListener)

Adds a cluster listener.

Parameters:

clusterListener - the non-null cluster listener

Returns:

this

Since:

3.3

applyConnectionString

public ClusterSettings.Builder applyConnectionString(ConnectionString connectionString)

Take the settings from the given ConnectionString and add them to the builder

Parameters:

connectionString - a URI containing details of how to connect to MongoDB

Returns:

this

build

public ClusterSettings build()

Build the settings from the builder.

Returns:

the cluster settings