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

java.lang.Object
- com.mongodb.MongoClientOptions

```
@Immutable
public class MongoClientOptions
extends java.lang.Object
```
Various settings to control the behavior of a MongoClient.

Note: This class is a replacement for MongoOptions, to be used with MongoClient. The main difference in behavior is that the default write concern is WriteConcern.ACKNOWLEDGED.

从以下版本开始:

2.10.0

另请参阅:

MongoClient

嵌套类概要

嵌套类
限定符和类型	类和说明
`static class`	`MongoClientOptions.Builder` A builder for MongoClientOptions so that MongoClientOptions can be immutable, and to support easier construction through chaining.

方法概要

所有方法静态方法实例方法具体方法
限定符和类型	方法和说明
`static MongoClientOptions.Builder`	`builder()` Creates a builder instance.
`static MongoClientOptions.Builder`	`builder(MongoClientOptions options)` Creates a builder instance.
`boolean`	`equals(java.lang.Object o)`
`java.util.List<ClusterListener>`	`getClusterListeners()` Gets the list of added `ClusterListener`.
`CodecRegistry`	`getCodecRegistry()` The codec registry to use.
`java.util.List<CommandListener>`	`getCommandListeners()` Gets the list of added `CommandListener`.
`int`	`getConnectionsPerHost()` The maximum number of connections allowed per host for this MongoClient instance.
`int`	`getConnectTimeout()` The connection timeout in milliseconds.
`DBDecoderFactory`	`getDbDecoderFactory()` Override the decoder factory.
`DBEncoderFactory`	`getDbEncoderFactory()` Override the encoder factory.
`java.lang.String`	`getDescription()` Gets the description for this MongoClient, which is used in various places like logging and JMX.
`int`	`getHeartbeatConnectTimeout()` Gets the connect timeout for connections used for the cluster heartbeat.
`int`	`getHeartbeatFrequency()` Gets the heartbeat frequency.
`int`	`getHeartbeatSocketTimeout()` Gets the socket timeout for connections used for the cluster heartbeat.
`int`	`getLocalThreshold()` Gets the local threshold.
`int`	`getMaxConnectionIdleTime()` The maximum idle time of a pooled connection.
`int`	`getMaxConnectionLifeTime()` The maximum life time of a pooled connection.
`int`	`getMaxWaitTime()` The maximum wait time in milliseconds that a thread may wait for a connection to become available.
`int`	`getMinConnectionsPerHost()` The minimum number of connections per host for this MongoClient instance.
`int`	`getMinHeartbeatFrequency()` Gets the minimum heartbeat frequency.
`ReadConcern`	`getReadConcern()` The read concern to use.
`ReadPreference`	`getReadPreference()` The read preference to use for queries, map-reduce, aggregation, and count.
`java.lang.String`	`getRequiredReplicaSetName()` Gets the required replica set name.
`java.util.List<ServerListener>`	`getServerListeners()` Gets the list of added `ServerListener`.
`java.util.List<ServerMonitorListener>`	`getServerMonitorListeners()` Gets the list of added `ServerMonitorListener`.
`int`	`getServerSelectionTimeout()` Gets the server selection timeout in milliseconds, which defines how long the driver will wait for server selection to succeed before throwing an exception.
`javax.net.SocketFactory`	`getSocketFactory()` The socket factory for creating sockets to the mongo server.
`int`	`getSocketTimeout()` The socket timeout in milliseconds.
`int`	`getThreadsAllowedToBlockForConnectionMultiplier()` This multiplier, multiplied with the connectionsPerHost setting, gives the maximum number of threads that may be waiting for a connection to become available from the pool.
`WriteConcern`	`getWriteConcern()` The write concern to use.
`int`	`hashCode()`
`boolean`	`isAlwaysUseMBeans()` Gets whether JMX beans registered by the driver should always be MBeans, regardless of whether the VM is Java 6 or greater.
`boolean`	`isCursorFinalizerEnabled()` Gets whether there is a a finalize method created that cleans up instances of DBCursor that the client does not close.
`boolean`	`isSocketKeepAlive()` This flag controls the socket keep alive feature that keeps a connection alive through firewalls `Socket.setKeepAlive(boolean)` Default is false.
`boolean`	`isSslEnabled()` Whether to use SSL.
`boolean`	`isSslInvalidHostNameAllowed()` Returns whether invalid host names should be allowed if SSL is enabled.
`java.lang.String`	`toString()`

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

- 方法详细资料
  - builder
```
public static MongoClientOptions.Builder builder()
```
    Creates a builder instance.
    
    返回:
    
    a builder
    
    从以下版本开始:
    
    3.0.0
  - builder
```
public static MongoClientOptions.Builder builder(MongoClientOptions options)
```
    Creates a builder instance.
    
    参数:
    
    options - existing MongoClientOptions to default the builder settings on.
    
    返回:
    
    a builder
    
    从以下版本开始:
    
    3.0.0
  - getDescription
```
public java.lang.String getDescription()
```
    Gets the description for this MongoClient, which is used in various places like logging and JMX.
    
    Default is null.
    
    返回:
    
    the description
  - getConnectionsPerHost
```
public int getConnectionsPerHost()
```
    The maximum number of connections allowed per host for this MongoClient instance. Those connections will be kept in a pool when idle. Once the pool is exhausted, any operation requiring a connection will block waiting for an available connection.
    
    Default is 100.
    
    返回:
    
    the maximum size of the connection pool per host
    
    另请参阅:
    
    getThreadsAllowedToBlockForConnectionMultiplier()
  - getMinConnectionsPerHost
```
public int getMinConnectionsPerHost()
```
    The minimum number of connections per host for this MongoClient instance. Those connections will be kept in a pool when idle, and the pool will ensure over time that it contains at least this minimum number.
    
    Default is 0.
    
    返回:
    
    the minimum size of the connection pool per host
  - getThreadsAllowedToBlockForConnectionMultiplier
```
public int getThreadsAllowedToBlockForConnectionMultiplier()
```
    This multiplier, multiplied with the connectionsPerHost setting, gives the maximum number of threads that may be waiting for a connection to become available from the pool. All further threads will get an exception right away. For example if connectionsPerHost is 10 and threadsAllowedToBlockForConnectionMultiplier is 5, then up to 50 threads can wait for a connection.
    
    Default is 5.
    
    返回:
    
    the multiplier
  - getServerSelectionTimeout
```
public int getServerSelectionTimeout()
```
    Gets the server selection timeout in milliseconds, which defines how long the driver will wait for server selection to succeed before throwing an exception.
    
    Default is 30,000. A value of 0 means that it will timeout immediately if no server is available. A negative value means to wait indefinitely.
    
    返回:
    
    the server selection timeout in milliseconds.
  - getMaxWaitTime
```
public int getMaxWaitTime()
```
    The maximum wait time in milliseconds that a thread may wait for a connection to become available.
    
    Default is 120,000. A value of 0 means that it will not wait. A negative value means to wait indefinitely.
    
    返回:
    
    the maximum wait time.
  - getMaxConnectionIdleTime
```
public int getMaxConnectionIdleTime()
```
    The maximum idle time of a pooled connection. A zero value indicates no limit to the idle time. A pooled connection that has exceeded its idle time will be closed and replaced when necessary by a new connection.
    
    返回:
    
    the maximum idle time, in milliseconds
    
    从以下版本开始:
    
    2.12
  - getMaxConnectionLifeTime
```
public int getMaxConnectionLifeTime()
```
    The maximum life time of a pooled connection. A zero value indicates no limit to the life time. A pooled connection that has exceeded its life time will be closed and replaced when necessary by a new connection.
    
    返回:
    
    the maximum life time, in milliseconds
    
    从以下版本开始:
    
    2.12
  - getConnectTimeout
```
public int getConnectTimeout()
```
    The connection timeout in milliseconds. A value of 0 means no timeout. It is used solely when establishing a new connection Socket.connect(java.net.SocketAddress, int)
    
    Default is 10,000.
    
    返回:
    
    the socket connect timeout
  - getSocketTimeout
```
public int getSocketTimeout()
```
    The socket timeout in milliseconds. It is used for I/O socket read and write operations Socket.setSoTimeout(int)
    
    Default is 0 and means no timeout.
    
    返回:
    
    the socket timeout
  - isSocketKeepAlive
```
public boolean isSocketKeepAlive()
```
    This flag controls the socket keep alive feature that keeps a connection alive through firewalls Socket.setKeepAlive(boolean)
    
    Default is false.
    
    返回:
    
    whether keep-alive is enabled on each socket
  - getHeartbeatFrequency
```
public int getHeartbeatFrequency()
```
    Gets 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.
    
    返回:
    
    the heartbeat frequency, in milliseconds
    
    从以下版本开始:
    
    2.12
  - getMinHeartbeatFrequency
```
public int getMinHeartbeatFrequency()
```
    Gets 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.
    
    返回:
    
    the minimum heartbeat frequency, in milliseconds
    
    从以下版本开始:
    
    2.13
  - getHeartbeatConnectTimeout
```
public int getHeartbeatConnectTimeout()
```
    Gets the connect timeout for connections used for the cluster heartbeat.
    
    The default value is 20,000 milliseconds.
    
    返回:
    
    the heartbeat connect timeout, in milliseconds
    
    从以下版本开始:
    
    2.12
  - getHeartbeatSocketTimeout
```
public int getHeartbeatSocketTimeout()
```
    Gets the socket timeout for connections used for the cluster heartbeat. The default value is 20,000 milliseconds.
    
    返回:
    
    the heartbeat socket timeout, in milliseconds
    
    从以下版本开始:
    
    2.12
  - getLocalThreshold
```
public int getLocalThreshold()
```
    Gets the local threshold. When choosing among multiple MongoDB servers to send a request, the MongoClient will only send that request to a server whose ping time is less than or equal to the server with the fastest ping time plus the local threshold.
    
    For example, let's say that the client is choosing a server to send a query when the read preference is ReadPreference.secondary(), and that there are three secondaries, server1, server2, and server3, whose ping times are 10, 15, and 16 milliseconds, respectively. With a local threshold of 5 milliseconds, the client will send the query to either server1 or server2 (randomly selecting between the two).
    
    The default value is 15 milliseconds.
    
    返回:
    
    the local threshold, in milliseconds
    
    从以下版本开始:
    
    2.13.0
    
    MongoDB documentation
    
    Local Threshold
  - getRequiredReplicaSetName
```
public java.lang.String getRequiredReplicaSetName()
```
    Gets the required replica set name. With this option set, the MongoClient instance will
    1. Connect in replica set mode, and discover all members of the set based on the given servers
    2. Make sure that the set name reported by all members matches the required set name.
    3. Refuse to service any requests if any member of the seed list is not part of a replica set with the required name.
    返回:
    
    the required replica set name
    
    从以下版本开始:
    
    2.12
  - isSslEnabled
```
public boolean isSslEnabled()
```
    Whether to use SSL. The default is false.
    
    返回:
    
    true if SSL should be used
    
    从以下版本开始:
    
    3.0
  - isSslInvalidHostNameAllowed
```
public boolean isSslInvalidHostNameAllowed()
```
    Returns whether invalid host names should be allowed if SSL is enabled. Defaults to false. Take care before setting this to true, as it makes the application susceptible to man-in-the-middle attacks. Note that host name verification currently requires Java 7, so if your application is using SSL and must run on Java 6, this property must be set to true.
    
    返回:
    
    true if invalid host names are allowed.
  - getReadPreference
```
public ReadPreference getReadPreference()
```
    The read preference to use for queries, map-reduce, aggregation, and count.
    
    Default is ReadPreference.primary().
    
    返回:
    
    the read preference
    
    另请参阅:
    
    ReadPreference.primary()
  - getWriteConcern
```
public WriteConcern getWriteConcern()
```
    The write concern to use.
    
    Default is WriteConcern.ACKNOWLEDGED.
    
    返回:
    
    the write concern
    
    另请参阅:
    
    WriteConcern.ACKNOWLEDGED
  - getReadConcern
```
public ReadConcern getReadConcern()
```
    The read concern to use.
    
    返回:
    
    the read concern
    
    从以下版本开始:
    
    3.2
    
    MongoDB documentation
    
    Read Concern
    
    Since server release
    
    3.2
  - getCodecRegistry
```
public CodecRegistry getCodecRegistry()
```
    The codec registry to use. By default, a MongoClient will be able to encode and decode instances of Document.
    
    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.
    
    返回:
    
    the codec registry
    
    从以下版本开始:
    
    3.0
    
    另请参阅:
    
    MongoClient.getDatabase(java.lang.String)
  - getCommandListeners
```
public java.util.List<CommandListener> getCommandListeners()
```
    Gets the list of added CommandListener. The default is an empty list.
    
    返回:
    
    the unmodifiable list of command listeners
    
    从以下版本开始:
    
    3.1
  - getClusterListeners
```
public java.util.List<ClusterListener> getClusterListeners()
```
    Gets the list of added ClusterListener. The default is an empty list.
    
    返回:
    
    the unmodifiable list of cluster listeners
    
    从以下版本开始:
    
    3.3
  - getServerListeners
```
public java.util.List<ServerListener> getServerListeners()
```
    Gets the list of added ServerListener. The default is an empty list.
    
    返回:
    
    the unmodifiable list of server listeners
    
    从以下版本开始:
    
    3.3
  - getServerMonitorListeners
```
public java.util.List<ServerMonitorListener> getServerMonitorListeners()
```
    Gets the list of added ServerMonitorListener. The default is an empty list.
    
    返回:
    
    the unmodifiable list of server monitor listeners
    
    从以下版本开始:
    
    3.3
  - getDbDecoderFactory
```
public DBDecoderFactory getDbDecoderFactory()
```
    Override the decoder factory. Default is for the standard Mongo Java driver configuration.
    
    返回:
    
    the decoder factory
  - getDbEncoderFactory
```
public DBEncoderFactory getDbEncoderFactory()
```
    Override the encoder factory. Default is for the standard Mongo Java driver configuration.
    
    返回:
    
    the encoder factory
  - isAlwaysUseMBeans
```
public boolean isAlwaysUseMBeans()
```
    Gets 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.
    
    Default is false.
    
    返回:
    
    true if JMX beans should always be MBeans
  - getSocketFactory
```
public javax.net.SocketFactory getSocketFactory()
```
    The socket factory for creating sockets to the mongo server.
    
    Default is SocketFactory.getDefault()
    
    返回:
    
    the socket factory
  - isCursorFinalizerEnabled
```
public boolean isCursorFinalizerEnabled()
```
    Gets whether there is a a finalize method created that cleans up instances of DBCursor that the client does not close. If you are careful to always call the close method of DBCursor, then this can safely be set to false.
    
    Default is true.
    
    返回:
    
    whether finalizers are enabled on cursors
    
    另请参阅:
    
    DBCursor, DBCursor.close()
  - equals
```
public boolean equals(java.lang.Object o)
```
    覆盖:
    
    equals 在类中 java.lang.Object
  - hashCode
```
public int hashCode()
```
    覆盖:
    
    hashCode 在类中 java.lang.Object
  - toString
```
public java.lang.String toString()
```
    覆盖:
    
    toString 在类中 java.lang.Object

类 MongoClientOptions

嵌套类概要

方法概要

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

方法详细资料

builder

builder

getDescription

getConnectionsPerHost

getMinConnectionsPerHost

getThreadsAllowedToBlockForConnectionMultiplier

getServerSelectionTimeout

getMaxWaitTime

getMaxConnectionIdleTime

getMaxConnectionLifeTime

getConnectTimeout

getSocketTimeout

isSocketKeepAlive

getHeartbeatFrequency

getMinHeartbeatFrequency

getHeartbeatConnectTimeout

getHeartbeatSocketTimeout

getLocalThreshold

getRequiredReplicaSetName

isSslEnabled

isSslInvalidHostNameAllowed

getReadPreference

getWriteConcern

getReadConcern

getCodecRegistry

getCommandListeners

getClusterListeners

getServerListeners

getServerMonitorListeners

getDbDecoderFactory

getDbEncoderFactory

isAlwaysUseMBeans

getSocketFactory

isCursorFinalizerEnabled

equals

hashCode

toString