org.datanucleus.identity

Class DatastoreUniqueOID

java.lang.Object

org.datanucleus.identity.DatastoreUniqueOID

All Implemented Interfaces:

Serializable, Comparable, OID

public class DatastoreUniqueOID
extends Object
implements Serializable, OID, Comparable

Identity for use with datastore-identity where the datastore provides a unique "identity" key per object and hence doesn't need the class name. The behaviour of this class is governed by JDO spec 5.4.3. Main benefit over OIDImpl is size.

See Also:

Serialized Form

Field Summary

Fields

Modifier and Type	Field and Description
long	key The key value.

Constructor Summary

Constructors

Constructor and Description
DatastoreUniqueOID() Creates an OID with no value.
DatastoreUniqueOID(long key) Constructor taking the long form of the key.
DatastoreUniqueOID(String str) Constructs an OID from its string representation that is consistent with the output of toString().

Method Summary

Methods

Modifier and Type	Method and Description
int	compareTo(Object o) Comparator method.
boolean	equals(Object obj) Equality operator.
long	getKey() Convenience accessor for the long form of the key.
Object	getKeyValue() Accessor for the key value.
String	getPcClass() Accessor for the persistable class name.
int	hashCode() Accessor for the hashcode
String	toString() Creates a String representation of the datastore identity, formed from the key value.

Methods inherited from class java.lang.Object

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

Field Detail

key

public final long key

The key value.

Constructor Detail

DatastoreUniqueOID

public DatastoreUniqueOID()

Creates an OID with no value. Required by the JDO spec.

DatastoreUniqueOID

public DatastoreUniqueOID(long key)

Constructor taking the long form of the key.

Parameters:

key - The key

DatastoreUniqueOID

public DatastoreUniqueOID(String str)
                   throws IllegalArgumentException

Constructs an OID from its string representation that is consistent with the output of toString().

Parameters:

str - the string representation of an OID

Throws:

IllegalArgumentException - if the given string representation is not valid.

See Also:

toString()

Method Detail

getKeyValue

public Object getKeyValue()

Accessor for the key value.

Specified by:

getKeyValue in interface OID

Returns:

The key value

getKey

public long getKey()

Convenience accessor for the long form of the key.

Returns:

long primitive form of the key

getPcClass

public String getPcClass()

Accessor for the persistable class name.

Specified by:

getPcClass in interface OID

Returns:

persistable class name

equals

public boolean equals(Object obj)

Equality operator.

Specified by:

equals in interface OID

Overrides:

equals in class Object

Parameters:

obj - Object to compare against

Returns:

Whether they are equal

compareTo

public int compareTo(Object o)

Comparator method.

Specified by:

compareTo in interface Comparable

Parameters:

o - The object to compare against

Returns:

The comparison result

hashCode

public int hashCode()

Accessor for the hashcode

Specified by:

hashCode in interface OID

Overrides:

hashCode in class Object

Returns:

Hashcode for this object

toString

public String toString()

Creates a String representation of the datastore identity, formed from the key value. This will be something like

3254

Specified by:

toString in interface OID

Overrides:

toString in class Object

Returns:

The String form of the identity