PlayIterateesCursor

Abstract Value Members

abstract def bulkEnumerator(maxDocs: Int = Int.MaxValue, err: ErrorHandler[Unit] = FailOnError[Unit]())(implicit ctx: ExecutionContext): Enumerator[Iterator[T]]

Produces an Enumerator of Iterator of documents.
Produces an Enumerator of Iterator of documents.
maxDocs
Enumerate 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. Only the errors when reading the inputs from the DB will be handle: if then an Iteratee is failing to process, the error is out of this mechanism scope.
returns
an Enumerator of Iterators of documents.
abstract def collect[M[_]](maxDocs: Int, err: ErrorHandler[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.
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
Cursor
abstract def enumerator(maxDocs: Int = Int.MaxValue, err: ErrorHandler[Unit] = FailOnError[Unit]())(implicit ctx: ExecutionContext): Enumerator[T]

Produces an Enumerator of documents.
Produces an Enumerator of documents.
maxDocs
Enumerate 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. Only the errors when reading the inputs from the DB will be handle: if then an Iteratee is failing to process, the error is out of this mechanism scope.
returns
an Enumerator of documents.
abstract def foldBulks[A](z: ⇒ A, maxDocs: Int = Int.MaxValue)(suc: (A, Iterator[T]) ⇒ State[A], err: ErrorHandler[A] = FailOnError[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. 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
Cursor
abstract def foldBulksM[A](z: ⇒ A, maxDocs: Int = Int.MaxValue)(suc: (A, Iterator[T]) ⇒ Future[State[A]], err: ErrorHandler[A] = FailOnError[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. 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
Cursor
abstract def foldResponses[A](z: ⇒ A, maxDocs: Int = Int.MaxValue)(suc: (A, Response) ⇒ State[A], err: ErrorHandler[A] = FailOnError[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. 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
Cursor
abstract def foldResponsesM[A](z: ⇒ A, maxDocs: Int = Int.MaxValue)(suc: (A, Response) ⇒ Future[State[A]], err: ErrorHandler[A] = FailOnError[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. 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
Cursor
abstract def foldWhile[A](z: ⇒ A, maxDocs: Int = Int.MaxValue)(suc: (A, T) ⇒ State[A], err: ErrorHandler[A] = FailOnError[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.
z
the initial value
maxDocs
The maximum number of documents to be retrieved.
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.
```
cursor.foldWhile(Nil: Seq[Person])((s, p) => Cursor.Cont(s :+ p),
  { (l, e) => println("last valid value: " + l); Cursor.Fail(e) })
```
Definition Classes
Cursor
abstract def foldWhileM[A](z: ⇒ A, maxDocs: Int = Int.MaxValue)(suc: (A, T) ⇒ Future[State[A]], err: ErrorHandler[A] = FailOnError[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.
z
the initial value
maxDocs
The maximum number of documents to be retrieved.
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.
```
cursor.foldWhileM(Nil: Seq[Person])(
  (s, p) => Future.successful(Cursor.Cont(s :+ p)),
  { (l, e) => Future {
    println("last valid value: " + l)
    Cursor.Fail(e)
  })
```
Definition Classes
Cursor
abstract def responseEnumerator(maxDocs: Int = Int.MaxValue, err: ErrorHandler[Unit] = FailOnError[Unit]())(implicit ctx: ExecutionContext): Enumerator[Response]

Produces an Enumerator of responses from the database.
Produces an Enumerator of responses from the database.
maxDocs
Enumerate 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. Only the errors when reading the inputs from the DB will be handle: if then an Iteratee is failing to process, the error is out of this mechanism scope.
returns
an Enumerator of Responses.
abstract def enumerate(maxDocs: Int = Int.MaxValue, stopOnError: Boolean = false)(implicit ctx: ExecutionContext): Enumerator[T]

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
The maximum number of documents to be retrieved.
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 Enumerator of documents.

Definition Classes
Cursor
Annotations
@deprecated
Deprecated
(Since version 0.11.10) Use .enumerator from Play Iteratee modules
abstract def enumerateBulks(maxDocs: Int = Int.MaxValue, 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. 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 Enumerator of Iterators of documents.

Definition Classes
Cursor
Annotations
@deprecated
Deprecated
(Since version 0.11.10) Use .bulkEnumerator from the Play Iteratee modules
abstract def enumerateResponses(maxDocs: Int = Int.MaxValue, 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. 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 Enumerator of Responses.

Definition Classes
Cursor
Annotations
@deprecated
Deprecated
(Since version 0.11.10) Use .responseEnumerator from the Play Iteratee modules
abstract def rawEnumerateResponses(maxDocs: Int = Int.MaxValue)(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. Consider using enumerateResponses instead.
maxDocs
The maximum number of documents to be retrieved

Definition Classes
Cursor
Annotations
@deprecated
Deprecated
(Since version 0.11.10) Use the Play Iteratee modules

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

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

Definition Classes
AnyRef → 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 = Int.MaxValue, 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.
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.. 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
Cursor
def ensuring(cond: (PlayIterateesCursor[T]) ⇒ Boolean, msg: ⇒ Any): PlayIterateesCursor[T]

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

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

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

Implicit information
This member is added by an implicit conversion from PlayIterateesCursor[T] to Ensuring[PlayIterateesCursor[T]] 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 fold[A](z: ⇒ A, maxDocs: Int = Int.MaxValue)(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.
z
the initial value
maxDocs
The maximum number of documents to be retrieved.
suc
the binary operator to be applied when the next document is successfully read.

Definition Classes
Cursor
def formatted(fmtstr: String): String

Implicit information
This member is added by an implicit conversion from PlayIterateesCursor[T] to StringFormat[PlayIterateesCursor[T]] 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
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.
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
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): (PlayIterateesCursor[T], B)

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

Deprecated Value Members

def toList(maxDocs: Int = Int.MaxValue, 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

Inherited from Cursor[T]

Inherited from AnyRef

Inherited from Any

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

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

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

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

Ungrouped

Related Doc: package iteratees

sealed trait PlayIterateesCursor[T] extends Cursor[T]

Abstract Value Members

abstract def bulkEnumerator(maxDocs: Int = Int.MaxValue, err: ErrorHandler[Unit] = FailOnError[Unit]())(implicit ctx: ExecutionContext): Enumerator[Iterator[T]]

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

abstract def enumerator(maxDocs: Int = Int.MaxValue, err: ErrorHandler[Unit] = FailOnError[Unit]())(implicit ctx: ExecutionContext): Enumerator[T]

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

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

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

abstract def foldResponsesM[A](z: ⇒ A, maxDocs: Int = Int.MaxValue)(suc: (A, Response) ⇒ Future[State[A]], err: ErrorHandler[A] = FailOnError[A]())(implicit ctx: ExecutionContext): Future[A]

abstract def foldWhile[A](z: ⇒ A, maxDocs: Int = Int.MaxValue)(suc: (A, T) ⇒ State[A], err: ErrorHandler[A] = FailOnError[A]())(implicit ctx: ExecutionContext): Future[A]

abstract def foldWhileM[A](z: ⇒ A, maxDocs: Int = Int.MaxValue)(suc: (A, T) ⇒ Future[State[A]], err: ErrorHandler[A] = FailOnError[A]())(implicit ctx: ExecutionContext): Future[A]

abstract def responseEnumerator(maxDocs: Int = Int.MaxValue, err: ErrorHandler[Unit] = FailOnError[Unit]())(implicit ctx: ExecutionContext): Enumerator[Response]

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

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

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

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

Concrete Value Members

final def !=(arg0: Any): Boolean

final def ##(): Int

def +(other: String): String

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

final def ==(arg0: Any): Boolean

final def asInstanceOf[T0]: T0

def clone(): AnyRef

def collect[M[_]](maxDocs: Int = Int.MaxValue, stopOnError: Boolean = true)(implicit cbf: CanBuildFrom[M[_], T, M[T]], ec: ExecutionContext): Future[M[T]]

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

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

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

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

final def eq(arg0: AnyRef): Boolean

def equals(arg0: Any): Boolean

def finalize(): Unit

def fold[A](z: ⇒ A, maxDocs: Int = Int.MaxValue)(suc: (A, T) ⇒ A)(implicit ctx: ExecutionContext): Future[A]

def formatted(fmtstr: String): String

final def getClass(): Class[_]

def hashCode(): Int

def headOption(implicit ctx: 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): (PlayIterateesCursor[T], B)

Deprecated Value Members

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

Inherited from Cursor[T]

Inherited from AnyRef

Inherited from Any

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

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

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

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

Ungrouped