A convenience bas class for listeners responding to save events.
cascadeAfterSave
protected void cascadeAfterSave(EventSource source,
EntityPersister persister,
Object entity,
Object anything)
Handles to calls needed to perform post-save cascades.
source
- The session from which the event originated.persister
- The entity's persister instance.entity
- The entity beng saved.anything
- Generally cascade-specific data
cascadeBeforeSave
protected void cascadeBeforeSave(EventSource source,
EntityPersister persister,
Object entity,
Object anything)
Handles the calls needed to perform pre-save cascades for the given entity.
source
- The session from whcih the save event originated.persister
- The entity's persister instance.entity
- The entity to be saved.anything
- Generally cascade-specific data
getAssumedUnsaved
protected Boolean getAssumedUnsaved()
getEntityState
protected int getEntityState(Object entity,
String entityName,
EntityEntry entry,
SessionImplementor source)
Determine whether the entity is persistent, detached, or transient
entity
- The entity to checkentityName
- The name of the entityentry
- The entity's entry in the persistence contextsource
- The originating session.
getLoggableName
protected String getLoggableName(String entityName,
Object entity)
getMergeMap
protected Map getMergeMap(Object anything)
isVersionIncrementDisabled
protected boolean isVersionIncrementDisabled()
After the save, will te version number be incremented
if the instance is modified?
- True if the version will be incremented on an entity change after save;
false otherwise.
performSave
protected Serializable performSave(Object entity,
Serializable id,
EntityPersister persister,
boolean useIdentityColumn,
Object anything,
EventSource source,
boolean requiresImmediateIdAccess)
Ppepares the save call by checking the session caches for a pre-existing
entity and performing any lifecycle callbacks.
entity
- The entity to be saved.id
- The id by which to save the entity.persister
- The entity's persister instance.useIdentityColumn
- Is an identity column being used?anything
- Generally cascade-specific information.source
- The session from which the event originated.requiresImmediateIdAccess
- does the event context require
access to the identifier immediately after execution of this method (if
not, post-insert style id generators may be postponed if we are outside
a transaction).
- The id used to save the entity; may be null depending on the
type of id generator used and the requiresImmediateIdAccess value
performSaveOrReplicate
protected Serializable performSaveOrReplicate(Object entity,
EntityKey key,
EntityPersister persister,
boolean useIdentityColumn,
Object anything,
EventSource source,
boolean requiresImmediateIdAccess)
Performs all the actual work needed to save an entity (well to get the save moved to
the execution queue).
entity
- The entity to be savedkey
- The id to be used for saving the entity (or null, in the case of identity columns)persister
- The entity's persister instance.useIdentityColumn
- Should an identity column be used for id generation?anything
- Generally cascade-specific information.source
- The session which is the source of the current event.requiresImmediateIdAccess
- Is access to the identifier required immediately
after the completion of the save? persist(), for example, does not require this...
- The id used to save the entity; may be null depending on the
type of id generator used and the requiresImmediateIdAccess value
saveWithGeneratedId
protected Serializable saveWithGeneratedId(Object entity,
String entityName,
Object anything,
EventSource source,
boolean requiresImmediateIdAccess)
Prepares the save call using a newly generated id.
entity
- The entity to be savedentityName
- The entity-name for the entity to be savedanything
- Generally cascade-specific information.source
- The session which is the source of this save event.requiresImmediateIdAccess
- does the event context require
access to the identifier immediately after execution of this method (if
not, post-insert style id generators may be postponed if we are outside
a transaction).
- The id used to save the entity; may be null depending on the
type of id generator used and the requiresImmediateIdAccess value
saveWithRequestedId
protected Serializable saveWithRequestedId(Object entity,
Serializable requestedId,
String entityName,
Object anything,
EventSource source)
Prepares the save call using the given requested id.
entity
- The entity to be saved.requestedId
- The id to which to associate the entity.entityName
- The name of the entity being saved.anything
- Generally cascade-specific information.source
- The session which is the source of this save event.
- The id used to save the entity.
substituteValuesIfNecessary
protected boolean substituteValuesIfNecessary(Object entity,
Serializable id,
Object[] values,
EntityPersister persister,
SessionImplementor source)
Perform any property value substitution that is necessary
(interceptor callback, version initialization...)
entity
- The entityid
- The entity identifiervalues
- The snapshot entity statepersister
- The entity persistersource
- The originating session
- True if the snapshot state changed such that
reinjection of the values into the entity is required.
visitCollectionsBeforeSave
protected boolean visitCollectionsBeforeSave(Object entity,
Serializable id,
Object[] values,
Type[] types,
EventSource source)