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

Property Summary

Properties

Type	Property and Description
boolean	performOnLazy Should this action be performed (or noCascade consulted) in the case of lazy properties.

Method Summary

Methods

Modifier and Type	Method and Description
void	cascade(EventSource session, Object child, String entityName, Object anything, boolean isCascadeDeleteEnabled) Cascade the action to the child object.
boolean	deleteOrphans() Does this action potentially extrapolate to orphan deletes?
Iterator	getCascadableChildrenIterator(EventSource session, CollectionType collectionType, Object collection) Given a collection, get an iterator of the children upon which the current cascading action should be visited.
void	noCascade(EventSource session, Object child, Object parent, EntityPersister persister, int propertyIndex) Called (in the case of requiresNoCascadeChecking() 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?

Property Detail

performOnLazy

Should this action be performed (or noCascade consulted) in the case of lazy properties.

Method Detail

cascade

void cascade(EventSource session,
           Object child,
           String entityName,
           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 name

anything - Anything ;) Typically some form of cascade-local cache which is specific to each CascadingAction type

isCascadeDeleteEnabled - Are cascading deletes enabled.

Throws:

HibernateException

getCascadableChildrenIterator

Iterator getCascadableChildrenIterator(EventSource session,
                                     CollectionType collectionType,
                                     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,
             Object child,
             Object parent,
             EntityPersister persister,
             int propertyIndex)

Called (in the case of requiresNoCascadeChecking() 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.

child - The property value

parent - The property value owner

persister - The entity persister for the owner

propertyIndex - 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.