# 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()}.

* + * @param the implementation type of the MBean * @param implementation the implementation of the MBean interface. * @param mbeanInterface a Standard MBean interface. * @param emitter the object that will handle notifications. @@ -129,6 +130,7 @@ * that will have no effect on this object's * {@code getNotificationInfo()}.

* + * @param the implementation type of the MBean * @param implementation the implementation of the MBean interface. * @param mbeanInterface a Standard MBean interface. * @param isMXBean If true, the {@code mbeanInterface} parameter diff -r 2eceae3716d9 -r 9cc3e111a1d8 jdk/src/java.management/share/classes/javax/management/StringValueExp.java --- a/jdk/src/java.management/share/classes/javax/management/StringValueExp.java Thu Apr 16 08:25:19 2015 -0700 +++ b/jdk/src/java.management/share/classes/javax/management/StringValueExp.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 @@ -95,11 +95,12 @@ * * @return The ValueExp. * - * @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 the Java type that described instances must have * @param elementType the open type of element values contained * in the arrays described by this ArrayType * instance; must be an instance of either @@ -800,7 +801,7 @@ * TabularType or another ArrayType * with a SimpleType, CompositeType * or TabularType as its elementType. - * + * @return an {@code ArrayType} instance * @throws OpenDataException if elementType's className is not * one of the allowed Java class names for open * data. @@ -834,12 +835,14 @@ * array type description = 3-dimension array of int * } * + * @param the Java type that described instances must have * @param arrayClass a primitive array class such as {@code int[].class}, * {@code boolean[][].class}, etc. The {@link * #getElementOpenType()} method of the returned * {@code ArrayType} returns the {@link SimpleType} * corresponding to the wrapper type of the primitive * type of the array. + * @return an {@code ArrayType} instance * * @throws IllegalArgumentException if arrayClass is not * a primitive array. diff -r 2eceae3716d9 -r 9cc3e111a1d8 jdk/src/java.management/share/classes/javax/management/timer/Timer.java --- a/jdk/src/java.management/share/classes/javax/management/timer/Timer.java Thu Apr 16 08:25:19 2015 -0700 +++ b/jdk/src/java.management/share/classes/javax/management/timer/Timer.java Thu Apr 16 09:51:29 2015 -0700 @@ -1,5 +1,5 @@ /* - * Copyright (c) 1999, 2012, 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 @@ -195,7 +195,7 @@ * * @return The name of the timer MBean registered. * - * @exception java.lang.Exception + * @exception java.lang.Exception if something goes wrong */ public ObjectName preRegister(MBeanServer server, ObjectName name) throws java.lang.Exception { @@ -217,7 +217,7 @@ *

* Stops the timer. * - * @exception java.lang.Exception + * @exception java.lang.Exception if something goes wrong */ public void preDeregister() throws java.lang.Exception {