| 10 |
by <a href="http://gee.cs.oswego.edu/dl">Doug Lea</a> |
by <a href="http://gee.cs.oswego.edu/dl">Doug Lea</a> |
| 11 |
<p> |
<p> |
| 12 |
|
|
| 13 |
This is an updated version of the specification submitted for JCP Public |
This is maintenance repository of JSR166 specifications. For further |
| 14 |
Review. To check for further updates, access a preliminary prototype |
information, go to: <A |
|
release of main functionality, or join a mailing list discussing |
|
|
JSR-166, go to: <A |
|
| 15 |
HREF="http://altair.cs.oswego.edu/mailman/listinfo/concurrency-interest"> |
HREF="http://altair.cs.oswego.edu/mailman/listinfo/concurrency-interest"> |
| 16 |
http://altair.cs.oswego.edu/mailman/listinfo/concurrency-interest</A>. |
http://altair.cs.oswego.edu/mailman/listinfo/concurrency-interest</A>. |
| 17 |
|
|
| 18 |
<p><em>Note: The javadocs here includes some existing java.util |
<p><em>Note: The javadocs here do <em>not</em> include pre-existing |
| 19 |
Collection interfaces and classes that are not part of the JSR-166 |
java classes (for example <tt>java.lang.Thread</tt>) that were changed |
| 20 |
spec, but are included because JSR-166 methods implement or inherit |
as part of the JSR166 spec. On the other hand, the javadocs here do |
| 21 |
from their specifications.</em> |
include some existing java.util Collection interfaces and classes that |
| 22 |
|
are not part of the spec, but are included because some new methods |
| 23 |
|
implement or inherit from their specifications. |
| 24 |
|
</em> |
| 25 |
|
|
| 26 |
<p> JSR-166 introduces package <tt>java.util.concurrent</tt> |
<p> JSR-166 introduces package <tt>java.util.concurrent</tt> |
| 27 |
containing utility classes commonly useful in concurrent |
containing utility classes commonly useful in concurrent |
| 28 |
programming. Like package <tt>java.util</tt>, it includes a few small |
programming. Like package <tt>java.util</tt>, it includes a few small |
| 29 |
standardized extensible frameworks, as well as some classes that |
standardized extensible frameworks, as well as other classes that |
| 30 |
provide useful functionality and are otherwise tedious or difficult to |
provide useful functionality and are otherwise tedious or difficult to |
| 31 |
implement. |
implement. |
| 32 |
|
|
| 38 |
pools. This diversity reflects the range of contexts in which |
pools. This diversity reflects the range of contexts in which |
| 39 |
developers of concurrent programs have been found to require or desire |
developers of concurrent programs have been found to require or desire |
| 40 |
support not previously available in J2SE, which also keeping the |
support not previously available in J2SE, which also keeping the |
| 41 |
resulting package small; providing only functionality that it makes |
resulting package small; providing only functionality that has been |
| 42 |
sense to standardize. |
found to be worthwhile to standardize. |
| 43 |
|
|
| 44 |
<p>Descriptions and brief motivations for the main components may be |
<p>Descriptions and brief motivations for the main components may be |
| 45 |
found in the associated package documentation. JSR-166 also includes |
found in the associated package documentation. JSR-166 also includes |
| 75 |
<tt>InterruptedExceptions</tt>. |
<tt>InterruptedExceptions</tt>. |
| 76 |
<li> The <tt>destroy</tt> method, which has never been implemented, |
<li> The <tt>destroy</tt> method, which has never been implemented, |
| 77 |
has finally been deprecated. This is just a spec change, reflecting |
has finally been deprecated. This is just a spec change, reflecting |
| 78 |
the fact that that the reason it has never been implmented is that |
the fact that that the reason it has never been implemented is that |
| 79 |
it was undesirable and unworkable. |
it was undesirable and unworkable. |
| 80 |
</ul> |
</ul> |
| 81 |
|
|