org.hibernate.engine.internal

Class EntityEntryContext

java.lang.Object

org.hibernate.engine.internal.EntityEntryContext

public class EntityEntryContext
extends Object

Defines a context for maintaining the relation between an entity associated with the Session ultimately owning this EntityEntryContext instance and that entity's corresponding EntityEntry. 2 approaches are supported:

• the entity->EntityEntry association is maintained in a Map within this class
• the EntityEntry is injected into the entity via it implementing the ManagedEntity contract, either directly or through bytecode enhancement.

Author:

Steve Ebersole

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static interface	EntityEntryContext.EntityEntryCrossRef Used in building the reentrantSafeEntityEntries() entries

Constructor Summary

Constructors

Constructor and Description
EntityEntryContext(PersistenceContext persistenceContext) Constructs a EntityEntryContext

Method Summary

Modifier and Type	Method and Description
void	addEntityEntry(Object entity, EntityEntry entityEntry) Adds the entity and entry to this context, associating them together
void	clear() Clear this context of all managed entities
static EntityEntryContext	deserialize(ObjectInputStream ois, StatefulPersistenceContext rtn) JDK serialization hook for deserializing
void	downgradeLocks() Down-grade locks to NONE for all entities in this context
EntityEntry	getEntityEntry(Object entity) Retrieve the associated EntityEntry for the entity
int	getNumberOfManagedEntities()
boolean	hasEntityEntry(Object entity) Does this entity exist in this context, associated with an EntityEntry?
Map.Entry<Object,EntityEntry>[]	reentrantSafeEntityEntries() The main bugaboo with IdentityMap that warranted this class in the first place.
EntityEntry	removeEntityEntry(Object entity) Remove an entity from the context, returning the EntityEntry which was associated with it
void	serialize(ObjectOutputStream oos) JDK serialization hook for serializing

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

EntityEntryContext

public EntityEntryContext(PersistenceContext persistenceContext)

Constructs a EntityEntryContext

Method Detail

addEntityEntry

public void addEntityEntry(Object entity,
                           EntityEntry entityEntry)

Adds the entity and entry to this context, associating them together

Parameters:

entity - The entity

entityEntry - The entry

hasEntityEntry

public boolean hasEntityEntry(Object entity)

Does this entity exist in this context, associated with an EntityEntry?

Parameters:

entity - The entity to check

Returns:

true if it is associated with this context

getEntityEntry

public EntityEntry getEntityEntry(Object entity)

Retrieve the associated EntityEntry for the entity

Parameters:

entity - The entity to retrieve the EntityEntry for

Returns:

The associated EntityEntry

removeEntityEntry

public EntityEntry removeEntityEntry(Object entity)

Remove an entity from the context, returning the EntityEntry which was associated with it

Parameters:

entity - The entity to remove

Returns:

Tjee EntityEntry

reentrantSafeEntityEntries

public Map.Entry<Object,EntityEntry>[] reentrantSafeEntityEntries()

The main bugaboo with IdentityMap that warranted this class in the first place. Return an array of all the entity/EntityEntry pairs in this context. The array is to make sure that the iterators built off of it are safe from concurrency/reentrancy

Returns:

The safe array

clear

public void clear()

Clear this context of all managed entities

downgradeLocks

public void downgradeLocks()

Down-grade locks to NONE for all entities in this context

serialize

public void serialize(ObjectOutputStream oos)
               throws IOException

JDK serialization hook for serializing

Parameters:

oos - The stream to write ourselves to

Throws:

IOException - Indicates an IO exception accessing the given stream

deserialize

public static EntityEntryContext deserialize(ObjectInputStream ois,
                                             StatefulPersistenceContext rtn)
                                      throws IOException,
                                             ClassNotFoundException

JDK serialization hook for deserializing

Parameters:

ois - The stream to read ourselves from

rtn - The persistence context we belong to

Returns:

The deserialized EntityEntryContext

Throws:

IOException - Indicates an IO exception accessing the given stream

ClassNotFoundException - Problem reading stream data

getNumberOfManagedEntities

public int getNumberOfManagedEntities()