Class QuerySnapshot (3.22.0)

public abstract class QuerySnapshot implements Iterable<QueryDocumentSnapshot>

A QuerySnapshot contains the results of a query. It can contain zero or more DocumentSnapshot objects.

Inheritance

Object > QuerySnapshot

Static Methods

withChanges(Query query, Timestamp readTime, DocumentSet documentSet, List<DocumentChange> documentChanges)

public static QuerySnapshot withChanges(Query query, Timestamp readTime, DocumentSet documentSet, List<DocumentChange> documentChanges)

Creates a new QuerySnapshot representing a snapshot of a Query with changed documents.

Parameters
Name Description
query Query
readTime com.google.cloud.Timestamp
documentSet com.google.cloud.firestore.DocumentSet
documentChanges List<DocumentChange>
Returns
Type Description
QuerySnapshot

withDocuments(Query query, Timestamp readTime, List<QueryDocumentSnapshot> documents)

public static QuerySnapshot withDocuments(Query query, Timestamp readTime, List<QueryDocumentSnapshot> documents)

Creates a new QuerySnapshot representing the results of a Query with added documents.

Parameters
Name Description
query Query
readTime com.google.cloud.Timestamp
documents List<QueryDocumentSnapshot>
Returns
Type Description
QuerySnapshot

Constructors

QuerySnapshot(Query query, Timestamp readTime)

protected QuerySnapshot(Query query, Timestamp readTime)
Parameters
Name Description
query Query
readTime com.google.cloud.Timestamp

Methods

<T>toObjects(Class<T> clazz)

public List<T> <T>toObjects(Class<T> clazz)

Returns the contents of the documents in the QuerySnapshot, converted to the provided class, as a list.

Parameter
Name Description
clazz Class<T>

The POJO type used to convert the documents in the list.

Returns
Type Description
List<T>

equals(Object obj)

public abstract boolean equals(Object obj)

Returns true if the document data in this QuerySnapshot equals the provided snapshot.

Parameter
Name Description
obj Object

The object to compare against.

Returns
Type Description
boolean

Whether this QuerySnapshot is equal to the provided object.

Overrides

getDocumentChanges()

public abstract List<DocumentChange> getDocumentChanges()

Returns the list of documents that changed since the last snapshot. If it's the first snapshot all documents will be in the list as added changes.

Returns
Type Description
List<DocumentChange>

The list of documents that changed since the last snapshot.

getDocuments()

public abstract List<QueryDocumentSnapshot> getDocuments()

Returns the documents in this QuerySnapshot as a List in order of the query.

Returns
Type Description
List<QueryDocumentSnapshot>

The list of documents.

getQuery()

public Query getQuery()

Returns the query for the snapshot.

Returns
Type Description
Query

The backing query that produced this snapshot.

getReadTime()

public Timestamp getReadTime()

Returns the time at which this snapshot was read.

Returns
Type Description
com.google.cloud.Timestamp

The read time of this snapshot.

hashCode()

public abstract int hashCode()
Returns
Type Description
int
Overrides

isEmpty()

public boolean isEmpty()

Returns true if there are no documents in the QuerySnapshot.

Returns
Type Description
boolean

iterator()

public Iterator<QueryDocumentSnapshot> iterator()
Returns
Type Description
Iterator<QueryDocumentSnapshot>

size()

public abstract int size()

Returns the number of documents in the QuerySnapshot.

Returns
Type Description
int