org.hibernate.engine.spi
Interface PersistenceContext

All Known Implementing Classes:
StatefulPersistenceContext

public interface PersistenceContext

Represents the state of "stuff" Hibernate is tracking, including (not exhaustive):

Often referred to as the "first level cache".


Nested Class Summary
static interface PersistenceContext.NaturalIdHelper
          Provides centralized access to natural-id-related functionality.
 
Method Summary
 void addChildParent(Object child, Object parent)
          Add a child/parent relation to cache for cascading op
 void addCollectionHolder(PersistentCollection holder)
          Register a PersistentCollection object for an array.
 void addEntity(EntityKey key, Object entity)
          Add a canonical mapping from entity key to entity instance
 void addEntity(EntityUniqueKey euk, Object entity)
          Add an entity to the cache by unique key
 EntityEntry addEntity(Object entity, Status status, Object[] loadedState, EntityKey entityKey, Object version, LockMode lockMode, boolean existsInDatabase, EntityPersister persister, boolean disableVersionIncrement, boolean lazyPropertiesAreUnfetched)
          Adds an entity to the internal caches.
 EntityEntry addEntry(Object entity, Status status, Object[] loadedState, Object rowId, Serializable id, Object version, LockMode lockMode, boolean existsInDatabase, EntityPersister persister, boolean disableVersionIncrement, boolean lazyPropertiesAreUnfetched)
          Generates an appropriate EntityEntry instance and adds it to the event source's internal caches.
 CollectionEntry addInitializedCollection(CollectionPersister persister, PersistentCollection collection, Serializable id)
          add a collection we just pulled out of the cache (does not need initializing)
 void addInitializedDetachedCollection(CollectionPersister collectionPersister, PersistentCollection collection)
          add an (initialized) collection that was created by another session and passed into update() (ie.
 void addNewCollection(CollectionPersister persister, PersistentCollection collection)
          Add a new collection (ie.
 void addNonLazyCollection(PersistentCollection collection)
          Register a collection for non-lazy loading at the end of the two-phase load
 void addNullProperty(EntityKey ownerKey, String propertyName)
          Record the fact that the association belonging to the keyed entity is null.
 void addProxy(EntityKey key, Object proxy)
          Add a proxy to the session cache
 void addUninitializedCollection(CollectionPersister persister, PersistentCollection collection, Serializable id)
          add a collection we just loaded up (still needs initializing)
 void addUninitializedDetachedCollection(CollectionPersister persister, PersistentCollection collection)
          add a detached uninitialized collection
 void addUnownedCollection(CollectionKey key, PersistentCollection collection)
          Add a collection which has no owner loaded
 void afterLoad()
          Call this after finishing a two-phase load
 void afterTransactionCompletion()
          Called after transactions end
 void beforeLoad()
          Call this before begining a two-phase load
 void checkUniqueness(EntityKey key, Object object)
          Attempts to check whether the given key represents an entity already loaded within the current session.
 void clear()
          Clear the state of the persistence context
 boolean containsCollection(PersistentCollection collection)
          Is the given collection associated with this persistence context?
 boolean containsEntity(EntityKey key)
          Is there an entity with the given key in the persistence context
 boolean containsProxy(Object proxy)
          Is the given proxy associated with this persistence context?
 int decrementCascadeLevel()
          Called after cascading
 BatchFetchQueue getBatchFetchQueue()
          Get the BatchFetchQueue, instantiating one if necessary.
 Object[] getCachedDatabaseSnapshot(EntityKey key)
          Get the current database state of the entity, using the cached state snapshot if one is available.
 int getCascadeLevel()
          How deep are we cascaded?
 PersistentCollection getCollection(CollectionKey collectionKey)
          Get the collection instance associated with the CollectionKey
 Map getCollectionEntries()
          Get the mapping from collection instance to collection entry
 CollectionEntry getCollectionEntry(PersistentCollection coll)
          Get the collection entry for a persistent collection
 CollectionEntry getCollectionEntryOrNull(Object collection)
          Get the collection entry for a collection passed to filter, which might be a collection wrapper, an array, or an unwrapped collection.
 PersistentCollection getCollectionHolder(Object array)
          Get the PersistentCollection object for an array
 Object getCollectionOwner(Serializable key, CollectionPersister collectionPersister)
          Get the entity that owns this persistent collection
 Map getCollectionsByKey()
          Get the mapping from collection key to collection instance
 Object[] getDatabaseSnapshot(Serializable id, EntityPersister persister)
          Get the current state of the entity as known to the underlying database, or null if there is no corresponding row
 Map getEntitiesByKey()
          Get the mapping from key value to entity instance
 Object getEntity(EntityKey key)
          Get the entity instance associated with the given key
 Object getEntity(EntityUniqueKey euk)
          Get an entity cached by unique key
 Map getEntityEntries()
          Get the mapping from entity instance to entity entry
 EntityEntry getEntry(Object entity)
          Retrieve the EntityEntry representation of the given entity.
 Object getIndexInOwner(String entity, String property, Object childObject, Map mergeMap)
          Search the persistence context for an index of the child object, given a collection role
 LoadContexts getLoadContexts()
          Retrieve this persistence context's managed load context.
 Serializable getLoadedCollectionOwnerIdOrNull(PersistentCollection collection)
          Get the ID for the entity that owned this persistent collection when it was loaded
 Object getLoadedCollectionOwnerOrNull(PersistentCollection collection)
          Get the entity that owned this persistent collection when it was loaded
 PersistenceContext.NaturalIdHelper getNaturalIdHelper()
          Access to the natural-id helper for this persistence context
 Object[] getNaturalIdSnapshot(Serializable id, EntityPersister persister)
          Get the values of the natural id fields as known to the underlying database, or null if the entity has no natural id or there is no corresponding row.
 HashSet getNullifiableEntityKeys()
          Retrieve the set of EntityKeys representing nullifiable references
 Serializable getOwnerId(String entity, String property, Object childObject, Map mergeMap)
          Search the persistence context for an owner for the child object, given a collection role
 Object getProxy(EntityKey key)
          Get an existing proxy by key
 SessionImplementor getSession()
          Get the session to which this persistence context is bound.
 Serializable getSnapshot(PersistentCollection coll)
          Get the snapshot of the pre-flush collection state
 boolean hasNonReadOnlyEntities()
           
 int incrementCascadeLevel()
          Called before cascading
 void initializeNonLazyCollections()
          Force initialization of all non-lazy collections encountered during the current two-phase load (actually, this is a no-op, unless this is the "outermost" load)
 boolean isDefaultReadOnly()
          Will entities and proxies that are loaded into this persistence context be made read-only by default? To determine the read-only/modifiable setting for a particular entity or proxy:
 boolean isEntryFor(Object entity)
          Is there an EntityEntry registration for this entity instance?
 boolean isFlushing()
          Is a flush cycle currently in process?
 boolean isLoadFinished()
          Is in a two-phase load?
 boolean isPropertyNull(EntityKey ownerKey, String propertyName)
          Is the association property belonging to the keyed entity null?
 boolean isReadOnly(Object entityOrProxy)
          Is the entity or proxy read-only?

To determine the default read-only/modifiable setting used for entities and proxies that are loaded into the session use Session.isDefaultReadOnly()

 boolean isStateless()
           
 Object narrowProxy(Object proxy, EntityPersister persister, EntityKey key, Object object)
          If the existing proxy is insufficiently "narrow" (derived), instantiate a new proxy and overwrite the registration of the old one.
 Object proxyFor(EntityPersister persister, EntityKey key, Object impl)
          Return the existing proxy associated with the given EntityKey, or the third argument (the entity associated with the key) if no proxy exists.
 Object proxyFor(Object impl)
          Return the existing proxy associated with the given EntityKey, or the argument (the entity associated with the key) if no proxy exists.
 boolean reassociateIfUninitializedProxy(Object value)
          Takes the given object and, if it represents a proxy, reassociates it with this event source.
 void reassociateProxy(Object value, Serializable id)
          If a deleted entity instance is re-saved, and it has a proxy, we need to reset the identifier of the proxy
 void registerInsertedKey(EntityPersister persister, Serializable id)
          Register keys inserted during the current transaction
 void removeChildParent(Object child)
          Remove child/parent relation from cache
 PersistentCollection removeCollectionHolder(Object array)
          Remove the mapping of collection to holder during eviction of the owning entity
 Object removeEntity(EntityKey key)
          Remove an entity.
 EntityEntry removeEntry(Object entity)
          Remove an entity entry from the session cache
 Object removeProxy(EntityKey key)
          Remove a proxy from the session cache
 void replaceDelayedEntityIdentityInsertKeys(EntityKey oldKey, Serializable generatedId)
           
 void setDefaultReadOnly(boolean readOnly)
          Change the default for entities and proxies loaded into this persistence context from modifiable to read-only mode, or from modifiable to read-only mode.
 void setEntryStatus(EntityEntry entry, Status status)
          Set the status of an entry
 void setFlushing(boolean flushing)
          Called before and after the flushcycle
 void setReadOnly(Object entityOrProxy, boolean readOnly)
          Set an unmodified persistent object to read-only mode, or a read-only object to modifiable mode.
 String toString()
          Returns a string representation of the object.
 Object unproxy(Object maybeProxy)
          Get the entity instance underlying the given proxy, throwing an exception if the proxy is uninitialized.
 Object unproxyAndReassociate(Object maybeProxy)
          Possibly unproxy the given reference and reassociate it with the current session.
 PersistentCollection useUnownedCollection(CollectionKey key)
          Take ownership of a previously unowned collection, if one.
 boolean wasInsertedDuringTransaction(EntityPersister persister, Serializable id)
          Allows callers to check to see if the identified entity was inserted during the current transaction.
 

Method Detail

isStateless

boolean isStateless()

getSession

SessionImplementor getSession()
Get the session to which this persistence context is bound.

Returns:
The session.

getLoadContexts

LoadContexts getLoadContexts()
Retrieve this persistence context's managed load context.

Returns:
The load context

addUnownedCollection

void addUnownedCollection(CollectionKey key,
                          PersistentCollection collection)
Add a collection which has no owner loaded

Parameters:
key - The collection key under which to add the collection
collection - The collection to add

useUnownedCollection

PersistentCollection useUnownedCollection(CollectionKey key)
Take ownership of a previously unowned collection, if one. This method returns null if no such collection was previous added () or was previously removed.

This should indicate the owner is being loaded and we are ready to "link" them.

Parameters:
key - The collection key for which to locate a collection collection
Returns:
The unowned collection, or null

getBatchFetchQueue

BatchFetchQueue getBatchFetchQueue()
Get the BatchFetchQueue, instantiating one if necessary.

Returns:
The batch fetch queue in effect for this persistence context

clear

void clear()
Clear the state of the persistence context


hasNonReadOnlyEntities

boolean hasNonReadOnlyEntities()
Returns:
false if we know for certain that all the entities are read-only

setEntryStatus

void setEntryStatus(EntityEntry entry,
                    Status status)
Set the status of an entry

Parameters:
entry - The entry for which to set the status
status - The new status

afterTransactionCompletion

void afterTransactionCompletion()
Called after transactions end


getDatabaseSnapshot

Object[] getDatabaseSnapshot(Serializable id,
                             EntityPersister persister)
Get the current state of the entity as known to the underlying database, or null if there is no corresponding row

Parameters:
id - The identifier of the entity for which to grab a snapshot
persister - The persister of the entity.
Returns:
The entity's (non-cached) snapshot
See Also:
getCachedDatabaseSnapshot(org.hibernate.engine.spi.EntityKey)

getCachedDatabaseSnapshot

Object[] getCachedDatabaseSnapshot(EntityKey key)
Get the current database state of the entity, using the cached state snapshot if one is available.

Parameters:
key - The entity key
Returns:
The entity's (non-cached) snapshot

getNaturalIdSnapshot

Object[] getNaturalIdSnapshot(Serializable id,
                              EntityPersister persister)
Get the values of the natural id fields as known to the underlying database, or null if the entity has no natural id or there is no corresponding row.

Parameters:
id - The identifier of the entity for which to grab a snapshot
persister - The persister of the entity.
Returns:
The current (non-cached) snapshot of the entity's natural id state.

addEntity

void addEntity(EntityKey key,
               Object entity)
Add a canonical mapping from entity key to entity instance

Parameters:
key - The key under which to add an entity
entity - The entity instance to add

getEntity

Object getEntity(EntityKey key)
Get the entity instance associated with the given key

Parameters:
key - The key under which to look for an entity
Returns:
The matching entity, or null

containsEntity

boolean containsEntity(EntityKey key)
Is there an entity with the given key in the persistence context

Parameters:
key - The key under which to look for an entity
Returns:
true indicates an entity was found; otherwise false

removeEntity

Object removeEntity(EntityKey key)
Remove an entity. Also clears up all other state associated with the entity aside from the EntityEntry

Parameters:
key - The key whose matching entity should be removed
Returns:
The matching entity

addEntity

void addEntity(EntityUniqueKey euk,
               Object entity)
Add an entity to the cache by unique key

Parameters:
euk - The unique (non-primary) key under which to add an entity
entity - The entity instance

getEntity

Object getEntity(EntityUniqueKey euk)
Get an entity cached by unique key

Parameters:
euk - The unique (non-primary) key under which to look for an entity
Returns:
The located entity

getEntry

EntityEntry getEntry(Object entity)
Retrieve the EntityEntry representation of the given entity.

Parameters:
entity - The entity instance for which to locate the corresponding entry
Returns:
The entry

removeEntry

EntityEntry removeEntry(Object entity)
Remove an entity entry from the session cache

Parameters:
entity - The entity instance for which to remove the corresponding entry
Returns:
The matching entry

isEntryFor

boolean isEntryFor(Object entity)
Is there an EntityEntry registration for this entity instance?

Parameters:
entity - The entity instance for which to check for an entry
Returns:
true indicates a matching entry was found.

getCollectionEntry

CollectionEntry getCollectionEntry(PersistentCollection coll)
Get the collection entry for a persistent collection

Parameters:
coll - The persistent collection instance for which to locate the collection entry
Returns:
The matching collection entry

addEntity

EntityEntry addEntity(Object entity,
                      Status status,
                      Object[] loadedState,
                      EntityKey entityKey,
                      Object version,
                      LockMode lockMode,
                      boolean existsInDatabase,
                      EntityPersister persister,
                      boolean disableVersionIncrement,
                      boolean lazyPropertiesAreUnfetched)
Adds an entity to the internal caches.


addEntry

EntityEntry addEntry(Object entity,
                     Status status,
                     Object[] loadedState,
                     Object rowId,
                     Serializable id,
                     Object version,
                     LockMode lockMode,
                     boolean existsInDatabase,
                     EntityPersister persister,
                     boolean disableVersionIncrement,
                     boolean lazyPropertiesAreUnfetched)
Generates an appropriate EntityEntry instance and adds it to the event source's internal caches.


containsCollection

boolean containsCollection(PersistentCollection collection)
Is the given collection associated with this persistence context?


containsProxy

boolean containsProxy(Object proxy)
Is the given proxy associated with this persistence context?


reassociateIfUninitializedProxy

boolean reassociateIfUninitializedProxy(Object value)
                                        throws MappingException
Takes the given object and, if it represents a proxy, reassociates it with this event source.

Parameters:
value - The possible proxy to be reassociated.
Returns:
Whether the passed value represented an actual proxy which got initialized.
Throws:
MappingException

reassociateProxy

void reassociateProxy(Object value,
                      Serializable id)
                      throws MappingException
If a deleted entity instance is re-saved, and it has a proxy, we need to reset the identifier of the proxy

Throws:
MappingException

unproxy

Object unproxy(Object maybeProxy)
               throws HibernateException
Get the entity instance underlying the given proxy, throwing an exception if the proxy is uninitialized. If the given object is not a proxy, simply return the argument.

Throws:
HibernateException

unproxyAndReassociate

Object unproxyAndReassociate(Object maybeProxy)
                             throws HibernateException
Possibly unproxy the given reference and reassociate it with the current session.

Parameters:
maybeProxy - The reference to be unproxied if it currently represents a proxy.
Returns:
The unproxied instance.
Throws:
HibernateException

checkUniqueness

void checkUniqueness(EntityKey key,
                     Object object)
                     throws HibernateException
Attempts to check whether the given key represents an entity already loaded within the current session.

Parameters:
object - The entity reference against which to perform the uniqueness check.
Throws:
HibernateException

narrowProxy

Object narrowProxy(Object proxy,
                   EntityPersister persister,
                   EntityKey key,
                   Object object)
                   throws HibernateException
If the existing proxy is insufficiently "narrow" (derived), instantiate a new proxy and overwrite the registration of the old one. This breaks == and occurs only for "class" proxies rather than "interface" proxies. Also init the proxy to point to the given target implementation if necessary.

Parameters:
proxy - The proxy instance to be narrowed.
persister - The persister for the proxied entity.
key - The internal cache key for the proxied entity.
object - (optional) the actual proxied entity instance.
Returns:
An appropriately narrowed instance.
Throws:
HibernateException

proxyFor

Object proxyFor(EntityPersister persister,
                EntityKey key,
                Object impl)
                throws HibernateException
Return the existing proxy associated with the given EntityKey, or the third argument (the entity associated with the key) if no proxy exists. Init the proxy to the target implementation, if necessary.

Throws:
HibernateException

proxyFor

Object proxyFor(Object impl)
                throws HibernateException
Return the existing proxy associated with the given EntityKey, or the argument (the entity associated with the key) if no proxy exists. (slower than the form above)

Throws:
HibernateException

getCollectionOwner

Object getCollectionOwner(Serializable key,
                          CollectionPersister collectionPersister)
                          throws MappingException
Get the entity that owns this persistent collection

Throws:
MappingException

getLoadedCollectionOwnerOrNull

Object getLoadedCollectionOwnerOrNull(PersistentCollection collection)
Get the entity that owned this persistent collection when it was loaded

Parameters:
collection - The persistent collection
Returns:
the owner if its entity ID is available from the collection's loaded key and the owner entity is in the persistence context; otherwise, returns null

getLoadedCollectionOwnerIdOrNull

Serializable getLoadedCollectionOwnerIdOrNull(PersistentCollection collection)
Get the ID for the entity that owned this persistent collection when it was loaded

Parameters:
collection - The persistent collection
Returns:
the owner ID if available from the collection's loaded key; otherwise, returns null

addUninitializedCollection

void addUninitializedCollection(CollectionPersister persister,
                                PersistentCollection collection,
                                Serializable id)
add a collection we just loaded up (still needs initializing)


addUninitializedDetachedCollection

void addUninitializedDetachedCollection(CollectionPersister persister,
                                        PersistentCollection collection)
add a detached uninitialized collection


addNewCollection

void addNewCollection(CollectionPersister persister,
                      PersistentCollection collection)
                      throws HibernateException
Add a new collection (ie. a newly created one, just instantiated by the application, with no database state or snapshot)

Parameters:
collection - The collection to be associated with the persistence context
Throws:
HibernateException

addInitializedDetachedCollection

void addInitializedDetachedCollection(CollectionPersister collectionPersister,
                                      PersistentCollection collection)
                                      throws HibernateException
add an (initialized) collection that was created by another session and passed into update() (ie. one with a snapshot and existing state on the database)

Throws:
HibernateException

addInitializedCollection

CollectionEntry addInitializedCollection(CollectionPersister persister,
                                         PersistentCollection collection,
                                         Serializable id)
                                         throws HibernateException
add a collection we just pulled out of the cache (does not need initializing)

Throws:
HibernateException

getCollection

PersistentCollection getCollection(CollectionKey collectionKey)
Get the collection instance associated with the CollectionKey


addNonLazyCollection

void addNonLazyCollection(PersistentCollection collection)
Register a collection for non-lazy loading at the end of the two-phase load


initializeNonLazyCollections

void initializeNonLazyCollections()
                                  throws HibernateException
Force initialization of all non-lazy collections encountered during the current two-phase load (actually, this is a no-op, unless this is the "outermost" load)

Throws:
HibernateException

getCollectionHolder

PersistentCollection getCollectionHolder(Object array)
Get the PersistentCollection object for an array


addCollectionHolder

void addCollectionHolder(PersistentCollection holder)
Register a PersistentCollection object for an array. Associates a holder with an array - MUST be called after loading array, since the array instance is not created until endLoad().


removeCollectionHolder

PersistentCollection removeCollectionHolder(Object array)
Remove the mapping of collection to holder during eviction of the owning entity


getSnapshot

Serializable getSnapshot(PersistentCollection coll)
Get the snapshot of the pre-flush collection state


getCollectionEntryOrNull

CollectionEntry getCollectionEntryOrNull(Object collection)
Get the collection entry for a collection passed to filter, which might be a collection wrapper, an array, or an unwrapped collection. Return null if there is no entry.


getProxy

Object getProxy(EntityKey key)
Get an existing proxy by key


addProxy

void addProxy(EntityKey key,
              Object proxy)
Add a proxy to the session cache


removeProxy

Object removeProxy(EntityKey key)
Remove a proxy from the session cache


getNullifiableEntityKeys

HashSet getNullifiableEntityKeys()
Retrieve the set of EntityKeys representing nullifiable references


getEntitiesByKey

Map getEntitiesByKey()
Get the mapping from key value to entity instance


getEntityEntries

Map getEntityEntries()
Get the mapping from entity instance to entity entry


getCollectionEntries

Map getCollectionEntries()
Get the mapping from collection instance to collection entry


getCollectionsByKey

Map getCollectionsByKey()
Get the mapping from collection key to collection instance


getCascadeLevel

int getCascadeLevel()
How deep are we cascaded?


incrementCascadeLevel

int incrementCascadeLevel()
Called before cascading


decrementCascadeLevel

int decrementCascadeLevel()
Called after cascading


isFlushing

boolean isFlushing()
Is a flush cycle currently in process?


setFlushing

void setFlushing(boolean flushing)
Called before and after the flushcycle


beforeLoad

void beforeLoad()
Call this before begining a two-phase load


afterLoad

void afterLoad()
Call this after finishing a two-phase load


isLoadFinished

boolean isLoadFinished()
Is in a two-phase load?


toString

String toString()
Returns a string representation of the object.

Overrides:
toString in class Object
Returns:
a string representation of the object.

getOwnerId

Serializable getOwnerId(String entity,
                        String property,
                        Object childObject,
                        Map mergeMap)
Search the persistence context for an owner for the child object, given a collection role


getIndexInOwner

Object getIndexInOwner(String entity,
                       String property,
                       Object childObject,
                       Map mergeMap)
Search the persistence context for an index of the child object, given a collection role


addNullProperty

void addNullProperty(EntityKey ownerKey,
                     String propertyName)
Record the fact that the association belonging to the keyed entity is null.


isPropertyNull

boolean isPropertyNull(EntityKey ownerKey,
                       String propertyName)
Is the association property belonging to the keyed entity null?


isDefaultReadOnly

boolean isDefaultReadOnly()
Will entities and proxies that are loaded into this persistence context be made read-only by default? To determine the read-only/modifiable setting for a particular entity or proxy:

Returns:
true, loaded entities/proxies will be made read-only by default; false, loaded entities/proxies will be made modifiable by default.
See Also:
isReadOnly(Object), Session.isReadOnly(Object), Session.isDefaultReadOnly()

setDefaultReadOnly

void setDefaultReadOnly(boolean readOnly)
Change the default for entities and proxies loaded into this persistence context from modifiable to read-only mode, or from modifiable to read-only mode. Read-only entities are not dirty-checked and snapshots of persistent state are not maintained. Read-only entities can be modified, but changes are not persisted. When a proxy is initialized, the loaded entity will have the same read-only/modifiable setting as the uninitialized proxy has, regardless of the persistence context's current setting. To change the read-only/modifiable setting for a particular entity or proxy that is already in this session: + * @see PersistenceContext#setReadOnly(Object,boolean)

Parameters:
readOnly - true, the default for loaded entities/proxies is read-only; false, the default for loaded entities/proxies is modifiable
See Also:
To override this session's read-only/modifiable setting for entities and proxies loaded by a Query:, Query.setReadOnly(boolean), Session.setDefaultReadOnly(boolean)

isReadOnly

boolean isReadOnly(Object entityOrProxy)
Is the entity or proxy read-only?

To determine the default read-only/modifiable setting used for entities and proxies that are loaded into the session use Session.isDefaultReadOnly()

Parameters:
entityOrProxy - an entity or proxy
Returns:
true if the object is read-only; otherwise false to indicate that the object is modifiable.

setReadOnly

void setReadOnly(Object entityOrProxy,
                 boolean readOnly)
Set an unmodified persistent object to read-only mode, or a read-only object to modifiable mode. Read-only entities are not dirty-checked and snapshots of persistent state are not maintained. Read-only entities can be modified, but changes are not persisted. When a proxy is initialized, the loaded entity will have the same read-only/modifiable setting as the uninitialized proxy has, regardless of the session's current setting. If the entity or proxy already has the specified read-only/modifiable setting, then this method does nothing.

Parameters:
entityOrProxy - an entity or proxy
readOnly - if true, the entity or proxy is made read-only; otherwise, the entity or proxy is made modifiable.
See Also:
Session.setDefaultReadOnly(boolean), Session.setReadOnly(java.lang.Object, boolean), Query.setReadOnly(boolean)

replaceDelayedEntityIdentityInsertKeys

void replaceDelayedEntityIdentityInsertKeys(EntityKey oldKey,
                                            Serializable generatedId)

addChildParent

void addChildParent(Object child,
                    Object parent)
Add a child/parent relation to cache for cascading op

Parameters:
child - The child of the relationship
parent - The parent of the relationship

removeChildParent

void removeChildParent(Object child)
Remove child/parent relation from cache

Parameters:
child - The child to be removed.

registerInsertedKey

void registerInsertedKey(EntityPersister persister,
                         Serializable id)
Register keys inserted during the current transaction

Parameters:
persister - The entity persister
id - The id

wasInsertedDuringTransaction

boolean wasInsertedDuringTransaction(EntityPersister persister,
                                     Serializable id)
Allows callers to check to see if the identified entity was inserted during the current transaction.

Parameters:
persister - The entity persister
id - The id
Returns:
True if inserted during this transaction, false otherwise.

getNaturalIdHelper

PersistenceContext.NaturalIdHelper getNaturalIdHelper()
Access to the natural-id helper for this persistence context

Returns:
This persistence context's natural-id helper


Copyright © 2001-2013 Red Hat, Inc. All Rights Reserved.