# HG changeset patch
# User darcy
# Date 1429203089 25200
# Node ID 9cc3e111a1d8f7d239151046348b7e7310bda601
# Parent 2eceae3716d95a8fbc588860963a7d6b263ee35f
8077923: Add missing doclint in javax.management
Reviewed-by: dfuchs
diff -r 2eceae3716d9 -r 9cc3e111a1d8 jdk/src/java.management/share/classes/javax/management/AttributeValueExp.java
--- a/jdk/src/java.management/share/classes/javax/management/AttributeValueExp.java Thu Apr 16 08:25:19 2015 -0700
+++ b/jdk/src/java.management/share/classes/javax/management/AttributeValueExp.java Thu Apr 16 09:51:29 2015 -0700
@@ -1,5 +1,5 @@
/*
- * Copyright (c) 1999, 2008, Oracle and/or its affiliates. All rights reserved.
+ * Copyright (c) 1999, 2015, Oracle and/or its affiliates. All rights reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
*
* This code is free software; you can redistribute it and/or modify it
@@ -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,
diff -r 2eceae3716d9 -r 9cc3e111a1d8 jdk/src/java.management/share/classes/javax/management/DescriptorKey.java
--- a/jdk/src/java.management/share/classes/javax/management/DescriptorKey.java Thu Apr 16 08:25:19 2015 -0700
+++ b/jdk/src/java.management/share/classes/javax/management/DescriptorKey.java Thu Apr 16 09:51:29 2015 -0700
@@ -1,5 +1,5 @@
/*
- * Copyright (c) 2005, 2013, Oracle and/or its affiliates. All rights reserved.
+ * Copyright (c) 2005, 2015, Oracle and/or its affiliates. All rights reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
*
* This code is free software; you can redistribute it and/or modify it
@@ -168,5 +168,9 @@
@Retention(RetentionPolicy.RUNTIME)
@Target(ElementType.METHOD)
public @interface DescriptorKey {
+ /**
+ * Returns the descriptor key.
+ * @return the descriptor key
+ */
String value();
}
diff -r 2eceae3716d9 -r 9cc3e111a1d8 jdk/src/java.management/share/classes/javax/management/DynamicMBean.java
--- a/jdk/src/java.management/share/classes/javax/management/DynamicMBean.java Thu Apr 16 08:25:19 2015 -0700
+++ b/jdk/src/java.management/share/classes/javax/management/DynamicMBean.java Thu Apr 16 09:51:29 2015 -0700
@@ -1,5 +1,5 @@
/*
- * Copyright (c) 1999, 2003, Oracle and/or its affiliates. All rights reserved.
+ * Copyright (c) 1999, 2015, Oracle and/or its affiliates. All rights reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
*
* This code is free software; you can redistribute it and/or modify it
@@ -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.
*
diff -r 2eceae3716d9 -r 9cc3e111a1d8 jdk/src/java.management/share/classes/javax/management/ImmutableDescriptor.java
--- a/jdk/src/java.management/share/classes/javax/management/ImmutableDescriptor.java Thu Apr 16 08:25:19 2015 -0700
+++ b/jdk/src/java.management/share/classes/javax/management/ImmutableDescriptor.java Thu Apr 16 09:51:29 2015 -0700
@@ -1,5 +1,5 @@
/*
- * Copyright (c) 2004, 2013, Oracle and/or its affiliates. All rights reserved.
+ * Copyright (c) 2004, 2015, Oracle and/or its affiliates. All rights reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
*
* This code is free software; you can redistribute it and/or modify it
@@ -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 diff -r 2eceae3716d9 -r 9cc3e111a1d8 jdk/src/java.management/share/classes/javax/management/QueryExp.java --- a/jdk/src/java.management/share/classes/javax/management/QueryExp.java Thu Apr 16 08:25:19 2015 -0700 +++ b/jdk/src/java.management/share/classes/javax/management/QueryExp.java Thu Apr 16 09:51:29 2015 -0700 @@ -1,5 +1,5 @@ /* - * Copyright (c) 1999, 2008, Oracle and/or its affiliates. All rights reserved. + * Copyright (c) 1999, 2015, Oracle and/or its affiliates. All rights reserved. * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. * * This code is free software; you can redistribute it and/or modify it @@ -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 ; diff -r 2eceae3716d9 -r 9cc3e111a1d8 jdk/src/java.management/share/classes/javax/management/StandardEmitterMBean.java --- a/jdk/src/java.management/share/classes/javax/management/StandardEmitterMBean.java Thu Apr 16 08:25:19 2015 -0700 +++ b/jdk/src/java.management/share/classes/javax/management/StandardEmitterMBean.java Thu Apr 16 09:51:29 2015 -0700 @@ -1,5 +1,5 @@ /* - * Copyright (c) 2005, 2013, Oracle and/or its affiliates. All rights reserved. + * Copyright (c) 2005, 2015, Oracle and/or its affiliates. All rights reserved. * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. * * This code is free software; you can redistribute it and/or modify it @@ -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;
diff -r 2eceae3716d9 -r 9cc3e111a1d8 jdk/src/java.management/share/classes/javax/management/ValueExp.java
--- a/jdk/src/java.management/share/classes/javax/management/ValueExp.java Thu Apr 16 08:25:19 2015 -0700
+++ b/jdk/src/java.management/share/classes/javax/management/ValueExp.java Thu Apr 16 09:51:29 2015 -0700
@@ -1,5 +1,5 @@
/*
- * Copyright (c) 1999, 2004, Oracle and/or its affiliates. All rights reserved.
+ * Copyright (c) 1999, 2015, Oracle and/or its affiliates. All rights reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
*
* This code is free software; you can redistribute it and/or modify it
@@ -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,
diff -r 2eceae3716d9 -r 9cc3e111a1d8 jdk/src/java.management/share/classes/javax/management/modelmbean/ModelMBeanInfo.java
--- a/jdk/src/java.management/share/classes/javax/management/modelmbean/ModelMBeanInfo.java Thu Apr 16 08:25:19 2015 -0700
+++ b/jdk/src/java.management/share/classes/javax/management/modelmbean/ModelMBeanInfo.java Thu Apr 16 09:51:29 2015 -0700
@@ -1,5 +1,5 @@
/*
- * Copyright (c) 2000, 2013, Oracle and/or its affiliates. All rights reserved.
+ * Copyright (c) 2000, 2015, Oracle and/or its affiliates. All rights reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
*
* This code is free software; you can redistribute it and/or modify it
@@ -307,6 +307,7 @@
/**
* Creates and returns a copy of this object.
+ * @return a copy of this object
*/
public java.lang.Object clone();
diff -r 2eceae3716d9 -r 9cc3e111a1d8 jdk/src/java.management/share/classes/javax/management/monitor/Monitor.java
--- a/jdk/src/java.management/share/classes/javax/management/monitor/Monitor.java Thu Apr 16 08:25:19 2015 -0700
+++ b/jdk/src/java.management/share/classes/javax/management/monitor/Monitor.java Thu Apr 16 09:51:29 2015 -0700
@@ -1,5 +1,5 @@
/*
- * Copyright (c) 1999, 2013, Oracle and/or its affiliates. All rights reserved.
+ * Copyright (c) 1999, 2015, Oracle and/or its affiliates. All rights reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
*
* This code is free software; you can redistribute it and/or modify it
@@ -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 {
diff -r 2eceae3716d9 -r 9cc3e111a1d8 jdk/src/java.management/share/classes/javax/management/openmbean/ArrayType.java
--- a/jdk/src/java.management/share/classes/javax/management/openmbean/ArrayType.java Thu Apr 16 08:25:19 2015 -0700
+++ b/jdk/src/java.management/share/classes/javax/management/openmbean/ArrayType.java Thu Apr 16 09:51:29 2015 -0700
@@ -1,5 +1,5 @@
/*
- * Copyright (c) 2000, 2013, Oracle and/or its affiliates. All rights reserved.
+ * Copyright (c) 2000, 2015, Oracle and/or its affiliates. All rights reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
*
* This code is free software; you can redistribute it and/or modify it
@@ -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 {