com.google.cloud.firestore

Class Transaction

java.lang.Object

com.google.cloud.firestore.UpdateBuilder<Transaction>

com.google.cloud.firestore.Transaction

public final class Transaction
extends UpdateBuilder<Transaction>

A Transaction is passed to a Function to provide the methods to read and write data within the transaction context.

See Also:

Firestore#runTransaction(Function)

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static interface	Transaction.AsyncFunction<T> User callback that takes a Firestore Async Transaction.
static interface	Transaction.Function<T> User callback that takes a Firestore Transaction.

Field Summary

Fields inherited from class com.google.cloud.firestore.UpdateBuilder

committed

Method Summary

Modifier and Type	Method and Description
com.google.api.core.ApiFuture<AggregateQuerySnapshot>	get(AggregateQuery query) Returns the result from the provided aggregate query.
com.google.api.core.ApiFuture<DocumentSnapshot>	get(DocumentReference documentRef) Reads the document referred to by the provided DocumentReference.
com.google.api.core.ApiFuture<QuerySnapshot>	get(Query query) Returns the result set from the provided query.
com.google.api.core.ApiFuture<List<DocumentSnapshot>>	getAll(DocumentReference... documentReferences) Retrieves multiple documents from Firestore.
com.google.api.core.ApiFuture<List<DocumentSnapshot>>	getAll(DocumentReference[] documentReferences, FieldMask fieldMask) Retrieves multiple documents from Firestore, while optionally applying a field mask to reduce the amount of data transmitted from the backend.
boolean	hasTransactionId()

Methods inherited from class com.google.cloud.firestore.UpdateBuilder

create, create, delete, delete, getMutationsSize, set, set, set, set, toString, update, update, update, update, update, update

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Method Detail

hasTransactionId

public boolean hasTransactionId()

get

@Nonnull
public com.google.api.core.ApiFuture<DocumentSnapshot> get(@Nonnull
                                                                    DocumentReference documentRef)

Reads the document referred to by the provided DocumentReference. Holds a pessimistic lock on the returned document.

Returns:

The contents of the Document at this DocumentReference.

getAll

@Nonnull
public com.google.api.core.ApiFuture<List<DocumentSnapshot>> getAll(@Nonnull
                                                                             DocumentReference... documentReferences)

Retrieves multiple documents from Firestore. Holds a pessimistic lock on all returned documents.

Parameters:

documentReferences - List of Document References to fetch.

getAll

@Nonnull
public com.google.api.core.ApiFuture<List<DocumentSnapshot>> getAll(@Nonnull
                                                                             DocumentReference[] documentReferences,
                                                                             @Nullable
                                                                             FieldMask fieldMask)

Retrieves multiple documents from Firestore, while optionally applying a field mask to reduce the amount of data transmitted from the backend. Holds a pessimistic lock on all returned documents.

Parameters:

documentReferences - Array with Document References to fetch.

fieldMask - If set, specifies the subset of fields to return.

get

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

Returns the result set from the provided query. Holds a pessimistic lock on all returned documents.

Returns:

The contents of the Document at this DocumentReference.

get

@Nonnull
public com.google.api.core.ApiFuture<AggregateQuerySnapshot> get(@Nonnull
                                                                          AggregateQuery query)

Returns the result from the provided aggregate query. Holds a pessimistic lock on all accessed documents.

Returns:

The result of the aggregation.