Package org.apache.openjpa.event

Class RemoteCommitEvent

java.lang.Object

org.apache.openjpa.event.RemoteCommitEvent

All Implemented Interfaces:

Externalizable, Serializable

public class RemoteCommitEvent
extends Object
implements Externalizable

Event type to hold the IDs of additions, updates, and deletes. This event type is also fully serializable for remote communication.

Since:

0.3.0

Author:

Patrick Linskey, Abe White

See Also:

• Serialized Form

Field Summary

Fields

Modifier and Type	Field	Description
static final int	PAYLOAD_EXTENTS	Names of added, updated, and deleted classes only.
static final int	PAYLOAD_LOCAL_STALE_DETECTION	The local BrokerFactory detected that local data is out of date with the data store.
static final int	PAYLOAD_OIDS	Names of added classes, updated and deleted Object IDs.
static final int	PAYLOAD_OIDS_WITH_ADDS	Names of added classes, added, updated and deleted Object IDs.

Constructor Summary

Constructors

Constructor	Description
RemoteCommitEvent()	Constructor used during externalization.
RemoteCommitEvent(int payloadType, Collection addIds, Collection addClasses, Collection updates, Collection deletes)	Constructor.

Method Summary

Modifier and Type	Method	Description
Collection	getDeletedObjectIds()	When the event type is not PAYLOAD_EXTENTS, return the set of object IDs for deleted objects.
Collection	getDeletedTypeNames()	When the event type is PAYLOAD_EXTENTS, return the set of class names for the classes of deleted objects.
int	getPayloadType()	The event PAYLOAD constant.
Collection	getPersistedObjectIds()	When the event type is PAYLOAD_OIDS_WITH_ADDS, return the set of object IDs for added objects.
Collection	getPersistedTypeNames()	For all event types, return the set of class names for the classes of inserted objects.
Collection	getUpdatedObjectIds()	When the event type is not PAYLOAD_EXTENTS, return the set of object IDs for updated objects.
Collection	getUpdatedTypeNames()	When the event type is PAYLOAD_EXTENTS, return the set of class names for the classes of updated objects.
void	readExternal(ObjectInput in)
void	writeExternal(ObjectOutput out)

Methods inherited from class java.lang.Object

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

Field Details

PAYLOAD_OIDS

public static final int PAYLOAD_OIDS

Names of added classes, updated and deleted Object IDs.

See Also:

• Constant Field Values

PAYLOAD_OIDS_WITH_ADDS

public static final int PAYLOAD_OIDS_WITH_ADDS

Names of added classes, added, updated and deleted Object IDs.

See Also:

• Constant Field Values

PAYLOAD_EXTENTS

public static final int PAYLOAD_EXTENTS

Names of added, updated, and deleted classes only.

See Also:

• Constant Field Values

PAYLOAD_LOCAL_STALE_DETECTION

public static final int PAYLOAD_LOCAL_STALE_DETECTION

The local BrokerFactory detected that local data is out of date with the data store. Stale object IDs will be in t he updated set, although it is possible that records were actually deleted, rather than updated.

Since:

1.0.0

See Also:

• Constant Field Values

Constructor Details

RemoteCommitEvent

public RemoteCommitEvent()

Constructor used during externalization.

RemoteCommitEvent

public RemoteCommitEvent(int payloadType,
 Collection addIds,
 Collection addClasses,
 Collection updates,
 Collection deletes)

Constructor. All collections will be proxied with unmodifiable views.

Parameters:

payloadType - PAYLOAD constant for type of data in this event

addIds - set of object IDs for added instances, or null

addClasses - set of class names for added instances

updates - set of class names or object IDs for updated instances

deletes - set of class names or object IDs for deleted instances

Method Details

getPayloadType

public int getPayloadType()

The event PAYLOAD constant.

getPersistedObjectIds

public Collection getPersistedObjectIds()

When the event type is PAYLOAD_OIDS_WITH_ADDS, return the set of object IDs for added objects. This will only be callable when the backward compatability property transmitAddObjectIds is true.

getUpdatedObjectIds

public Collection getUpdatedObjectIds()

When the event type is not PAYLOAD_EXTENTS, return the set of object IDs for updated objects. When the event type is PAYLOAD_LOCAL_STALE_DETECTION, items in this list may actually have been deleted from the database.

getDeletedObjectIds

public Collection getDeletedObjectIds()

When the event type is not PAYLOAD_EXTENTS, return the set of object IDs for deleted objects.

getPersistedTypeNames

public Collection getPersistedTypeNames()

For all event types, return the set of class names for the classes of inserted objects.

getUpdatedTypeNames

public Collection getUpdatedTypeNames()

When the event type is PAYLOAD_EXTENTS, return the set of class names for the classes of updated objects.

getDeletedTypeNames

public Collection getDeletedTypeNames()

When the event type is PAYLOAD_EXTENTS, return the set of class names for the classes of deleted objects.

writeExternal

public void writeExternal(ObjectOutput out)
                   throws IOException

Specified by:

writeExternal in interface Externalizable

Throws:

IOException

readExternal

public void readExternal(ObjectInput in)
                  throws IOException

Specified by:

readExternal in interface Externalizable

Throws:

IOException