Package org.hibernate.engine.spi

Interface CascadingAction<T>

All Known Implementing Classes:

CascadingActions.BaseCascadingAction

public interface CascadingAction<T>

A session action that may be cascaded from parent entity to its children

Method Summary

Modifier and Type	Method	Description
void	cascade(EventSource session, Object child, String entityName, T 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 parent, EntityPersister persister, Type propertyType, 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?

Method Detail

cascade

void cascade(EventSource session,
             Object child,
             String entityName,
             T anything,
             boolean isCascadeDeleteEnabled)
      throws HibernateException

Cascade the action to the child object.

Parameters:

session - The session within which the cascade is occurring.

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

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 parent,
               EntityPersister persister,
               Type propertyType,
               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 within which the cascade is occurring.

parent - The property value owner

persister - The entity persister for the owner

propertyType - The property type

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.