com.google.cloud.firestore

Class Query

java.lang.Object

com.google.cloud.firestore.Query

Direct Known Subclasses:

CollectionReference

public class Query
extends Object

A Query which you can read or listen to. You can also construct refined Query objects by adding filters and ordering.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	Query.Direction The direction of a sort.

Method Summary

Modifier and Type	Method and Description
ListenerRegistration	addSnapshotListener(EventListener<QuerySnapshot> listener) Starts listening to this query.
ListenerRegistration	addSnapshotListener(Executor executor, EventListener<QuerySnapshot> listener) Starts listening to this query.
Query	endAt(DocumentSnapshot snapshot) Creates and returns a new Query that ends at the provided document (inclusive).
Query	endAt(Object... fieldValues) Creates and returns a new Query that ends at the provided fields relative to the order of the query.
Query	endBefore(DocumentSnapshot snapshot) Creates and returns a new Query that ends before the provided document (exclusive).
Query	endBefore(Object... fieldValues) Creates and returns a new Query that ends before the provided fields relative to the order of the query.
boolean	equals(Object obj) Returns true if this Query is equal to the provided object.
com.google.api.core.ApiFuture<QuerySnapshot>	get() Executes the query and returns the results as QuerySnapshot.
Firestore	getFirestore() Gets the Firestore instance associated with this query.
int	hashCode()
Query	limit(int limit) Creates and returns a new Query that's additionally limited to only return up to the specified number of documents.
Query	offset(int offset) Creates and returns a new Query that skips the first n results.
Query	orderBy(FieldPath fieldPath) Creates and returns a new Query that's additionally sorted by the specified field.
Query	orderBy(FieldPath fieldPath, Query.Direction direction) Creates and returns a new Query that's additionally sorted by the specified field, optionally in descending order instead of ascending.
Query	orderBy(String field) Creates and returns a new Query that's additionally sorted by the specified field.
Query	orderBy(String field, Query.Direction direction) Creates and returns a new Query that's additionally sorted by the specified field, optionally in descending order instead of ascending.
Query	select(FieldPath... fieldPaths) Creates and returns a new Query instance that applies a field mask to the result and returns the specified subset of fields.
Query	select(String... fields) Creates and returns a new Query instance that applies a field mask to the result and returns the specified subset of fields.
Query	startAfter(DocumentSnapshot snapshot) Creates and returns a new Query that starts after the provided document (exclusive).
Query	startAfter(Object... fieldValues) Creates and returns a new Query that starts after the provided fields relative to the order of the query.
Query	startAt(DocumentSnapshot snapshot) Creates and returns a new Query that starts at the provided document (inclusive).
Query	startAt(Object... fieldValues) Creates and returns a new Query that starts at the provided fields relative to the order of the query.
void	stream(com.google.api.gax.rpc.ApiStreamObserver<DocumentSnapshot> responseObserver) Executes the query and streams the results as a StreamObserver of DocumentSnapshots.
Query	whereArrayContains(FieldPath fieldPath, Object value) Creates and returns a new Query with the additional filter that documents must contain the specified field, the value must be an array, and that the array must contain the provided value.
Query	whereArrayContains(String field, Object value) Creates and returns a new Query with the additional filter that documents must contain the specified field, the value must be an array, and that the array must contain the provided value.
Query	whereArrayContainsAny(FieldPath fieldPath, List<? extends Object> values) Creates and returns a new Query with the additional filter that documents must contain the specified field, the value must be an array, and that the array must contain at least one value from the provided list.
Query	whereArrayContainsAny(String field, List<? extends Object> values) Creates and returns a new Query with the additional filter that documents must contain the specified field, the value must be an array, and that the array must contain at least one value from the provided list.
Query	whereEqualTo(FieldPath fieldPath, Object value) Creates and returns a new Query with the additional filter that documents must contain the specified field and the value should be equal to the specified value.
Query	whereEqualTo(String field, Object value) Creates and returns a new Query with the additional filter that documents must contain the specified field and the value should be equal to the specified value.
Query	whereGreaterThan(FieldPath fieldPath, Object value) Creates and returns a new Query with the additional filter that documents must contain the specified field and the value should be greater than the specified value.
Query	whereGreaterThan(String field, Object value) Creates and returns a new Query with the additional filter that documents must contain the specified field and the value should be greater than the specified value.
Query	whereGreaterThanOrEqualTo(FieldPath fieldPath, Object value) Creates and returns a new Query with the additional filter that documents must contain the specified field and the value should be greater than or equal to the specified value.
Query	whereGreaterThanOrEqualTo(String field, Object value) Creates and returns a new Query with the additional filter that documents must contain the specified field and the value should be greater than or equal to the specified value.
Query	whereIn(FieldPath fieldPath, List<? extends Object> values) Creates and returns a new Query with the additional filter that documents must contain the specified field and the value must equal one of the values from the provided list.
Query	whereIn(String field, List<? extends Object> values) Creates and returns a new Query with the additional filter that documents must contain the specified field and the value must equal one of the values from the provided list.
Query	whereLessThan(FieldPath fieldPath, Object value) Creates and returns a new Query with the additional filter that documents must contain the specified field and the value should be less than the specified value.
Query	whereLessThan(String field, Object value) Creates and returns a new Query with the additional filter that documents must contain the specified field and the value should be less than the specified value.
Query	whereLessThanOrEqualTo(FieldPath fieldPath, Object value) Creates and returns a new Query with the additional filter that documents must contain the specified field and the value should be less or equal to the specified value.
Query	whereLessThanOrEqualTo(String field, Object value) Creates and returns a new Query with the additional filter that documents must contain the specified field and the value should be less or equal to the specified value.

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, toString, wait, wait, wait

Method Detail

getFirestore

@Nonnull
public Firestore getFirestore()

Gets the Firestore instance associated with this query.

Returns:

The Firestore instance associated with this query.

whereEqualTo

@Nonnull
public Query whereEqualTo(@Nonnull
                                   String field,
                                   @Nullable
                                   Object value)

Creates and returns a new Query with the additional filter that documents must contain the specified field and the value should be equal to the specified value.

Parameters:

field - The name of the field to compare.

value - The value for comparison.

Returns:

The created Query.

whereEqualTo

@Nonnull
public Query whereEqualTo(@Nonnull
                                   FieldPath fieldPath,
                                   @Nullable
                                   Object value)

Creates and returns a new Query with the additional filter that documents must contain the specified field and the value should be equal to the specified value.

Parameters:

fieldPath - The path of the field to compare.

value - The value for comparison.

Returns:

The created Query.

whereLessThan

@Nonnull
public Query whereLessThan(@Nonnull
                                    String field,
                                    @Nonnull
                                    Object value)

Creates and returns a new Query with the additional filter that documents must contain the specified field and the value should be less than the specified value.

Parameters:

field - The name of the field to compare.

value - The value for comparison.

Returns:

The created Query.

whereLessThan

@Nonnull
public Query whereLessThan(@Nonnull
                                    FieldPath fieldPath,
                                    @Nonnull
                                    Object value)

Creates and returns a new Query with the additional filter that documents must contain the specified field and the value should be less than the specified value.

Parameters:

fieldPath - The path of the field to compare.

value - The value for comparison.

Returns:

The created Query.

whereLessThanOrEqualTo

@Nonnull
public Query whereLessThanOrEqualTo(@Nonnull
                                             String field,
                                             @Nonnull
                                             Object value)

Creates and returns a new Query with the additional filter that documents must contain the specified field and the value should be less or equal to the specified value.

Parameters:

field - The name of the field to compare.

value - The value for comparison.

Returns:

The created Query.

whereLessThanOrEqualTo

@Nonnull
public Query whereLessThanOrEqualTo(@Nonnull
                                             FieldPath fieldPath,
                                             @Nonnull
                                             Object value)

Creates and returns a new Query with the additional filter that documents must contain the specified field and the value should be less or equal to the specified value.

Parameters:

fieldPath - The path of the field to compare.

value - The value for comparison.

Returns:

The created Query.

whereGreaterThan

@Nonnull
public Query whereGreaterThan(@Nonnull
                                       String field,
                                       @Nonnull
                                       Object value)

Creates and returns a new Query with the additional filter that documents must contain the specified field and the value should be greater than the specified value.

Parameters:

field - The name of the field to compare.

value - The value for comparison.

Returns:

The created Query.

whereGreaterThan

@Nonnull
public Query whereGreaterThan(@Nonnull
                                       FieldPath fieldPath,
                                       @Nonnull
                                       Object value)

Creates and returns a new Query with the additional filter that documents must contain the specified field and the value should be greater than the specified value.

Parameters:

fieldPath - The path of the field to compare.

value - The value for comparison.

Returns:

The created Query.

whereGreaterThanOrEqualTo

@Nonnull
public Query whereGreaterThanOrEqualTo(@Nonnull
                                                String field,
                                                @Nonnull
                                                Object value)

Creates and returns a new Query with the additional filter that documents must contain the specified field and the value should be greater than or equal to the specified value.

Parameters:

field - The name of the field to compare.

value - The value for comparison.

Returns:

The created Query.

whereGreaterThanOrEqualTo

@Nonnull
public Query whereGreaterThanOrEqualTo(@Nonnull
                                                FieldPath fieldPath,
                                                @Nonnull
                                                Object value)

Creates and returns a new Query with the additional filter that documents must contain the specified field and the value should be greater than or equal to the specified value.

Parameters:

fieldPath - The path of the field to compare.

value - The value for comparison.

Returns:

The created Query.

whereArrayContains

@Nonnull
public Query whereArrayContains(@Nonnull
                                         String field,
                                         @Nonnull
                                         Object value)

Creates and returns a new Query with the additional filter that documents must contain the specified field, the value must be an array, and that the array must contain the provided value.

A Query can have only one whereArrayContains() filter.

Parameters:

field - The name of the field containing an array to search

value - The value that must be contained in the array

Returns:

The created Query.

whereArrayContains

@Nonnull
public Query whereArrayContains(@Nonnull
                                         FieldPath fieldPath,
                                         @Nonnull
                                         Object value)

Creates and returns a new Query with the additional filter that documents must contain the specified field, the value must be an array, and that the array must contain the provided value.

A Query can have only one whereArrayContains() filter.

Parameters:

fieldPath - The path of the field containing an array to search

value - The value that must be contained in the array

Returns:

The created Query.

whereArrayContainsAny

@Nonnull
public Query whereArrayContainsAny(@Nonnull
                                            String field,
                                            @Nonnull
                                            List<? extends Object> values)

Creates and returns a new Query with the additional filter that documents must contain the specified field, the value must be an array, and that the array must contain at least one value from the provided list.

A Query can have only one whereArrayContainsAny() filter and it cannot be combined with whereArrayContains() or whereIn().

Parameters:

field - The name of the field containing an array to search.

values - A list that contains the values to match.

Returns:

The created Query.

whereArrayContainsAny

@Nonnull
public Query whereArrayContainsAny(@Nonnull
                                            FieldPath fieldPath,
                                            @Nonnull
                                            List<? extends Object> values)

Creates and returns a new Query with the additional filter that documents must contain the specified field, the value must be an array, and that the array must contain at least one value from the provided list.

A Query can have only one whereArrayContainsAny() filter and it cannot be combined with whereArrayContains() or whereIn().

Parameters:

fieldPath - The path of the field containing an array to search.

values - A list that contains the values to match.

Returns:

The created Query.

whereIn

@Nonnull
public Query whereIn(@Nonnull
                              String field,
                              @Nonnull
                              List<? extends Object> values)

Creates and returns a new Query with the additional filter that documents must contain the specified field and the value must equal one of the values from the provided list.

A Query can have only one whereIn() filter, and it cannot be combined with whereArrayContainsAny().

Parameters:

field - The name of the field to search.

values - A list that contains the values to match.

Returns:

The created Query.

whereIn

@Nonnull
public Query whereIn(@Nonnull
                              FieldPath fieldPath,
                              @Nonnull
                              List<? extends Object> values)

Creates and returns a new Query with the additional filter that documents must contain the specified field and the value must equal one of the values from the provided list.

A Query can have only one whereIn() filter, and it cannot be combined with whereArrayContainsAny().

Parameters:

fieldPath - The path of the field to search.

values - A list that contains the values to match.

Returns:

The created Query.

orderBy

@Nonnull
public Query orderBy(@Nonnull
                              String field)

Creates and returns a new Query that's additionally sorted by the specified field.

Parameters:

field - The field to sort by.

Returns:

The created Query.

orderBy

@Nonnull
public Query orderBy(@Nonnull
                              FieldPath fieldPath)

Creates and returns a new Query that's additionally sorted by the specified field.

Parameters:

fieldPath - The field to sort by.

Returns:

The created Query.

orderBy

@Nonnull
public Query orderBy(@Nonnull
                              String field,
                              @Nonnull
                              Query.Direction direction)

Creates and returns a new Query that's additionally sorted by the specified field, optionally in descending order instead of ascending.

Parameters:

field - The field to sort by.

direction - The direction to sort.

Returns:

The created Query.

orderBy

@Nonnull
public Query orderBy(@Nonnull
                              FieldPath fieldPath,
                              @Nonnull
                              Query.Direction direction)

Creates and returns a new Query that's additionally sorted by the specified field, optionally in descending order instead of ascending.

Parameters:

fieldPath - The field to sort by.

direction - The direction to sort.

Returns:

The created Query.

limit

@Nonnull
public Query limit(int limit)

Creates and returns a new Query that's additionally limited to only return up to the specified number of documents.

Parameters:

limit - The maximum number of items to return.

Returns:

The created Query.

offset

@Nonnull
public Query offset(int offset)

Creates and returns a new Query that skips the first n results.

Parameters:

offset - The number of items to skip.

Returns:

The created Query.

startAt

@Nonnull
public Query startAt(@Nonnull
                              DocumentSnapshot snapshot)

Creates and returns a new Query that starts at the provided document (inclusive). The starting position is relative to the order of the query. The document must contain all of the fields provided in the orderBy of this query.

Parameters:

snapshot - The snapshot of the document to start at.

Returns:

The created Query.

startAt

@Nonnull
public Query startAt(Object... fieldValues)

Creates and returns a new Query that starts at the provided fields relative to the order of the query. The order of the field values must match the order of the order by clauses of the query.

Parameters:

fieldValues - The field values to start this query at, in order of the query's order by.

Returns:

The created Query.

select

@Nonnull
public Query select(String... fields)

Creates and returns a new Query instance that applies a field mask to the result and returns the specified subset of fields. You can specify a list of field paths to return, or use an empty list to only return the references of matching documents.

Parameters:

fields - The fields to include.

Returns:

The created Query.

select

@Nonnull
public Query select(FieldPath... fieldPaths)

Creates and returns a new Query instance that applies a field mask to the result and returns the specified subset of fields. You can specify a list of field paths to return, or use an empty list to only return the references of matching documents.

Parameters:

fieldPaths - The field paths to include.

Returns:

The created Query.

startAfter

@Nonnull
public Query startAfter(@Nonnull
                                 DocumentSnapshot snapshot)

Creates and returns a new Query that starts after the provided document (exclusive). The starting position is relative to the order of the query. The document must contain all of the fields provided in the orderBy of this query.

Parameters:

snapshot - The snapshot of the document to start after.

Returns:

The created Query.

startAfter

public Query startAfter(Object... fieldValues)

Creates and returns a new Query that starts after the provided fields relative to the order of the query. The order of the field values must match the order of the order by clauses of the query.

Parameters:

fieldValues - The field values to start this query after, in order of the query's order by.

Returns:

The created Query.

endBefore

@Nonnull
public Query endBefore(@Nonnull
                                DocumentSnapshot snapshot)

Creates and returns a new Query that ends before the provided document (exclusive). The end position is relative to the order of the query. The document must contain all of the fields provided in the orderBy of this query.

Parameters:

snapshot - The snapshot of the document to end before.

Returns:

The created Query.

endBefore

@Nonnull
public Query endBefore(Object... fieldValues)

Creates and returns a new Query that ends before the provided fields relative to the order of the query. The order of the field values must match the order of the order by clauses of the query.

Parameters:

fieldValues - The field values to end this query before, in order of the query's order by.

Returns:

The created Query.

endAt

@Nonnull
public Query endAt(Object... fieldValues)

Creates and returns a new Query that ends at the provided fields relative to the order of the query. The order of the field values must match the order of the order by clauses of the query.

Parameters:

fieldValues - The field values to end this query at, in order of the query's order by.

Returns:

The created Query.

endAt

@Nonnull
public Query endAt(@Nonnull
                            DocumentSnapshot snapshot)

Creates and returns a new Query that ends at the provided document (inclusive). The end position is relative to the order of the query. The document must contain all of the fields provided in the orderBy of this query.

Parameters:

snapshot - The snapshot of the document to end at.

Returns:

The created Query.

stream

public void stream(@Nonnull
                   com.google.api.gax.rpc.ApiStreamObserver<DocumentSnapshot> responseObserver)

Executes the query and streams the results as a StreamObserver of DocumentSnapshots.

Parameters:

responseObserver - The observer to be notified when results arrive.

get

@Nonnull
public com.google.api.core.ApiFuture<QuerySnapshot> get()

Executes the query and returns the results as QuerySnapshot.

Returns:

An ApiFuture that will be resolved with the results of the Query.

addSnapshotListener

@Nonnull
public ListenerRegistration addSnapshotListener(@Nonnull
                                                         EventListener<QuerySnapshot> listener)

Starts listening to this query.

Parameters:

listener - The event listener that will be called with the snapshots.

Returns:

A registration object that can be used to remove the listener.

addSnapshotListener

@Nonnull
public ListenerRegistration addSnapshotListener(@Nonnull
                                                         Executor executor,
                                                         @Nonnull
                                                         EventListener<QuerySnapshot> listener)

Starts listening to this query.

Parameters:

executor - The executor to use to call the listener.

listener - The event listener that will be called with the snapshots.

Returns:

A registration object that can be used to remove the listener.

equals

public boolean equals(Object obj)

Returns true if this Query is equal to the provided object.

Overrides:

equals in class Object

Parameters:

obj - The object to compare against.

Returns:

Whether this Query is equal to the provided object.

hashCode

public int hashCode()

Overrides:

hashCode in class Object