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

java.lang.Object
- com.mongodb.Mongo
- - com.mongodb.MongoClient

所有已实现的接口:

java.io.Closeable, java.lang.AutoCloseable
```
public class MongoClient
extends Mongo
implements java.io.Closeable
```
A MongoDB client with internal connection pooling. For most applications, you should have one MongoClient instance for the entire JVM.
The following are equivalent, and all connect to the local database running on the default port:
```
 MongoClient mongoClient1 = new MongoClient();
 MongoClient mongoClient1 = new MongoClient("localhost");
 MongoClient mongoClient2 = new MongoClient("localhost", 27017);
 MongoClient mongoClient4 = new MongoClient(new ServerAddress("localhost"));
 MongoClient mongoClient5 = new MongoClient(new ServerAddress("localhost"), new MongoClientOptions.Builder().build());
 
```
You can connect to a replica set using the Java driver by passing a ServerAddress list to the MongoClient constructor. For example:
```
 MongoClient mongoClient = new MongoClient(Arrays.asList(
   new ServerAddress("localhost", 27017),
   new ServerAddress("localhost", 27018),
   new ServerAddress("localhost", 27019)));
 
```
You can connect to a sharded cluster using the same constructor. MongoClient will auto-detect whether the servers are a list of replica set members or a list of mongos servers.

By default, all read and write operations will be made on the primary, but it's possible to read from secondaries by changing the read preference:
```
 mongoClient.setReadPreference(ReadPreference.secondaryPreferred());
 
```
By default, all write operations will wait for acknowledgment by the server, as the default write concern is WriteConcern.ACKNOWLEDGED.

Note: This class supersedes the Mongo class. While it extends Mongo, it differs from it in that the default write concern is to wait for acknowledgment from the server of all write operations. In addition, its constructors accept instances of MongoClientOptions and MongoClientURI, which both also set the same default write concern.

In general, users of this class will pick up all of the default options specified in MongoClientOptions. In particular, note that the default value of the connectionsPerHost option has been increased to 100 from the old default value of 10 used by the superseded Mongo class.
从以下版本开始:

2.10.0

另请参阅:

ReadPreference.primary(), WriteConcern.ACKNOWLEDGED, MongoClientOptions, MongoClientURI

嵌套类概要
- 从类继承的嵌套类/接口 com.mongodb.Mongo
  Mongo.Holder

构造器概要

构造器
构造器和说明
`MongoClient()` Creates an instance based on a (single) mongodb node (localhost, default port).
`MongoClient(java.util.List<ServerAddress> seeds)` Creates an instance based on a list of replica set members or mongos servers.
`MongoClient(java.util.List<ServerAddress> seeds, java.util.List<MongoCredential> credentialsList)` Creates an instance based on a list of replica set members or mongos servers.
`MongoClient(java.util.List<ServerAddress> seeds, java.util.List<MongoCredential> credentialsList, MongoClientOptions options)` Creates an instance based on a list of replica set members or mongos servers.
`MongoClient(java.util.List<ServerAddress> seeds, MongoClientOptions options)` Construct an instance based on a list of replica set members or mongos servers.
`MongoClient(MongoClientURI uri)` Creates a Mongo described by a URI.
`MongoClient(ServerAddress addr)` Creates a Mongo instance based on a (single) mongodb node
`MongoClient(ServerAddress addr, java.util.List<MongoCredential> credentialsList)` Creates a Mongo instance based on a (single) mongodb node and a list of credentials
`MongoClient(ServerAddress addr, java.util.List<MongoCredential> credentialsList, MongoClientOptions options)` Creates a Mongo instance based on a (single) mongo node using a given ServerAddress and default options.
`MongoClient(ServerAddress addr, MongoClientOptions options)` Creates a Mongo instance based on a (single) mongo node using a given ServerAddress and default options.
`MongoClient(java.lang.String host)` Creates a Mongo instance based on a (single) mongodb node.
`MongoClient(java.lang.String host, int port)` Creates a Mongo instance based on a (single) mongodb node.
`MongoClient(java.lang.String host, MongoClientOptions options)` Creates a Mongo instance based on a (single) mongodb node (default port).

方法概要

所有方法静态方法实例方法具体方法
限定符和类型	方法和说明
`java.util.List<MongoCredential>`	`getCredentialsList()` Gets the list of credentials that this client authenticates all connections with
`MongoDatabase`	`getDatabase(java.lang.String databaseName)`
`static CodecRegistry`	`getDefaultCodecRegistry()` Gets the default codec registry.
`MongoClientOptions`	`getMongoClientOptions()` Gets the options that this client uses to connect to server.
`MongoIterable<java.lang.String>`	`listDatabaseNames()` Get a list of the database names
`ListDatabasesIterable<Document>`	`listDatabases()` Gets the list of databases
`<T> ListDatabasesIterable<T>`	`listDatabases(java.lang.Class<T> clazz)` Gets the list of databases

从类继承的方法 com.mongodb.Mongo
addOption, close, dropDatabase, fsync, fsyncAndLock, getAddress, getAllAddress, getConnectPoint, getDatabaseNames, getDB, getMaxBsonObjectSize, getMongoOptions, getOptions, getReadConcern, getReadPreference, getReplicaSetStatus, getServerAddressList, getUsedDatabases, getWriteConcern, isLocked, resetOptions, setOptions, setReadPreference, setWriteConcern, slaveOk, toString, unlock

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

从接口继承的方法 java.io.Closeable
close

- 构造器详细资料
  - MongoClient
```
public MongoClient()
```
    Creates an instance based on a (single) mongodb node (localhost, default port).
  - MongoClient
```
public MongoClient(java.lang.String host)
```
    Creates a Mongo instance based on a (single) mongodb node.
    
    参数:
    
    host - server to connect to in format host[:port]
  - MongoClient
```
public MongoClient(java.lang.String host,
                   MongoClientOptions options)
```
    Creates a Mongo instance based on a (single) mongodb node (default port).
    
    参数:
    
    host - server to connect to in format host[:port]
    
    options - default query options
  - MongoClient
```
public MongoClient(java.lang.String host,
                   int port)
```
    Creates a Mongo instance based on a (single) mongodb node.
    
    参数:
    
    host - the database's host address
    
    port - the port on which the database is running
  - MongoClient
```
public MongoClient(ServerAddress addr)
```
    Creates a Mongo instance based on a (single) mongodb node
    
    参数:
    
    addr - the database address
    
    另请参阅:
    
    ServerAddress
  - MongoClient
```
public MongoClient(ServerAddress addr,
                   java.util.List<MongoCredential> credentialsList)
```
    Creates a Mongo instance based on a (single) mongodb node and a list of credentials
    
    参数:
    
    addr - the database address
    
    credentialsList - the list of credentials used to authenticate all connections
    
    从以下版本开始:
    
    2.11.0
    
    另请参阅:
    
    ServerAddress
  - MongoClient
```
public MongoClient(ServerAddress addr,
                   MongoClientOptions options)
```
    Creates a Mongo instance based on a (single) mongo node using a given ServerAddress and default options.
    
    参数:
    
    addr - the database address
    
    options - default options
    
    另请参阅:
    
    ServerAddress
  - MongoClient
```
public MongoClient(ServerAddress addr,
                   java.util.List<MongoCredential> credentialsList,
                   MongoClientOptions options)
```
    Creates a Mongo instance based on a (single) mongo node using a given ServerAddress and default options.
    
    参数:
    
    addr - the database address
    
    credentialsList - the list of credentials used to authenticate all connections
    
    options - default options
    
    从以下版本开始:
    
    2.11.0
    
    另请参阅:
    
    ServerAddress
  - MongoClient
```
public MongoClient(java.util.List<ServerAddress> seeds)
```
    Creates an instance based on a list of replica set members or mongos servers. For a replica set it will discover all members. For a list with a single seed, the driver will still discover all members of the replica set. For a direct connection to a replica set member, with no discovery, use the MongoClient(ServerAddress) constructor instead.
    
    When there is more than one server to choose from based on the type of request (read or write) and the read preference (if it's a read request), the driver will randomly select a server to send a request. This applies to both replica sets and sharded clusters. The servers to randomly select from are further limited by the local threshold. See MongoClientOptions.getLocalThreshold()
    
    参数:
    
    seeds - Put as many servers as you can in the list and the system will figure out the rest. This can either be a list of mongod servers in the same replica set or a list of mongos servers in the same sharded cluster.
    
    另请参阅:
    
    MongoClientOptions.getLocalThreshold()
  - MongoClient
```
public MongoClient(java.util.List<ServerAddress> seeds,
                   java.util.List<MongoCredential> credentialsList)
```
    Creates an instance based on a list of replica set members or mongos servers. For a replica set it will discover all members. For a list with a single seed, the driver will still discover all members of the replica set. For a direct connection to a replica set member, with no discovery, use the MongoClient(ServerAddress, List) constructor instead.
    
    When there is more than one server to choose from based on the type of request (read or write) and the read preference (if it's a read request), the driver will randomly select a server to send a request. This applies to both replica sets and sharded clusters. The servers to randomly select from are further limited by the local threshold. See MongoClientOptions.getLocalThreshold()
    
    参数:
    
    seeds - Put as many servers as you can in the list and the system will figure out the rest. This can either be a list of mongod servers in the same replica set or a list of mongos servers in the same sharded cluster.
    
    credentialsList - the list of credentials used to authenticate all connections
    
    从以下版本开始:
    
    2.11.0
    
    另请参阅:
    
    MongoClientOptions.getLocalThreshold()
  - MongoClient
```
public MongoClient(java.util.List<ServerAddress> seeds,
                   MongoClientOptions options)
```
    Construct an instance based on a list of replica set members or mongos servers. For a replica set it will discover all members. For a list with a single seed, the driver will still discover all members of the replica set. For a direct connection to a replica set member, with no discovery, use the MongoClient(ServerAddress, MongoClientOptions) constructor instead.
    
    When there is more than one server to choose from based on the type of request (read or write) and the read preference (if it's a read request), the driver will randomly select a server to send a request. This applies to both replica sets and sharded clusters. The servers to randomly select from are further limited by the local threshold. See MongoClientOptions.getLocalThreshold()
    
    参数:
    
    seeds - Put as many servers as you can in the list and the system will figure out the rest. This can either be a list of mongod servers in the same replica set or a list of mongos servers in the same sharded cluster.
    
    options - the options
    
    另请参阅:
    
    MongoClientOptions.getLocalThreshold()
  - MongoClient
```
public MongoClient(java.util.List<ServerAddress> seeds,
                   java.util.List<MongoCredential> credentialsList,
                   MongoClientOptions options)
```
    Creates an instance based on a list of replica set members or mongos servers. For a replica set it will discover all members. For a list with a single seed, the driver will still discover all members of the replica set. For a direct connection to a replica set member, with no discovery, use the MongoClient(ServerAddress, List, MongoClientOptions) constructor instead.
    
    When there is more than one server to choose from based on the type of request (read or write) and the read preference (if it's a read request), the driver will randomly select a server to send a request. This applies to both replica sets and sharded clusters. The servers to randomly select from are further limited by the local threshold. See MongoClientOptions.getLocalThreshold()
    
    参数:
    
    seeds - Put as many servers as you can in the list and the system will figure out the rest. This can either be a list of mongod servers in the same replica set or a list of mongos servers in the same sharded cluster.
    
    credentialsList - the list of credentials used to authenticate all connections
    
    options - the options
    
    从以下版本开始:
    
    2.11.0
    
    另请参阅:
    
    MongoClientOptions.getLocalThreshold()
  - MongoClient
```
public MongoClient(MongoClientURI uri)
```
    Creates a Mongo described by a URI. If only one address is used it will only connect to that node, otherwise it will discover all nodes.
    
    参数:
    
    uri - the URI
    
    抛出:
    
    MongoException - if theres a failure
- 方法详细资料
  - getDefaultCodecRegistry
```
public static CodecRegistry getDefaultCodecRegistry()
```
    Gets the default codec registry. It includes the following providers:
    返回:
    
    the default codec registry
    
    从以下版本开始:
    
    3.0
    
    另请参阅:
    
    MongoClientOptions.getCodecRegistry()
  - getMongoClientOptions
```
public MongoClientOptions getMongoClientOptions()
```
    Gets the options that this client uses to connect to server.
    Note: MongoClientOptions is immutable.
    
    返回:
    
    the options
  - getCredentialsList
```
public java.util.List<MongoCredential> getCredentialsList()
```
    Gets the list of credentials that this client authenticates all connections with
    
    返回:
    
    the list of credentials
    
    从以下版本开始:
    
    2.11.0
  - listDatabaseNames
```
public MongoIterable<java.lang.String> listDatabaseNames()
```
    Get a list of the database names
    
    返回:
    
    an iterable containing all the names of all the databases
    
    从以下版本开始:
    
    3.0
    
    MongoDB documentation
    
    List Databases
  - listDatabases
```
public ListDatabasesIterable<Document> listDatabases()
```
    Gets the list of databases
    
    返回:
    
    the list of databases
    
    从以下版本开始:
    
    3.0
  - listDatabases
```
public <T> ListDatabasesIterable<T> listDatabases(java.lang.Class<T> clazz)
```
    Gets the list of databases
    
    类型参数:
    
    T - the type of the class to use instead of Document.
    
    参数:
    
    clazz - the class to cast the database documents to
    
    返回:
    
    the list of databases
    
    从以下版本开始:
    
    3.0
  - getDatabase
```
public MongoDatabase getDatabase(java.lang.String databaseName)
```
    参数:
    
    databaseName - the name of the database to retrieve
    
    返回:
    
    a MongoDatabase representing the specified database

类 MongoClient

嵌套类概要

从类继承的嵌套类/接口 com.mongodb.Mongo

构造器概要

方法概要

从类继承的方法 com.mongodb.Mongo

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

从接口继承的方法 java.io.Closeable

构造器详细资料

MongoClient

MongoClient

MongoClient

MongoClient

MongoClient

MongoClient

MongoClient

MongoClient

MongoClient

MongoClient

MongoClient

MongoClient

MongoClient

方法详细资料

getDefaultCodecRegistry

getMongoClientOptions

getCredentialsList

listDatabaseNames

listDatabases

listDatabases

getDatabase