com.google.cloud.datastore

Class Key

java.lang.Object

com.google.cloud.datastore.BaseKey

com.google.cloud.datastore.IncompleteKey

com.google.cloud.datastore.Key

All Implemented Interfaces:

Serializable

public final class Key
extends IncompleteKey

A key that is guaranteed to be complete and could be used to reference a Google Cloud Datastore Entity. This class is immutable.

See Also:

Google Cloud Datastore Entities, Properties, and Keys, Serialized Form

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	Key.Builder

Method Summary

Modifier and Type	Method and Description
static Key.Builder	builder(IncompleteKey copyFrom, long id) Deprecated.
static Key.Builder	builder(IncompleteKey copyFrom, String name) Deprecated.
static Key.Builder	builder(Key copyFrom) Deprecated.
static Key.Builder	builder(Key parent, String kind, long id) Deprecated.
static Key.Builder	builder(Key parent, String kind, String name) Deprecated.
static Key.Builder	builder(String projectId, String kind, long id) Deprecated.
static Key.Builder	builder(String projectId, String kind, String name) Deprecated.
static Key	fromUrlSafe(String urlSafe) Create a Key given its URL safe encoded form.
Long	getId() Returns the key's id or null if it has a name instead.
String	getName() Returns the key's name or null if it has an id instead.
Object	getNameOrId() Returns the key's ID (as Long) or name (as String).
boolean	hasId()
boolean	hasName()
Long	id() Deprecated.
String	name() Deprecated.
Object	nameOrId() Deprecated.
static Key.Builder	newBuilder(IncompleteKey copyFrom, long id)
static Key.Builder	newBuilder(IncompleteKey copyFrom, String name)
static Key.Builder	newBuilder(Key copyFrom)
static Key.Builder	newBuilder(Key parent, String kind, long id)
static Key.Builder	newBuilder(Key parent, String kind, String name)
static Key.Builder	newBuilder(String projectId, String kind, long id)
static Key.Builder	newBuilder(String projectId, String kind, String name)
String	toUrlSafe() Returns the key in an encoded form that can be used as part of a URL.

Methods inherited from class com.google.cloud.datastore.IncompleteKey

builder, builder, builder, getParent, newBuilder, newBuilder, newBuilder, parent

Methods inherited from class com.google.cloud.datastore.BaseKey

ancestors, equals, getAncestors, getKind, getNamespace, getProjectId, hashCode, kind, namespace, projectId, toString

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Method Detail

hasId

public boolean hasId()

id

@Deprecated
public Long id()

Deprecated.

Returns the key's id or null if it has a name instead.

getId

public Long getId()

Returns the key's id or null if it has a name instead.

hasName

public boolean hasName()

name

@Deprecated
public String name()

Deprecated.

Returns the key's name or null if it has an id instead.

getName

public String getName()

Returns the key's name or null if it has an id instead.

nameOrId

@Deprecated
public Object nameOrId()

Deprecated.

Returns the key's ID (as Long) or name (as String). Never null.

getNameOrId

public Object getNameOrId()

Returns the key's ID (as Long) or name (as String). Never null.

toUrlSafe

public String toUrlSafe()

Returns the key in an encoded form that can be used as part of a URL.

fromUrlSafe

public static Key fromUrlSafe(String urlSafe)

Create a Key given its URL safe encoded form.

Throws:

IllegalArgumentException - when decoding fails

builder

@Deprecated
public static Key.Builder builder(String projectId,
                                              String kind,
                                              String name)

Deprecated.

newBuilder

public static Key.Builder newBuilder(String projectId,
                                     String kind,
                                     String name)

builder

@Deprecated
public static Key.Builder builder(String projectId,
                                              String kind,
                                              long id)

Deprecated.

newBuilder

public static Key.Builder newBuilder(String projectId,
                                     String kind,
                                     long id)

builder

@Deprecated
public static Key.Builder builder(Key copyFrom)

Deprecated.

newBuilder

public static Key.Builder newBuilder(Key copyFrom)

builder

@Deprecated
public static Key.Builder builder(IncompleteKey copyFrom,
                                              String name)

Deprecated.

newBuilder

public static Key.Builder newBuilder(IncompleteKey copyFrom,
                                     String name)

builder

@Deprecated
public static Key.Builder builder(IncompleteKey copyFrom,
                                              long id)

Deprecated.

newBuilder

public static Key.Builder newBuilder(IncompleteKey copyFrom,
                                     long id)

builder

@Deprecated
public static Key.Builder builder(Key parent,
                                              String kind,
                                              String name)

Deprecated.

newBuilder

public static Key.Builder newBuilder(Key parent,
                                     String kind,
                                     String name)

builder

@Deprecated
public static Key.Builder builder(Key parent,
                                              String kind,
                                              long id)

Deprecated.

newBuilder

public static Key.Builder newBuilder(Key parent,
                                     String kind,
                                     long id)