public Class DescriptorEventManager

PUBLIC: EJB 3.0 support for default listeners.

PUBLIC: EJB 3.0 support for lifecycle callback events defined on an entity listener class.

INTERNAL:

INTERNAL:

PUBLIC: Listener objects can be registered with the event manager to be notified when an event occurs on any instance of the descriptor's class.

Overrides java.lang.Object.clone.

INTERNAL: Clone the manager and its private parts.

Returns:Object

Doc from java.lang.Object.clone.

a clone of this instance.

Annotations

@Override

INTERNAL: EJB 3.0 support. Returns true if this event manager should exclude the invocation of the default listeners for this descriptor.

INTERNAL: EJB 3.0 support. Returns true is this event manager should exclude the invocation of the listeners defined by the entity listener classes for the superclasses of this descriptor.

Implements abstract org.eclipse.persistence.core.descriptors.CoreDescriptorEventManager.executeEvent.

INTERNAL: Execute the given selector with the event as argument.

Annotations

@Override

Exceptions

DescriptorException:

- the method cannot be found or executed

INTERNAL: bug 251180 - Missing method org.eclipse.persistence.descriptors.DescriptorEventManager#setAboutToDeleteSelector

INTERNAL:

INTERNAL:

INTERNAL: EJB 3.0 support. Returns the default listeners.

INTERNAL: used by JPA project caching to store DescriptorEventListener representations that can build the underlying DescriptorEventListener and add it to the EventManager.

INTERNAL: EJB 3.0 support. Returns the entity event listener.

INTERNAL: EJB 3.0 support. Returns the entity listener event listeners.

PUBLIC: Returns the Listener objects that have been added.

See Also

addListener(DescriptorEventListener)

PUBLIC: The name of the method called after an object is built

PUBLIC: The name of the method called after an object is cloned

PUBLIC: The name of the method called after an object is deleted

PUBLIC: The name of the method called after an object is inserted

PUBLIC: The name of the method called after an object is merged

PUBLIC: The name of the method called after an object is refreshed

PUBLIC: The name of the method called after an object is updated

PUBLIC: The name of the method called after an object is written

PUBLIC: The name of the method called before an object is deleted

PUBLIC: The name of the method called before an object is inserted

PUBLIC: The name of the method called before the create operation is applied to an object

PUBLIC: The name of the method called before the remove operation is applied to an object

PUBLIC: The name of the method called before an object is updated

PUBLIC: The name of the method called before an object is written

Implements abstract org.eclipse.persistence.core.descriptors.CoreDescriptorEventManager.hasAnyEventListeners.

INTERNAL: Return if the event manager has any event listeners, or event methods. If nothing is listening to event they can be avoided.

Annotations

@Override

INTERNAL: This method will return true, if this event manager has default listeners and does not exclude them. Default listeners are always added to every event manager to allow users to turn them on a later time if so desired.

INTERNAL: EJB 3.0 support. Return true if this event manager has any entity event listeners.

INTERNAL: EJB 3.0 support. Return true if this event manager has any entity listener event listeners.

INTERNAL: Internal event support. Return true if this event manager has any internal listener event listeners.

INTERNAL: Configure inherited selectors.

INTERNAL: Notify the event listeners.

INTERNAL: This method was added to allow JPA project caching so that DescriptorEventListeners could be serialized and re-added to the EventManager using a SerializableDescriptorEventHolder.

INTERNAL: Used to initialize a remote DescriptorEventManager.

PUBLIC: Remove a event listener.

PUBLIC: A method can be registered to be called when an object's row it about to be inserted. This uses the optional event argument of the DatabaseRow. This is different from pre/postInsert because it occurs after the row has already been built. This event can be used to modify the row before insert, such as adding a user inserted by.

PUBLIC: A method can be registered to be called when an object's row it about to be inserted. This uses the optional event argument of the DatabaseRow. This is different from pre/postInsert because it occurs after the row has already been built. This event can be used to modify the row before insert, such as adding a user inserted by.

PUBLIC: A method can be registered to be called when an object's row it about to be updated. This uses the optional event argument of the DatabaseRow. This is different from pre/postUpdate because it occurs after the row has already been built, and it ONLY called if the update is required (changed within a unit of work), as the other occur ALWAYS. This event can be used to modify the row before insert, such as adding a user inserted by.

INTERNAL: Set the descriptor.

INTERNAL: used by JPA project caching to store DescriptorEventListener representations that can build the underlying DescriptorEventListener and add it to the EventManager.

PUBLIC: EJB 3.0 support for lifecycle callback events defined on an entity class.

INTERNAL: EJB 3.0 support. Default listeners apply to all entities in a persistence unit. Set this flag to true to exclude the invocation of the default listeners for this descriptor.

INTERNAL: EJB 3.0 support. If multiple entity classes in an inheritance hierarchy define entity listeners, the listeners defined for a superclass are invoked before the listeners defined for its subclasses. Set this flag to true to exclude the invocation of the listeners defined by the entity listener classes for the superclasses of this descriptor.

PUBLIC: A method can be registered to be called on a object that has just been built from the database. This uses the optional event argument for the DatabaseRow. This event can be used to correctly initialize an object's non-persistent attributes or to perform complex optimizations or mappings. This event is called whenever an object is built.

PUBLIC: A method can be registered to be called on a object that has just been cloned into a unit of work. This uses the optional event argument for the original object (the source object is the clone). This event can be used to correctly initialize an object's non-persistent attributes.

PUBLIC: A method can be registered to be called on a object that has just been deleted from the database. This event can notify/remove any dependents on the object.

PUBLIC: A method can be registered to be called on a object that has just been inserted into the database. This event can be used to notify any dependent on the object, or to update information not accessible until the object has been inserted.

PUBLIC: A method can be registered to be called on a object that has just been merge from a unit of work. This uses the optional event argument of the original object which is the object being merged from, the source object is the object being merged into. This event can be used to correctly initialize an object's non-persistent attributes.

PUBLIC: A method can be registered to be called on a object that has just been refreshed from the database. This uses the optional event argument of the DatabaseRow. This event can be used to correctly initialize an object's non-persistent attributes or to perform complex optimizations or mappings. This event is only called on refreshes of existing objects.

PUBLIC: A method can be registered to be called on a object that has just been updated into the database.

PUBLIC: A method can be registered to be called on a object that has just been written to the database. This event is raised on any registered object in a unit of work, even if it has not changed, refer to the "aboutToUpdate" selector if it is required for the event to be raised only when the object has been changed. This will be called on all inserts and updates, after the "postInsert/Update" event has been raised. This event can be used to notify any dependent on the object.

PUBLIC: A method can be registered to be called on a object that is going to be deleted from the database. This event can notify/remove any dependents on the object.

PUBLIC: A method can be registered to be called on a object that is going to be inserted into the database. This event can be used to notify any dependent on the object or acquire the object's id through a custom mechanism.

PUBLIC: A method can be registered to be called on a object when that object has the create operation applied to it.

PUBLIC: A method can be registered to be called on a object when that object has the remove operation applied to it.

PUBLIC: A method can be registered to be called on a object that is going to be updated into the database. This event is raised on any registered object in a unit of work, even if it has not changed, refer to the "aboutToUpdate" selector if it is required for the event to be raised only when the object has been changed. This event can be used to notify any dependent on the object.

PUBLIC: A method can be registered to be called on a object that is going to be written to the database. This event is raised on any registered object in a unit of work, even if it has not changed, refer to the "aboutToUpdate" selector if it is required for the event to be raised only when the object has been changed. This will be called on all inserts and updates, before the "preInsert/Update" event has been raised. This event can be used to notify any dependent on the object.