ViewVC Help

View File | Revision Log | Show Annotations | Download File | Root Listing

root/jsr166/jsr166/src/jsr166e/StampedLock.java

Comparing jsr166/src/jsr166e/StampedLock.java (file contents):
Revision 1.8 by dl, Sat Oct 13 11:51:12 2012 UTC vs.
Revision 1.12 by jsr166, Sat Oct 13 23:05:13 2012 UTC

#	Line 11 | Line 11 | import java.util.concurrent.TimeUnit;
11
12		/**
13		* A capability-based lock with three modes for controlling read/write
14	<	* access.  The state of a StampedLock consists of a version and
15	<	* mode. Lock acquisition methods return a stamp that represents and
14	>	* access.  The state of a StampedLock consists of a version and mode.
15	>	* Lock acquisition methods return a stamp that represents and
16		* controls access with respect to a lock state; "try" versions of
17		* these methods may instead return the special value zero to
18		* represent failure to acquire access. Lock release and conversion
#	Line 55 | Line 55 | import java.util.concurrent.TimeUnit;
55		* <p>This class also supports methods that conditionally provide
56		* conversions across the three modes. For example, method {@link
57		* #tryConvertToWriteLock} attempts to "upgrade" a mode, returning
58	<	* valid write stamp if (1) already in writing mode (2) in reading
58	>	* a valid write stamp if (1) already in writing mode (2) in reading
59		* mode and there are no other readers or (3) in optimistic mode and
60		* the lock is available. The forms of these methods are designed to
61		* help reduce some of the code bloat that otherwise occurs in
#	Line 539 | Line 539 | public class StampedLock implements java
539		}
540
541		/**
542	<	* If the lock state matches the given stamp, releases
542	>	* If the lock state matches the given stamp, releases the
543		* non-exclusive lock.
544		*
545		* @param stamp a stamp returned by a read-lock operation
#	Line 606 | Line 606 | public class StampedLock implements java
606		/**
607		* If the lock state matches the given stamp then performs one of
608		* the following actions. If the stamp represents holding a write
609	<	* lock, returns it. Or, if a read lock, if the write lock is
610	<	* available, releases the read and returns a write stamp. Or, if
611	<	* an optimistic read, returns a write stamp only if immediately
612	<	* available. This method returns zero in all other cases.
609	>	* lock, returns it.  Or, if a read lock, if the write lock is
610	>	* available, releases the read lock and returns a write stamp.
611	>	* Or, if an optimistic read, returns a write stamp only if
612	>	* immediately available. This method returns zero in all other
613	>	* cases.
614		*
615		* @param stamp a stamp
616		* @return a valid write stamp, or zero on failure

Diff Legend

–	Removed lines
+	Added lines
<	Changed lines
>	Changed lines