Transaction

public class Transaction extends Object

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

Subclassing Note: Firestore classes are not meant to be subclassed except for use in test mocks. Subclassing is not supported in production code and new SDK releases may break code that does so.

Nested Class Summary

interface Transaction.Function<TResult> An interface for providing code to be executed within a transaction context. 

Public Method Summary

Transaction
delete(DocumentReference documentRef)
Deletes the document referred to by the provided DocumentReference.
DocumentSnapshot
get(DocumentReference documentRef)
Reads the document referenced by this DocumentReference
Transaction
set(DocumentReference documentRef, Map<StringObject> data)
Overwrites the document referred to by the provided DocumentReference.
Transaction
set(DocumentReference documentRef, Map<StringObject> data, SetOptions options)
Writes to the document referred to by the provided DocumentReference.
Transaction
set(DocumentReference documentRef, Object pojo)
Overwrites the document referred to by the provided DocumentReference.
Transaction
set(DocumentReference documentRef, Object pojo, SetOptions options)
Writes to the document referred to by the provided DocumentReference.
Transaction
update(DocumentReference documentRef, Map<StringObject> data)
Updates fields in the document referred to by the provided DocumentReference.
Transaction
update(DocumentReference documentRef, String field, Object value, Object... moreFieldsAndValues)
Updates fields in the document referred to by the provided DocumentReference.
Transaction
update(DocumentReference documentRef, FieldPath fieldPath, Object value, Object... moreFieldsAndValues)
Updates fields in the document referred to by the provided DocumentReference.

Inherited Method Summary

Public Methods

public Transaction delete (DocumentReference documentRef)

Deletes the document referred to by the provided DocumentReference.

Parameters
documentRef The DocumentReference to delete.
Returns
  • This Transaction instance. Used for chaining method calls.

public DocumentSnapshot get (DocumentReference documentRef)

Reads the document referenced by this DocumentReference

Parameters
documentRef The DocumentReference to read.
Returns
  • The contents of the Document at this DocumentReference.

public Transaction set (DocumentReference documentRef, Map<StringObject> data)

Overwrites the document referred to by the provided DocumentReference. If the document does not yet exist, it will be created. If a document already exists, it will be overwritten.

Parameters
documentRef The DocumentReference to overwrite.
data A map of the fields and values for the document.
Returns
  • This Transaction instance. Used for chaining method calls.

public Transaction set (DocumentReference documentRef, Map<StringObject> data, SetOptions options)

Writes to the document referred to by the provided DocumentReference. If the document does not yet exist, it will be created. If you pass SetOptions, the provided data can be merged into an existing document.

Parameters
documentRef The DocumentReference to overwrite.
data A map of the fields and values for the document.
options An object to configure the set behavior.
Returns
  • This Transaction instance. Used for chaining method calls.

public Transaction set (DocumentReference documentRef, Object pojo)

Overwrites the document referred to by the provided DocumentReference. If the document does not yet exist, it will be created. If a document already exists, it will be overwritten.

Parameters
documentRef The DocumentReference to overwrite.
pojo The POJO that will be used to populate the document contents
Returns
  • This Transaction instance. Used for chaining method calls.

public Transaction set (DocumentReference documentRef, Object pojo, SetOptions options)

Writes to the document referred to by the provided DocumentReference. If the document does not yet exist, it will be created. If you pass SetOptions, the provided data can be merged into an existing document.

Parameters
documentRef The DocumentReference to overwrite.
pojo The POJO that will be used to populate the document contents
options An object to configure the set behavior.
Returns
  • This Transaction instance. Used for chaining method calls.

public Transaction update (DocumentReference documentRef, Map<StringObject> data)

Updates fields in the document referred to by the provided DocumentReference. If no document exists yet, the update will fail.

Parameters
documentRef The DocumentReference to update.
data A map of field / value pairs to update. Fields can contain dots to reference nested fields within the document.
Returns
  • This Transaction instance. Used for chaining method calls.

public Transaction update (DocumentReference documentRef, String field, Object value, Object... moreFieldsAndValues)

Updates fields in the document referred to by the provided DocumentReference. If no document exists yet, the update will fail.

Parameters
documentRef The DocumentReference to update.
field The first field to update. Fields can contain dots to reference a nested field within the document.
value The first value
moreFieldsAndValues Additional field/value pairs.
Returns
  • This Transaction instance. Used for chaining method calls.

public Transaction update (DocumentReference documentRef, FieldPath fieldPath, Object value, Object... moreFieldsAndValues)

Updates fields in the document referred to by the provided DocumentReference. If no document exists yet, the update will fail.

Parameters
documentRef The DocumentReference to update.
fieldPath The first field to update.
value The first value
moreFieldsAndValues Additional field/value pairs.
Returns
  • This Transaction instance. Used for chaining method calls.

发送以下问题的反馈:

此网页
需要帮助?请访问我们的支持页面