oracle.toplink.publicinterface
Class DescriptorEvent

java.lang.Object
  |
  +--java.util.EventObject
        |
        +--oracle.toplink.publicinterface.DescriptorEvent

All Implemented Interfaces:

java.io.Serializable

public class DescriptorEvent

extends java.util.EventObject

Purpose: Encapsulate the information provided with descriptor events. This is used as the argument to any event raised by the descriptor. Events can be registered for through two methods, the first is by providing a method to be called on the object that a paticular operation is being performed on. The second is by registering a manager object to be notified when any event occurs for that descriptor. The second method is more similar to the java beans event model but requires the registered object to implement the DescriptorEventListener interface.

See Also:

DescriptorEventManager, DescriptorEventListener, Serialized Form

Constructor Summary

DescriptorEvent(int eventCode, ObjectLevelModifyQuery query)
PUBLIC: Most events are trigger from queries, so this is a helper method.

DescriptorEvent(java.lang.Object sourceObject)
PUBLIC: All events require a source object.

Method Summary

Type	Method
void	applyAttributeValuesIntoRow(java.lang.String attributeName) PUBLIC: Re-populate the database row with the values from the source object based upon the attribute's mapping.
oracle.toplink.internal.sessions.ObjectChangeSet	getChangeSet() PUBLIC: Returns the Object changeSet if available
Descriptor	getDescriptor() PUBLIC: The source descriptor of the event.
int	getEventCode() PUBLIC: The code of the descriptor event being raised.
java.lang.Object	getObject() PUBLIC: Synanym for source.
java.lang.Object	getOriginalObject() PUBLIC: The source object represents the object the event is being raised on, some events also require a second object, for example the original object in a postClone.
DatabaseQuery	getQuery() PUBLIC: The query causing the event.
DatabaseRow	getRow() PUBLIC: Optionally a database row may be provided on some events, (such as aboutToUpdate).
Session	getSession() PUBLIC: The session in which the event is raised.

Methods inherited from class java.util.EventObject

getSource

Methods inherited from class java.lang.Object

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

Constructor Detail

DescriptorEvent

public DescriptorEvent(int eventCode,
                       ObjectLevelModifyQuery query)

PUBLIC: Most events are trigger from queries, so this is a helper method.

DescriptorEvent

public DescriptorEvent(java.lang.Object sourceObject)

PUBLIC: All events require a source object.

Method Detail

applyAttributeValuesIntoRow

public void applyAttributeValuesIntoRow(java.lang.String attributeName)

PUBLIC: Re-populate the database row with the values from the source object based upon the attribute's mapping. Provided as a helper method for modifying the row during event handling.

getChangeSet

public oracle.toplink.internal.sessions.ObjectChangeSet getChangeSet()

PUBLIC: Returns the Object changeSet if available

getDescriptor

public Descriptor getDescriptor()

PUBLIC: The source descriptor of the event.

getEventCode

public int getEventCode()

PUBLIC: The code of the descriptor event being raised. This is an integer constant value from DescriptorEventManager.

getObject

public java.lang.Object getObject()

PUBLIC: Synanym for source.

getOriginalObject

public java.lang.Object getOriginalObject()

PUBLIC: The source object represents the object the event is being raised on, some events also require a second object, for example the original object in a postClone.

See Also:

EventObject.getSource()

getQuery

public DatabaseQuery getQuery()

PUBLIC: The query causing the event.

getRow

public DatabaseRow getRow()

PUBLIC: Optionally a database row may be provided on some events, (such as aboutToUpdate).

getSession

public Session getSession()

PUBLIC: The session in which the event is raised.