JDK-6269729 : Improve method tables in BlockingDeque and related interfaces
  • Type: Bug
  • Component: core-libs
  • Sub-Component: java.util.concurrent
  • Affected Version: 6
  • Priority: P4
  • Status: Resolved
  • Resolution: Fixed
  • OS: generic
  • CPU: generic
  • Submitted: 2005-05-12
  • Updated: 2010-04-02
  • Resolved: 2005-09-04
The Version table provides details related to the release that this issue/RFE will be addressed.

Unresolved : Release in which this issue/RFE will be addressed.
Resolved: Release in which this issue/RFE has been resolved.
Fixed : Release in which this issue/RFE has been fixed. The release containing this fix may be available for download as an Early Access Release or a General Availability Release.

To download the current JDK release, click here.
JDK 6
6 b51Fixed
Description
The new interface BlockingDeque has many different methods, that come in
many flavors based on the three dimensions:
- blocking/exception behavior (4 variants)
- first/last/unspecified-endian (3 variants)
- insert/remove/examine (3 variants)

So there are up to 36 different methods (some are missing; in fact only 30) a user
needs to keep track of.  We need good html tables in the class javadoc
to clarify all of these many methods.

Similarly, BlockingQueue, Deque, and Queue can have minor improvements to their
method tables.  The methods in the javadoc should be presented in the same order
as their presentation in the corresponding table.
###@###.### 2005-05-12 22:56:27 GMT

Comments
EVALUATION Will be fixed as part of the jsr166x project. ###@###.### 2005-05-12 22:57:24 GMT
12-05-2005