MongoClientOptions.Builder (mongo-java-driver 3.3.0-query-log-max-size API)

java.lang.Object
- com.mongodb.MongoClientOptions.Builder

封闭类:

MongoClientOptions
```
@NotThreadSafe
public static class MongoClientOptions.Builder
extends java.lang.Object
```
A builder for MongoClientOptions so that MongoClientOptions can be immutable, and to support easier construction through chaining.

从以下版本开始:

2.10.0

构造器概要

构造器
构造器和说明
`Builder()` Creates a Builder for MongoClientOptions, getting the appropriate system properties for initialization.
`Builder(MongoClientOptions options)` Creates a Builder from an existing MongoClientOptions.

方法概要

所有方法实例方法具体方法
限定符和类型	方法和说明
`MongoClientOptions.Builder`	`addClusterListener(ClusterListener clusterListener)` Adds the given cluster listener.
`MongoClientOptions.Builder`	`addCommandListener(CommandListener commandListener)` Adds the given command listener.
`MongoClientOptions.Builder`	`addServerListener(ServerListener serverListener)` Adds the given server listener.
`MongoClientOptions.Builder`	`addServerMonitorListener(ServerMonitorListener serverMonitorListener)` Adds the given server monitro listener.
`MongoClientOptions.Builder`	`alwaysUseMBeans(boolean alwaysUseMBeans)` Sets whether JMX beans registered by the driver should always be MBeans, regardless of whether the VM is Java 6 or greater.
`MongoClientOptions`	`build()` Build an instance of MongoClientOptions.
`MongoClientOptions.Builder`	`codecRegistry(CodecRegistry codecRegistry)` Sets the codec registry Note that instances of `DB` and `DBCollection` do not use the registry, so it's not necessary to include a codec for DBObject in the registry.
`MongoClientOptions.Builder`	`connectionsPerHost(int connectionsPerHost)` Sets the maximum number of connections per host.
`MongoClientOptions.Builder`	`connectTimeout(int connectTimeout)` Sets the connection timeout.
`MongoClientOptions.Builder`	`cursorFinalizerEnabled(boolean cursorFinalizerEnabled)` Sets whether cursor finalizers are enabled.
`MongoClientOptions.Builder`	`dbDecoderFactory(DBDecoderFactory dbDecoderFactory)` Sets the decoder factory.
`MongoClientOptions.Builder`	`dbEncoderFactory(DBEncoderFactory dbEncoderFactory)` Sets the encoder factory.
`MongoClientOptions.Builder`	`description(java.lang.String description)` Sets the description.
`MongoClientOptions.Builder`	`heartbeatConnectTimeout(int connectTimeout)` Sets the connect timeout for connections used for the cluster heartbeat.
`MongoClientOptions.Builder`	`heartbeatFrequency(int heartbeatFrequency)` Sets the heartbeat frequency.
`MongoClientOptions.Builder`	`heartbeatSocketTimeout(int socketTimeout)` Sets the socket timeout for connections used for the cluster heartbeat.
`MongoClientOptions.Builder`	`legacyDefaults()` Sets defaults to be what they are in `MongoOptions`.
`MongoClientOptions.Builder`	`localThreshold(int localThreshold)` Sets the local threshold.
`MongoClientOptions.Builder`	`maxConnectionIdleTime(int maxConnectionIdleTime)` Sets the maximum idle time for a pooled connection.
`MongoClientOptions.Builder`	`maxConnectionLifeTime(int maxConnectionLifeTime)` Sets the maximum life time for a pooled connection.
`MongoClientOptions.Builder`	`maxWaitTime(int maxWaitTime)` Sets the maximum time that a thread will block waiting for a connection.
`MongoClientOptions.Builder`	`minConnectionsPerHost(int minConnectionsPerHost)` Sets the minimum number of connections per host.
`MongoClientOptions.Builder`	`minHeartbeatFrequency(int minHeartbeatFrequency)` Sets the minimum heartbeat frequency.
`MongoClientOptions.Builder`	`readConcern(ReadConcern readConcern)` Sets the read concern.
`MongoClientOptions.Builder`	`readPreference(ReadPreference readPreference)` Sets the read preference.
`MongoClientOptions.Builder`	`requiredReplicaSetName(java.lang.String requiredReplicaSetName)` Sets the required replica set name for the cluster.
`MongoClientOptions.Builder`	`serverSelectionTimeout(int serverSelectionTimeout)` Sets the server selection timeout in milliseconds, which defines how long the driver will wait for server selection to succeed before throwing an exception.
`MongoClientOptions.Builder`	`socketFactory(javax.net.SocketFactory socketFactory)` Sets the socket factory.
`MongoClientOptions.Builder`	`socketKeepAlive(boolean socketKeepAlive)` Sets whether socket keep alive is enabled.
`MongoClientOptions.Builder`	`socketTimeout(int socketTimeout)` Sets the socket timeout.
`MongoClientOptions.Builder`	`sslEnabled(boolean sslEnabled)` Sets whether to use SSL.
`MongoClientOptions.Builder`	`sslInvalidHostNameAllowed(boolean sslInvalidHostNameAllowed)` Define whether invalid host names should be allowed.
`MongoClientOptions.Builder`	`threadsAllowedToBlockForConnectionMultiplier(int threadsAllowedToBlockForConnectionMultiplier)` Sets the multiplier for number of threads allowed to block waiting for a connection.
`MongoClientOptions.Builder`	`writeConcern(WriteConcern writeConcern)` Sets the write concern.

从类继承的方法 java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- 构造器详细资料
  - Builder
```
public Builder()
```
    Creates a Builder for MongoClientOptions, getting the appropriate system properties for initialization.
  - Builder
```
public Builder(MongoClientOptions options)
```
    Creates a Builder from an existing MongoClientOptions.
    
    参数:
    
    options - create a builder from existing options
- 方法详细资料
  - description
```
public MongoClientOptions.Builder description(java.lang.String description)
```
    Sets the description.
    
    参数:
    
    description - the description of this MongoClient
    
    返回:
    
    this
    
    另请参阅:
    
    MongoClientOptions.getDescription()
  - minConnectionsPerHost
```
public MongoClientOptions.Builder minConnectionsPerHost(int minConnectionsPerHost)
```
    Sets the minimum number of connections per host.
    
    参数:
    
    minConnectionsPerHost - minimum number of connections
    
    返回:
    
    this
    
    抛出:
    
    java.lang.IllegalArgumentException - if minConnectionsPerHost < 0
    
    从以下版本开始:
    
    2.12
    
    另请参阅:
    
    MongoClientOptions.getMinConnectionsPerHost()
  - connectionsPerHost
```
public MongoClientOptions.Builder connectionsPerHost(int connectionsPerHost)
```
    Sets the maximum number of connections per host.
    
    参数:
    
    connectionsPerHost - maximum number of connections
    
    返回:
    
    this
    
    抛出:
    
    java.lang.IllegalArgumentException - if connectionsPerHost < 1
    
    另请参阅:
    
    MongoClientOptions.getConnectionsPerHost()
  - threadsAllowedToBlockForConnectionMultiplier
```
public MongoClientOptions.Builder threadsAllowedToBlockForConnectionMultiplier(int threadsAllowedToBlockForConnectionMultiplier)
```
    Sets the multiplier for number of threads allowed to block waiting for a connection.
    
    参数:
    
    threadsAllowedToBlockForConnectionMultiplier - the multiplier
    
    返回:
    
    this
    
    抛出:
    
    java.lang.IllegalArgumentException - if threadsAllowedToBlockForConnectionMultiplier < 1
    
    另请参阅:
    
    MongoClientOptions.getThreadsAllowedToBlockForConnectionMultiplier()
  - serverSelectionTimeout
```
public MongoClientOptions.Builder serverSelectionTimeout(int serverSelectionTimeout)
```
    Sets the server selection timeout in milliseconds, which defines how long the driver will wait for server selection to succeed before throwing an exception.
    
    A value of 0 means that it will timeout immediately if no server is available. A negative value means to wait indefinitely.
    
    参数:
    
    serverSelectionTimeout - the server selection timeout
    
    返回:
    
    this
    
    另请参阅:
    
    MongoClientOptions.getServerSelectionTimeout()
  - maxWaitTime
```
public MongoClientOptions.Builder maxWaitTime(int maxWaitTime)
```
    Sets the maximum time that a thread will block waiting for a connection.
    
    参数:
    
    maxWaitTime - the maximum wait time
    
    返回:
    
    this
    
    另请参阅:
    
    MongoClientOptions.getMaxWaitTime()
  - maxConnectionIdleTime
```
public MongoClientOptions.Builder maxConnectionIdleTime(int maxConnectionIdleTime)
```
    Sets the maximum idle time for a pooled connection.
    
    参数:
    
    maxConnectionIdleTime - the maximum idle time
    
    返回:
    
    this
    
    抛出:
    
    java.lang.IllegalArgumentException - if aMaxConnectionIdleTime < 0
    
    从以下版本开始:
    
    2.12
    
    另请参阅:
    
    MongoClientOptions.getMaxConnectionIdleTime()
  - maxConnectionLifeTime
```
public MongoClientOptions.Builder maxConnectionLifeTime(int maxConnectionLifeTime)
```
    Sets the maximum life time for a pooled connection.
    
    参数:
    
    maxConnectionLifeTime - the maximum life time
    
    返回:
    
    this
    
    抛出:
    
    java.lang.IllegalArgumentException - if aMaxConnectionIdleTime < 0
    
    从以下版本开始:
    
    2.12
    
    另请参阅:
    
    MongoClientOptions.getMaxConnectionIdleTime()
  - connectTimeout
```
public MongoClientOptions.Builder connectTimeout(int connectTimeout)
```
    Sets the connection timeout.
    
    参数:
    
    connectTimeout - the connection timeout
    
    返回:
    
    this
    
    另请参阅:
    
    MongoClientOptions.getConnectTimeout()
  - socketTimeout
```
public MongoClientOptions.Builder socketTimeout(int socketTimeout)
```
    Sets the socket timeout.
    
    参数:
    
    socketTimeout - the socket timeout
    
    返回:
    
    this
    
    另请参阅:
    
    MongoClientOptions.getSocketTimeout()
  - socketKeepAlive
```
public MongoClientOptions.Builder socketKeepAlive(boolean socketKeepAlive)
```
    Sets whether socket keep alive is enabled.
    
    参数:
    
    socketKeepAlive - keep alive
    
    返回:
    
    this
    
    另请参阅:
    
    MongoClientOptions.isSocketKeepAlive()
  - sslEnabled
```
public MongoClientOptions.Builder sslEnabled(boolean sslEnabled)
```
    Sets whether to use SSL. Setting this to true will also set the socketFactory to SSLSocketFactory.getDefault() and setting it to false will set the socketFactory to SocketFactory.getDefault()
    
    参数:
    
    sslEnabled - set to true if using SSL
    
    返回:
    
    this
    
    从以下版本开始:
    
    3.0
    
    另请参阅:
    
    MongoClientOptions.isSslEnabled()
  - sslInvalidHostNameAllowed
```
public MongoClientOptions.Builder sslInvalidHostNameAllowed(boolean sslInvalidHostNameAllowed)
```
    Define whether invalid host names should be allowed. Defaults to false. Take care before setting this to true, as it makes the application susceptible to man-in-the-middle attacks.
    
    参数:
    
    sslInvalidHostNameAllowed - whether invalid host names are allowed in SSL certificates.
    
    返回:
    
    this
  - readPreference
```
public MongoClientOptions.Builder readPreference(ReadPreference readPreference)
```
    Sets the read preference.
    
    参数:
    
    readPreference - read preference
    
    返回:
    
    this
    
    另请参阅:
    
    MongoClientOptions.getReadPreference()
  - writeConcern
```
public MongoClientOptions.Builder writeConcern(WriteConcern writeConcern)
```
    Sets the write concern.
    
    参数:
    
    writeConcern - the write concern
    
    返回:
    
    this
    
    另请参阅:
    
    MongoClientOptions.getWriteConcern()
  - readConcern
```
public MongoClientOptions.Builder readConcern(ReadConcern readConcern)
```
    Sets the read concern.
    
    参数:
    
    readConcern - the read concern.
    
    返回:
    
    this
    
    从以下版本开始:
    
    3.2
    
    另请参阅:
    
    MongoClientOptions.getReadConcern()
    
    MongoDB documentation
    
    Read Concern
    
    Since server release
    
    3.2
  - codecRegistry
```
public MongoClientOptions.Builder codecRegistry(CodecRegistry codecRegistry)
```
    Sets the codec registry
    Note that instances of DB and DBCollection do not use the registry, so it's not necessary to include a codec for DBObject in the registry.
    
    参数:
    
    codecRegistry - the codec registry
    
    返回:
    
    this
    
    从以下版本开始:
    
    3.0
    
    另请参阅:
    
    MongoClientOptions.getCodecRegistry()
  - addCommandListener
```
public MongoClientOptions.Builder addCommandListener(CommandListener commandListener)
```
    Adds the given command listener.
    
    参数:
    
    commandListener - the non-null command listener
    
    返回:
    
    this
    
    从以下版本开始:
    
    3.1
  - addClusterListener
```
public MongoClientOptions.Builder addClusterListener(ClusterListener clusterListener)
```
    Adds the given cluster listener.
    
    参数:
    
    clusterListener - the non-null cluster listener
    
    返回:
    
    this
    
    从以下版本开始:
    
    3.3
  - addServerListener
```
public MongoClientOptions.Builder addServerListener(ServerListener serverListener)
```
    Adds the given server listener.
    
    参数:
    
    serverListener - the non-null server listener
    
    返回:
    
    this
    
    从以下版本开始:
    
    3.3
  - addServerMonitorListener
```
public MongoClientOptions.Builder addServerMonitorListener(ServerMonitorListener serverMonitorListener)
```
    Adds the given server monitro listener.
    
    参数:
    
    serverMonitorListener - the non-null server monitor listener
    
    返回:
    
    this
    
    从以下版本开始:
    
    3.3
  - socketFactory
```
public MongoClientOptions.Builder socketFactory(javax.net.SocketFactory socketFactory)
```
    Sets the socket factory.
    
    参数:
    
    socketFactory - the socket factory
    
    返回:
    
    this
    
    另请参阅:
    
    MongoClientOptions.getSocketFactory()
  - cursorFinalizerEnabled
```
public MongoClientOptions.Builder cursorFinalizerEnabled(boolean cursorFinalizerEnabled)
```
    Sets whether cursor finalizers are enabled.
    
    参数:
    
    cursorFinalizerEnabled - whether cursor finalizers are enabled.
    
    返回:
    
    this
    
    另请参阅:
    
    MongoClientOptions.isCursorFinalizerEnabled()
  - alwaysUseMBeans
```
public MongoClientOptions.Builder alwaysUseMBeans(boolean alwaysUseMBeans)
```
    Sets whether JMX beans registered by the driver should always be MBeans, regardless of whether the VM is Java 6 or greater. If false, the driver will use MXBeans if the VM is Java 6 or greater, and use MBeans if the VM is Java 5.
    
    参数:
    
    alwaysUseMBeans - true if driver should always use MBeans, regardless of VM version
    
    返回:
    
    this
    
    另请参阅:
    
    MongoClientOptions.isAlwaysUseMBeans()
  - dbDecoderFactory
```
public MongoClientOptions.Builder dbDecoderFactory(DBDecoderFactory dbDecoderFactory)
```
    Sets the decoder factory.
    
    参数:
    
    dbDecoderFactory - the decoder factory
    
    返回:
    
    this
    
    另请参阅:
    
    MongoClientOptions.getDbDecoderFactory()
  - dbEncoderFactory
```
public MongoClientOptions.Builder dbEncoderFactory(DBEncoderFactory dbEncoderFactory)
```
    Sets the encoder factory.
    
    参数:
    
    dbEncoderFactory - the encoder factory
    
    返回:
    
    this
    
    另请参阅:
    
    MongoClientOptions.getDbEncoderFactory()
  - heartbeatFrequency
```
public MongoClientOptions.Builder heartbeatFrequency(int heartbeatFrequency)
```
    Sets the heartbeat frequency. This is the frequency that the driver will attempt to determine the current state of each server in the cluster. The default value is 10,000 milliseconds
    
    参数:
    
    heartbeatFrequency - the heartbeat frequency for the cluster, in milliseconds, which must be > 0
    
    返回:
    
    this
    
    从以下版本开始:
    
    2.12
    
    另请参阅:
    
    MongoClientOptions.getHeartbeatFrequency()
  - minHeartbeatFrequency
```
public MongoClientOptions.Builder minHeartbeatFrequency(int minHeartbeatFrequency)
```
    Sets the minimum heartbeat frequency. In the event that the driver has to frequently re-check a server's availability, it will wait at least this long since the previous check to avoid wasted effort. The default value is 500 milliseconds.
    
    参数:
    
    minHeartbeatFrequency - the minimum heartbeat frequency, in milliseconds, which must be > 0
    
    返回:
    
    this
    
    从以下版本开始:
    
    2.13
    
    另请参阅:
    
    MongoClientOptions.getMinHeartbeatFrequency()
  - heartbeatConnectTimeout
```
public MongoClientOptions.Builder heartbeatConnectTimeout(int connectTimeout)
```
    Sets the connect timeout for connections used for the cluster heartbeat.
    
    参数:
    
    connectTimeout - the connection timeout
    
    返回:
    
    this
    
    从以下版本开始:
    
    2.12
    
    另请参阅:
    
    MongoClientOptions.getHeartbeatConnectTimeout()
  - heartbeatSocketTimeout
```
public MongoClientOptions.Builder heartbeatSocketTimeout(int socketTimeout)
```
    Sets the socket timeout for connections used for the cluster heartbeat.
    
    参数:
    
    socketTimeout - the socket timeout
    
    返回:
    
    this
    
    从以下版本开始:
    
    2.12
    
    另请参阅:
    
    MongoClientOptions.getHeartbeatSocketTimeout()
  - localThreshold
```
public MongoClientOptions.Builder localThreshold(int localThreshold)
```
    Sets the local threshold.
    
    参数:
    
    localThreshold - the acceptable latency difference, in milliseconds
    
    返回:
    
    this
    
    抛出:
    
    java.lang.IllegalArgumentException - if acceptableLatencyDifference < 0
    
    从以下版本开始:
    
    2.13.0
    
    另请参阅:
    
    MongoClientOptions.getLocalThreshold()
  - requiredReplicaSetName
```
public MongoClientOptions.Builder requiredReplicaSetName(java.lang.String requiredReplicaSetName)
```
    Sets the required replica set name for the cluster.
    
    参数:
    
    requiredReplicaSetName - the required replica set name for the replica set.
    
    返回:
    
    this
    
    从以下版本开始:
    
    2.12
    
    另请参阅:
    
    MongoClientOptions.getRequiredReplicaSetName()
  - legacyDefaults
```
public MongoClientOptions.Builder legacyDefaults()
```
    Sets defaults to be what they are in MongoOptions.
    
    返回:
    
    this
    
    另请参阅:
    
    MongoOptions
  - build
```
public MongoClientOptions build()
```
    Build an instance of MongoClientOptions.
    
    返回:
    
    the options from this builder

类 MongoClientOptions.Builder

构造器概要

方法概要

从类继承的方法 java.lang.Object

构造器详细资料

Builder

Builder

方法详细资料

description

minConnectionsPerHost

connectionsPerHost

threadsAllowedToBlockForConnectionMultiplier

serverSelectionTimeout

maxWaitTime

maxConnectionIdleTime

maxConnectionLifeTime

connectTimeout

socketTimeout

socketKeepAlive

sslEnabled

sslInvalidHostNameAllowed

readPreference

writeConcern

readConcern

codecRegistry

addCommandListener

addClusterListener

addServerListener

addServerMonitorListener

socketFactory

cursorFinalizerEnabled

alwaysUseMBeans

dbDecoderFactory

dbEncoderFactory

heartbeatFrequency

minHeartbeatFrequency

heartbeatConnectTimeout

heartbeatSocketTimeout

localThreshold

requiredReplicaSetName

legacyDefaults

build