[infinispan-commits] Infinispan SVN: r1567 - trunk/core/src/main/java/org/infinispan/notifications/cachelistener/annotation.

[infinispan-commits at lists.jboss.org]

Author: mircea.markus
Date: 2010-03-04 06:49:13 -0500 (Thu, 04 Mar 2010)
New Revision: 1567

Modified:
   trunk/core/src/main/java/org/infinispan/notifications/cachelistener/annotation/CacheEntryActivated.java
   trunk/core/src/main/java/org/infinispan/notifications/cachelistener/annotation/CacheEntryCreated.java
   trunk/core/src/main/java/org/infinispan/notifications/cachelistener/annotation/CacheEntryEvicted.java
   trunk/core/src/main/java/org/infinispan/notifications/cachelistener/annotation/CacheEntryInvalidated.java
   trunk/core/src/main/java/org/infinispan/notifications/cachelistener/annotation/CacheEntryLoaded.java
   trunk/core/src/main/java/org/infinispan/notifications/cachelistener/annotation/CacheEntryModified.java
   trunk/core/src/main/java/org/infinispan/notifications/cachelistener/annotation/CacheEntryPassivated.java
   trunk/core/src/main/java/org/infinispan/notifications/cachelistener/annotation/CacheEntryRemoved.java
   trunk/core/src/main/java/org/infinispan/notifications/cachelistener/annotation/CacheEntryVisited.java
Log:
added javadoc related to locking.

Modified: trunk/core/src/main/java/org/infinispan/notifications/cachelistener/annotation/CacheEntryActivated.java
===================================================================
--- trunk/core/src/main/java/org/infinispan/notifications/cachelistener/annotation/CacheEntryActivated.java	2010-03-04 07:42:28 UTC (rev 1566)
+++ trunk/core/src/main/java/org/infinispan/notifications/cachelistener/annotation/CacheEntryActivated.java	2010-03-04 11:49:13 UTC (rev 1567)
@@ -32,6 +32,7 @@
  * Methods annotated with this annotation should be public and take in a single parameter, a {@link
  * org.infinispan.notifications.cachelistener.event.CacheEntryActivatedEvent} otherwise an {@link
  * org.infinispan.notifications.IncorrectListenerException} will be thrown when registering your cache listener.
+ * Locking: notification is performed WITH locks on the given key.
  *
  * @author <a href="mailto:manik at jboss.org">Manik Surtani</a>
  * @see org.infinispan.notifications.Listener

Modified: trunk/core/src/main/java/org/infinispan/notifications/cachelistener/annotation/CacheEntryCreated.java
===================================================================
--- trunk/core/src/main/java/org/infinispan/notifications/cachelistener/annotation/CacheEntryCreated.java	2010-03-04 07:42:28 UTC (rev 1566)
+++ trunk/core/src/main/java/org/infinispan/notifications/cachelistener/annotation/CacheEntryCreated.java	2010-03-04 11:49:13 UTC (rev 1567)
@@ -32,6 +32,8 @@
  * Methods annotated with this annotation should be public and take in a single parameter, a {@link
  * org.infinispan.notifications.cachelistener.event.CacheEntryCreatedEvent} otherwise an {@link
  * org.infinispan.notifications.IncorrectListenerException} will be thrown when registering your cache listener.
+ * <p/>
+ * Locking: notification is performed WITH locks on the given key.
  *
  * @author <a href="mailto:manik at jboss.org">Manik Surtani</a>
  * @see org.infinispan.notifications.Listener

Modified: trunk/core/src/main/java/org/infinispan/notifications/cachelistener/annotation/CacheEntryEvicted.java
===================================================================
--- trunk/core/src/main/java/org/infinispan/notifications/cachelistener/annotation/CacheEntryEvicted.java	2010-03-04 07:42:28 UTC (rev 1566)
+++ trunk/core/src/main/java/org/infinispan/notifications/cachelistener/annotation/CacheEntryEvicted.java	2010-03-04 11:49:13 UTC (rev 1567)
@@ -32,6 +32,8 @@
  * Methods annotated with this annotation should be public and take in a single parameter, a {@link
  * org.infinispan.notifications.cachelistener.event.CacheEntryEvictedEvent} otherwise an {@link
  * org.infinispan.notifications.IncorrectListenerException} will be thrown when registering your cache listener.
+ * <p/>
+ *  Locking: notification is performed WITH locks on the given key.
  *
  * @author <a href="mailto:manik at jboss.org">Manik Surtani</a>
  * @see org.infinispan.notifications.Listener

Modified: trunk/core/src/main/java/org/infinispan/notifications/cachelistener/annotation/CacheEntryInvalidated.java
===================================================================
--- trunk/core/src/main/java/org/infinispan/notifications/cachelistener/annotation/CacheEntryInvalidated.java	2010-03-04 07:42:28 UTC (rev 1566)
+++ trunk/core/src/main/java/org/infinispan/notifications/cachelistener/annotation/CacheEntryInvalidated.java	2010-03-04 11:49:13 UTC (rev 1567)
@@ -32,6 +32,9 @@
  * Methods annotated with this annotation should be public and take in a single parameter, a {@link
  * org.infinispan.notifications.cachelistener.event.CacheEntryInvalidatedEvent} otherwise an {@link
  * org.infinispan.notifications.IncorrectListenerException} will be thrown when registering your cache listener.
+ *  <p/>
+ *  Locking: notification is performed WITH locks on the given key.
+
  *
  * @author <a href="mailto:manik at jboss.org">Manik Surtani</a>
  * @see org.infinispan.notifications.Listener

Modified: trunk/core/src/main/java/org/infinispan/notifications/cachelistener/annotation/CacheEntryLoaded.java
===================================================================
--- trunk/core/src/main/java/org/infinispan/notifications/cachelistener/annotation/CacheEntryLoaded.java	2010-03-04 07:42:28 UTC (rev 1566)
+++ trunk/core/src/main/java/org/infinispan/notifications/cachelistener/annotation/CacheEntryLoaded.java	2010-03-04 11:49:13 UTC (rev 1567)
@@ -38,7 +38,8 @@
  * Methods annotated with this annotation should be public and take in a single parameter, a {@link
  * CacheEntryLoadedEvent} otherwise an {@link IncorrectListenerException} will be thrown when registering your cache
  * listener.
- *
+ * <p/>
+ * Locking: notification is performed WITH locks on the given key.
  * @author <a href="mailto:manik at jboss.org">Manik Surtani</a>
  * @see Listener
  * @since 4.0

Modified: trunk/core/src/main/java/org/infinispan/notifications/cachelistener/annotation/CacheEntryModified.java
===================================================================
--- trunk/core/src/main/java/org/infinispan/notifications/cachelistener/annotation/CacheEntryModified.java	2010-03-04 07:42:28 UTC (rev 1566)
+++ trunk/core/src/main/java/org/infinispan/notifications/cachelistener/annotation/CacheEntryModified.java	2010-03-04 11:49:13 UTC (rev 1567)
@@ -33,7 +33,8 @@
  * org.infinispan.notifications.cachelistener.event.CacheEntryModifiedEvent} otherwise an {@link
  * org.infinispan.notifications.IncorrectListenerException} will be thrown when registering your cache listener.
  * <p/>
- *
+ * Locking: notification is performed WITH locks on the given key.
+
  * @author <a href="mailto:manik at jboss.org">Manik Surtani</a>
  * @see org.infinispan.notifications.Listener
  * @since 4.0

Modified: trunk/core/src/main/java/org/infinispan/notifications/cachelistener/annotation/CacheEntryPassivated.java
===================================================================
--- trunk/core/src/main/java/org/infinispan/notifications/cachelistener/annotation/CacheEntryPassivated.java	2010-03-04 07:42:28 UTC (rev 1566)
+++ trunk/core/src/main/java/org/infinispan/notifications/cachelistener/annotation/CacheEntryPassivated.java	2010-03-04 11:49:13 UTC (rev 1567)
@@ -32,6 +32,8 @@
  * Methods annotated with this annotation should accept a single parameter, a {@link
  * org.infinispan.notifications.cachelistener.event.CacheEntryPassivatedEvent} otherwise a {@link
  * org.infinispan.notifications.IncorrectListenerException} will be thrown when registering your listener.
+ *  <p/>
+ *  Locking: notification is performed WITH locks on the given key.
  *
  * @author <a href="mailto:manik at jboss.org">Manik Surtani</a>
  * @see org.infinispan.notifications.Listener

Modified: trunk/core/src/main/java/org/infinispan/notifications/cachelistener/annotation/CacheEntryRemoved.java
===================================================================
--- trunk/core/src/main/java/org/infinispan/notifications/cachelistener/annotation/CacheEntryRemoved.java	2010-03-04 07:42:28 UTC (rev 1566)
+++ trunk/core/src/main/java/org/infinispan/notifications/cachelistener/annotation/CacheEntryRemoved.java	2010-03-04 11:49:13 UTC (rev 1567)
@@ -32,6 +32,8 @@
  * Methods annotated with this annotation should accept a single parameter, a {@link
  * org.infinispan.notifications.cachelistener.event.CacheEntryRemovedEvent} otherwise a {@link
  * org.infinispan.notifications.IncorrectListenerException} will be thrown when registering your listener.
+ *  <p/>
+ *  Locking: notification is performed WITH locks on the given key.
  *
  * @author <a href="mailto:manik at jboss.org">Manik Surtani</a>
  * @see org.infinispan.notifications.Listener

Modified: trunk/core/src/main/java/org/infinispan/notifications/cachelistener/annotation/CacheEntryVisited.java
===================================================================
--- trunk/core/src/main/java/org/infinispan/notifications/cachelistener/annotation/CacheEntryVisited.java	2010-03-04 07:42:28 UTC (rev 1566)
+++ trunk/core/src/main/java/org/infinispan/notifications/cachelistener/annotation/CacheEntryVisited.java	2010-03-04 11:49:13 UTC (rev 1567)
@@ -32,6 +32,9 @@
  * Methods annotated with this annotation should accept a single parameter, a {@link
  * org.infinispan.notifications.cachelistener.event.CacheEntryVisitedEvent} otherwise a {@link
  * org.infinispan.notifications.IncorrectListenerException} will be thrown when registering your listener.
+ *  <p/>
+ *  Locking: notification is performed WITHOUT locks on the given key (unless {@link org.infinispan.context.Flag#FORCE_WRITE_LOCK} is used for this call).
+
  *
  * @author <a href="mailto:manik at jboss.org">Manik Surtani</a>
  * @see org.infinispan.notifications.Listener