JDO Class

InstanceLifecycleEvent

java.lang.Object
  ∟ java.util.EventObject
    ∟ javax.jdo.listener.InstanceLifecycleEvent
This is the event class used in life cycle event notifications.

Note that although InstanceLifecycleEvent inherits Serializable interface from EventObject, it is not intended to be Serializable. Appropriate serialization methods are implemented to throw NotSerializableException.

Since:
JDO 2.0

Public Constructors

InstanceLifecycleEvent(Object source, int type)
Creates a new event object with the specified source and type.
Parameters:
source - the instance that triggered the event
type - the event type
Since:
JDO 2.0
InstanceLifecycleEvent(Object source, int type, Object target)
Creates a new event object with the specified source, type, and target.
Parameters:
source - the instance that triggered the event
type - the event type
target - the "other" instance
Since:
JDO 2.0

Public Methods

Object getDetachedInstance()
Returns the detached instance involved in the event.
Return:
The detached instance involved in the event, or null if there was none.
See Also:
"Section 12.15, Java Data Objects 2.0 Specification"
Since:
JDO 2.0
int getEventType()
Returns the event type that triggered this event.
Return:
the event type
Since:
JDO 2.0
Object getPersistentInstance()
Returns the persistent instance involved in the event.
Return:
The persistent instance involved in the event, or null if there was none.
See Also:
"Section 12.15, Java Data Objects 2.0 Specification"
Since:
JDO 2.0
Object getSource()
The source object of the Event.
Although not deprecated, it is recommended that the the methods getPersistentInstance() and getDetachedInstance() be used instead.
Return:
The persistent instance on any pre- callback except preAttach, or the detached instance for a postDetach or preAttach callback.
See Also:
getPersistentInstance()
getDetachedInstance()
"Section 12.15, Java Data Objects 2.0 Specification"
Since:
JDO 2.0
Object getTarget()
The target object of the Event.
Although not deprecated, it is recommended that the the methods getPersistentInstance() and getDetachedInstance() be used instead.
Return:
The detached instance for preDetach and postAttach, the persistent instance otherwise.
See Also:
getPersistentInstance()
getDetachedInstance()
"Section 12.15, Java Data Objects 2.0 Specification"
Since:
JDO 2.0

Public Static Fields

ATTACH
Since:
JDO 2.0
CLEAR
Since:
JDO 2.0
CREATE
Since:
JDO 2.0
DELETE
Since:
JDO 2.0
DETACH
Since:
JDO 2.0
DIRTY
Since:
JDO 2.0
LOAD
Since:
JDO 2.0
STORE
Since:
JDO 2.0

Method inherited from class java.util.EventObject

getSource, toString

Method inherited from class java.lang.Object

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