com.google.cloud.firestore

Class UpdateBuilder<T extends UpdateBuilder>

java.lang.Object

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

Direct Known Subclasses:

Transaction, WriteBatch

public abstract class UpdateBuilder<T extends UpdateBuilder>
extends Object

Abstract class that collects and bundles all write operations for Transaction and WriteBatch.

Method Summary

Modifier and Type	Method and Description
T	create(DocumentReference documentReference, Map<String,Object> fields) Creates a new Document at the DocumentReference's location.
T	create(DocumentReference documentReference, Object pojo) Creates a new Document at the DocumentReference location.
T	delete(DocumentReference documentReference) Deletes the document referred to by this DocumentReference.
T	delete(DocumentReference documentReference, Precondition precondition) Deletes the document referred to by this DocumentReference.
int	getMutationsSize() Get the number of mutations.
T	set(DocumentReference documentReference, Map<String,Object> fields) Overwrites the document referred to by this DocumentReference.
T	set(DocumentReference documentReference, Map<String,Object> fields, SetOptions options) Overwrites the document referred to by this DocumentReference.
T	set(DocumentReference documentReference, Object pojo) Overwrites the document referred to by this DocumentReference.
T	set(DocumentReference documentReference, Object pojo, SetOptions options) Overwrites the document referred to by this DocumentReference.
T	update(DocumentReference documentReference, FieldPath fieldPath, Object value, Object... moreFieldsAndValues) Updates the fields in the document referred to by this DocumentReference.
T	update(DocumentReference documentReference, Map<String,Object> fields) Updates fields in the document referred to by this DocumentReference.
T	update(DocumentReference documentReference, Map<String,Object> fields, Precondition options) Updates fields in the document referred to by this DocumentReference.
T	update(DocumentReference documentReference, Precondition options, FieldPath fieldPath, Object value, Object... moreFieldsAndValues) Updates the fields in the document referred to by this DocumentReference.
T	update(DocumentReference documentReference, Precondition options, String field, Object value, Object... moreFieldsAndValues) Updates the fields in the document referred to by this DocumentReference.
T	update(DocumentReference documentReference, String field, Object value, Object... moreFieldsAndValues) Updates the fields in the document referred to by this DocumentReference.

Methods inherited from class java.lang.Object

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

Method Detail

create

@Nonnull
public T create(@Nonnull
                         DocumentReference documentReference,
                         @Nonnull
                         Map<String,Object> fields)

Creates a new Document at the DocumentReference's location. It fails the write if the document exists.

Parameters:

documentReference - The DocumentReference to create.

fields - A map of the fields and values for the document.

Returns:

The instance for chaining.

create

@Nonnull
public T create(@Nonnull
                         DocumentReference documentReference,
                         @Nonnull
                         Object pojo)

Creates a new Document at the DocumentReference location. It fails the write if the document exists.

Parameters:

documentReference - The DocumentReference to create.

pojo - A map of the fields and values for the document.

Returns:

The instance for chaining.

set

@Nonnull
public T set(@Nonnull
                      DocumentReference documentReference,
                      @Nonnull
                      Map<String,Object> fields)

Overwrites the document referred to by this DocumentReference. If the document doesn't exist yet, it will be created. If a document already exists, it will be overwritten.

Parameters:

documentReference - The DocumentReference to overwrite.

fields - A map of the field paths and values for the document.

Returns:

The instance for chaining.

set

@Nonnull
public T set(@Nonnull
                      DocumentReference documentReference,
                      @Nonnull
                      Map<String,Object> fields,
                      @Nonnull
                      SetOptions options)

Overwrites the document referred to by this DocumentReference. If the document doesn't exist yet, it will be created. If you pass SetOptions, the provided data can be merged into an existing document.

Parameters:

documentReference - The DocumentReference to overwrite.

fields - A map of the field paths and values for the document.

options - An object to configure the set behavior.

Returns:

The instance for chaining.

set

@Nonnull
public T set(@Nonnull
                      DocumentReference documentReference,
                      @Nonnull
                      Object pojo)

Overwrites the document referred to by this DocumentReference. If the document doesn't exist yet, it will be created. If a document already exists, it will be overwritten.

Parameters:

documentReference - The DocumentReference to overwrite.

pojo - The POJO that will be used to populate the document contents.

Returns:

The instance for chaining.

set

@Nonnull
public T set(@Nonnull
                      DocumentReference documentReference,
                      @Nonnull
                      Object pojo,
                      @Nonnull
                      SetOptions options)

Overwrites the document referred to by this DocumentReference. If the document doesn't exist yet, it will be created. If you pass SetOptions, the provided data can be merged into an existing document.

Parameters:

documentReference - 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:

The instance for chaining.

update

@Nonnull
public T update(@Nonnull
                         DocumentReference documentReference,
                         @Nonnull
                         Map<String,Object> fields)

Updates fields in the document referred to by this DocumentReference. If the document doesn't exist yet, the update will fail.

Parameters:

documentReference - The DocumentReference to update.

fields - A Map containing the fields and values with which to update the document.

Returns:

The instance for chaining.

update

@Nonnull
public T update(@Nonnull
                         DocumentReference documentReference,
                         @Nonnull
                         Map<String,Object> fields,
                         Precondition options)

Updates fields in the document referred to by this DocumentReference. If the document doesn't exist yet, the update will fail.

Parameters:

documentReference - The DocumentReference to update.

fields - A Map containing the fields and values with which to update the document.

options - Preconditions to enforce on this update.

Returns:

The instance for chaining.

update

@Nonnull
public T update(@Nonnull
                         DocumentReference documentReference,
                         @Nonnull
                         String field,
                         @Nullable
                         Object value,
                         Object... moreFieldsAndValues)

Updates the fields in the document referred to by this DocumentReference. If the document doesn't exist yet, the update will fail.

Parameters:

documentReference - The DocumentReference to update.

field - The first field to set.

value - The first value to set.

moreFieldsAndValues - String and Object pairs with more fields to be set.

Returns:

The instance for chaining.

update

@Nonnull
public T update(@Nonnull
                         DocumentReference documentReference,
                         @Nonnull
                         FieldPath fieldPath,
                         @Nullable
                         Object value,
                         Object... moreFieldsAndValues)

Updates the fields in the document referred to by this DocumentReference. If the document doesn't exist yet, the update will fail.

Parameters:

documentReference - The DocumentReference to update.

fieldPath - The first field to set.

value - The first value to set.

moreFieldsAndValues - String and Object pairs with more fields to be set.

Returns:

The instance for chaining.

update

@Nonnull
public T update(@Nonnull
                         DocumentReference documentReference,
                         @Nonnull
                         Precondition options,
                         @Nonnull
                         String field,
                         @Nullable
                         Object value,
                         Object... moreFieldsAndValues)

Updates the fields in the document referred to by this DocumentReference. If the document doesn't exist yet, the update will fail.

Parameters:

documentReference - The DocumentReference to update.

options - Preconditions to enforce on this update.

field - The first field to set.

value - The first value to set.

moreFieldsAndValues - String and Object pairs with more fields to be set.

Returns:

The instance for chaining.

update

@Nonnull
public T update(@Nonnull
                         DocumentReference documentReference,
                         @Nonnull
                         Precondition options,
                         @Nonnull
                         FieldPath fieldPath,
                         @Nullable
                         Object value,
                         Object... moreFieldsAndValues)

Updates the fields in the document referred to by this DocumentReference. If the document doesn't exist yet, the update will fail.

Parameters:

documentReference - The DocumentReference to update.

options - Preconditions to enforce on this update.

fieldPath - The first field to set.

value - The first value to set.

moreFieldsAndValues - String and Object pairs with more fields to be set.

Returns:

The instance for chaining.

delete

@Nonnull
public T delete(@Nonnull
                         DocumentReference documentReference,
                         @Nonnull
                         Precondition precondition)

Deletes the document referred to by this DocumentReference.

Parameters:

documentReference - The DocumentReference to delete.

precondition - Precondition for the delete operation.

Returns:

The instance for chaining.

delete

@Nonnull
public T delete(@Nonnull
                         DocumentReference documentReference)

Deletes the document referred to by this DocumentReference.

Parameters:

documentReference - The DocumentReference to delete.

Returns:

The instance for chaining.

getMutationsSize

public int getMutationsSize()

Get the number of mutations.