Package org.hibernate.engine.spi
Interface CascadingAction
-
- All Known Implementing Classes:
CascadingActions.BaseCascadingAction
public interface CascadingAction
A session action that may be cascaded from parent entity to its children
-
-
Method Summary
All Methods Instance Methods Abstract Methods Modifier and Type Method Description void
cascade(EventSource session, java.lang.Object child, java.lang.String entityName, java.lang.Object anything, boolean isCascadeDeleteEnabled)
Cascade the action to the child object.boolean
deleteOrphans()
Does this action potentially extrapolate to orphan deletes?java.util.Iterator
getCascadableChildrenIterator(EventSource session, CollectionType collectionType, java.lang.Object collection)
Given a collection, get an iterator of the children upon which the current cascading action should be visited.void
noCascade(EventSource session, java.lang.Object parent, EntityPersister persister, Type propertyType, int propertyIndex)
Called (in the case ofrequiresNoCascadeChecking()
returning true) to validate that no cascade on the given property is considered a valid semantic.boolean
performOnLazyProperty()
Should this action be performed (or noCascade consulted) in the case of lazy properties.boolean
requiresNoCascadeChecking()
Does the specified cascading action require verification of no cascade validity?
-
-
-
Method Detail
-
cascade
void cascade(EventSource session, java.lang.Object child, java.lang.String entityName, java.lang.Object anything, boolean isCascadeDeleteEnabled) throws HibernateException
Cascade the action to the child object.- Parameters:
session
- The session within which the cascade is occuring.child
- The child to which cascading should be performed.entityName
- The child's entity nameanything
- Anything ;) Typically some form of cascade-local cache which is specific to each CascadingAction typeisCascadeDeleteEnabled
- Are cascading deletes enabled.- Throws:
HibernateException
-
getCascadableChildrenIterator
java.util.Iterator getCascadableChildrenIterator(EventSource session, CollectionType collectionType, java.lang.Object collection)
Given a collection, get an iterator of the children upon which the current cascading action should be visited.- Parameters:
session
- The session within which the cascade is occuring.collectionType
- The mapping type of the collection.collection
- The collection instance.- Returns:
- The children iterator.
-
deleteOrphans
boolean deleteOrphans()
Does this action potentially extrapolate to orphan deletes?- Returns:
- True if this action can lead to deletions of orphans.
-
requiresNoCascadeChecking
boolean requiresNoCascadeChecking()
Does the specified cascading action require verification of no cascade validity?- Returns:
- True if this action requires no-cascade verification; false otherwise.
-
noCascade
void noCascade(EventSource session, java.lang.Object parent, EntityPersister persister, Type propertyType, int propertyIndex)
Called (in the case ofrequiresNoCascadeChecking()
returning true) to validate that no cascade on the given property is considered a valid semantic.- Parameters:
session
- The session witin which the cascade is occurring.parent
- The property value ownerpersister
- The entity persister for the ownerpropertyType
- The property typepropertyIndex
- The index of the property within the owner.
-
performOnLazyProperty
boolean performOnLazyProperty()
Should this action be performed (or noCascade consulted) in the case of lazy properties.
-
-