org.hibernate.engine.spi

Class EntityKey

java.lang.Object

org.hibernate.engine.spi.EntityKey

All Implemented Interfaces:

Serializable

public final class EntityKey
extends Object
implements Serializable

Uniquely identifies of an entity instance in a particular Session by identifier. Note that it's only safe to be used within the scope of a Session: it doesn't consider for example the tenantId as part of the equality definition.

Information used to determine uniqueness consists of the entity-name and the identifier value (see equals(java.lang.Object)).

Performance considerations: lots of instances of this type are created at runtime. Make sure each one is as small as possible by storing just the essential needed.

Author:

Gavin King, Sanne Grinovero

See Also:

Serialized Form

Constructor Summary

Constructors

Constructor and Description
EntityKey(Serializable id, EntityPersister persister) Construct a unique identifier for an entity class instance.

Method Summary

Modifier and Type	Method and Description
static EntityKey	deserialize(ObjectInputStream ois, SessionFactoryImplementor sessionFactory) Custom deserialization routine used during deserialization of a Session/PersistenceContext for increased performance.
boolean	equals(Object other)
String	getEntityName()
Serializable	getIdentifier()
int	hashCode()
boolean	isBatchLoadable()
void	serialize(ObjectOutputStream oos) Custom serialization routine used during serialization of a Session/PersistenceContext for increased performance.
String	toString()

Methods inherited from class java.lang.Object

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

Constructor Detail

EntityKey

public EntityKey(Serializable id,
                 EntityPersister persister)

Construct a unique identifier for an entity class instance.

NOTE : This signature has changed to accommodate both entity mode and multi-tenancy, both of which relate to the Session to which this key belongs. To help minimize the impact of these changes in the future, the SessionImplementor.generateEntityKey(java.io.Serializable, org.hibernate.persister.entity.EntityPersister) method was added to hide the session-specific changes.

Parameters:

id - The entity id

persister - The entity persister

Method Detail

isBatchLoadable

public boolean isBatchLoadable()

getIdentifier

public Serializable getIdentifier()

getEntityName

public String getEntityName()

equals

public boolean equals(Object other)

Overrides:

equals in class Object

hashCode

public int hashCode()

Overrides:

hashCode in class Object

toString

public String toString()

Overrides:

toString in class Object

serialize

public void serialize(ObjectOutputStream oos)
               throws IOException

Custom serialization routine used during serialization of a Session/PersistenceContext for increased performance.

Parameters:

oos - The stream to which we should write the serial data.

Throws:

IOException - Thrown by Java I/O

deserialize

public static EntityKey deserialize(ObjectInputStream ois,
                                    SessionFactoryImplementor sessionFactory)
                             throws IOException,
                                    ClassNotFoundException

Custom deserialization routine used during deserialization of a Session/PersistenceContext for increased performance.

Parameters:

ois - The stream from which to read the entry.

sessionFactory - The SessionFactory owning the Session being deserialized.

Returns:

The deserialized EntityEntry

Throws:

IOException - Thrown by Java I/O

ClassNotFoundException - Thrown by Java I/O