--- old/src/java.management/share/classes/javax/management/AttributeValueExp.java 2015-04-15 19:40:40.296525183 -0700
+++ new/src/java.management/share/classes/javax/management/AttributeValueExp.java 2015-04-15 19:40:40.116615181 -0700
@@ -93,11 +93,10 @@
*
* @return The ValueExp
.
*
- * @exception BadAttributeValueExpException
- * @exception InvalidApplicationException
- * @exception BadStringOperationException
- * @exception BadBinaryOpValueExpException
- *
+ * @throws BadStringOperationException {@inheritDoc}
+ * @throws BadBinaryOpValueExpException {@inheritDoc}
+ * @throws BadAttributeValueExpException {@inheritDoc}
+ * @throws InvalidApplicationException {@inheritDoc}
*/
@Override
public ValueExp apply(ObjectName name) throws BadStringOperationException, BadBinaryOpValueExpException,
--- old/src/java.management/share/classes/javax/management/DescriptorKey.java 2015-04-15 19:40:40.740303194 -0700
+++ new/src/java.management/share/classes/javax/management/DescriptorKey.java 2015-04-15 19:40:40.564391190 -0700
@@ -168,5 +168,9 @@
@Retention(RetentionPolicy.RUNTIME)
@Target(ElementType.METHOD)
public @interface DescriptorKey {
+ /**
+ * Returns the descriptor key.
+ * @return the descriptor key
+ */
String value();
}
--- old/src/java.management/share/classes/javax/management/DynamicMBean.java 2015-04-15 19:40:41.196075205 -0700
+++ new/src/java.management/share/classes/javax/management/DynamicMBean.java 2015-04-15 19:40:41.016165202 -0700
@@ -43,7 +43,7 @@
*
* @return The value of the attribute retrieved.
*
- * @exception AttributeNotFoundException
+ * @exception AttributeNotFoundException if specified attribute does not exist or cannot be retrieved
* @exception MBeanException Wraps a java.lang.Exception
thrown by the MBean's getter.
* @exception ReflectionException Wraps a java.lang.Exception
thrown while trying to invoke the getter.
*
@@ -58,8 +58,8 @@
* @param attribute The identification of the attribute to
* be set and the value it is to be set to.
*
- * @exception AttributeNotFoundException
- * @exception InvalidAttributeValueException
+ * @exception AttributeNotFoundException if specified attribute does not exist or cannot be retrieved
+ * @exception InvalidAttributeValueException if value specified is not valid for the attribute
* @exception MBeanException Wraps a java.lang.Exception
thrown by the MBean's setter.
* @exception ReflectionException Wraps a java.lang.Exception
thrown while trying to invoke the MBean's setter.
*
--- old/src/java.management/share/classes/javax/management/ImmutableDescriptor.java 2015-04-15 19:40:41.639853215 -0700
+++ new/src/java.management/share/classes/javax/management/ImmutableDescriptor.java 2015-04-15 19:40:41.455945211 -0700
@@ -65,6 +65,8 @@
/**
* Construct a descriptor containing the given fields and values.
*
+ * @param fieldNames the field names
+ * @param fieldValues the field values
* @throws IllegalArgumentException if either array is null, or
* if the arrays have different sizes, or
* if a field name is null or empty, or if the same field name
@@ -81,6 +83,7 @@
* is {@code a=b=c} then the field name is {@code a} and its value
* is {@code b=c}.
*
+ * @param fields the field names
* @throws IllegalArgumentException if the parameter is null, or
* if a field name is empty, or if the same field name appears
* more than once, or if one of the strings does not contain
@@ -94,6 +97,7 @@
*
Construct a descriptor where the names and values of the fields * are the keys and values of the given Map.
* + * @param fields the field names and values * @throws IllegalArgumentException if the parameter is null, or * if a field name is null or empty, or if the same field name appears * more than once (which can happen because field names are not case --- old/src/java.management/share/classes/javax/management/QueryExp.java 2015-04-15 19:40:42.099623225 -0700 +++ new/src/java.management/share/classes/javax/management/QueryExp.java 2015-04-15 19:40:41.919713221 -0700 @@ -53,10 +53,13 @@ * * @return True if the query was successfully applied to the MBean, false otherwise * - * @exception BadStringOperationException - * @exception BadBinaryOpValueExpException - * @exception BadAttributeValueExpException - * @exception InvalidApplicationException + * @throws BadStringOperationException when an invalid string + * operation is passed to a method for constructing a query + * @throws BadBinaryOpValueExpException when an invalid expression + * is passed to a method for constructing a query + * @throws BadAttributeValueExpException when an invalid MBean + * attribute is passed to a query constructing method + * @throws InvalidApplicationException when an invalid apply is attempted */ public boolean apply(ObjectName name) throws BadStringOperationException, BadBinaryOpValueExpException, BadAttributeValueExpException, InvalidApplicationException ; --- old/src/java.management/share/classes/javax/management/StandardEmitterMBean.java 2015-04-15 19:40:42.559393236 -0700 +++ new/src/java.management/share/classes/javax/management/StandardEmitterMBean.java 2015-04-15 19:40:42.367489231 -0700 @@ -91,6 +91,7 @@ * that will have no effect on this object's * {@code getNotificationInfo()}. * + * @paramValueExp
.
*
- * @exception BadStringOperationException
- * @exception BadBinaryOpValueExpException
- * @exception BadAttributeValueExpException
- * @exception InvalidApplicationException
+ * @throws BadStringOperationException {@inheritDoc}
+ * @throws BadBinaryOpValueExpException {@inheritDoc}
+ * @throws BadAttributeValueExpException {@inheritDoc}
+ * @throws InvalidApplicationException {@inheritDoc}
*/
+ @Override
public ValueExp apply(ObjectName name) throws BadStringOperationException, BadBinaryOpValueExpException,
BadAttributeValueExpException, InvalidApplicationException {
return this;
--- old/src/java.management/share/classes/javax/management/ValueExp.java 2015-04-15 19:40:43.466939257 -0700
+++ new/src/java.management/share/classes/javax/management/ValueExp.java 2015-04-15 19:40:43.283031253 -0700
@@ -80,10 +80,13 @@
*
* @return The ValueExp
.
*
- * @exception BadStringOperationException
- * @exception BadBinaryOpValueExpException
- * @exception BadAttributeValueExpException
- * @exception InvalidApplicationException
+ * @throws BadStringOperationException when an invalid string
+ * operation is passed to a method for constructing a query
+ * @throws BadBinaryOpValueExpException when an invalid expression
+ * is passed to a method for constructing a query
+ * @throws BadAttributeValueExpException when an invalid MBean
+ * attribute is passed to a query constructing method
+ * @throws InvalidApplicationException when an invalid apply is attempted
*/
public ValueExp apply(ObjectName name)
throws BadStringOperationException, BadBinaryOpValueExpException,
--- old/src/java.management/share/classes/javax/management/modelmbean/ModelMBeanInfo.java 2015-04-15 19:40:43.930707268 -0700
+++ new/src/java.management/share/classes/javax/management/modelmbean/ModelMBeanInfo.java 2015-04-15 19:40:43.746799263 -0700
@@ -307,6 +307,7 @@
/**
* Creates and returns a copy of this object.
+ * @return a copy of this object
*/
public java.lang.Object clone();
--- old/src/java.management/share/classes/javax/management/monitor/Monitor.java 2015-04-15 19:40:44.386479279 -0700
+++ new/src/java.management/share/classes/javax/management/monitor/Monitor.java 2015-04-15 19:40:44.198573274 -0700
@@ -387,7 +387,7 @@
*
* @return The name of the monitor MBean registered.
*
- * @exception Exception
+ * @exception Exception if something goes wrong
*/
public ObjectName preRegister(MBeanServer server, ObjectName name)
throws Exception {
@@ -416,7 +416,7 @@
*
* Stops the monitor.
*
- * @exception Exception
+ * @exception Exception if something goes wrong
*/
public void preDeregister() throws Exception {
--- old/src/java.management/share/classes/javax/management/openmbean/ArrayType.java 2015-04-15 19:40:44.902221290 -0700
+++ new/src/java.management/share/classes/javax/management/openmbean/ArrayType.java 2015-04-15 19:40:44.670337285 -0700
@@ -793,6 +793,7 @@
* array type description = 3-dimension array of java.lang.String
* }
*
+ * @param
* Stops the timer.
*
- * @exception java.lang.Exception
+ * @exception java.lang.Exception if something goes wrong
*/
public void preDeregister() throws java.lang.Exception {