DB - ReactiveMongo API 0.19 - reactivemongo.api.DB

Type Members

abstract type DBType <: DB

Attributes
protected

Abstract Value Members

abstract def abortTransaction(failIfNotStarted: Boolean)(implicit ec: ExecutionContext): Future[DBType]

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)
abstract def commitTransaction(failIfNotStarted: Boolean)(implicit ec: ExecutionContext): Future[DBType]

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)
abstract def connection: MongoConnection

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

Annotations
@transient()
abstract def endSession(failIfNotStarted: Boolean)(implicit ec: ExecutionContext): Future[DBType]

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
abstract def failoverStrategy: FailoverStrategy

A failover strategy for sending requests.
abstract def killSession(failIfNotStarted: Boolean)(implicit ec: ExecutionContext): Future[DBType]

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
abstract def name: String

This database name.
abstract def startSession(failIfAlreadyStarted: Boolean)(implicit ec: ExecutionContext): Future[DBType]

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.
abstract def startTransaction(writeConcern: Option[WriteConcern], failIfAlreadyStarted: Boolean)(implicit ec: ExecutionContext): Future[DBType]

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.

Concrete Value Members

final def !=(arg0: Any): Boolean

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

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

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

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

Definition Classes
AnyRef → Any
final def abortTransaction()(implicit ec: ExecutionContext): Future[DBType]

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)

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

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
final def asInstanceOf[T0]: T0

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

Authenticates the connection on this database.
Authenticates the connection on this database.
user
the name of the user
password
the user password
def clone(): AnyRef

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

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
final def commitTransaction()(implicit ec: ExecutionContext): Future[DBType]

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)

Annotations
@inline()
def defaultReadPreference: ReadPreference

Annotations
@inline()
final def endSession()(implicit ec: ExecutionContext): Future[DBType]

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

Annotations
@inline()
def ensuring(cond: (DB) ⇒ Boolean, msg: ⇒ Any): DB

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

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

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

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

Definition Classes
AnyRef
def equals(arg0: Any): Boolean

Definition Classes
AnyRef → Any
def finalize(): Unit

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

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

Definition Classes
AnyRef → Any
def hashCode(): Int

Definition Classes
AnyRef → Any
final def isInstanceOf[T0]: Boolean

Definition Classes
Any
final def killSession()(implicit ec: ExecutionContext): Future[DBType]

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

Annotations
@inline()
final def ne(arg0: AnyRef): Boolean

Definition Classes
AnyRef
final def notify(): Unit

Definition Classes
AnyRef
final def notifyAll(): Unit

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

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
final def startSession()(implicit ec: ExecutionContext): Future[DBType]

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

Annotations
@inline()
final def startTransaction(writeConcern: Option[WriteConcern])(implicit ec: ExecutionContext): Future[DBType]

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.

Annotations
@inline()
final def synchronized[T0](arg0: ⇒ T0): T0

Definition Classes
AnyRef
def toString(): String

Definition Classes
AnyRef → Any
final def wait(): Unit

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

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

Definition Classes
AnyRef
Annotations
@throws( ... )
def →[B](y: B): (DB, B)

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

Deprecated Value Members

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

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

Annotations
@deprecated
Deprecated
(Since version 0.16.0) Use sibling1
See also
sibling1

DB

Related Docs: object DB | package api

sealed trait DB extends AnyRef

Type Members

abstract type DBType <: DB

Abstract Value Members

abstract def abortTransaction(failIfNotStarted: Boolean)(implicit ec: ExecutionContext): Future[DBType]

abstract def commitTransaction(failIfNotStarted: Boolean)(implicit ec: ExecutionContext): Future[DBType]

abstract def connection: MongoConnection

abstract def endSession(failIfNotStarted: Boolean)(implicit ec: ExecutionContext): Future[DBType]

abstract def failoverStrategy: FailoverStrategy

abstract def killSession(failIfNotStarted: Boolean)(implicit ec: ExecutionContext): Future[DBType]

abstract def name: String

abstract def startSession(failIfAlreadyStarted: Boolean)(implicit ec: ExecutionContext): Future[DBType]

abstract def startTransaction(writeConcern: Option[WriteConcern], failIfAlreadyStarted: Boolean)(implicit ec: ExecutionContext): Future[DBType]

Concrete Value Members

final def !=(arg0: Any): Boolean

final def ##(): Int

def +(other: String): String

def ->[B](y: B): (DB, B)

final def ==(arg0: Any): Boolean

final def abortTransaction()(implicit ec: ExecutionContext): Future[DBType]

def apply[C <: Collection](name: String, failoverStrategy: FailoverStrategy = failoverStrategy)(implicit producer: CollectionProducer[C] = ...): C

final def asInstanceOf[T0]: T0

def authenticate(user: String, password: String)(implicit ec: ExecutionContext): Future[SuccessfulAuthentication]

def clone(): AnyRef

def collection[C <: Collection](name: String, failoverStrategy: FailoverStrategy = failoverStrategy)(implicit producer: CollectionProducer[C] = ...): C

final def commitTransaction()(implicit ec: ExecutionContext): Future[DBType]

def defaultReadPreference: ReadPreference

final def endSession()(implicit ec: ExecutionContext): Future[DBType]

def ensuring(cond: (DB) ⇒ Boolean, msg: ⇒ Any): DB

def ensuring(cond: (DB) ⇒ Boolean): DB

def ensuring(cond: Boolean, msg: ⇒ Any): DB

def ensuring(cond: Boolean): DB

final def eq(arg0: AnyRef): Boolean

def equals(arg0: Any): Boolean

def finalize(): Unit

def formatted(fmtstr: String): String

final def getClass(): Class[_]

def hashCode(): Int

final def isInstanceOf[T0]: Boolean

final def killSession()(implicit ec: ExecutionContext): Future[DBType]

final def ne(arg0: AnyRef): Boolean

final def notify(): Unit

final def notifyAll(): Unit

def sibling1(name: String, failoverStrategy: FailoverStrategy = failoverStrategy)(implicit ec: ExecutionContext): Future[DefaultDB]

final def startSession()(implicit ec: ExecutionContext): Future[DBType]

final def startTransaction(writeConcern: Option[WriteConcern])(implicit ec: ExecutionContext): Future[DBType]

final def synchronized[T0](arg0: ⇒ T0): T0

def toString(): String

final def wait(): Unit

final def wait(arg0: Long, arg1: Int): Unit

final def wait(arg0: Long): Unit

def →[B](y: B): (DB, B)

Deprecated Value Members

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

Inherited from AnyRef

Inherited from Any

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

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

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

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

Ungrouped