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

java.lang.Object
- com.mongodb.DB

```
@ThreadSafe
public class DB
extends java.lang.Object
```
A thread-safe client view of a logical database in a MongoDB cluster. A DB instance can be achieved from a MongoClient instance using code like:
```
 
 MongoClient mongoClient = new MongoClient();
 DB db = mongoClient.getDB("<db name>");
 
 
```
See Mongo.getDB(String) for further information about the effective deprecation of this class.
另请参阅:

MongoClient

MongoDB documentation

Database

构造器概要

构造器
构造器和说明

DB(Mongo mongo, java.lang.String name)
Constructs a new instance of the DB.

构造器
构造器和说明
`DB(Mongo mongo, java.lang.String name)` Constructs a new instance of the `DB`.

方法概要

所有方法实例方法具体方法已过时的方法
限定符和类型	方法和说明
`void`	`addOption(int option)` Adds the given flag to the default query options.
`WriteResult`	`addUser(java.lang.String userName, char[] password)` 已过时。 Use `DB.command` to call either the createUser or updateUser command
`WriteResult`	`addUser(java.lang.String userName, char[] password, boolean readOnly)` 已过时。 Use `DB.command` to call either the createUser or updateUser command
`boolean`	`collectionExists(java.lang.String collectionName)` Checks to see if a collection with a given name exists on a server.
`CommandResult`	`command(DBObject command)` Executes a database command.
`CommandResult`	`command(DBObject command, DBEncoder encoder)` Executes a database command.
`CommandResult`	`command(DBObject command, ReadPreference readPreference)` Executes the command against the database with the given read preference.
`CommandResult`	`command(DBObject command, ReadPreference readPreference, DBEncoder encoder)` Executes a database command with the selected readPreference, and encodes the command using the given encoder.
`CommandResult`	`command(java.lang.String command)` Executes a database command.
`CommandResult`	`command(java.lang.String command, ReadPreference readPreference)` Executes a database command.
`DBCollection`	`createCollection(java.lang.String collectionName, DBObject options)` Creates a collection with a given name and options.
`CommandResult`	`doEval(java.lang.String code, java.lang.Object... args)` Evaluates JavaScript functions on the database server.
`protected DBCollection`	`doGetCollection(java.lang.String name)` Gets a collection with a given name.
`void`	`dropDatabase()` Drops this database.
`java.lang.Object`	`eval(java.lang.String code, java.lang.Object... args)` Calls `doEval(java.lang.String, java.lang.Object[])`.
`DBCollection`	`getCollection(java.lang.String name)` Gets a collection with a given name.
`DBCollection`	`getCollectionFromString(java.lang.String collectionName)` Returns a collection matching a given string.
`java.util.Set<java.lang.String>`	`getCollectionNames()` Returns a set containing the names of all collections in this database.
`Mongo`	`getMongo()` Gets the Mongo instance
`java.lang.String`	`getName()` Returns the name of this database.
`int`	`getOptions()` Gets the query options
`ReadConcern`	`getReadConcern()` Get the read concern for this database.
`ReadPreference`	`getReadPreference()` Gets the read preference for this database.
`DB`	`getSisterDB(java.lang.String name)` Gets another database on same server
`CommandResult`	`getStats()` Helper method for calling a 'dbStats' command.
`WriteConcern`	`getWriteConcern()` Gets the write concern for this database.
`WriteResult`	`removeUser(java.lang.String userName)` 已过时。 Use `DB.command` to call the dropUser command
`void`	`resetOptions()` Resets the query options.
`void`	`setOptions(int options)` Sets the query options, overwriting previous value.
`void`	`setReadConcern(ReadConcern readConcern)` Sets the read concern for this database.
`void`	`setReadPreference(ReadPreference readPreference)` Sets the read preference for this database.
`void`	`setWriteConcern(WriteConcern writeConcern)` Sets the write concern for this database.
`void`	`slaveOk()` 已过时。 Replaced with `ReadPreference.secondaryPreferred()`
`java.lang.String`	`toString()`

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

- 构造器详细资料
  - DB
```
public DB(Mongo mongo,
          java.lang.String name)
```
    Constructs a new instance of the DB.
    
    参数:
    
    mongo - the mongo instance
    
    name - the database name - must not be empty and cannot contain spaces
- 方法详细资料
  - getMongo
```
public Mongo getMongo()
```
    Gets the Mongo instance
    
    返回:
    
    the mongo instance that this database was created from.
  - setReadPreference
```
public void setReadPreference(ReadPreference readPreference)
```
    Sets the read preference for this database. Will be used as default for read operations from any collection in this database. See the documentation for ReadPreference for more information.
    
    参数:
    
    readPreference - ReadPreference to use
    
    MongoDB documentation
    
    Read Preference
  - setWriteConcern
```
public void setWriteConcern(WriteConcern writeConcern)
```
    Sets the write concern for this database. It will be used for write operations to any collection in this database. See the documentation for WriteConcern for more information.
    
    参数:
    
    writeConcern - WriteConcern to use
    
    MongoDB documentation
    
    Write Concern
  - getReadPreference
```
public ReadPreference getReadPreference()
```
    Gets the read preference for this database.
    
    返回:
    
    ReadPreference to be used for read operations, if not specified explicitly
    
    MongoDB documentation
    
    Read Preference
  - getWriteConcern
```
public WriteConcern getWriteConcern()
```
    Gets the write concern for this database.
    
    返回:
    
    WriteConcern to be used for write operations, if not specified explicitly
    
    MongoDB documentation
    
    Write Concern
  - setReadConcern
```
public void setReadConcern(ReadConcern readConcern)
```
    Sets the read concern for this database.
    
    参数:
    
    readConcern - the read concern to use for this collection
    
    从以下版本开始:
    
    3.3
    
    MongoDB documentation
    
    Read Concern
    
    Since server release
    
    3.2
  - getReadConcern
```
public ReadConcern getReadConcern()
```
    Get the read concern for this database.
    
    返回:
    
    the ReadConcern
    
    从以下版本开始:
    
    3.3
    
    MongoDB documentation
    
    Read Concern
    
    Since server release
    
    3.2
  - doGetCollection
```
protected DBCollection doGetCollection(java.lang.String name)
```
    Gets a collection with a given name. If the collection does not exist, a new collection is created.
    
    This class is NOT part of the public API. Be prepared for non-binary compatible changes in minor releases.
    
    参数:
    
    name - the name of the collection
    
    返回:
    
    the collection
  - getCollection
```
public DBCollection getCollection(java.lang.String name)
```
    Gets a collection with a given name.
    
    参数:
    
    name - the name of the collection to return
    
    返回:
    
    the collection
  - dropDatabase
```
public void dropDatabase()
```
    Drops this database. Removes all data on disk. Use with caution.
    
    抛出:
    
    MongoException - if the operation failed
    
    MongoDB documentation
    
    Drop Database
  - getCollectionFromString
```
public DBCollection getCollectionFromString(java.lang.String collectionName)
```
    Returns a collection matching a given string.
    
    参数:
    
    collectionName - the name of the collection
    
    返回:
    
    the collection
  - getName
```
public java.lang.String getName()
```
    Returns the name of this database.
    
    返回:
    
    the name
  - getCollectionNames
```
public java.util.Set<java.lang.String> getCollectionNames()
```
    Returns a set containing the names of all collections in this database.
    
    返回:
    
    the names of collections in this database
    
    抛出:
    
    MongoException - if the operation failed
    
    MongoDB documentation
    
    getCollectionNames()
  - createCollection
```
public DBCollection createCollection(java.lang.String collectionName,
                                     DBObject options)
```
    Creates a collection with a given name and options. If the collection already exists, this throws a CommandFailureException.
    
    Possible options:
    - capped (boolean) - Enables a collection cap. False by default. If enabled, you must specify a size parameter.
    - size (int) - If capped is true, size specifies a maximum size in bytes for the capped collection. When capped is false, you may use size to preallocate space.
    - max (int) - Optional. Specifies a maximum "cap" in number of documents for capped collections. You must also specify size when specifying max.
    Note that if the options parameter is null, the creation will be deferred to when the collection is written to.
    参数:
    
    collectionName - the name of the collection to return
    
    options - options
    
    返回:
    
    the collection
    
    抛出:
    
    MongoException - if there's a failure
    
    MongoDB documentation
    
    createCollection()
  - command
```
public CommandResult command(java.lang.String command)
```
    Executes a database command. This method constructs a simple DBObject using command as the field name and true as its value, and calls command(DBObject, ReadPreference) with the default read preference for the database.
    
    参数:
    
    command - command to execute
    
    返回:
    
    result of command from the database
    
    抛出:
    
    MongoException - if the command failed
    
    MongoDB documentation
    
    Commands
  - command
```
public CommandResult command(DBObject command)
```
    Executes a database command. This method calls command(DBObject, ReadPreference) with the default read preference for the database.
    
    参数:
    
    command - DBObject representation of the command to be executed
    
    返回:
    
    result of the command execution
    
    抛出:
    
    MongoException - if the command failed
    
    MongoDB documentation
    
    Commands
  - command
```
public CommandResult command(DBObject command,
                             DBEncoder encoder)
```
    Executes a database command. This method calls command(DBObject, ReadPreference, DBEncoder) with the default read preference for the database.
    
    参数:
    
    command - DBObject representation of the command to be executed
    
    encoder - DBEncoder to be used for command encoding
    
    返回:
    
    result of the command execution
    
    抛出:
    
    MongoException - if the command failed
    
    MongoDB documentation
    
    Commands
  - command
```
public CommandResult command(DBObject command,
                             ReadPreference readPreference,
                             DBEncoder encoder)
```
    Executes a database command with the selected readPreference, and encodes the command using the given encoder.
    
    参数:
    
    command - The DBObject representation the command to be executed
    
    readPreference - Where to execute the command - this will only be applied for a subset of commands
    
    encoder - The DBEncoder that knows how to serialise the command
    
    返回:
    
    The result of executing the command, success or failure
    
    从以下版本开始:
    
    2.12
    
    MongoDB documentation
    
    Commands
  - command
```
public CommandResult command(DBObject command,
                             ReadPreference readPreference)
```
    Executes the command against the database with the given read preference.
    
    参数:
    
    command - The DBObject representation the command to be executed
    
    readPreference - Where to execute the command - this will only be applied for a subset of commands
    
    返回:
    
    The result of executing the command, success or failure
    
    从以下版本开始:
    
    2.12
    
    MongoDB documentation
    
    Commands
  - command
```
public CommandResult command(java.lang.String command,
                             ReadPreference readPreference)
```
    Executes a database command. This method constructs a simple DBObject and calls command(DBObject, ReadPreference).
    
    参数:
    
    command - The name of the command to be executed
    
    readPreference - Where to execute the command - this will only be applied for a subset of commands
    
    返回:
    
    The result of the command execution
    
    抛出:
    
    MongoException - if the command failed
    
    从以下版本开始:
    
    2.12
    
    MongoDB documentation
    
    Commands
  - getSisterDB
```
public DB getSisterDB(java.lang.String name)
```
    Gets another database on same server
    
    参数:
    
    name - name of the database
    
    返回:
    
    the DB for the given name
  - collectionExists
```
public boolean collectionExists(java.lang.String collectionName)
```
    Checks to see if a collection with a given name exists on a server.
    
    参数:
    
    collectionName - a name of the collection to test for existence
    
    返回:
    
    false if no collection by that name exists, true if a match to an existing collection was found
    
    抛出:
    
    MongoException - if the operation failed
  - doEval
```
public CommandResult doEval(java.lang.String code,
                            java.lang.Object... args)
```
    Evaluates JavaScript functions on the database server. This is useful if you need to touch a lot of data lightly, in which case network transfer could be a bottleneck.
    
    参数:
    
    code - String representation of JavaScript function
    
    args - arguments to pass to the JavaScript function
    
    返回:
    
    result of the command execution
    
    抛出:
    
    MongoException - if the operation failed
    
    MongoDB documentation
    
    db.eval()
  - eval
```
public java.lang.Object eval(java.lang.String code,
                             java.lang.Object... args)
```
    Calls doEval(java.lang.String, java.lang.Object[]). If the command is successful, the "retval" field is extracted and returned. Otherwise an exception is thrown.
    
    参数:
    
    code - String representation of JavaScript function
    
    args - arguments to pass to the JavaScript function
    
    返回:
    
    result of the execution
    
    抛出:
    
    MongoException - if the operation failed
    
    MongoDB documentation
    
    db.eval()
  - getStats
```
public CommandResult getStats()
```
    Helper method for calling a 'dbStats' command. It returns storage statistics for a given database.
    
    返回:
    
    result of the execution
    
    抛出:
    
    MongoException - if the operation failed
    
    MongoDB documentation
    
    Database Stats
  - addUser
```
@Deprecated
public WriteResult addUser(java.lang.String userName,
                                       char[] password)
```
    已过时。 Use DB.command to call either the createUser or updateUser command
    
    Adds or updates a user for this database
    
    参数:
    
    userName - the user name
    
    password - the password
    
    返回:
    
    the result of executing this operation
    
    抛出:
    
    MongoException - if the operation failed
    
    MongoDB documentation
    
    Access Control
    
    createUser
    
    updateUser
  - addUser
```
@Deprecated
public WriteResult addUser(java.lang.String userName,
                                       char[] password,
                                       boolean readOnly)
```
    已过时。 Use DB.command to call either the createUser or updateUser command
    
    Adds or updates a user for this database
    
    参数:
    
    userName - the user name
    
    password - the password
    
    readOnly - if true, user will only be able to read
    
    返回:
    
    the result of executing this operation
    
    抛出:
    
    MongoException - if the operation failed
    
    MongoDB documentation
    
    Access Control
    
    createUser
    
    updateUser
  - removeUser
```
@Deprecated
public WriteResult removeUser(java.lang.String userName)
```
    已过时。 Use DB.command to call the dropUser command
    
    Removes the specified user from the database.
    
    参数:
    
    userName - user to be removed
    
    返回:
    
    the result of executing this operation
    
    抛出:
    
    MongoException - if the operation failed
    
    MongoDB documentation
    
    Access Control
  - slaveOk
```
@Deprecated
public void slaveOk()
```
    已过时。 Replaced with ReadPreference.secondaryPreferred()
    
    Makes it possible to execute "read" queries on a slave node
    
    另请参阅:
    
    ReadPreference.secondaryPreferred()
  - addOption
```
public void addOption(int option)
```
    Adds the given flag to the default query options.
    
    参数:
    
    option - value to be added
    
    MongoDB documentation
    
    Query Flags
  - setOptions
```
public void setOptions(int options)
```
    Sets the query options, overwriting previous value.
    
    参数:
    
    options - bit vector of query options
    
    MongoDB documentation
    
    Query Flags
  - resetOptions
```
public void resetOptions()
```
    Resets the query options.
    
    MongoDB documentation
    
    Query Flags
  - getOptions
```
public int getOptions()
```
    Gets the query options
    
    返回:
    
    bit vector of query options
    
    MongoDB documentation
    
    Query Flags
  - toString
```
public java.lang.String toString()
```
    覆盖:
    
    toString 在类中 java.lang.Object

类 DB

构造器概要

方法概要

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

构造器详细资料

DB

方法详细资料

getMongo

setReadPreference

setWriteConcern

getReadPreference

getWriteConcern

setReadConcern

getReadConcern

doGetCollection

getCollection

dropDatabase

getCollectionFromString

getName

getCollectionNames

createCollection

command

command

command

command

command

command

getSisterDB

collectionExists

doEval

eval

getStats

addUser

addUser

removeUser

slaveOk

addOption

setOptions

resetOptions

getOptions

toString