svn commit: r828343 - /jackrabbit/trunk/jackrabbit-core/src/main/java/org/apache/jackrabbit/core/observation/SynchronousEventListener.java

[mr...@apache.org]

Author: mreutegg
Date: Thu Oct 22 08:03:04 2009
New Revision: 828343

URL: http://svn.apache.org/viewvc?rev=828343&view=rev
Log:
JCR-2357: Duplicate entries in the index
- javadoc

Modified:
    jackrabbit/trunk/jackrabbit-core/src/main/java/org/apache/jackrabbit/core/observation/SynchronousEventListener.java

Modified: jackrabbit/trunk/jackrabbit-core/src/main/java/org/apache/jackrabbit/core/observation/SynchronousEventListener.java
URL: http://svn.apache.org/viewvc/jackrabbit/trunk/jackrabbit-core/src/main/java/org/apache/jackrabbit/core/observation/SynchronousEventListener.java?rev=828343&r1=828342&r2=828343&view=diff
==============================================================================
--- jackrabbit/trunk/jackrabbit-core/src/main/java/org/apache/jackrabbit/core/observation/SynchronousEventListener.java (original)
+++ jackrabbit/trunk/jackrabbit-core/src/main/java/org/apache/jackrabbit/core/observation/SynchronousEventListener.java Thu Oct 22 08:03:04 2009
@@ -16,6 +16,7 @@
  */
 package org.apache.jackrabbit.core.observation;
 
+import javax.jcr.observation.EventIterator;
 import javax.jcr.observation.EventListener;
 
 /**
@@ -25,6 +26,10 @@
  * the call to {@link javax.jcr.Item#save()} returns. In contrast, a regular
  * {@link javax.jcr.observation.EventListener} might be called after
  * <code>save()</code> returns.
+ * <p/>
+ * <b>Important note</b>: an implementation of {@link SynchronousEventListener}
+ * <b>must not</b> modify content with the thread that calls {@link
+ * #onEvent(EventIterator)} otherwise inconsistencies may occur.
  */
 public interface SynchronousEventListener extends EventListener {
 }