Class Key (6.56.0)

public final class Key implements Serializable

Represents a row key in a Cloud Spanner table or index. A key is a tuple of values constrained to the scalar Cloud Spanner types: currently these are BOOLEAN, INT64, FLOAT64, STRING, BYTES and TIMESTAMP. Values may be null where the table definition permits it.

Key is used to define the row, or endpoints of a range of rows, to retrieve in read operations or to delete in a mutation.

Key instances are immutable.

Inheritance

Object > Key

Implements

Serializable

Inherited Members

Object.clone()

Object.equals(Object)

Object.finalize()

Object.getClass()

Object.hashCode()

Object.notify()

Object.notifyAll()

Object.toString()

Object.wait()

Object.wait(long)

Object.wait(long,int)

Static Methods

newBuilder()

public static Key.Builder newBuilder()

Returns a new builder for constructing a key.

Returns
Type	Description
`Key.Builder`

of(Object[] values)

public static Key of(Object[] values)

Construct a key with parts specified by values. Each object in values must be either null or one of the following supported types:

Boolean for the BOOL Cloud Spanner type
Integer, Long for the INT64 Cloud Spanner type
Float, Double for the FLOAT64 Cloud Spanner type
BigDecimal for the NUMERIC Cloud Spanner type
String for the STRING Cloud Spanner type
String for the JSON Cloud Spanner type
ByteArray for the BYTES Cloud Spanner type
Timestamp for the TIMESTAMP Cloud Spanner type
Date for the DATE Cloud Spanner type

Parameter
Name	Description
`values`	`Object[]`

Returns
Type	Description
`Key`

Methods

equals(Object o)

public boolean equals(Object o)

Parameter
Name	Description
`o`	`Object`

Returns
Type	Description
`boolean`

Overrides

Object.equals(Object)

getParts()

public Iterable<Object> getParts()

Returns the parts in this key. Each part is represented by the corresponding Cloud Spanner type's canonical Java type, as listed below. Note that other types supported by #of(Object...) are converted to one of the canonical types.

BOOL is represented by Boolean
INT64 is represented by Long
FLOAT64 is represented by Double
NUMERIC is represented by BigDecimal
STRING is represented by String
JSON is represented by String
BYTES is represented by ByteArray
TIMESTAMP is represented by Timestamp
DATE is represented by Date

Returns
Type	Description
`Iterable<Object>`	an unmodifiable list containing the key parts

hashCode()

public int hashCode()

Returns
Type	Description
`int`

Overrides

Object.hashCode()

size()

public int size()

Returns the number of parts in this key, including null values.

Returns
Type	Description
`int`

toBuilder()

public Key.Builder toBuilder()

Returns a builder initialized with the value of this key.

Returns
Type	Description
`Key.Builder`

toString()

public String toString()

Returns
Type	Description
`String`

Overrides

Object.toString()