Trait

reactivemongo.api

WrappedCursor

Related Doc: package api

Permalink

trait WrappedCursor[T] extends Cursor[T]

Cursor wrapper, to help to define custom cursor classes.

See also

CursorProducer

Linear Supertypes
Cursor[T], AnyRef, Any
Ordering
  1. Alphabetic
  2. By inheritance
Inherited
  1. WrappedCursor
  2. Cursor
  3. AnyRef
  4. 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

Abstract Value Members

  1. abstract def wrappee: Cursor[T]

    Permalink

    The underlying cursor

Concrete 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 WrappedCursor[T] to any2stringadd[WrappedCursor[T]] performed by method any2stringadd in scala.Predef.
    Definition Classes
    any2stringadd
  4. def ->[B](y: B): (WrappedCursor[T], B)

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

    Permalink
    Definition Classes
    AnyRef → Any
  6. final def asInstanceOf[T0]: T0

    Permalink
    Definition Classes
    Any
  7. def clone(): AnyRef

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

    Permalink

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

    Collects all the documents into a collection of type M[T]. Given the stopOnError parameter (which defaults to true), the resulting Future may fail if any non-fatal exception occurs. If set to false, all the documents that caused exceptions are skipped. Up to maxDocs returned by the database may be processed. If stopOnError is false, then documents that cause error are dropped, so the result may contain a little less than maxDocs even if maxDocs documents were processed.

    maxDocs

    Collect up to maxDocs documents.

    stopOnError

    States if the Future should fail if any non-fatal exception occurs. Example:

    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
  9. def collect[M[_]](maxDocs: Int, err: ErrorHandler[M[T]])(implicit cbf: CanBuildFrom[M[_], T, M[T]], ec: ExecutionContext): Future[M[T]]

    Permalink

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

    Collects all the documents into a collection of type M[T]. Given the stopOnError parameter (which defaults to true), the resulting Future may fail if any non-fatal exception occurs. If set to false, all the documents that caused exceptions are skipped. Up to maxDocs returned by the database may be processed. If stopOnError is false, then documents that cause error are dropped, so the result may contain a little less than maxDocs even if maxDocs documents were processed.

    maxDocs

    Collect up to maxDocs documents.

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

    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())
    Definition Classes
    WrappedCursorCursor
  10. def ensuring(cond: (WrappedCursor[T]) ⇒ Boolean, msg: ⇒ Any): WrappedCursor[T]

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

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

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

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

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

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

    Permalink
    Attributes
    protected[java.lang]
    Definition Classes
    AnyRef
    Annotations
    @throws( classOf[java.lang.Throwable] )
  17. def fold[A](z: ⇒ A, maxDocs: Int = Int.MaxValue)(suc: (A, T) ⇒ A)(implicit ctx: ExecutionContext): Future[A]

    Permalink

    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.

    z

    the start value.

    maxDocs

    the maximum number of documents to be read.

    suc

    the binary operator to be applied when the next document is successfully read.

    Definition Classes
    Cursor
  18. def foldBulks[A](z: ⇒ A, maxDocs: Int = Int.MaxValue)(suc: (A, Iterator[T]) ⇒ State[A], err: ErrorHandler[A])(implicit ctx: ExecutionContext): Future[A]

    Permalink

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

    maxDocs

    the maximum number of documents to be read.

    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

    Definition Classes
    WrappedCursorCursor
  19. def foldBulksM[A](z: ⇒ A, maxDocs: Int = Int.MaxValue)(suc: (A, Iterator[T]) ⇒ Future[State[A]], err: ErrorHandler[A])(implicit ctx: ExecutionContext): Future[A]

    Permalink

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

    maxDocs

    the maximum number of documents to be read.

    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

    Definition Classes
    WrappedCursorCursor
  20. def foldResponses[A](z: ⇒ A, maxDocs: Int = Int.MaxValue)(suc: (A, Response) ⇒ State[A], err: ErrorHandler[A])(implicit ctx: ExecutionContext): Future[A]

    Permalink

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

    maxDocs

    the maximum number of documents to be read.

    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 foldResponsesM[A](z: ⇒ A, maxDocs: Int = Int.MaxValue)(suc: (A, Response) ⇒ Future[State[A]], err: ErrorHandler[A])(implicit ctx: ExecutionContext): Future[A]

    Permalink

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

    maxDocs

    the maximum number of documents to be read.

    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 foldWhile[A](z: ⇒ A, maxDocs: Int = Int.MaxValue)(suc: (A, T) ⇒ State[A], err: ErrorHandler[A])(implicit ctx: ExecutionContext): Future[A]

    Permalink

    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.

    z

    the start value.

    maxDocs

    the maximum number of documents to be read.

    suc

    The binary operator to be applied when the next document is successfully read.

    err

    the binary operator to be applied when failing to read the next document.

    cursor.foldWhile(Nil: Seq[Person])((s, p) => Cursor.Cont(s :+ p),
      { (l, e) => println("last valid value: " + l); Cursor.Fail(e) })
    Definition Classes
    WrappedCursorCursor
  23. def foldWhileM[A](z: ⇒ A, maxDocs: Int = Int.MaxValue)(suc: (A, T) ⇒ Future[State[A]], err: ErrorHandler[A])(implicit ctx: ExecutionContext): Future[A]

    Permalink

    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.

    z

    the start value.

    maxDocs

    the maximum number of documents to be read.

    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 read the next document.

    cursor.foldWhile(Nil: Seq[Person])((s, p) => Cursor.Cont(s :+ p),
      { (l, e) => println("last valid value: " + l); Cursor.Fail(e) })
    Definition Classes
    WrappedCursorCursor
  24. def formatted(fmtstr: String): String

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

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

    Permalink
    Definition Classes
    AnyRef → Any
  27. def headOption(implicit ctx: ExecutionContext): Future[Option[T]]

    Permalink

    Gets the first document matching the query, if any.

    Gets the first document matching the query, if any. The resulting Future may fail if any exception occurs (for example, while deserializing the document).

    Example:

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

    Permalink
    Definition Classes
    Any
  29. def makeRequest(maxDocs: Int)(implicit ctx: ExecutionContext): Future[Response]

    Permalink
    Definition Classes
    WrappedCursorCursor
  30. final def ne(arg0: AnyRef): Boolean

    Permalink
    Definition Classes
    AnyRef
  31. def nextResponse(maxDocs: Int): (ExecutionContext, Response) ⇒ Future[Option[Response]]

    Permalink
    Definition Classes
    WrappedCursorCursor
  32. final def notify(): Unit

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

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

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

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

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

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

    Permalink
    Definition Classes
    AnyRef
    Annotations
    @throws( ... )
  39. def [B](y: B): (WrappedCursor[T], B)

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

Deprecated Value Members

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

    Permalink

    Produces an Enumerator of documents.

    Produces an Enumerator of documents. Given the stopOnError parameter, this Enumerator may stop on any non-fatal exception, or skip and continue. 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

    Enumerate up to maxDocs documents.

    stopOnError

    States if the produced Enumerator may stop on non-fatal exception.

    returns

    an Enumerator of documents.

    Definition Classes
    WrappedCursorCursor
    Annotations
    @deprecated
    Deprecated

    (Since version 0.11.10) Use the Play Iteratee modules

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

    Permalink

    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

    Enumerate up to maxDocs documents.

    stopOnError

    States if the produced Enumerator may stop on non-fatal exception.

    returns

    an Enumerator of Iterators of documents.

    Definition Classes
    WrappedCursorCursor
    Annotations
    @deprecated
    Deprecated

    (Since version 0.11.10) Use the Play Iteratee modules

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

    Permalink

    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

    Enumerate up to maxDocs documents.

    stopOnError

    States if the produced Enumerator may stop on non-fatal exception.

    returns

    an Enumerator of Responses.

    Definition Classes
    WrappedCursorCursor
    Annotations
    @deprecated
    Deprecated

    (Since version 0.11.10) Use the Play Iteratee modules

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

    Permalink

    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. Consider using enumerateResponses instead.

    maxDocs

    Enumerate up to maxDocs documents.

    returns

    an Enumerator of Responses.

    Definition Classes
    WrappedCursorCursor
    Annotations
    @deprecated
    Deprecated

    (Since version 0.11.10) Use the Play Iteratee modules

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

    Permalink

    Collects all the documents into a List[T].

    Collects all the documents into a List[T]. Given the stopOnError parameter (which defaults to true), the resulting Future may fail if any non-fatal exception occurs. If set to false, all the documents that caused exceptions are skipped.

    maxDocs

    Collect up to maxDocs documents.

    stopOnError

    States if the Future should fail if any non-fatal exception occurs. Example:

    val cursor = collection.find(query, filter).cursor[BSONDocument]
    // return the 3 first documents in a list.
    val list = cursor.toList(3)
    Definition Classes
    Cursor
    Annotations
    @deprecated
    Deprecated

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

Inherited from Cursor[T]

Inherited from AnyRef

Inherited from Any

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

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

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

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

Ungrouped