Class/Object

reactivemongo.api

DefaultDB

Related Docs: object DefaultDB | package api

Permalink

class DefaultDB extends DB with DBMetaCommands with GenericDB[Pack] with Product with Serializable

The default DB implementation, that mixes in the database traits.

Annotations
@SerialVersionUID()
Linear Supertypes
Serializable, Serializable, Product, Equals, GenericDB[Pack], DBMetaCommands, DB, AnyRef, Any
Ordering
  1. Alphabetic
  2. By Inheritance
Inherited
  1. DefaultDB
  2. Serializable
  3. Serializable
  4. Product
  5. Equals
  6. GenericDB
  7. DBMetaCommands
  8. DB
  9. AnyRef
  10. Any
Implicitly
  1. by any2stringadd
  2. by StringFormat
  3. by Ensuring
  4. by ArrowAssoc
  1. Hide All
  2. Show All
Visibility
  1. Public
  2. All

Type Members

  1. type DBMetaWriter[T] = BSONDocumentWriter[T]

    Permalink

    Type of writer to serialization database metadata

    Type of writer to serialization database metadata

    Definition Classes
    DBMetaCommands
  2. type DBType = DefaultDB

    Permalink
    Definition Classes
    DefaultDBDB

Value Members

  1. final def !=(arg0: Any): Boolean

    Permalink
    Definition Classes
    AnyRef → Any
  2. final def ##(): Int

    Permalink
    Definition Classes
    AnyRef → Any
  3. def +(other: String): String

    Permalink
    Implicit information
    This member is added by an implicit conversion from DefaultDB to any2stringadd[DefaultDB] performed by method any2stringadd in scala.Predef.
    Definition Classes
    any2stringadd
  4. def ->[B](y: B): (DefaultDB, B)

    Permalink
    Implicit information
    This member is added by an implicit conversion from DefaultDB to ArrowAssoc[DefaultDB] performed by method ArrowAssoc in scala.Predef.
    Definition Classes
    ArrowAssoc
    Annotations
    @inline()
  5. final def ==(arg0: Any): Boolean

    Permalink
    Definition Classes
    AnyRef → Any
  6. def abortTransaction(failIfNotStarted: Boolean)(implicit ec: ExecutionContext): Future[DBType]

    Permalink

    Aborts the transaction associated with the current client session (since MongoDB 4.0), if any otherwise does nothing .

    Aborts the transaction associated with the current client session (since MongoDB 4.0), if any otherwise does nothing .

    EXPERIMENTAL: API may change without notice.

    returns

    The database reference with transaction aborted (but not session)

    Definition Classes
    DefaultDBDB
  7. final def abortTransaction()(implicit ec: ExecutionContext): Future[DBType]

    Permalink

    Aborts the transaction associated with the current client session (since MongoDB 4.0), if any otherwise does nothing .

    Aborts the transaction associated with the current client session (since MongoDB 4.0), if any otherwise does nothing .

    EXPERIMENTAL: API may change without notice.

    // Equivalent to
    db.abortTransaction(failIfNotStarted = false)
    returns

    The database reference with transaction aborted (but not session)

    Definition Classes
    DB
    Annotations
    @inline()
  8. def apply[C <: Collection](name: String, failoverStrategy: FailoverStrategy = failoverStrategy)(implicit producer: CollectionProducer[C] = ...): C

    Permalink

    Returns a reactivemongo.api.Collection from this database (alias for the collection method).

    Returns a reactivemongo.api.Collection from this database (alias for the collection method).

    name

    the name of the collection to resolve

    failoverStrategy

    the failover strategy to override the default one

    Definition Classes
    DB
  9. final def asInstanceOf[T0]: T0

    Permalink
    Definition Classes
    Any
  10. def authenticate(user: String, password: String)(implicit ec: ExecutionContext): Future[SuccessfulAuthentication]

    Permalink

    Authenticates the connection on this database.

    Authenticates the connection on this database.

    user

    the name of the user

    password

    the user password

    Definition Classes
    DB
  11. def canEqual(that: Any): Boolean

    Permalink
    Definition Classes
    DefaultDB → Equals
  12. def clone(): AnyRef

    Permalink
    Attributes
    protected[java.lang]
    Definition Classes
    AnyRef
    Annotations
    @throws( ... )
  13. def collection[C <: Collection](name: String, failoverStrategy: FailoverStrategy = failoverStrategy)(implicit producer: CollectionProducer[C] = ...): C

    Permalink

    Returns a reactivemongo.api.Collection from this database.

    Returns a reactivemongo.api.Collection from this database.

    name

    the name of the collection to resolve

    failoverStrategy

    the failover strategy to override the default one

    Definition Classes
    DB
  14. def collectionNames(implicit ec: ExecutionContext): Future[List[String]]

    Permalink

    Returns the names of the collections in this database.

    Returns the names of the collections in this database.

    Definition Classes
    DBMetaCommands
  15. def commitTransaction(failIfNotStarted: Boolean)(implicit ec: ExecutionContext): Future[DBType]

    Permalink

    Commits the transaction associated with the current client session (since MongoDB 4.0), if any otherwise does nothing .

    Commits the transaction associated with the current client session (since MongoDB 4.0), if any otherwise does nothing .

    EXPERIMENTAL: API may change without notice.

    returns

    The database reference with transaction commited (but not session)

    Definition Classes
    DefaultDBDB
  16. final def commitTransaction()(implicit ec: ExecutionContext): Future[DBType]

    Permalink

    Commits the transaction associated with the current client session (since MongoDB 4.0), if any otherwise does nothing .

    Commits the transaction associated with the current client session (since MongoDB 4.0), if any otherwise does nothing .

    EXPERIMENTAL: API may change without notice.

    // Equivalent to
    db.commitTransaction(failIfNotStarted = false)
    returns

    The database reference with transaction commited (but not session)

    Definition Classes
    DB
    Annotations
    @inline()
  17. val connection: MongoConnection

    Permalink

    The reactivemongo.api.MongoConnection that will be used to query this database.

    The reactivemongo.api.MongoConnection that will be used to query this database.

    Definition Classes
    DefaultDBDB
  18. val connectionState: ConnectionState

    Permalink

    The state of the associated connection

    The state of the associated connection

    Definition Classes
    DefaultDBDB
  19. def createUser[T](user: String, pwd: Option[String], customData: Option[T], roles: List[UserRole], digestPassword: Boolean, writeConcern: commands.WriteConcern, restrictions: List[AuthenticationRestriction], mechanisms: List[AuthenticationMode])(implicit ec: ExecutionContext, w: DBMetaWriter[T]): Future[Unit]

    Permalink

    Create the specified user.

    Create the specified user.

    user

    the name of the user to be created

    pwd

    the user password (not required if the database uses external credentials)

    customData

    the custom data to associate with the user account

    roles

    the roles granted to the user, possibly an empty to create users without roles

    digestPassword

    when true, the mongod instance will create the hash of the user password (default: true)

    writeConcern

    the optional level of write concern

    restrictions

    the authentication restriction

    mechanisms

    the authentication mechanisms (e.g. SCRAM-SHA-1)

    Definition Classes
    DBMetaCommands
    See also

    https://docs.mongodb.com/manual/reference/command/createUser/

  20. def defaultReadPreference: ReadPreference

    Permalink
    Definition Classes
    DB
    Annotations
    @inline()
  21. def drop()(implicit ec: ExecutionContext): Future[Unit]

    Permalink

    Drops this database.

    Drops this database.

    Definition Classes
    DBMetaCommands
  22. def endSession(failIfNotStarted: Boolean)(implicit ec: ExecutionContext): Future[DefaultDB]

    Permalink

    Ends (closes) the session associated with this database reference (since MongoDB 3.6), if any otherwise does nothing .

    Ends (closes) the session associated with this database reference (since MongoDB 3.6), if any otherwise does nothing .

    EXPERIMENTAL: API may change without notice.

    returns

    The database reference with session ended

    Definition Classes
    DefaultDBDB
  23. final def endSession()(implicit ec: ExecutionContext): Future[DBType]

    Permalink

    Ends (closes) the session associated with this database reference (since MongoDB 3.6), if any otherwise does nothing .

    Ends (closes) the session associated with this database reference (since MongoDB 3.6), if any otherwise does nothing .

    EXPERIMENTAL: API may change without notice.

    // Equivalent to
    db.endSession(failIfNotStarted = false)
    returns

    The database reference with session ended

    Definition Classes
    DB
    Annotations
    @inline()
  24. def ensuring(cond: (DefaultDB) ⇒ Boolean, msg: ⇒ Any): DefaultDB

    Permalink
    Implicit information
    This member is added by an implicit conversion from DefaultDB to Ensuring[DefaultDB] performed by method Ensuring in scala.Predef.
    Definition Classes
    Ensuring
  25. def ensuring(cond: (DefaultDB) ⇒ Boolean): DefaultDB

    Permalink
    Implicit information
    This member is added by an implicit conversion from DefaultDB to Ensuring[DefaultDB] performed by method Ensuring in scala.Predef.
    Definition Classes
    Ensuring
  26. def ensuring(cond: Boolean, msg: ⇒ Any): DefaultDB

    Permalink
    Implicit information
    This member is added by an implicit conversion from DefaultDB to Ensuring[DefaultDB] performed by method Ensuring in scala.Predef.
    Definition Classes
    Ensuring
  27. def ensuring(cond: Boolean): DefaultDB

    Permalink
    Implicit information
    This member is added by an implicit conversion from DefaultDB to Ensuring[DefaultDB] performed by method Ensuring in scala.Predef.
    Definition Classes
    Ensuring
  28. final def eq(arg0: AnyRef): Boolean

    Permalink
    Definition Classes
    AnyRef
  29. def equals(arg0: Any): Boolean

    Permalink
    Definition Classes
    AnyRef → Any
  30. val failoverStrategy: FailoverStrategy

    Permalink

    A failover strategy for sending requests.

    A failover strategy for sending requests.

    Definition Classes
    DefaultDBDB
  31. def finalize(): Unit

    Permalink
    Attributes
    protected[java.lang]
    Definition Classes
    AnyRef
    Annotations
    @throws( classOf[java.lang.Throwable] )
  32. def formatted(fmtstr: String): String

    Permalink
    Implicit information
    This member is added by an implicit conversion from DefaultDB to StringFormat[DefaultDB] performed by method StringFormat in scala.Predef.
    Definition Classes
    StringFormat
    Annotations
    @inline()
  33. final def getClass(): Class[_]

    Permalink
    Definition Classes
    AnyRef → Any
  34. def hashCode(): Int

    Permalink
    Definition Classes
    AnyRef → Any
  35. def indexesManager(implicit ec: ExecutionContext): IndexesManager

    Permalink

    Returns an index manager for this database.

    Returns an index manager for this database.

    Definition Classes
    DBMetaCommands
  36. final def isInstanceOf[T0]: Boolean

    Permalink
    Definition Classes
    Any
  37. def killSession(failIfNotStarted: Boolean)(implicit ec: ExecutionContext): Future[DefaultDB]

    Permalink

    Kills (aborts) the session associated with this database reference (since MongoDB 3.6), if any otherwise does nothing .

    Kills (aborts) the session associated with this database reference (since MongoDB 3.6), if any otherwise does nothing .

    EXPERIMENTAL: API may change without notice.

    returns

    The database reference with session aborted

    Definition Classes
    DefaultDBDB
  38. final def killSession()(implicit ec: ExecutionContext): Future[DBType]

    Permalink

    Kills (aborts) the session associated with this database reference (since MongoDB 3.6), if any otherwise does nothing .

    Kills (aborts) the session associated with this database reference (since MongoDB 3.6), if any otherwise does nothing .

    EXPERIMENTAL: API may change without notice.

    // Equivalent to
    db.killSession(failIfNotStarted = false)
    returns

    The database reference with session aborted

    Definition Classes
    DB
    Annotations
    @inline()
  39. val name: String

    Permalink

    This database name.

    This database name.

    Definition Classes
    DefaultDBDB
  40. final def ne(arg0: AnyRef): Boolean

    Permalink
    Definition Classes
    AnyRef
  41. final def notify(): Unit

    Permalink
    Definition Classes
    AnyRef
  42. final def notifyAll(): Unit

    Permalink
    Definition Classes
    AnyRef
  43. val pack: Pack

    Permalink
    Definition Classes
    DefaultDB → GenericDB
  44. def ping(readPreference: ReadPreference = ReadPreference.nearest)(implicit ec: ExecutionContext): Future[Boolean]

    Permalink

    Tests if the server, resolved according to the given read preference, responds to commands.

    Tests if the server, resolved according to the given read preference, responds to commands. (since MongoDB 3.0)

    returns

    true if successful (even if the server is write locked)

    Definition Classes
    DBMetaCommands
  45. def productIterator: Iterator[Any]

    Permalink
    Definition Classes
    Product
  46. def productPrefix: String

    Permalink
    Definition Classes
    Product
  47. def renameCollection[C <: Collection](db: String, from: String, to: String, dropExisting: Boolean = false, failoverStrategy: FailoverStrategy = failoverStrategy)(implicit ec: ExecutionContext, producer: CollectionProducer[C] = ...): Future[C]

    Permalink

    Renames a collection.

    Renames a collection. Can only be executed if the this database reference is the admin one.

    db

    the name of the database where the collection exists with the current name

    from

    the current name of the collection, in the specified db

    to

    the new name of this collection (inside the same db)

    dropExisting

    If a collection of name to already exists, then drops that collection before renaming this one.

    returns

    a failure if the dropExisting option is false and the target collection already exists

    Definition Classes
    DBMetaCommands
  48. def runCommand[C <: Command](command: C, failoverStrategy: FailoverStrategy)(implicit writer: Writer[C]): CursorFetcher[pack.type, Cursor]

    Permalink

    failoverStrategy

    the failover strategy to override the default one

    Definition Classes
    GenericDB
  49. def runCommand[R, C <: Command with CommandWithResult[R]](command: C with CommandWithResult[R], failoverStrategy: FailoverStrategy)(implicit writer: Writer[C], reader: Reader[R], ec: ExecutionContext): Future[R]

    Permalink

    failoverStrategy

    the failover strategy to override the default one

    Definition Classes
    GenericDB
  50. def runValueCommand[A <: AnyVal, R <: BoxedAnyVal[A], C <: Command with CommandWithResult[R]](command: C with CommandWithResult[R with BoxedAnyVal[A]], failoverStrategy: FailoverStrategy, readPreference: ReadPreference)(implicit writer: Writer[C], reader: Reader[R], ec: ExecutionContext): Future[A]

    Permalink

    failoverStrategy

    the failover strategy to override the default one

    Definition Classes
    GenericDB
  51. def serverStatus(implicit ec: ExecutionContext): Future[ServerStatusResult]

    Permalink

    Returns the server status.

    Returns the server status.

    Definition Classes
    DBMetaCommands
  52. def sibling1(name: String, failoverStrategy: FailoverStrategy = failoverStrategy)(implicit ec: ExecutionContext): Future[DefaultDB]

    Permalink

    Returns the database of the given name on the same MongoConnection.

    Returns the database of the given name on the same MongoConnection.

    name

    the name of the collection to resolve

    failoverStrategy

    the failover strategy to override the default one

    Definition Classes
    DB
  53. def startSession(failIfAlreadyStarted: Boolean)(implicit ec: ExecutionContext): Future[DefaultDB]

    Permalink

    Starts a new session (since MongoDB 3.6).

    Starts a new session (since MongoDB 3.6).

    EXPERIMENTAL: API may change without notice.

    failIfAlreadyStarted

    if true fails if a session is already started

    returns

    The database reference updated with a new session, if none is already started with the current reference.

    Definition Classes
    DefaultDBDB
  54. final def startSession()(implicit ec: ExecutionContext): Future[DBType]

    Permalink

    Starts a new session (since MongoDB 3.6), does nothing if a session has already being started .

    Starts a new session (since MongoDB 3.6), does nothing if a session has already being started .

    EXPERIMENTAL: API may change without notice.

    // Equivalent to
    db.startSession(failIfAlreadyStarted = false)
    returns

    The database reference updated with a new session

    Definition Classes
    DB
    Annotations
    @inline()
  55. def startTransaction(writeConcern: Option[WriteConcern], failIfAlreadyStarted: Boolean)(implicit ec: ExecutionContext): Future[DBType]

    Permalink

    Starts a transaction (since MongoDB 4.0), if none is already started with the current client session otherwise does nothing.

    Starts a transaction (since MongoDB 4.0), if none is already started with the current client session otherwise does nothing.

    It fails if no session is previously started (see startSession).

    EXPERIMENTAL: API may change without notice.

    // Equivalent to
    db.startTransaction(aWriteConcern, failIfAlreadyStarted = false)
    writeConcern

    the write concern for the transaction operation

    returns

    The database reference with transaction.

    Definition Classes
    DefaultDBDB
  56. final def startTransaction(writeConcern: Option[WriteConcern])(implicit ec: ExecutionContext): Future[DBType]

    Permalink

    Starts a transaction (since MongoDB 4.0), if none is already started with the current client session otherwise does nothing.

    Starts a transaction (since MongoDB 4.0), if none is already started with the current client session otherwise does nothing.

    It fails if no session is previously started (see startSession).

    EXPERIMENTAL: API may change without notice.

    // Equivalent to
    db.startTransaction(aWriteConcern, failIfAlreadyStarted = false)
    writeConcern

    the write concern for the transaction operation

    returns

    The database reference with transaction.

    Definition Classes
    DB
    Annotations
    @inline()
  57. final def synchronized[T0](arg0: ⇒ T0): T0

    Permalink
    Definition Classes
    AnyRef
  58. def toString(): String

    Permalink
    Definition Classes
    DefaultDB → AnyRef → Any
  59. final def wait(): Unit

    Permalink
    Definition Classes
    AnyRef
    Annotations
    @throws( ... )
  60. final def wait(arg0: Long, arg1: Int): Unit

    Permalink
    Definition Classes
    AnyRef
    Annotations
    @throws( ... )
  61. final def wait(arg0: Long): Unit

    Permalink
    Definition Classes
    AnyRef
    Annotations
    @throws( ... )
  62. def [B](y: B): (DefaultDB, B)

    Permalink
    Implicit information
    This member is added by an implicit conversion from DefaultDB to ArrowAssoc[DefaultDB] performed by method ArrowAssoc in scala.Predef.
    Definition Classes
    ArrowAssoc

Deprecated Value Members

  1. def createUser(user: String, pwd: Option[String], customData: Option[BSONDocument], roles: List[UserRole], digestPassword: Boolean, writeConcern: commands.WriteConcern, restrictions: List[AuthenticationRestriction], mechanisms: List[AuthenticationMode])(implicit ec: ExecutionContext): Future[Unit]

    Permalink
    Definition Classes
    DBMetaCommands
    Annotations
    @deprecated
    Deprecated

    (Since version 0.19.1) Use createUser with DBMetaWriter

  2. def createUser(user: String, pwd: Option[String], roles: List[UserRole], digestPassword: Boolean = true, writeConcern: commands.WriteConcern = connection.options.writeConcern, customData: Option[BSONDocument] = None)(implicit ec: ExecutionContext): Future[Unit]

    Permalink
    Definition Classes
    DBMetaCommands
    Annotations
    @deprecated
    Deprecated

    (Since version 0.18.4) Use createUser with complete authentication options

  3. val productArity: Int

    Permalink
    Definition Classes
    DefaultDB → Product
    Annotations
    @deprecated
    Deprecated

    (Since version 0.16.0) DefaultDB will no longer be a Product

  4. def productElement(n: Int): Any

    Permalink
    Definition Classes
    DefaultDB → Product
    Annotations
    @deprecated
    Deprecated

    (Since version 0.16.0) DefaultDB will no longer be a Product

  5. def sibling(name: String, failoverStrategy: FailoverStrategy = failoverStrategy)(implicit ec: ExecutionContext): DefaultDB

    Permalink

    Returns the database of the given name on the same MongoConnection.

    Returns the database of the given name on the same MongoConnection.

    name

    the name of the collection to resolve

    failoverStrategy

    the failover strategy to override the default one

    Definition Classes
    DB
    Annotations
    @deprecated
    Deprecated

    (Since version 0.16.0) Use sibling1

    See also

    sibling1

Inherited from Serializable

Inherited from Serializable

Inherited from Product

Inherited from Equals

Inherited from GenericDB[Pack]

Inherited from DBMetaCommands

Inherited from DB

Inherited from AnyRef

Inherited from Any

Inherited by implicit conversion any2stringadd from DefaultDB to any2stringadd[DefaultDB]

Inherited by implicit conversion StringFormat from DefaultDB to StringFormat[DefaultDB]

Inherited by implicit conversion Ensuring from DefaultDB to Ensuring[DefaultDB]

Inherited by implicit conversion ArrowAssoc from DefaultDB to ArrowAssoc[DefaultDB]

Ungrouped