javax.jdo.listener
Class InstanceLifecycleEvent

java.lang.Object
  java.util.EventObject
      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
static int	LOAD
static int	STORE

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.

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

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

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"