Class Transaction (3.30.0)

public abstract 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)

Inheritance

java.lang.Object > UpdateBuilder > Transaction

Inherited Members

UpdateBuilder.className()

UpdateBuilder.create(DocumentReference,Object)

UpdateBuilder.create(DocumentReference,Map<String,Object>)

UpdateBuilder.delete(DocumentReference)

UpdateBuilder.delete(DocumentReference,Precondition)

UpdateBuilder.getMutationsSize()

UpdateBuilder.set(DocumentReference,Object)

UpdateBuilder.set(DocumentReference,Object,SetOptions)

UpdateBuilder.set(DocumentReference,Map<String,Object>)

UpdateBuilder.set(DocumentReference,Map<String,Object>,SetOptions)

UpdateBuilder.toString()

UpdateBuilder.update(DocumentReference,FieldPath,Object,Object)

UpdateBuilder.update(DocumentReference,Precondition,FieldPath,Object,Object)

UpdateBuilder.update(DocumentReference,Precondition,String,Object,Object)

UpdateBuilder.update(DocumentReference,String,Object,Object)

UpdateBuilder.update(DocumentReference,Map<String,Object>)

UpdateBuilder.update(DocumentReference,Map<String,Object>,Precondition)

Object.clone()

Object.equals(Object)

Object.finalize()

Object.getClass()

Object.hashCode()

Object.notify()

Object.notifyAll()

Object.wait()

Object.wait(long)

Object.wait(long,int)

Constructors

Transaction(FirestoreImpl firestore)

protected Transaction(FirestoreImpl firestore)

Parameter
Name	Description
`firestore`	`com.google.cloud.firestore.FirestoreImpl`

Fields

transactionTraceContext

protected TraceUtil.Context transactionTraceContext

Field Value
Type	Description
`TraceUtil.Context`

Methods

className()

protected String className()

Returns
Type	Description
`String`

Overrides

UpdateBuilder<T>.className()

get(AggregateQuery query)

public abstract ApiFuture<AggregateQuerySnapshot> get(AggregateQuery query)

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

Parameter
Name	Description
`query`	`AggregateQuery`

Returns
Type	Description
`ApiFuture<AggregateQuerySnapshot>`	The result of the aggregation.

get(DocumentReference documentRef)

public abstract ApiFuture<DocumentSnapshot> get(DocumentReference documentRef)

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

Parameter
Name	Description
`documentRef`	`DocumentReference`

Returns
Type	Description
`ApiFuture<DocumentSnapshot>`	The contents of the Document at this DocumentReference.

get(Query query)

public abstract ApiFuture<QuerySnapshot> get(Query query)

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

Parameter
Name	Description
`query`	`Query`

Returns
Type	Description
`ApiFuture<QuerySnapshot>`	The contents of the Document at this DocumentReference.

getAll(DocumentReference[] documentReferences)

public abstract ApiFuture<List<DocumentSnapshot>> getAll(DocumentReference[] documentReferences)

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

Parameter
Name	Description
`documentReferences`	`DocumentReference[]` List of Document References to fetch.

Returns
Type	Description
`ApiFuture<List<DocumentSnapshot>>`

getAll(DocumentReference[] documentReferences, FieldMask fieldMask)

public abstract 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. Holds a pessimistic lock on all returned documents.

Parameters
Name	Description
`documentReferences`	`DocumentReference[]` Array with Document References to fetch.
`fieldMask`	`FieldMask` If set, specifies the subset of fields to return.

Returns
Type	Description
`ApiFuture<List<DocumentSnapshot>>`

hasTransactionId()

public abstract boolean hasTransactionId()

Returns
Type	Description
`boolean`