Index: jackrabbit-api/src/main/java/org/apache/jackrabbit/api/observation/JackrabbitObservationManager.java
IDEA additional info:
Subsystem: com.intellij.openapi.diff.impl.patch.CharsetEP
<+>UTF-8
===================================================================
--- jackrabbit-api/src/main/java/org/apache/jackrabbit/api/observation/JackrabbitObservationManager.java	(revision )
+++ jackrabbit-api/src/main/java/org/apache/jackrabbit/api/observation/JackrabbitObservationManager.java	(revision )
@@ -0,0 +1,38 @@
+package org.apache.jackrabbit.api.observation;
+
+import javax.jcr.RepositoryException;
+import javax.jcr.observation.EventListener;
+
+/**
+ * Jackrabbit specific extensions to {@link javax.jcr.observation.ObservationManager}.
+ */
+public interface JackrabbitObservationManager {
+
+    /**
+     * Adds an event listener that listens for the events specified
+     * by the passed {@link JackrabbitEventFilter}.
+     * <p>
+     * In addition to the <code>EventFilter</code>, the set of events reported
+     * will be further filtered by the access rights of the
+     * current <code>Session</code>.
+     * <p>
+     * See {@link JackrabbitEventFilter} for a description of the filtering parameters available.
+     * <p>
+     * The filter of an already-registered <code>EventListener</code> can be
+     * changed at runtime by re-registering the same <code>EventListener</code>
+     * object (i.e. the same actual Java object) with a new filter.
+     * The implementation must ensure that no events are lost during the changeover.
+     * <p>
+     * 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 <code>jcr:system</code>
+     * subgraph may not be supported.
+     *
+     * @param listener     an {@link EventListener} object.
+     * @param filter       an {@link JackrabbitEventFilter} object.
+     * @throws RepositoryException If an error occurs.
+     */
+    void addEventListener(EventListener listener, JackrabbitEventFilter filter)
+            throws RepositoryException;
+}
Index: jackrabbit-api/src/main/java/org/apache/jackrabbit/api/observation/JackrabbitEventFilter.java
IDEA additional info:
Subsystem: com.intellij.openapi.diff.impl.patch.CharsetEP
<+>UTF-8
===================================================================
--- jackrabbit-api/src/main/java/org/apache/jackrabbit/api/observation/JackrabbitEventFilter.java	(revision )
+++ jackrabbit-api/src/main/java/org/apache/jackrabbit/api/observation/JackrabbitEventFilter.java	(revision )
@@ -0,0 +1,175 @@
+package org.apache.jackrabbit.api.observation;
+
+/**
+ * A storage object for event filter configuration.
+ * <p>
+ * The parameters of the filter can then be set by chaining the set methods,
+ * since each method returns the same <code>EventFilter</code> with the indicated parameter set.
+ * <p>
+ * Once the filter is configured, it and an {@link javax.jcr.observation.EventListener} object are
+ * passed to
+ * {@link org.apache.jackrabbit.api.observation.JackrabbitObservationManager#addEventListener(javax.jcr.observation.EventListener, JackrabbitEventFilter)}.
+ * <p>
+ * The filter restricts which events are sent to the <code>EventListener</code> according to the
+ * following parameters. Note that the term <i>associated parent node</i> of an event means the
+ * parent node of the item at (or formerly at) the path returned by
+ * {@link javax.jcr.observation.Event#getPath}.
+ * <ul>
+ * <li>
+ * <code>eventTypes</code>:
+ * A bitwise <code>OR</code> of the event types to be listened to. See
+ * {@link javax.jcr.observation.Event} for details.
+ * </li>
+ * <li>
+ * <code>absPath</code>, <code>absPaths</code> <code>isDeep</code>:
+ * Only events whose associated parent node is at one of the paths in
+ * <code>absPath</code> or <code>absPaths</code> (or within its subgraph,
+ * if <code>isDeep</code> is <code>true</code>) will be received. It is
+ * permissible to register a listener for a path where no node currently exists.
+ * </li>
+ * <li>
+ * <code>uuid</code>:
+ * Only events whose associated parent node has one of
+ * the identifiers in this list will be received. If his parameter is
+ * <code>null</code> then no identifier-related restriction is placed on
+ * events received. Note that specifying an empty array instead of
+ * <code>null</code> would result in no nodes being listened to. The term
+ * "UUID" is used for compatibility with JCR 1.0.
+ * </li>
+ * <li>
+ * <code>nodeTypeName</code>:
+ * Only events whose associated parent 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 <code>null</code> then no node
+ * type-related restriction is placed on events received. Note that
+ * specifying an empty array instead of <code>null</code> would result in no
+ * nodes types being listened to.
+ * </li>
+ * <li>
+ * <code>noLocal</code>: if <code>true</code>, then events
+ * generated by the session through which the listener was registered are
+ * ignored. Otherwise, they are not ignored.
+ * </li>
+ * <li>
+ * <code>noExternal</code>: if <code>true</code>, then events
+ * from external cluster nodes are ignored. Otherwise, they are not ignored.
+ * </li>
+ * </ul>
+ * The restrictions are "ANDed" together. In other words, for a particular node to be "listened to" it
+ * must meet all the restrictions.
+ *
+ */
+public interface JackrabbitEventFilter {  // TODO extends EventFilter once JCR 2.1 is out
+
+    /**
+     * Sets the <code>eventTypes</code> parameter of the filter.
+     * If left unset, this parameter defaults to <code>null</code>.
+     * @param eventTypes an <code>int</code>.
+     * @return This EventFilter object with the <code>eventTypes</code> parameter set.
+     */
+    JackrabbitEventFilter setEventTypes(int eventTypes);
+
+    /**
+     * Returns the <code>eventTypes</code> parameter of the filter.
+     * @return an <code>int</code>.
+     */
+    int getEventTypes();
+
+    /**
+     * Sets the <code>absPath</code> parameter of the filter.
+     * If left unset, this parameter defaults to <code>null</code>.
+     * @param absPath an absolute path <code>String</code>.
+     * @return This EventFilter object with the <code>absPath</code> parameter set.
+     */
+    JackrabbitEventFilter setAbsPath(String absPath);
+
+    /**
+     * Returns the <code>absPath</code> parameter of the filter.
+     * @return a <code>String</code>.
+     */
+    String getAbsPath();
+
+    /**
+     * Sets the <code>isDeep</code> parameter of the filter.
+     * If left unset, this parameter defaults to <code>false</code>.
+     * @param isDeep a <code>boolean</code>.
+     * @return This EventFilter object with the <code>isDeep</code> parameter set.
+     */
+    JackrabbitEventFilter setIsDeep(boolean isDeep);
+
+    /**
+     * Returns the <code>isDeep</code> parameter of the filter.
+     * @return a <code>boolean</code>.
+     */
+    boolean getIsDeep();
+
+    /**
+     * Sets the <code>identifiers</code> parameter of the filter.
+     * If left unset, this parameter defaults to <code>null</code>.
+     * @param identifiers a <code>String</code> array.
+     * @return This EventFilter object with the <code>identifiers</code> parameter set.
+     */
+    JackrabbitEventFilter setIdentifiers(String[] identifiers);
+
+    /**
+     * Returns the <code>uuids</code> parameter of the filter.
+     * @return a <code>String</code> array.
+     */
+    String[] getIdentifiers();
+
+    /**
+     * Sets the <code>nodeTypeNames</code> parameter of the filter.
+     * If left unset, this parameter defaults to <code>null</code>.
+     * @param nodeTypeNames a <code>String</code> array.
+     * @return This EventFilter object with the <code>nodeTypes</code> parameter set.
+     */
+    JackrabbitEventFilter setNodeTypes(String[] nodeTypeNames);
+
+    /**
+     * Returns the <code>nodeTypeName</code> parameter of the filter.
+     * @return a <code>String</code> array.
+     */
+    String[] getNodeTypes();
+
+    /**
+     * Sets the <code>noLocal</code> parameter of the filter.
+     * If left unset, this parameter defaults to <code>false</code>.
+     * @param noLocal a <code>boolean</code>.
+     * @return This EventFilter object with the <code>noLocal</code> parameter set.
+     */
+    JackrabbitEventFilter setNoLocal(boolean noLocal);
+
+    /**
+     * Returns the <code>noLocal</code> parameter of the filter.
+     * @return a <code>boolean</code>.
+     */
+    boolean getNoLocal();
+
+    /**
+     * Sets the <code>absPaths</code> parameter of the filter.
+     * If left unset, this parameter defaults to an empty array.
+     * @param absPaths an absolute path <code>String</code> array.
+     * @return This EventFilter object with the <code>absPaths</code> parameter set.
+     */
+    JackrabbitEventFilter setAdditionalPaths(String[] absPaths);
+
+    /**
+     * Returns the <code>absPaths</code> parameter of the filter.
+     * @return a <code>String</code> array.
+     */
+    String[] getAdditionalPaths();
+
+    /**
+     * Sets the <code>noExternal</code> parameter of the filter.
+     * If left unset, this parameter defaults to <code>false</code>.
+     * @param noExternal a <code>boolean</code>.
+     * @return This EventFilter object with the <code>noExternal</code> parameter set.
+     */
+    JackrabbitEventFilter setNoExternal(boolean noExternal);
+
+    /**
+     * Returns the <code>noExternal</code> parameter of the filter.
+     * @return a <code>boolean</code>.
+     */
+    boolean getNoExternal();
+}
\ No newline at end of file