JDK-6273613 : Javadoc is missing exception wrapping description for javax.management.Descriptor.setFields
  • Type: Bug
  • Component: core-svc
  • Sub-Component: javax.management
  • Affected Version: 6
  • Priority: P3
  • Status: Closed
  • Resolution: Fixed
  • OS: generic
  • CPU: generic
  • Submitted: 2005-05-20
  • Updated: 2017-05-16
  • Resolved: 2005-12-21
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 b45Fixed
Related Reports
Relates :  
JDK-6305139 - ImmutableDescriptor.setFields does not wrap IAE as said in Descriptor interface
Description
From the interface javax.management.Descriptor, the method setFields is said to throw RuntimeOperationsException that way (since b37):
[...]
RuntimeOperationsException - for illegal value for field Names or field Values. Neither can be null. The array lengths must be equal. If the descriptor construction fails for any reason, this exception will be thrown.
[...]

It is not symmetric to the specification of the method setField where the wrapped exception is described:
[...]
RuntimeOperationsException - if the field name or field value is illegal (wrapped exception is IllegalArgumentException); or if the descriptor is immutable (wrapped exception is UnsupportedOperationException).
[...]

###@###.### 2005-05-20 11:51:05 GMT
Comments
SUGGESTED FIX It should be said that an IllegalArgumentException is wrapped into the RuntimeOperationsException. Note that the implementation (b37) does such wrapping. ###@###.### 2005-05-20 11:51:05 GMT
20-05-2005
EVALUATION Should be fixed to be consistent. ###@###.### 2005-05-24 12:14:17 GMT
20-05-2005