ViewVC Help

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

root/jsr166/jsr166/src/test/loops/LinkedAsyncAction.java

Comparing jsr166/src/test/loops/LinkedAsyncAction.java (file contents):
Revision 1.3 by jsr166, Fri Jul 1 02:37:22 2011 UTC vs.
Revision 1.6 by jsr166, Sun Nov 18 18:03:11 2012 UTC

#	Line 1 | Line 1
1		/*
2		* Written by Doug Lea with assistance from members of JCP JSR-166
3		* Expert Group and released to the public domain, as explained at
4	<	*
4	>	* http://creativecommons.org/publicdomain/zero/1.0/
5		*/
6
7		import java.util.*;
#	Line 11 | Line 11 | import java.util.concurrent.atomic.*;
11		/**
12		* AsyncActions that may be linked in parent-child relationships.
13		*
14	<	* <p> Upon construction, an LinkedAsyncAction may register as a
14	>	* <p>Upon construction, an LinkedAsyncAction may register as a
15		* subtask of a given parent task. In this case, completion of this
16		* task will propagate to its parent. If the parent's pending subtask
17		* completion count becomes zero, it too will complete.
#	Line 24 | Line 24 | import java.util.concurrent.atomic.*;
24		* <tt>complete</tt> of the subtask will trigger <tt>complete</tt> of the
25		* parent without the parent explicitly doing so.
26		*
27	<	* <p> In addition to supporting these different computation styles
27	>	* <p>In addition to supporting these different computation styles
28		* compared to Recursive tasks, LinkedAsyncActions may have smaller
29		* stack space footprints while executing, but may have greater
30		* per-task overhead.
31		*
32	<	* <p> <b>Sample Usage.</b> Here is a sketch of an LinkedAsyncAction
32	>	* <p><b>Sample Usage.</b> Here is a sketch of an LinkedAsyncAction
33		* that visits all of the nodes of a graph. The details of the graph's
34		* Node and Edge classes are omitted, but we assume each node contains
35		* an <tt>AtomicBoolean</tt> mark that starts out false. To execute
#	Line 56 | Line 56 | import java.util.concurrent.atomic.*;
56		*   }
57		* }
58		* </pre>
59	–	*
59		*/
60		public abstract class LinkedAsyncAction extends ForkJoinTask<Void> {
61
#	Line 141 | Line 140 | public abstract class LinkedAsyncAction
140		* Overridable callback action triggered by <tt>complete</tt>.  Upon
141		* invocation, all subtasks have completed.  After return, this
142		* task <tt>isDone</tt> and is joinable by other tasks. The
143	<	* default version of this method does nothing. But it may may be
143	>	* default version of this method does nothing. But it may be
144		* overridden in subclasses to perform some action when this task
145		* is about to complete.
146		*/

Diff Legend

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