United StatesChange Country, Oracle Worldwide Web Sites Communities I am a... I want to...
Bug ID: JDK-6273613 Javadoc is missing exception wrapping description for javax.management.Descriptor.setFields
JDK-6273613 : Javadoc is missing exception wrapping description for javax.management.Descriptor.setFields

Details
Type:
Bug
Submit Date:
2005-05-20
Status:
Closed
Updated Date:
2010-07-29
Project Name:
JDK
Resolved Date:
2005-12-21
Component:
core-svc
OS:
generic
Sub-Component:
javax.management
CPU:
generic
Priority:
P3
Resolution:
Fixed
Affected Versions:
6
Fixed Versions:

Related Reports
Relates:

Sub Tasks

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
                                     
2005-05-20
EVALUATION

Should be fixed to be consistent.
###@###.### 2005-05-24 12:14:17 GMT
                                     
2005-05-20



Hardware and Software, Engineered to Work Together