* The set of events can be filtered by specifying restrictions based on characteristics of the node associated * with the event. In the case of event types NODE_ADDED and NODE_REMOVED, the node * associated with an event is the node at (or formerly at) the path returned by Event.getPath. * In the case of event types PROPERTY_ADDED, PROPERTY_REMOVED and * PROPERTY_CHANGED, the node associated with an event is the parent node of the property at * (or formerly at) the path returned by Event.getPath: *

*
• * absPath, isDeep: Only events whose associated node is at * absPath (or within its subtree, if isDeep is true) will be received. * It is permissible to register a listener for a path where no node currently exists. *
*
• * uuid: Only events whose associated node has one of the UUIDs in this list will be * received. If his parameter is null then no UUID-related restriction is placed on events * received. *
*
• * nodeTypeName: Only events whose associated node has one of the node types * (or a subtype of one of the node types) in this list will be received. If his parameter is * null then no node type-related restriction is placed on events received. *
*

* Additionally, if noLocal is true, then events generated by the session through which * the listener was registered are ignored. Otherwise, they are not ignored. *

* The filters 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 set of filter arguments. * The implementation must ensure that no events are lost during the changeover. * * @param listener an {@link EventListener} object. * @param eventTypes A combination of one or more event type constants encoded as a bitmask. * @param absPath an absolute path. * @param isDeep a boolean. * @param uuid array of UUIDs. * @param nodeTypeName array of node type names. * @param noLocal a boolean. * @throws RepositoryException If an error occurs. */ public function addEventListener( EventListener $listener, $eventTypes, $absPath, $isDeep, $uuid, $nodeTypeName, $noLocal ); /** * Deregisters an event listener. *

* A listener may be deregistered while it is being executed. The * deregistration method will block until the listener has completed * executing. An exception to this rule is a listener which deregisters * itself from within the onEvent method. In this case, the * deregistration method returns immediately, but deregistration will * effectively be delayed until the listener completes. * * @param listener The listener to deregister. * * @throws RepositoryException If an error occurs. */ public function removeEventListener( EventListener $listener ); /** * Returns all event listeners that have been registered through this session. * If no listeners have been registered, an empty iterator is returned. * * @return an EventListenerIterator. * @throws RepositoryException */ public function getRegisteredEventListeners(); } ?>