Author: chetanm
Date: Mon Aug 19 13:06:44 2013
New Revision: 1515396
URL: http://svn.apache.org/r1515396
Log:
OAK-960 - Provide an interceptor for SessionOperations
Updating javadoc
Modified:
jackrabbit/oak/trunk/oak-jcr/src/main/java/org/apache/jackrabbit/oak/jcr/delegate/SessionOperationInterceptor.java
Modified:
jackrabbit/oak/trunk/oak-jcr/src/main/java/org/apache/jackrabbit/oak/jcr/delegate/SessionOperationInterceptor.java
URL:
http://svn.apache.org/viewvc/jackrabbit/oak/trunk/oak-jcr/src/main/java/org/apache/jackrabbit/oak/jcr/delegate/SessionOperationInterceptor.java?rev=1515396&r1=1515395&r2=1515396&view=diff
==============================================================================
---
jackrabbit/oak/trunk/oak-jcr/src/main/java/org/apache/jackrabbit/oak/jcr/delegate/SessionOperationInterceptor.java
(original)
+++
jackrabbit/oak/trunk/oak-jcr/src/main/java/org/apache/jackrabbit/oak/jcr/delegate/SessionOperationInterceptor.java
Mon Aug 19 13:06:44 2013
@@ -21,6 +21,10 @@ package org.apache.jackrabbit.oak.jcr.de
import org.apache.jackrabbit.oak.jcr.operation.SessionOperation;
+/**
+ * Interceptor for operations being performed in a session.
+ *
+ */
public interface SessionOperationInterceptor {
SessionOperationInterceptor NOOP = new SessionOperationInterceptor() {
@Override
@@ -33,8 +37,16 @@ public interface SessionOperationInterce
};
/**
- * Invoked before the sessionOperation is performed. SessionOperation MUST
only be
- * used for reading purpose and implementation must not invoke the {@link
SessionOperation#perform}
+ * Invoked before the sessionOperation is performed.
+ *
+ * <p>
+ * An implementation of this method should not perform content access or
any other
+ * repository operation. The {@link SessionDelegate} and {@link
SessionOperation} must only be used
+ * to extract information e.g. session Id, type of operation etc.
+ *
+ * Further {@link SessionOperation#perform} is invoked
+ * by the caller and implementers MUST not invoke it
+ * </p>
*
* @param delegate sessionDelegate performing the operation
* @param operation operation to perform
@@ -42,8 +54,16 @@ public interface SessionOperationInterce
void before(SessionDelegate delegate, SessionOperation operation);
/**
- * Invoked after the sessionOperation is performed. SessionOperation MUST
only be
- * used for reading purpose and implementation must not invoke the {@link
SessionOperation#perform}
+ * Invoked after the sessionOperation is performed.
+ *
+ * <p>
+ * An implementation of this method should not perform content access or
any other
+ * repository operation. The {@link SessionDelegate} and {@link
SessionOperation} must only be used
+ * to extract information e.g. session Id, type of operation etc.
+ *
+ * Further {@link SessionOperation#perform} is invoked
+ * by the caller and implementers MUST not invoke it
+ * </p>
*
* @param delegate sessionDelegate performing the operation
* @param operation operation to perform
