reactivemongo.api

WrappedCursor

trait WrappedCursor[T] extends Cursor[T]

Cursor wrapper, to help to define custom cursor classes.

See also

CursorProducer

Linear Supertypes
Ordering
  1. Alphabetic
  2. By inheritance
Inherited
  1. WrappedCursor
  2. Cursor
  3. AnyRef
  4. Any
Implicitly
  1. by any2stringadd
  2. by any2stringfmt
  3. by any2ArrowAssoc
  4. by any2Ensuring
  1. Hide All
  2. Show all
Learn more about member selection
Visibility
  1. Public
  2. All

Abstract Value Members

  1. abstract def wrappee: Cursor[T]

    The underlying cursor

Concrete Value Members

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

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

    Definition Classes
    Any
  3. final def ##(): Int

    Definition Classes
    AnyRef → Any
  4. 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
  5. 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()
  6. final def ==(arg0: AnyRef): Boolean

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

    Definition Classes
    Any
  8. final def asInstanceOf[T0]: T0

    Definition Classes
    Any
  9. def clone(): AnyRef

    Attributes
    protected[java.lang]
    Definition Classes
    AnyRef
    Annotations
    @throws( ... )
  10. def collect[M[_]](maxDocs: Int = 1, stopOnError: Boolean = true)(implicit cbf: CanBuildFrom[M[_], T, M[T]], ec: ExecutionContext): Future[M[T]]

    Collects all the documents into a collection of type M[T].

    Collects all the documents into a collection of type M[T].

    maxDocs

    the maximum number of documents to be retrieved (-1 for unlimited).

    stopOnError

    States if may stop on non-fatal exception (default: true). If set to false, the exceptions are skipped, trying to get the next result..

    val cursor = collection.find(query, filter).cursor[BSONDocument]()
    // return the 3 first documents in a Vector[BSONDocument].
    val vector = cursor.collect[Vector](3)
    Definition Classes
    WrappedCursorCursor
  11. def collect[M[_]](maxDocs: Int, err: (M[T], Throwable) ⇒ State[M[T]])(implicit cbf: CanBuildFrom[M[_], T, M[T]], ec: ExecutionContext): Future[M[T]]

    Collects all the documents into a collection of type M[T].

    Collects all the documents into a collection of type M[T].

    maxDocs

    the maximum number of documents to be retrieved (-1 for unlimited).

    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.

    val cursor = collection.find(query, filter).cursor[BSONDocument]()
    // return the 3 first documents in a Vector[BSONDocument].
    val vector = cursor.collect[Vector](3, Cursor.FailOnError[Vector[BSONDocument]]())
    Definition Classes
    WrappedCursorCursor
  12. 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
  13. 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
  14. 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
  15. 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
  16. final def eq(arg0: AnyRef): Boolean

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

    Definition Classes
    AnyRef → Any
  18. def finalize(): Unit

    Attributes
    protected[java.lang]
    Definition Classes
    AnyRef
    Annotations
    @throws( classOf[java.lang.Throwable] )
  19. def fold[A](z: ⇒ A, maxDocs: Int = 1)(suc: (A, T) ⇒ A)(implicit ctx: 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

    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
  20. def foldBulks[A](z: ⇒ A, maxDocs: Int = 1)(suc: (A, Iterator[T]) ⇒ State[A], err: (A, Throwable) ⇒ State[A])(implicit ctx: 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

    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
    WrappedCursorCursor
  21. def foldBulksM[A](z: ⇒ A, maxDocs: Int = 1)(suc: (A, Iterator[T]) ⇒ Future[State[A]], err: (A, Throwable) ⇒ State[A])(implicit ctx: 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

    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
    WrappedCursorCursor
  22. def foldResponses[A](z: ⇒ A, maxDocs: Int = 1)(suc: (A, Response) ⇒ State[A], err: (A, Throwable) ⇒ State[A])(implicit ctx: 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
    WrappedCursorCursor
  23. def foldResponsesM[A](z: ⇒ A, maxDocs: Int = 1)(suc: (A, Response) ⇒ Future[State[A]], err: (A, Throwable) ⇒ State[A])(implicit ctx: 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
    WrappedCursorCursor
  24. def foldWhile[A](z: ⇒ A, maxDocs: Int = 1)(suc: (A, T) ⇒ State[A], err: (A, Throwable) ⇒ State[A])(implicit ctx: 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

    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
    WrappedCursorCursor
  25. def foldWhileM[A](z: ⇒ A, maxDocs: Int = 1)(suc: (A, T) ⇒ Future[State[A]], err: (A, Throwable) ⇒ State[A])(implicit ctx: 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

    cursor.foldWhileM(Nil: Seq[Person])(
    (s, p) => Future.successful(Cursor.Cont(s :+ p)),
    { (l, e) => Future {
      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. 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
    WrappedCursorCursor
  26. 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()
  27. final def getClass(): Class[_]

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

    Definition Classes
    AnyRef → Any
  29. def head(implicit ctx: ExecutionContext): Future[T]

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

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

    val cursor = collection.find(query, filter).cursor[BSONDocument]
    // return option of the first element.
    val first: Future[BSONDocument] = cursor.head
    Definition Classes
    WrappedCursorCursor
  30. def headOption(implicit ctx: ExecutionContext): Future[Option[T]]

    Returns the first document matching the query, if any.

    Returns the first document matching the query, if any.

    val cursor = collection.find(query, filter).cursor[BSONDocument]
    // return option of the first element.
    val maybeFirst: Future[Option[BSONDocument]] = cursor.headOption
    Definition Classes
    WrappedCursorCursor
  31. final def isInstanceOf[T0]: Boolean

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

    Definition Classes
    AnyRef
  33. final def notify(): Unit

    Definition Classes
    AnyRef
  34. final def notifyAll(): Unit

    Definition Classes
    AnyRef
  35. final def synchronized[T0](arg0: ⇒ T0): T0

    Definition Classes
    AnyRef
  36. def toString(): String

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

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

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

    Definition Classes
    AnyRef
    Annotations
    @throws( ... )
  40. 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

  1. 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
  2. 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

  1. def enumerate(maxDocs: Int = 1, stopOnError: Boolean = false)(implicit ctx: ExecutionContext): Enumerator[T]

    Produces an Enumerator of documents.

    Produces an Enumerator of documents. The returned enumerator may process up to maxDocs. If stopOnError is false, then documents that cause error are dropped, so the enumerator may emit a little less than maxDocs, even if it processes maxDocs documents.

    maxDocs

    the maximum number of documents to be retrieved (-1 for unlimited).

    stopOnError

    States if may stop on non-fatal exception (default: true). If set to false, the exceptions are skipped, trying to get the next result..

    returns

    an play.api.libs.iteratee.Enumerator of documents

    Definition Classes
    WrappedCursorCursor
    Annotations
    @deprecated
    Deprecated

    (Since version 0.11.10) Use the Play Iteratees module

  2. def enumerateBulks(maxDocs: Int = 1, stopOnError: Boolean = false)(implicit ctx: ExecutionContext): Enumerator[Iterator[T]]

    Produces an Enumerator of Iterator of documents.

    Produces an Enumerator of Iterator of documents. Given the stopOnError parameter, this Enumerator may stop on any non-fatal exception, or skip and continue.

    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.

    stopOnError

    States if may stop on non-fatal exception (default: true). If set to false, the exceptions are skipped, trying to get the next result..

    returns

    an play.api.libs.iteratee.Enumerator of Iterators of documents

    Definition Classes
    WrappedCursorCursor
    Annotations
    @deprecated
    Deprecated

    (Since version 0.11.10) Use the Play Iteratees module

  3. def enumerateResponses(maxDocs: Int = 1, stopOnError: Boolean = false)(implicit ctx: ExecutionContext): Enumerator[Response]

    Produces an Enumerator of responses from the database.

    Produces an Enumerator of responses from the database. Given the stopOnError parameter, this Enumerator may stop on any non-fatal exception, or skip and continue.

    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.

    stopOnError

    States if may stop on non-fatal exception (default: true). If set to false, the exceptions are skipped, trying to get the next result..

    returns

    an play.api.libs.iteratee.Enumerator of Responses.

    Definition Classes
    WrappedCursorCursor
    Annotations
    @deprecated
    Deprecated

    (Since version 0.11.10) Use the Play Iteratees module

  4. def rawEnumerateResponses(maxDocs: Int = 1)(implicit ctx: ExecutionContext): Enumerator[Response]

    Produces an Enumerator of responses from the database.

    Produces an Enumerator of responses from the database. An Enumeratee for error handling should be used to prevent silent failures.

    maxDocs

    the maximum number of documents to be retrieved (-1 for unlimited)

    Definition Classes
    WrappedCursorCursor
    Annotations
    @deprecated
    Deprecated

    (Since version 0.11.10) Use the Play Iteratees module

  5. def toList(maxDocs: Int = 1, stopOnError: Boolean = true)(implicit ctx: ExecutionContext): Future[List[T]]

    Returns the list of the matching documents.

    Returns the list of the matching documents.

    Definition Classes
    Cursor
    Annotations
    @deprecated
    Deprecated

    (Since version 0.10.0) consider using collect[List] instead

  6. 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

  7. 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

Inherited from Cursor[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