org.hibernate.cache.internal

Class CollectionCacheInvalidator

java.lang.Object

org.hibernate.cache.internal.CollectionCacheInvalidator

All Implemented Interfaces:

Serializable, PostDeleteEventListener, PostInsertEventListener, PostUpdateEventListener, Integrator

public class CollectionCacheInvalidator
extends Object
implements Integrator, PostInsertEventListener, PostDeleteEventListener, PostUpdateEventListener

Allows the collection cache to be automatically evicted if an element is inserted/removed/updated *without* properly managing both sides of the association (ie, the ManyToOne collection is changed w/o properly managing the OneToMany). For this functionality to be used, AvailableSettings.AUTO_EVICT_COLLECTION_CACHE must be enabled. For performance reasons, it's disabled by default.

Author:

Andreas Berger

See Also:

Serialized Form

Field Summary

Fields

Modifier and Type	Field and Description
static boolean	PROPAGATE_EXCEPTION Exposed for use in testing

Constructor Summary

Constructors

Constructor and Description
CollectionCacheInvalidator()

Method Summary

Modifier and Type	Method and Description
void	disintegrate(SessionFactoryImplementor sessionFactory, SessionFactoryServiceRegistry serviceRegistry) Tongue-in-cheek name for a shutdown callback.
void	integrate(Metadata metadata, SessionFactoryImplementor sessionFactory, SessionFactoryServiceRegistry serviceRegistry) Perform integration.
void	onPostDelete(PostDeleteEvent event)
void	onPostInsert(PostInsertEvent event)
void	onPostUpdate(PostUpdateEvent event)
boolean	requiresPostCommitHanding(EntityPersister persister) Does this listener require that after transaction hooks be registered? Typically this is true for post-insert event listeners, but may not be, for example, in JPA cases where there are no callbacks defined for the particular entity.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

PROPAGATE_EXCEPTION

public static boolean PROPAGATE_EXCEPTION

Exposed for use in testing

Constructor Detail

CollectionCacheInvalidator

public CollectionCacheInvalidator()

Method Detail

integrate

public void integrate(Metadata metadata,
                      SessionFactoryImplementor sessionFactory,
                      SessionFactoryServiceRegistry serviceRegistry)

Description copied from interface: Integrator

Perform integration.

Specified by:

integrate in interface Integrator

Parameters:

metadata - The "compiled" representation of the mapping information

sessionFactory - The session factory being created

serviceRegistry - The session factory's service registry

disintegrate

public void disintegrate(SessionFactoryImplementor sessionFactory,
                         SessionFactoryServiceRegistry serviceRegistry)

Description copied from interface: Integrator

Tongue-in-cheek name for a shutdown callback.

Specified by:

disintegrate in interface Integrator

Parameters:

sessionFactory - The session factory being closed.

serviceRegistry - That session factory's service registry

onPostInsert

public void onPostInsert(PostInsertEvent event)

Specified by:

onPostInsert in interface PostInsertEventListener

requiresPostCommitHanding

public boolean requiresPostCommitHanding(EntityPersister persister)

Description copied from interface: PostInsertEventListener

Does this listener require that after transaction hooks be registered? Typically this is true for post-insert event listeners, but may not be, for example, in JPA cases where there are no callbacks defined for the particular entity.

Specified by:

requiresPostCommitHanding in interface PostDeleteEventListener

Specified by:

requiresPostCommitHanding in interface PostInsertEventListener

Specified by:

requiresPostCommitHanding in interface PostUpdateEventListener

Parameters:

persister - The persister for the entity in question.

Returns:

true if after transaction callbacks should be added.

onPostDelete

public void onPostDelete(PostDeleteEvent event)

Specified by:

onPostDelete in interface PostDeleteEventListener

onPostUpdate

public void onPostUpdate(PostUpdateEvent event)

Specified by:

onPostUpdate in interface PostUpdateEventListener