--- jsr166/src/main/intro.html 2013/01/13 17:44:16 1.22 +++ jsr166/src/main/intro.html 2016/03/25 05:38:25 1.25 @@ -10,22 +10,14 @@ by Doug Lea

-This is maintenance repository of JSR166 specifications. For further +This is maintenance repository of JSR-166 specifications. For further information, go to: http://altair.cs.oswego.edu/mailman/listinfo/concurrency-interest. -

Note: The javadocs here do not include pre-existing -java classes (for example java.lang.Thread) that were changed -as part of the JSR166 spec. On the other hand, the javadocs here do -include some existing java.util Collection interfaces and classes that -are not part of the spec, but are included because some new methods -implement or inherit from their specifications. - - -

JSR-166 introduces package java.util.concurrent +

JSR-166 introduces package java.util.concurrent containing utility classes commonly useful in concurrent -programming. Like package java.util, it includes a few small +programming. Like package java.util, it includes a few small standardized extensible frameworks, as well as other classes that provide useful functionality and are otherwise tedious or difficult to implement. @@ -37,7 +29,7 @@ data structures, to high-level execution agents including thread pools. This diversity reflects the range of contexts in which developers of concurrent programs have been found to require or desire -support not previously available in J2SE, which also keeping the +support not previously available in J2SE, while also keeping the resulting package small; providing only functionality that has been found to be worthwhile to standardize. @@ -50,7 +42,7 @@ A basic (nonblocking) {@link java.util.Queue} interface extending {@link java.util.Collection} is introduced into -java.util. Existing class {@link java.util.LinkedList} is +java.util. Existing class {@link java.util.LinkedList} is adapted to support Queue, and a new non-thread-safe {@link java.util.PriorityQueue} is added. @@ -66,24 +58,24 @@ most programs. Perhaps they will eventually be deprecated.)

  • Access checks are no longer required when a Thread interrupts - itself. The interrupt method is the only way to + itself. The interrupt method is the only way to re-assert a thread's interruption status (and in the case of self-interruption has no other effect than this). The check here previously caused unjustifiable and uncontrollable failures when restricted code invoked library code that must reassert interruption to correctly propagate status when encountering some - InterruptedExceptions. -
  • The destroy method, which has never been implemented, + InterruptedExceptions. +
  • The destroy method, which has never been implemented, has finally been deprecated. This is just a spec change, reflecting - the fact that that the reason it has never been implemented is that + the fact that the reason it has never been implemented is that it was undesirable and unworkable.

    Timing

    -Method nanoTime is added to {@link java.lang.System}. It +Method nanoTime is added to {@link java.lang.System}. It provides a high-precision timing facility that is distinct from and -uncoordinated with System.currentTimeMillis. +uncoordinated with System.currentTimeMillis.

    Removing ThreadLocals