Package com.google.cloud.spanner

Enum Mutation.Op

java.lang.Object

java.lang.Enum<Mutation.Op>

com.google.cloud.spanner.Mutation.Op

All Implemented Interfaces:

Serializable, Comparable<Mutation.Op>

Enclosing class:

Mutation

public static enum Mutation.Op
extends Enum<Mutation.Op>

Enumerates the types of mutation that can be applied.

Enum Constant Summary

Enum Constants

Enum Constant	Description
DELETE	Deletes rows from a table.
INSERT	Inserts a new row in a table.
INSERT_OR_UPDATE	Like INSERT, except that if the row already exists, then its column values are overwritten with the ones provided.
REPLACE	Like INSERT, except that if the row already exists, it is deleted, and the column values provided are inserted instead.
UPDATE	Updates an existing row in a table.

Method Summary

Modifier and Type	Method	Description
static Mutation.Op	valueOf(String name)	Returns the enum constant of this type with the specified name.
static Mutation.Op[]	values()	Returns an array containing the constants of this enum type, in the order they are declared.

Methods inherited from class java.lang.Enum

clone, compareTo, equals, finalize, getDeclaringClass, hashCode, name, ordinal, toString, valueOf

Methods inherited from class java.lang.Object

getClass, notify, notifyAll, wait, wait, wait

Enum Constant Details

INSERT

public static final Mutation.Op INSERT

Inserts a new row in a table. If the row already exists, the write or transaction fails with ErrorCode.ALREADY_EXISTS. When inserting a row, all NOT NULL columns in the table must be given a value.

UPDATE

public static final Mutation.Op UPDATE

Updates an existing row in a table. If the row does not already exist, the transaction fails with error ErrorCode.NOT_FOUND.

INSERT_OR_UPDATE

public static final Mutation.Op INSERT_OR_UPDATE

Like INSERT, except that if the row already exists, then its column values are overwritten with the ones provided. All NOT NUll columns in the table must be give a value and this holds true even when the row already exists and will actually be updated. Values for all NULL columns not explicitly written are preserved.

REPLACE

public static final Mutation.Op REPLACE

Like INSERT, except that if the row already exists, it is deleted, and the column values provided are inserted instead. Unlike INSERT_OR_UPDATE, this means any values not explicitly written become NULL.

DELETE

public static final Mutation.Op DELETE

Deletes rows from a table. Succeeds whether or not the named rows were present.

Method Details

values

public static Mutation.Op[] values()

Returns an array containing the constants of this enum type, in the order they are declared.

Returns:

an array containing the constants of this enum type, in the order they are declared

valueOf

public static Mutation.Op valueOf(String name)

Returns the enum constant of this type with the specified name. The string must match exactly an identifier used to declare an enum constant in this type. (Extraneous whitespace characters are not permitted.)

Parameters:

name - the name of the enum constant to be returned.

Returns:

the enum constant with the specified name

Throws:

IllegalArgumentException - if this enum type has no constant with the specified name

NullPointerException - if the argument is null