jackrabbit-oak-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From chet...@apache.org
Subject svn commit: r1515396 - /jackrabbit/oak/trunk/oak-jcr/src/main/java/org/apache/jackrabbit/oak/jcr/delegate/SessionOperationInterceptor.java
Date Mon, 19 Aug 2013 13:06:44 GMT
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



Mime
View raw message