Package wt.fc

Class PersistenceManagerEvent

java.lang.Object

wt.events.KeyedEvent

wt.fc.PersistenceManagerEvent

All Implemented Interfaces:

wt.events.summary.SummarizedEvent

public class PersistenceManagerEvent
extends KeyedEvent

Used to represent events occuring within the PersistenceManager. This event supports both single and multiple object event targets. For most operations, the event target will either be a single Persistable or a WTCollection of Persistables.

The CLEANUP_LINK single object event contains the source Persistable object as the target and the cleaned up link is populated in the associatedLink attribute. The CLEANUP_LINK multiple object event contains a WTKeyedMap as the target. The key set in this map contains the source object and the associated values are the link objects. Note that the objects in the WTKeyedMap may not be inflated so they should be accesed as references when possible.

The COPY_LINK single object event contains the original Link object as the target and the new link is populated in the associatedLink attribute.The COPY_LINK multiple object event contains a WTKeyedMap as the target. The key set in this map contains the original link objects and the associated values are the new link objects. Note that the objects in this event's WTKeyedMap will be inflated.

Supported API: true

Extendable: false

Field Summary

Fields

Modifier and Type	Field	Description
static final String	COPY_LINK	The event used to notify listeners that a link object has been copied.
static final String	INFLATE_RESULT	Deprecated. as of 8.0, this event is no longer supported.
static final String	INSERT	The event used to notify listeners that an object has been inserted in the datastore.
static final String	POST_DELETE	The event used to notify listeners that an object has been deleted.
static final String	POST_MODIFY	The event used to notify listeners that an object has been modified.
static final String	POST_MULTI_DELETE	Deprecated. as of R8.0, use POST_DELETE since multi-object events are supported directly
static final String	POST_STORE	The event used to notify listeners that a new object has been created.
static final String	PRE_DELETE	The event used to notify listeners that an object is about to be deleted.
static final String	PRE_INSERT	The event used to notify listeners that an object is about to be inserted in the datastore.
static final String	PRE_MODIFY	The event used to notify listeners that an object is about to be modified.
static final String	PRE_MULTI_DELETE	Deprecated. as of R8.0, use PRE_DELETE since multi-object events are supported directly
static final String	PRE_REMOVE	The event used to notify listeners that an object is about to be deleted from the datastore.
static final String	PRE_STORE	The event used to notify listeners that a new object is about to be created.
static final String	PREPARE_FOR_MODIFICATION	The event used to notify listeners that an object is to be prepared for modification.
static final String	PREPARE_FOR_VIEW	The event used to notify listeners that an object is to be prepared for view.
static final String	REMOVE	The event used to notify listeners that an object has been deleted from the datastore.
static final String	UPDATE	The event used to notify listeners that an object has been updated in the datastore.

Method Summary

Modifier and Type	Method	Description
Link	getAssociatedLink()	Deprecated. as of R8.0, use getEventTarget() in a multi-object event listener.
Object[]	getOperableObjectArray()	Deprecated. as of R8.0, use getEventTarget() since multi-object events are supported directly.

Methods inherited from class wt.events.KeyedEvent

generateEventKey, getEventKey, getEventTarget, getEventType

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Field Details

PRE_STORE

public static final String PRE_STORE

The event used to notify listeners that a new object is about to be created.

Supported API: true

See Also:

• PersistenceManager.store(wt.fc.Persistable)
• PersistenceManager.store(wt.fc.collections.WTCollection)
• Constant Field Values

POST_STORE

public static final String POST_STORE

The event used to notify listeners that a new object has been created.

Supported API: true

See Also:

• PersistenceManager.store(wt.fc.Persistable)
• PersistenceManager.store(wt.fc.collections.WTCollection)
• Constant Field Values

PRE_MODIFY

public static final String PRE_MODIFY

The event used to notify listeners that an object is about to be modified.

Supported API: true

See Also:

• PersistenceManager.modify(wt.fc.Persistable)
• PersistenceManager.modify(wt.fc.collections.WTCollection)
• Constant Field Values

POST_MODIFY

public static final String POST_MODIFY

The event used to notify listeners that an object has been modified.

Supported API: true

See Also:

• PersistenceManager.modify(wt.fc.Persistable)
• PersistenceManager.modify(wt.fc.collections.WTCollection)
• Constant Field Values

PREPARE_FOR_MODIFICATION

public static final String PREPARE_FOR_MODIFICATION

The event used to notify listeners that an object is to be prepared for modification.

Supported API: true

See Also:

• PersistenceManager.prepareForModification(wt.fc.Persistable)
• PersistenceManager.prepareForModification(wt.fc.collections.WTCollection)
• Constant Field Values

PREPARE_FOR_VIEW

public static final String PREPARE_FOR_VIEW

The event used to notify listeners that an object is to be prepared for view.

Supported API: true

See Also:

• PersistenceManager.prepareForView(wt.fc.Persistable)
• Constant Field Values

UPDATE

public static final String UPDATE

The event used to notify listeners that an object has been updated in the datastore.

Supported API: true

See Also:

• PersistenceManagerSvr.update(wt.fc.Persistable)
• PersistenceManagerSvr.update(wt.fc.collections.WTCollection)
• Constant Field Values

PRE_REMOVE

public static final String PRE_REMOVE

The event used to notify listeners that an object is about to be deleted from the datastore. This event is emitted between PRE_DELETE and POST_DELETE and before a REMOVE.

Supported API: true

See Also:

• PersistenceManager.delete(wt.fc.Persistable)
• PersistenceManager.delete(wt.fc.collections.WTSet)
• PersistenceManagerSvr.remove(wt.fc.Persistable)
• PersistenceManagerSvr.remove(wt.fc.collections.WTSet)
• Constant Field Values

REMOVE

public static final String REMOVE

The event used to notify listeners that an object has been deleted from the datastore. This event is emitted between PRE_DELETE and POST_DELETE and before a CLEANUP_LINK.

Supported API: true

See Also:

• PersistenceManager.delete(wt.fc.Persistable)
• PersistenceManager.delete(wt.fc.collections.WTSet)
• PersistenceManagerSvr.remove(wt.fc.Persistable)
• PersistenceManagerSvr.remove(wt.fc.collections.WTSet)
• Constant Field Values

PRE_DELETE

public static final String PRE_DELETE

The event used to notify listeners that an object is about to be deleted.

Supported API: true

See Also:

• PersistenceManager.delete(wt.fc.Persistable)
• PersistenceManager.delete(wt.fc.collections.WTSet)
• Constant Field Values

POST_DELETE

public static final String POST_DELETE

The event used to notify listeners that an object has been deleted.

Supported API: true

See Also:

• PersistenceManager.delete(wt.fc.Persistable)
• PersistenceManager.delete(wt.fc.collections.WTSet)
• Constant Field Values

COPY_LINK

public static final String COPY_LINK

The event used to notify listeners that a link object has been copied.

Supported API: true

See Also:

• PersistenceManagerSvr.copyLink(wt.fc.BinaryLink,wt.fc.Persistable,String,wt.fc.Persistable)
• PersistenceManagerSvr.copyLink(WTValuedHashMap)
• Constant Field Values

INFLATE_RESULT

public static final String INFLATE_RESULT

Deprecated.

as of 8.0, this event is no longer supported.

The event used to notify listeners that a query that might have ObjectReferences in it has been done.

Supported API: true

See Also:

• Constant Field Values

INSERT

public static final String INSERT

The event used to notify listeners that an object has been inserted in the datastore.

Supported API: true

See Also:

• PersistenceManagerSvr.insert(wt.fc.Persistable)
• PersistenceManagerSvr.insert(wt.fc.collections.WTCollection)
• Constant Field Values

PRE_MULTI_DELETE

public static final String PRE_MULTI_DELETE

Deprecated.

as of R8.0, use PRE_DELETE since multi-object events are supported directly

The event used to notify listeners that a multi object delete is about to begin.

Supported API: true

See Also:

• Constant Field Values

POST_MULTI_DELETE

public static final String POST_MULTI_DELETE

Deprecated.

as of R8.0, use POST_DELETE since multi-object events are supported directly

The event used to notify listeners that a multi object delete is complete.

Supported API: true

See Also:

• Constant Field Values

PRE_INSERT

public static final String PRE_INSERT

The event used to notify listeners that an object is about to be inserted in the datastore.

Supported API: true

See Also:

• Constant Field Values

Method Details

getAssociatedLink

public Link getAssociatedLink()

Deprecated.

as of R8.0, use getEventTarget() in a multi-object event listener.

Gets the value of the attribute: associatedLink; The link associated with the target object of a PersistenceManager operation.

Supported API: true

Returns:

Link

getOperableObjectArray

public Object[] getOperableObjectArray()

Deprecated.

as of R8.0, use getEventTarget() since multi-object events are supported directly.

Return the operableObjectArray associated to the multi delete event, may be null.

Supported API: true

Returns:

Object[]