javax.jdo.listener
Class InstanceLifecycleEvent

java.lang.Object
  extended by java.util.EventObject
      extended by javax.jdo.listener.InstanceLifecycleEvent
All Implemented Interfaces:
java.io.Serializable

public class InstanceLifecycleEvent
extends java.util.EventObject

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:
2.0
Version:
2.0
See Also:
Serialized Form

Field Summary
static int ATTACH
           
static int CLEAR
           
static int CREATE
           
static int DELETE
           
static int DETACH
           
static int DIRTY
           
private  int eventType
          The event type that triggered the construction of this event object.
private static int FIRST_EVENT_TYPE
           
private static int LAST_EVENT_TYPE
           
static int LOAD
           
private static I18NHelper msg
          The Internationalization message helper.
static int STORE
           
private  java.lang.Object target
          The "other" object associated with the event.
 
Fields inherited from class java.util.EventObject
source
 
Constructor Summary
InstanceLifecycleEvent(java.lang.Object source, int type)
          Creates a new event object with the specified source and type.
InstanceLifecycleEvent(java.lang.Object source, int type, java.lang.Object target)
          Creates a new event object with the specified source, type, and target.
 
Method Summary
 java.lang.Object getDetachedInstance()
          Returns the detached instance involved in the event.
 int getEventType()
          Returns the event type that triggered this event.
 java.lang.Object getPersistentInstance()
          Returns the persistent instance involved in the event.
 java.lang.Object getSource()
          The source object of the Event.
 java.lang.Object getTarget()
          The target object of the Event.
private  void writeObject(java.io.ObjectOutputStream out)
          Serialization is not supported for InstanceLifecycleEvents.
 
Methods inherited from class java.util.EventObject
toString
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
 

Field Detail

FIRST_EVENT_TYPE

private static final int FIRST_EVENT_TYPE
See Also:
Constant Field Values

CREATE

public static final int CREATE
See Also:
Constant Field Values

LOAD

public static final int LOAD
See Also:
Constant Field Values

STORE

public static final int STORE
See Also:
Constant Field Values

CLEAR

public static final int CLEAR
See Also:
Constant Field Values

DELETE

public static final int DELETE
See Also:
Constant Field Values

DIRTY

public static final int DIRTY
See Also:
Constant Field Values

DETACH

public static final int DETACH
See Also:
Constant Field Values

ATTACH

public static final int ATTACH
See Also:
Constant Field Values

LAST_EVENT_TYPE

private static final int LAST_EVENT_TYPE
See Also:
Constant Field Values

msg

private static final I18NHelper msg
The Internationalization message helper.


eventType

private final int eventType
The event type that triggered the construction of this event object.


target

private final java.lang.Object target
The "other" object associated with the event.

Constructor Detail

InstanceLifecycleEvent

public InstanceLifecycleEvent(java.lang.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:
2.0

InstanceLifecycleEvent

public InstanceLifecycleEvent(java.lang.Object source,
                              int type,
                              java.lang.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:
2.0
Method Detail

getEventType

public int getEventType()
Returns the event type that triggered this event.

Returns:
the event type
Since:
2.0

getSource

public java.lang.Object getSource()
The source object of the Event. Although not deprecated, it is recommended that the the methods getPersistentInstance() and getDetachedInstance() be used instead.

Overrides:
getSource in class java.util.EventObject
Returns:
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"

getTarget

public java.lang.Object getTarget()
The target object of the Event. Although not deprecated, it is recommended that the the methods getPersistentInstance() and getDetachedInstance() be used instead.

Returns:
The detached instance for preDetach and postAttach, the persistent instance otherwise.
Since:
2.0
See Also:
getPersistentInstance(), getDetachedInstance(), "Section 12.15, Java Data Objects 2.0 Specification"

getPersistentInstance

public java.lang.Object getPersistentInstance()
Returns the persistent instance involved in the event.

Returns:
The persistent instance involved in the event, or null if there was none.
See Also:
"Section 12.15, Java Data Objects 2.0 Specification"

getDetachedInstance

public java.lang.Object getDetachedInstance()
Returns the detached instance involved in the event.

Returns:
The detached instance involved in the event, or null if there was none.
See Also:
"Section 12.15, Java Data Objects 2.0 Specification"

writeObject

private void writeObject(java.io.ObjectOutputStream out)
                  throws java.io.IOException
Serialization is not supported for InstanceLifecycleEvents. param out the output stream

Throws:
java.io.IOException
Since:
2.0