Top Description Fields Constructors Methods
org.hibernate.event

public abstract Class AbstractCollectionEvent

extends AbstractEvent
Class Inheritance
Known Direct Subclasses
org.hibernate.event.InitializeCollectionEvent, org.hibernate.event.PostCollectionRecreateEvent, org.hibernate.event.PostCollectionRemoveEvent, org.hibernate.event.PostCollectionUpdateEvent, org.hibernate.event.PreCollectionRecreateEvent, org.hibernate.event.PreCollectionRemoveEvent, org.hibernate.event.PreCollectionUpdateEvent
Imports
java.io.Serializable, org.hibernate.collection.PersistentCollection, org.hibernate.engine.CollectionEntry, .EntityEntry, org.hibernate.persister.collection.CollectionPersister
Defines a base class for events involving collections.
Author
Gail Badner

Field Summary

Modifier and TypeField and Description
private final Object
affectedOwner

private final String
affectedOwnerEntityName

private final Serializable
affectedOwnerId

private final PersistentCollection
collection

Constructor Summary

AccessConstructor and Description
public
AbstractCollectionEvent(CollectionPersister collectionPersister, PersistentCollection
- the collection
collection, EventSource
- the Session source
source, Object
- the owner that is affected by this event; can be null if unavailable
affectedOwner, Serializable
- the ID for the owner that is affected by this event; can be null if unavailable that is affected by this event; can be null if unavailable
affectedOwnerId)

Constructs an AbstractCollectionEvent object.

Method Summary

Modifier and TypeMethod and Description
protected static String
getAffectedOwnerEntityName(CollectionPersister collectionPersister, Object affectedOwner, EventSource source)

public String

Returns:

the entity name; if the owner is not in the PersistenceContext, the returned value may be a superclass name, instead of the actual class name
getAffectedOwnerEntityName()

Get the entity name for the collection owner entity that is affected by this event.

public Serializable

Returns:

the affected owner ID; returns null if the ID cannot be obtained from the collection's loaded key (e.g., a property-ref is used for the collection and does not include the entity's ID)
getAffectedOwnerIdOrNull()

Get the ID for the collection owner entity that is affected by this event.

public Object

Returns:

the affected owner; returns null if the entity is not in the persistence context (e.g., because the collection from a detached entity was moved to a new owner)
getAffectedOwnerOrNull()

Get the collection owner entity that is affected by this event.

public PersistentCollection
getCollection()

protected static CollectionPersister
getLoadedCollectionPersister(PersistentCollection collection, EventSource source)

protected static Serializable
getLoadedOwnerIdOrNull(PersistentCollection collection, EventSource source)

protected static Object
getLoadedOwnerOrNull(PersistentCollection collection, EventSource source)

protected static Serializable
getOwnerIdOrNull(Object owner, EventSource source)

Inherited from org.hibernate.event.AbstractEvent:
getSession

Field Detail

affectedOwnerback to summary
private final Object affectedOwner
affectedOwnerEntityNameback to summary
private final String affectedOwnerEntityName
affectedOwnerIdback to summary
private final Serializable affectedOwnerId
collectionback to summary
private final PersistentCollection collection

Constructor Detail

AbstractCollectionEventback to summary
public AbstractCollectionEvent(CollectionPersister collectionPersister, PersistentCollection collection, EventSource source, Object affectedOwner, Serializable affectedOwnerId)

Constructs an AbstractCollectionEvent object.

Parameters
collection:PersistentCollection

- the collection

source:EventSource

- the Session source

affectedOwner:Object

- the owner that is affected by this event; can be null if unavailable

affectedOwnerId:Serializable

- the ID for the owner that is affected by this event; can be null if unavailable that is affected by this event; can be null if unavailable

Method Detail

getAffectedOwnerEntityNameback to summary
protected static String getAffectedOwnerEntityName(CollectionPersister collectionPersister, Object affectedOwner, EventSource source)
getAffectedOwnerEntityNameback to summary
public String getAffectedOwnerEntityName()

Get the entity name for the collection owner entity that is affected by this event.

Returns:String

the entity name; if the owner is not in the PersistenceContext, the returned value may be a superclass name, instead of the actual class name

getAffectedOwnerIdOrNullback to summary
public Serializable getAffectedOwnerIdOrNull()

Get the ID for the collection owner entity that is affected by this event.

Returns:Serializable

the affected owner ID; returns null if the ID cannot be obtained from the collection's loaded key (e.g., a property-ref is used for the collection and does not include the entity's ID)

getAffectedOwnerOrNullback to summary
public Object getAffectedOwnerOrNull()

Get the collection owner entity that is affected by this event.

Returns:Object

the affected owner; returns null if the entity is not in the persistence context (e.g., because the collection from a detached entity was moved to a new owner)

getCollectionback to summary
public PersistentCollection getCollection()
getLoadedCollectionPersisterback to summary
protected static CollectionPersister getLoadedCollectionPersister(PersistentCollection collection, EventSource source)
getLoadedOwnerIdOrNullback to summary
protected static Serializable getLoadedOwnerIdOrNull(PersistentCollection collection, EventSource source)
getLoadedOwnerOrNullback to summary
protected static Object getLoadedOwnerOrNull(PersistentCollection collection, EventSource source)
getOwnerIdOrNullback to summary
protected static Serializable getOwnerIdOrNull(Object owner, EventSource source)