Adds an event listener that listens for the events specified by the passed {@link JackrabbitEventFilter}.
In addition to the EventFilter
, the set of events reported will be further filtered by the access rights of the current Session
.
See {@link JackrabbitEventFilter} for a description of the filtering parameters available.
The filter of an already-registered EventListener
can be changed at runtime by re-registering the same EventListener
object (i.e. the same actual Java object) with a new filter. The implementation must ensure that no events are lost during the changeover.
In addition to the filters placed on a listener above, the scope of observation support, in terms of which parts of a workspace are observable, may also be subject to implementation-specific restrictions. For example, in some repositories observation of changes in the jcr:system
subgraph may not be supported.
@param listener an {@link EventListener} object.
@param filter an {@link JackrabbitEventFilter} object.
@throws RepositoryException If an error occurs.