org.apache.jackrabbit.core.observation

Class ObservationManagerImpl

java.lang.Object

org.apache.jackrabbit.core.observation.ObservationManagerImpl

All Implemented Interfaces:

javax.jcr.observation.ObservationManager, org.apache.jackrabbit.api.observation.JackrabbitObservationManager, EventStateCollectionFactory

public class ObservationManagerImpl
extends Object
implements EventStateCollectionFactory, org.apache.jackrabbit.api.observation.JackrabbitObservationManager

Each Session instance has its own ObservationManager instance. The class SessionLocalObservationManager implements this behaviour.

Constructor Summary

Constructors

Constructor and Description
ObservationManagerImpl(ObservationDispatcher dispatcher, SessionImpl session, ClusterNode clusterNode) Creates an ObservationManager instance.

Method Summary

Methods

Modifier and Type	Method and Description
void	addEventListener(javax.jcr.observation.EventListener listener, int eventTypes, String absPath, boolean isDeep, String[] uuid, String[] nodeTypeName, boolean noLocal)
void	addEventListener(javax.jcr.observation.EventListener listener, org.apache.jackrabbit.api.observation.JackrabbitEventFilter filter)
EventFilter	createEventFilter(int eventTypes, List<String> absPaths, boolean isDeep, String[] uuid, String[] nodeTypeName, boolean noLocal, boolean noExternal, boolean noInternal) Creates a new event filter with the given restrictions.
EventStateCollection	createEventStateCollection() Creates an EventStateCollection.
void	dispose() Unregisters all EventListeners.
javax.jcr.observation.EventJournal	getEventJournal() Returns an unfiltered event journal for this workspace.
javax.jcr.observation.EventJournal	getEventJournal(int eventTypes, String absPath, boolean isDeep, String[] uuid, String[] nodeTypeName) Returns the event journal for this workspace.
javax.jcr.observation.EventListenerIterator	getRegisteredEventListeners()
void	removeEventListener(javax.jcr.observation.EventListener listener)
void	setUserData(String userData)

Methods inherited from class java.lang.Object

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

Constructor Detail

ObservationManagerImpl

public ObservationManagerImpl(ObservationDispatcher dispatcher,
                      SessionImpl session,
                      ClusterNode clusterNode)

Creates an ObservationManager instance.

Parameters:

dispatcher - observation dispatcher

session - the Session this ObservationManager belongs to.

clusterNode -

Throws:

NullPointerException - if dispatcher, session or clusterNode is null.

Method Detail

addEventListener

public void addEventListener(javax.jcr.observation.EventListener listener,
                    int eventTypes,
                    String absPath,
                    boolean isDeep,
                    String[] uuid,
                    String[] nodeTypeName,
                    boolean noLocal)
                      throws javax.jcr.RepositoryException

Specified by:

addEventListener in interface javax.jcr.observation.ObservationManager

Throws:

javax.jcr.RepositoryException

addEventListener

public void addEventListener(javax.jcr.observation.EventListener listener,
                    org.apache.jackrabbit.api.observation.JackrabbitEventFilter filter)
                      throws javax.jcr.RepositoryException

Specified by:

addEventListener in interface org.apache.jackrabbit.api.observation.JackrabbitObservationManager

Throws:

javax.jcr.RepositoryException

removeEventListener

public void removeEventListener(javax.jcr.observation.EventListener listener)
                         throws javax.jcr.RepositoryException

Specified by:

removeEventListener in interface javax.jcr.observation.ObservationManager

Throws:

javax.jcr.RepositoryException

getRegisteredEventListeners

public javax.jcr.observation.EventListenerIterator getRegisteredEventListeners()
                                                                        throws javax.jcr.RepositoryException

Specified by:

getRegisteredEventListeners in interface javax.jcr.observation.ObservationManager

Throws:

javax.jcr.RepositoryException

setUserData

public void setUserData(String userData)
                 throws javax.jcr.RepositoryException

Specified by:

setUserData in interface javax.jcr.observation.ObservationManager

Throws:

javax.jcr.RepositoryException

dispose

public void dispose()

Unregisters all EventListeners.

createEventFilter

public EventFilter createEventFilter(int eventTypes,
                            List<String> absPaths,
                            boolean isDeep,
                            String[] uuid,
                            String[] nodeTypeName,
                            boolean noLocal,
                            boolean noExternal,
                            boolean noInternal)
                              throws javax.jcr.RepositoryException

Creates a new event filter with the given restrictions.

Parameters:

eventTypes - A combination of one or more event type constants encoded as a bitmask.

absPaths - absolute paths.

isDeep - a boolean.

uuid - array of UUIDs.

nodeTypeName - array of node type names.

noLocal - a boolean.

noExternal - a boolean.

noInternal - a boolean.

Returns:

the event filter with the given restrictions.

Throws:

javax.jcr.RepositoryException - if an error occurs.

getEventJournal

public javax.jcr.observation.EventJournal getEventJournal(int eventTypes,
                                                 String absPath,
                                                 boolean isDeep,
                                                 String[] uuid,
                                                 String[] nodeTypeName)
                                                   throws javax.jcr.RepositoryException

Returns the event journal for this workspace. The events are filtered according to the passed criteria.

Specified by:

getEventJournal in interface javax.jcr.observation.ObservationManager

Parameters:

eventTypes - A combination of one or more event type constants encoded as a bitmask.

absPath - an absolute path.

isDeep - a boolean.

uuid - array of UUIDs.

nodeTypeName - array of node type names.

Returns:

the event journal for this repository.

Throws:

javax.jcr.UnsupportedRepositoryOperationException - if this repository does not support an event journal (cluster journal disabled).

javax.jcr.RepositoryException - if another error occurs.

See Also:

ObservationManager.getEventJournal(int, String, boolean, String[], String[])

getEventJournal

public javax.jcr.observation.EventJournal getEventJournal()
                                                   throws javax.jcr.RepositoryException

Returns an unfiltered event journal for this workspace.

Specified by:

getEventJournal in interface javax.jcr.observation.ObservationManager

Returns:

the event journal for this repository.

Throws:

javax.jcr.UnsupportedRepositoryOperationException - if this repository does not support an event journal (cluster journal disabled).

javax.jcr.RepositoryException - if another error occurs.

createEventStateCollection

public EventStateCollection createEventStateCollection()

Creates an EventStateCollection.

Creates an EventStateCollection tied to the session which is attached to this ObservationManager instance.

Specified by:

createEventStateCollection in interface EventStateCollectionFactory

Returns:

a new EventStateCollection