org.apache.jackrabbit.core.observation
Class EventStateCollection

java.lang.Object
  org.apache.jackrabbit.core.observation.EventStateCollection

public final class EventStateCollection

extends Object

The EventStateCollection class implements how EventState objects are created based on the ItemStates passed to the createEventStates(java.lang.String, org.apache.jackrabbit.core.state.ChangeLog, org.apache.jackrabbit.core.state.ItemStateManager) method.

The basic sequence of method calls is:

• createEventStates(java.lang.String, org.apache.jackrabbit.core.state.ChangeLog, org.apache.jackrabbit.core.state.ItemStateManager) or addAll(java.util.Collection) to create or add event states to the collection
• prepare() or prepareDeleted(org.apache.jackrabbit.core.state.ChangeLog) to prepare the events. If this step is omitted, EventListeners might see events of deleted item they are not allowed to see.
• dispatch() to dispatch the events to the EventListeners.

Method Summary

void	addAll(Collection c) Adds all event states in the given collection to this collection
void	createEventStates(String rootNodeUUID, ChangeLog changes, ItemStateManager provider) Creates EventState instances from ItemState changes.
void	dispatch() Dispatches the events to the EventListeners.
void	prepare() Prepares already added events for dispatching.
void	prepareDeleted(ChangeLog changes) Prepares deleted items from changes.

Methods inherited from class java.lang.Object

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

Method Detail

createEventStates

public void createEventStates(String rootNodeUUID,
                              ChangeLog changes,
                              ItemStateManager provider)
                       throws ItemStateException

Creates EventState instances from ItemState changes.

Parameters:

rootNodeUUID - the UUID of the root node.

changes - the changes on ItemStates.

provider - an ItemStateProvider to provide ItemState of items that are not contained in the changes collection.

Throws:

ItemStateException - if an error occurs while creating events states for the item state changes.

addAll

public void addAll(Collection c)

Adds all event states in the given collection to this collection

Parameters:

c -

prepare

public void prepare()

Prepares already added events for dispatching.

prepareDeleted

public void prepareDeleted(ChangeLog changes)

Prepares deleted items from changes.

Parameters:

changes - the changes to prepare.

dispatch

public void dispatch()

Dispatches the events to the EventListeners.