Trait

reactivemongo.api.collections

GenericQueryBuilder

Related Doc: package collections

Permalink

trait GenericQueryBuilder[P <: SerializationPack] extends QueryOps with QueryCodecs[P]

A builder that helps to make a fine-tuned query to MongoDB.

When the query is ready, you can call cursor to get a Cursor, or one if you want to retrieve just one document.

Linear Supertypes
QueryCodecs[P], QueryOps, AnyRef, Any
Known Subclasses
Ordering
  1. Alphabetic
  2. By Inheritance
Inherited
  1. GenericQueryBuilder
  2. QueryCodecs
  3. QueryOps
  4. AnyRef
  5. 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

Type Members

  1. abstract type Self <: GenericQueryBuilder[pack.type]

    Permalink
    Definition Classes
    GenericQueryBuilderQueryOps

Abstract Value Members

  1. abstract def collection: Collection

    Permalink
  2. abstract def commentString: Option[String]

    Permalink
  3. abstract def copy(queryOption: Option[P.Document] = queryOption, sortOption: Option[P.Document] = sortOption, projectionOption: Option[P.Document] = projectionOption, hintOption: Option[P.Document] = hintOption, explainFlag: Boolean = explainFlag, snapshotFlag: Boolean = snapshotFlag, commentString: Option[String] = commentString, options: QueryOpts = options, failover: FailoverStrategy = failover, maxTimeMsOption: Option[Long] = maxTimeMsOption): Self

    Permalink
  4. abstract def explainFlag: Boolean

    Permalink
  5. abstract def failover: FailoverStrategy

    Permalink
  6. abstract def hintOption: Option[P.Document]

    Permalink
  7. abstract def maxTimeMsOption: Option[Long]

    Permalink
  8. abstract def options: QueryOpts

    Permalink
  9. abstract val pack: P

    Permalink
    Definition Classes
    GenericQueryBuilder → QueryCodecs
  10. abstract def projectionOption: Option[P.Document]

    Permalink
  11. abstract def queryOption: Option[P.Document]

    Permalink
  12. abstract def snapshotFlag: Boolean

    Permalink
  13. abstract def sortOption: Option[P.Document]

    Permalink

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

    Permalink
    Implicit information
    This member is added by an implicit conversion from GenericQueryBuilder[P] to ArrowAssoc[GenericQueryBuilder[P]] 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 awaitData: Self

    Permalink

    Toggles AwaitData: Block a little while waiting for more data instead of returning immediately if no data.

    Toggles AwaitData: Block a little while waiting for more data instead of returning immediately if no data. Use along with TailableCursor.

    Definition Classes
    GenericQueryBuilderQueryOps
  8. def batchSize(n: Int): Self

    Permalink

    Sets an upper limit on the number of documents to retrieve per batch.

    Sets an upper limit on the number of documents to retrieve per batch. Defaults to 0 (meaning no upper limit - MongoDB decides).

    Definition Classes
    GenericQueryBuilderQueryOps
  9. def clone(): AnyRef

    Permalink
    Attributes
    protected[java.lang]
    Definition Classes
    AnyRef
    Annotations
    @throws( ... )
  10. def comment(message: String): Self

    Permalink

    Adds a comment to this query, that may appear in the MongoDB logs.

  11. def cursor[T](readPreference: ReadPreference = readPreference, isMongo26WriteOp: Boolean = false)(implicit reader: P.Reader[T], cp: CursorProducer[T]): ProducedCursor

    Permalink

    Makes a Cursor of this query, which can be enumerated.

    Makes a Cursor of this query, which can be enumerated.

    T

    the results type

    readPreference

    The reactivemongo.api.ReadPreference for this query. If the ReadPreference implies that this query can be run on a secondary, the slaveOk flag will be set.

    reader

    the reader for the results type

  12. def ensuring(cond: (GenericQueryBuilder[P]) ⇒ Boolean, msg: ⇒ Any): GenericQueryBuilder[P]

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

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

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

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

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

    Permalink
    Definition Classes
    AnyRef → Any
  18. def exhaust: Self

    Permalink

    Toggles Exhaust

    Toggles Exhaust

    Definition Classes
    GenericQueryBuilderQueryOps
  19. def explain(flag: Boolean = true): Self

    Permalink

    Toggles explain mode.

  20. def finalize(): Unit

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

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

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

    Permalink
    Definition Classes
    AnyRef → Any
  24. def hint(document: P.Document): Self

    Permalink

    Sets the hint document (a document that declares the index MongoDB should use for this query).

  25. final def isInstanceOf[T0]: Boolean

    Permalink
    Definition Classes
    Any
  26. def maxTimeMs(p: Long): Self

    Permalink

    Adds maxTimeMs to query https://docs.mongodb.org/v3.0/reference/operator/meta/maxTimeMS/

  27. def merge(readPreference: ReadPreference, maxDocs: Int): P.Document

    Permalink
    Attributes
    protected
  28. final def ne(arg0: AnyRef): Boolean

    Permalink
    Definition Classes
    AnyRef
  29. def noCursorTimeout: Self

    Permalink

    Toggles NoCursorTimeout: The cursor will not expire automatically

    Toggles NoCursorTimeout: The cursor will not expire automatically

    Definition Classes
    GenericQueryBuilderQueryOps
  30. final def notify(): Unit

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

    Permalink
    Definition Classes
    AnyRef
  32. def one[T](readPreference: ReadPreference)(implicit reader: P.Reader[T], ec: ExecutionContext): Future[Option[T]]

    Permalink

    Sends this query and gets a future Option[T] (alias for reactivemongo.api.Cursor.headOption).

    Sends this query and gets a future Option[T] (alias for reactivemongo.api.Cursor.headOption).

    T

    the results type

    readPreference

    The reactivemongo.api.ReadPreference for this query. If the ReadPreference implies that this query can be run on a secondary, the slaveOk flag will be set.

    reader

    the reader for the results type

  33. def one[T](implicit reader: P.Reader[T], ec: ExecutionContext): Future[Option[T]]

    Permalink

    Sends this query and gets a future Option[T] (alias for reactivemongo.api.Cursor.headOption).

    Sends this query and gets a future Option[T] (alias for reactivemongo.api.Cursor.headOption).

    T

    the results type

    reader

    the reader for the results type

  34. def oplogReplay: Self

    Permalink

    Toggles OplogReplay

    Toggles OplogReplay

    Definition Classes
    GenericQueryBuilderQueryOps
  35. def options(options: QueryOpts): Self

    Permalink
  36. def partial: Self

    Permalink

    Toggles Partial: The response can be partial - if a shard is down, no error will be thrown.

    Toggles Partial: The response can be partial - if a shard is down, no error will be thrown.

    Definition Classes
    GenericQueryBuilderQueryOps
  37. def projection(p: P.Document): Self

    Permalink

    Sets the projection document (for retrieving only a subset of fields).

  38. def projection[Pjn](p: Pjn)(implicit writer: P.Writer[Pjn]): Self

    Permalink

    Sets the projection document (for retrieving only a subset of fields).

    Sets the projection document (for retrieving only a subset of fields).

    Pjn

    The type of the projection. An implicit Writer[Pjn] typeclass for handling it has to be in the scope.

  39. def query(selector: P.Document): Self

    Permalink

    Sets the query (the selector document).

  40. def query[Qry](selector: Qry)(implicit writer: P.Writer[Qry]): Self

    Permalink

    Sets the selector document.

    Sets the selector document.

    Qry

    The type of the query. An implicit Writer[Qry] typeclass for handling it has to be in the scope.

  41. val readPreference: ReadPreference

    Permalink

    The default ReadPreference

  42. def requireOne[T](readPreference: ReadPreference)(implicit reader: P.Reader[T], ec: ExecutionContext): Future[T]

    Permalink

    Sends this query and gets a future T (alias for reactivemongo.api.Cursor.head).

    Sends this query and gets a future T (alias for reactivemongo.api.Cursor.head).

    T

    the results type

    readPreference

    The reactivemongo.api.ReadPreference for this query. If the ReadPreference implies that this query can be run on a secondary, the slaveOk flag will be set.

    reader

    the reader for the results type

  43. def requireOne[T](implicit reader: P.Reader[T], ec: ExecutionContext): Future[T]

    Permalink

    Sends this query and gets a future T (alias for reactivemongo.api.Cursor.head).

    Sends this query and gets a future T (alias for reactivemongo.api.Cursor.head).

    T

    the results type

    reader

    the reader for the results type

  44. def skip(n: Int): Self

    Permalink

    Sets the number of documents to skip.

    Sets the number of documents to skip.

    Definition Classes
    GenericQueryBuilderQueryOps
  45. def slaveOk: Self

    Permalink

    Toggles SlaveOk: The query is might be run on a secondary.

    Toggles SlaveOk: The query is might be run on a secondary.

    Definition Classes
    GenericQueryBuilderQueryOps
  46. def snapshot(flag: Boolean = true): Self

    Permalink

    Toggles snapshot mode.

  47. def sort(document: P.Document): Self

    Permalink

    Sets the sorting document.

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

    Permalink
    Definition Classes
    AnyRef
  49. def tailable: Self

    Permalink

    Toggles TailableCursor: Makes the cursor not to close after all the data is consumed.

    Toggles TailableCursor: Makes the cursor not to close after all the data is consumed.

    Definition Classes
    GenericQueryBuilderQueryOps
  50. def toString(): String

    Permalink
    Definition Classes
    AnyRef → Any
  51. lazy val version: MongoWireVersion

    Permalink
    Attributes
    protected
  52. final def wait(): Unit

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

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

    Permalink
    Definition Classes
    AnyRef
    Annotations
    @throws( ... )
  55. def [B](y: B): (GenericQueryBuilder[P], B)

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

Deprecated Value Members

  1. def merge(readPreference: ReadPreference): P.Document

    Permalink
    Annotations
    @deprecated
    Deprecated

    (Since version 0.12.0) Will be removed from the public API

  2. def updateOptions(update: (QueryOpts) ⇒ QueryOpts): Self

    Permalink
    Annotations
    @deprecated
    Deprecated

    (Since version 0.12.4) Use options or the separate query ops

Inherited from QueryCodecs[P]

Inherited from QueryOps

Inherited from AnyRef

Inherited from Any

Inherited by implicit conversion any2stringadd from GenericQueryBuilder[P] to any2stringadd[GenericQueryBuilder[P]]

Inherited by implicit conversion StringFormat from GenericQueryBuilder[P] to StringFormat[GenericQueryBuilder[P]]

Inherited by implicit conversion Ensuring from GenericQueryBuilder[P] to Ensuring[GenericQueryBuilder[P]]

Inherited by implicit conversion ArrowAssoc from GenericQueryBuilder[P] to ArrowAssoc[GenericQueryBuilder[P]]

Ungrouped