Author: toad
Date: 2008-01-12 21:00:56 +0000 (Sat, 12 Jan 2008)
New Revision: 17032
Modified:
trunk/freenet/src/freenet/support/RandomGrabArrayItem.java
Log:
locking note
Modified: trunk/freenet/src/freenet/support/RandomGrabArrayItem.java
===================================================================
--- trunk/freenet/src/freenet/support/RandomGrabArrayItem.java 2008-01-12
20:58:11 UTC (rev 17031)
+++ trunk/freenet/src/freenet/support/RandomGrabArrayItem.java 2008-01-12
21:00:56 UTC (rev 17032)
@@ -5,7 +5,8 @@
/** If true, will be automatically removed from the RGA, and not
returned.
* True indicates that the item is no longer needed for some reason -
in a request,
* usually that it has either been explicitly cancelled or that it is
not needed
- * because other queued blocks have been sufficient. */
+ * because other queued blocks have been sufficient. LOCKING: Should
hold as few
+ * locks as possible as this needs to be called while holding the RGA
lock(s). */
public boolean isCancelled();
/** Can this item be removed from the queue after it has been handled?
