WrappedCursor

Abstract Value Members

abstract def wrappee: Cursor[T]

The underlying cursor

Concrete Value Members

final def !=(arg0: AnyRef): Boolean

Definition Classes
AnyRef
final def !=(arg0: Any): Boolean

Definition Classes
Any
final def ##(): Int

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

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

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

Definition Classes
AnyRef
final def ==(arg0: Any): Boolean

Definition Classes
Any
final def asInstanceOf[T0]: T0

Definition Classes
Any
def clone(): AnyRef

Attributes
protected[java.lang]
Definition Classes
AnyRef
Annotations
@throws( ... )
def collect[M[_]](maxDocs: Int, err: (M[T], Throwable) ⇒ State[M[T]])(implicit cbf: CanBuildFrom[M[_], T, M[T]], ec: ExecutionContext): Future[M[T]]

Definition Classes
WrappedCursorCompat
def ensuring(cond: (WrappedCursor[T]) ⇒ Boolean, msg: ⇒ Any): WrappedCursor[T]

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

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

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

Implicit information
This member is added by an implicit conversion from WrappedCursor[T] to Ensuring[WrappedCursor[T]] performed by method any2Ensuring 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 fold[A](z: ⇒ A, maxDocs: Int = 1)(suc: (A, T) ⇒ A)(implicit ec: ExecutionContext): Future[A]

Applies a binary operator to a start value and all elements retrieved by this cursor, going first to last.
Applies a binary operator to a start value and all elements retrieved by this cursor, going first to last.
A
the result type of the binary operator
```
import scala.concurrent.ExecutionContext
import reactivemongo.api.Cursor

case class Person(name: String, age: Int)

def foo(cursor: Cursor[Person])(implicit ec: ExecutionContext) =
  cursor.foldWhile(Nil: Seq[Person])((s, p) => Cursor.Cont(s :+ p),
    { (l, e) => println("last valid value: " + l); Cursor.Fail(e) })
```
z
the initial value
maxDocs
the maximum number of documents to be retrieved (-1 for unlimited).
suc
The binary operator to be applied when the next document is successfully read.
Definition Classes
Cursor
def foldBulks[A](z: ⇒ A, maxDocs: Int = 1)(suc: (A, Iterator[T]) ⇒ State[A], err: (A, Throwable) ⇒ State[A])(implicit ec: ExecutionContext): Future[A]

Applies a binary operator to a start value and all bulks of documents retrieved by this cursor, going first to last.
Applies a binary operator to a start value and all bulks of documents retrieved by this cursor, going first to last.
A
the result type of the binary operator
```
import reactivemongo.api.Cursor
import scala.concurrent.ExecutionContext

case class Person(name: String, age: Int)

def foo(cursor: Cursor[Person])(implicit ec: ExecutionContext) =
  cursor.foldBulks(Nil: Seq[Person])(
    (s, bulk: Iterator[Person]) => Cursor.Cont(s ++ bulk),
    { (l, e) => println("last valid value: " + l); Cursor.Fail(e) })
```
z
the initial value
maxDocs
the maximum number of documents to be retrieved (-1 for unlimited). The actual document count can exceed this, when this maximum devided by the batch size given a non-zero remainder.
suc
The binary operator to be applied when the next response is successfully read.
err
The binary operator to be applied when failing to get the next response. Exception or Fail raised within the suc function cannot be recovered by this error handler.
Definition Classes
WrappedCursor → Cursor
def foldBulksM[A](z: ⇒ A, maxDocs: Int = 1)(suc: (A, Iterator[T]) ⇒ Future[State[A]], err: (A, Throwable) ⇒ State[A])(implicit ec: ExecutionContext): Future[A]

Applies a binary operator to a start value and all bulks of documents retrieved by this cursor, going first to last.
Applies a binary operator to a start value and all bulks of documents retrieved by this cursor, going first to last.
A
the result type of the binary operator
```
import scala.concurrent.{ ExecutionContext, Future }
import reactivemongo.api.Cursor

case class Person(name: String, age: Int)

def foo(cursor: Cursor[Person])(implicit ec: ExecutionContext) =
  cursor.foldBulksM(Nil: Seq[Person])(
    { (s, bulk: Iterator[Person]) =>
     Future.successful(Cursor.Cont(s ++ bulk))
   },
    { (l, e) =>
      println("last valid value: " + l)
      Cursor.Fail[Seq[Person]](e)
    })
```
z
the initial value
maxDocs
the maximum number of documents to be retrieved (-1 for unlimited). The actual document count can exceed this, when this maximum devided by the batch size given a non-zero remainder.
suc
The binary operator to be applied when the next response is successfully read. This must be safe, and any error must be returned as Future.failed[State[A]].
err
The binary operator to be applied when failing to get the next response. Exception or Fail raised within the suc function cannot be recovered by this error handler.
Definition Classes
WrappedCursor → Cursor
def foldResponses[A](z: ⇒ A, maxDocs: Int = 1)(suc: (A, Response) ⇒ State[A], err: (A, Throwable) ⇒ State[A])(implicit ec: ExecutionContext): Future[A]

Applies a binary operator to a start value and all responses handled by this cursor, going first to last.
Applies a binary operator to a start value and all responses handled by this cursor, going first to last.
A
the result type of the binary operator
z
the initial value
maxDocs
the maximum number of documents to be retrieved (-1 for unlimited). The actual document count can exceed this, when this maximum devided by the batch size given a non-zero remainder.
suc
The binary operator to be applied when the next response is successfully read.
err
The binary operator to be applied when failing to get the next response. Exception or Fail raised within the suc function cannot be recovered by this error handler.

Definition Classes
WrappedCursor → Cursor
def foldResponsesM[A](z: ⇒ A, maxDocs: Int = 1)(suc: (A, Response) ⇒ Future[State[A]], err: (A, Throwable) ⇒ State[A])(implicit ec: ExecutionContext): Future[A]

Applies a binary operator to a start value and all responses handled by this cursor, going first to last.
Applies a binary operator to a start value and all responses handled by this cursor, going first to last.
A
the result type of the binary operator
z
the initial value
maxDocs
the maximum number of documents to be retrieved (-1 for unlimited). The actual document count can exceed this, when this maximum devided by the batch size given a non-zero remainder.
suc
The binary operator to be applied when the next response is successfully read. This must be safe, and any error must be returned as Future.failed[State[A]].
err
The binary operator to be applied when failing to get the next response. Exception or Fail raised within the suc function cannot be recovered by this error handler.

Definition Classes
WrappedCursor → Cursor
def foldWhile[A](z: ⇒ A, maxDocs: Int = 1)(suc: (A, T) ⇒ State[A], err: (A, Throwable) ⇒ State[A])(implicit ec: ExecutionContext): Future[A]

Applies a binary operator to a start value and all elements retrieved by this cursor, going first to last.
Applies a binary operator to a start value and all elements retrieved by this cursor, going first to last.
A
the result type of the binary operator
```
import reactivemongo.api.Cursor
import scala.concurrent.ExecutionContext

case class Person(name: String, age: Int)

def foo(cursor: Cursor[Person])(implicit ec: ExecutionContext) =
  cursor.foldWhile(Nil: Seq[Person])((s, p) => Cursor.Cont(s :+ p),
    { (l, e) => println("last valid value: " + l); Cursor.Fail(e) })
```
z
the initial value
maxDocs
the maximum number of documents to be retrieved (-1 for unlimited).
suc
The binary operator to be applied when the next document is successfully read.
err
The binary operator to be applied when failing to get the next response. Exception or Fail raised within the suc function cannot be recovered by this error handler.
Definition Classes
WrappedCursor → Cursor
def foldWhileM[A](z: ⇒ A, maxDocs: Int = 1)(suc: (A, T) ⇒ Future[State[A]], err: (A, Throwable) ⇒ State[A])(implicit ec: ExecutionContext): Future[A]

Applies a binary operator to a start value and all elements retrieved by this cursor, going first to last.
Applies a binary operator to a start value and all elements retrieved by this cursor, going first to last.
A
the result type of the binary operator
```
import scala.concurrent.{ ExecutionContext, Future }
import reactivemongo.api.Cursor

case class Person(name: String, age: Int)

def foo(cursor: Cursor[Person])(implicit ec: ExecutionContext) =
  cursor.foldWhileM(Nil: Seq[Person])(
    (s, p) => Future.successful(Cursor.Cont(s :+ p)),
    { (l, e) =>
      println("last valid value: " + l)
      Cursor.Fail[Seq[Person]](e)
    })
```
z
the initial value
maxDocs
the maximum number of documents to be retrieved (-1 for unlimited).
suc
The binary operator to be applied when the next document is successfully read. This must be safe, and any error must be returned as Future.failed[State[A]].
err
The binary operator to be applied when failing to get the next response. Exception or Fail raised within the suc function cannot be recovered by this error handler.
Definition Classes
WrappedCursor → Cursor
def formatted(fmtstr: String): String

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

Definition Classes
AnyRef → Any
def hashCode(): Int

Definition Classes
AnyRef → Any

def head(implicit ec: ExecutionContext): Future[T]

Returns the first document matching the query, or fails with Cursor.NoSuchResultException if none.

import scala.concurrent.{ ExecutionContext, Future }

import reactivemongo.bson.BSONDocument
import reactivemongo.api.collections.bson.BSONCollection

def first(query: BSONDocument)(collection: BSONCollection)(
  implicit ec: ExecutionContext): Future[BSONDocument] = {
  val cursor = collection.find(query).cursor[BSONDocument]()
  // return option of the first element.
  cursor.head
}

Definition Classes: WrappedCursor → Cursor

def headOption(implicit ec: ExecutionContext): Future[Option[T]]

Returns the first document matching the query, if any.

import scala.concurrent.{ ExecutionContext, Future }

import reactivemongo.api.bson.BSONDocument

import reactivemongo.api.bson.collection.BSONCollection

def maybeFirst(query: BSONDocument)(collection: BSONCollection)(
  implicit ec: ExecutionContext): Future[Option[BSONDocument]] = {
  val cursor = collection.find(query).cursor[BSONDocument]()
  // return option of the first element.
  cursor.headOption
}

Definition Classes: WrappedCursor → Cursor

final def isInstanceOf[T0]: Boolean

Definition Classes
Any
final def ne(arg0: AnyRef): Boolean

Definition Classes
AnyRef
final def notify(): Unit

Definition Classes
AnyRef
final def notifyAll(): Unit

Definition Classes
AnyRef
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): (WrappedCursor[T], B)

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

Shadowed Implicit Value Members

val self: Any
Implicit information
This member is added by an implicit conversion from WrappedCursor[T] to StringAdd performed by method any2stringadd in scala.Predef.
Shadowing
This implicitly inherited member is ambiguous. One or more implicitly inherited members have similar signatures, so calling this member may produce an ambiguous implicit conversion compiler error.
To access this member you can use a type ascription:
(wrappedCursor: StringAdd).self
Definition Classes
StringAdd
val self: Any
Implicit information
This member is added by an implicit conversion from WrappedCursor[T] to StringFormat performed by method any2stringfmt in scala.Predef.
Shadowing
This implicitly inherited member is ambiguous. One or more implicitly inherited members have similar signatures, so calling this member may produce an ambiguous implicit conversion compiler error.
To access this member you can use a type ascription:
(wrappedCursor: StringFormat).self
Definition Classes
StringFormat

Deprecated Value Members

def x: WrappedCursor[T]
Implicit information
This member is added by an implicit conversion from WrappedCursor[T] to ArrowAssoc[WrappedCursor[T]] performed by method any2ArrowAssoc in scala.Predef.
Shadowing
This implicitly inherited member is ambiguous. One or more implicitly inherited members have similar signatures, so calling this member may produce an ambiguous implicit conversion compiler error.
To access this member you can use a type ascription:
(wrappedCursor: ArrowAssoc[WrappedCursor[T]]).x
Definition Classes
ArrowAssoc
Annotations
@deprecated
Deprecated
(Since version 2.10.0) Use leftOfArrow instead
def x: WrappedCursor[T]
Implicit information
This member is added by an implicit conversion from WrappedCursor[T] to Ensuring[WrappedCursor[T]] performed by method any2Ensuring in scala.Predef.
Shadowing
This implicitly inherited member is ambiguous. One or more implicitly inherited members have similar signatures, so calling this member may produce an ambiguous implicit conversion compiler error.
To access this member you can use a type ascription:
(wrappedCursor: Ensuring[WrappedCursor[T]]).x
Definition Classes
Ensuring
Annotations
@deprecated
Deprecated
(Since version 2.10.0) Use resultOfEnsuring instead

trait WrappedCursor[T] extends Cursor[T] with WrappedCursorCompat[T]

Abstract Value Members

abstract def wrappee: Cursor[T]

Concrete Value Members

final def !=(arg0: AnyRef): Boolean

final def !=(arg0: Any): Boolean

final def ##(): Int

def +(other: String): String

def ->[B](y: B): (WrappedCursor[T], B)

final def ==(arg0: AnyRef): Boolean

final def ==(arg0: Any): Boolean

final def asInstanceOf[T0]: T0

def clone(): AnyRef

def collect[M[_]](maxDocs: Int, err: (M[T], Throwable) ⇒ State[M[T]])(implicit cbf: CanBuildFrom[M[_], T, M[T]], ec: ExecutionContext): Future[M[T]]

def ensuring(cond: (WrappedCursor[T]) ⇒ Boolean, msg: ⇒ Any): WrappedCursor[T]

def ensuring(cond: (WrappedCursor[T]) ⇒ Boolean): WrappedCursor[T]

def ensuring(cond: Boolean, msg: ⇒ Any): WrappedCursor[T]

def ensuring(cond: Boolean): WrappedCursor[T]

final def eq(arg0: AnyRef): Boolean

def equals(arg0: Any): Boolean

def finalize(): Unit

def fold[A](z: ⇒ A, maxDocs: Int = 1)(suc: (A, T) ⇒ A)(implicit ec: ExecutionContext): Future[A]

def foldBulks[A](z: ⇒ A, maxDocs: Int = 1)(suc: (A, Iterator[T]) ⇒ State[A], err: (A, Throwable) ⇒ State[A])(implicit ec: ExecutionContext): Future[A]

def foldBulksM[A](z: ⇒ A, maxDocs: Int = 1)(suc: (A, Iterator[T]) ⇒ Future[State[A]], err: (A, Throwable) ⇒ State[A])(implicit ec: ExecutionContext): Future[A]

def foldResponses[A](z: ⇒ A, maxDocs: Int = 1)(suc: (A, Response) ⇒ State[A], err: (A, Throwable) ⇒ State[A])(implicit ec: ExecutionContext): Future[A]

def foldResponsesM[A](z: ⇒ A, maxDocs: Int = 1)(suc: (A, Response) ⇒ Future[State[A]], err: (A, Throwable) ⇒ State[A])(implicit ec: ExecutionContext): Future[A]

def foldWhile[A](z: ⇒ A, maxDocs: Int = 1)(suc: (A, T) ⇒ State[A], err: (A, Throwable) ⇒ State[A])(implicit ec: ExecutionContext): Future[A]

def foldWhileM[A](z: ⇒ A, maxDocs: Int = 1)(suc: (A, T) ⇒ Future[State[A]], err: (A, Throwable) ⇒ State[A])(implicit ec: ExecutionContext): Future[A]

def formatted(fmtstr: String): String

final def getClass(): Class[_]

def hashCode(): Int

def head(implicit ec: ExecutionContext): Future[T]

def headOption(implicit ec: ExecutionContext): Future[Option[T]]

final def isInstanceOf[T0]: Boolean

final def ne(arg0: AnyRef): Boolean

final def notify(): Unit

final def notifyAll(): Unit

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): (WrappedCursor[T], B)

Shadowed Implicit Value Members

val self: Any

val self: Any

Deprecated Value Members

def x: WrappedCursor[T]

def x: WrappedCursor[T]

Inherited from WrappedCursorCompat[T]

Inherited from Cursor[T]

Inherited from CursorCompatAPI[T]

Inherited from AnyRef

Inherited from Any

Inherited by implicit conversion any2stringadd from WrappedCursor[T] to StringAdd

Inherited by implicit conversion any2stringfmt from WrappedCursor[T] to StringFormat

Inherited by implicit conversion any2ArrowAssoc from WrappedCursor[T] to ArrowAssoc[WrappedCursor[T]]

Inherited by implicit conversion any2Ensuring from WrappedCursor[T] to Ensuring[WrappedCursor[T]]

Ungrouped