/[cvs]/jsr166/src/main/intro.html
ViewVC logotype

Diff of /jsr166/src/main/intro.html

Parent Directory Parent Directory | Revision Log Revision Log | View Patch Patch

revision 1.12 by dl, Sat Aug 9 20:00:07 2003 UTC revision 1.14 by dl, Sat Sep 27 12:21:56 2003 UTC
# Line 10  Line 10 
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  This is an updated version of the specification submitted for JCP Public
14  Community Draft review.  To check for further updates, access a  Review.  To check for further updates, access a preliminary prototype
15  preliminary prototype release of main functionality, or join a mailing  release of main functionality, or join a mailing list discussing
16  list discussing this JSR, go to: <A  JSR-166, go to: <A
17  HREF="http://altair.cs.oswego.edu/mailman/listinfo/concurrency-interest">  HREF="http://altair.cs.oswego.edu/mailman/listinfo/concurrency-interest">
18  http://altair.cs.oswego.edu/mailman/listinfo/concurrency-interest</A>  http://altair.cs.oswego.edu/mailman/listinfo/concurrency-interest</A>.
 .  <p>  
19    
20  <em> <b>Disclaimer</b>. The prototype implementation is experimental  <p><em>Note: The javadocs here includes some existing java.util
21  code developed as part of JCP JSR-166 is made available to the  Collection interfaces and classes that are not part of the JSR-166
22  developer community for use as-is. It is not a supported product. Use  spec, but are included because JSR-166 methods implement or inherit
23  it at your own risk. The specification, language and implementation  from their specifications.</em>
 are subject to change as a result of your feedback. Because these  
 features have not yet been approved for addition to the Java language,  
 there is no schedule for their inclusion in a product.  </em>  
   
 <p> <em> <b>Disclaimer</b>.  This draft specification was produced  
 using JDK1.4 tools plus some preprocessing. The resulting javadocs do  
 not yet correctly render other planned JDK1.5 constructs on which  
 JSR-166 relies, most notably the use of generic types. We are  
 releasing this version now (before the availability of JDK1.5-based  
 tools) because, even though they are misformatted and sometimes lack  
 proper cross-referencing, they otherwise convey the intended  
 specifications.  </em>  
24    
25  <p> JSR-166 introduces package <tt>java.util.concurrent</tt>  <p> JSR-166 introduces package <tt>java.util.concurrent</tt>
26  containing utility classes commonly useful in concurrent  containing utility classes commonly useful in concurrent
# Line 50  data structures, to high-level execution Line 37  data structures, to high-level execution
37  pools. This diversity reflects the range of contexts in which  pools. This diversity reflects the range of contexts in which
38  developers of concurrent programs have been found to require or desire  developers of concurrent programs have been found to require or desire
39  support not previously available in J2SE, which also keeping the  support not previously available in J2SE, which also keeping the
40  resulting package small; providing only that minimial support for  resulting package small; providing only functionality that it makes
41  which it makes sense to standardize.  sense to standardize.
42    
43  <p>Descriptions and brief motivations for the main components may be  <p>Descriptions and brief motivations for the main components may be
44  found in the associated package documentation.  JSR-166 also includes  found in the associated package documentation.  JSR-166 also includes
# Line 68  java.util.PriorityQueue} is added. Line 55  java.util.PriorityQueue} is added.
55    
56  <h2>Threads</h2>  <h2>Threads</h2>
57    
58  Two minor changes are introduced to the {@link java.lang.Thread}  Three minor changes are introduced to the {@link java.lang.Thread}
59  class: It now allows per-thread installation of handlers for uncaught  class:
60  exceptions. Ths optionally disassociates handlers from ThreadGroups,  <ul>
61  which has proven to be too inflexible. (Note that the combination of    <li> It now allows per-thread installation of handlers for uncaught
62  features in JSR-166 make ThreadGroups even less likely to be used in    exceptions. Ths optionally disassociates handlers from ThreadGroups,
63  most programs. Perhaps they will eventually be deprecated.) Secondly,    which has proven to be too inflexible. (Note that the combination of
64  access checks are no longer required when a Thread interrupts    features in JSR-166 make ThreadGroups even less likely to be used in
65  <em>itself</em>.  The <tt>interrupt</tt> method is the only way to    most programs. Perhaps they will eventually be deprecated.)
66  re-assert a thread's interruption status (and in the case of  
67  self-interruption has no other effect than this).  The check here    <li> Access checks are no longer required when a Thread interrupts
68  previously caused unjustifiable and uncontrollable failures when    <em>itself</em>.  The <tt>interrupt</tt> method is the only way to
69  restricted code invoked library code that must reassert interruption    re-assert a thread's interruption status (and in the case of
70  to correctly propagate status when encountering some    self-interruption has no other effect than this).  The check here
71  <tt>InterruptedExceptions</tt>.    previously caused unjustifiable and uncontrollable failures when
72      restricted code invoked library code that must reassert interruption
73      to correctly propagate status when encountering some
74      <tt>InterruptedExceptions</tt>.
75      <li> The <tt>destroy</tt> method, which has never been implemented,
76      has finally been deprecated. This is just a spec change, reflecting
77      the fact that that the reason it has never been implmented is that
78      it was undesirable and unworkable.
79    </ul>
80    
81  <h2>Timing</h2>  <h2>Timing</h2>
82    
# Line 98  designs. Line 93  designs.
93    
94    
95    <hr>    <hr>
   <address><A HREF="http://gee.cs.oswego.edu/dl">Doug Lea</A></address>  
96   </body>   </body>
97  </html>  </html>

Legend:
Removed from v.1.12  
changed lines
  Added in v.1.14

dl@cs.oswego.edu
ViewVC Help
Powered by ViewVC 1.1.27