changeset 58369:e713e8a312ea

8240957: Clarify BadAttributeValueExpException readObject method Reviewed-by: bpb
author rriggs
date Thu, 12 Mar 2020 11:57:35 -0400
parents 910e8900f11d
children fa70160bcf72
files src/java.management/share/classes/javax/management/BadAttributeValueExpException.java
diffstat 1 files changed, 11 insertions(+), 1 deletions(-) [+]
line wrap: on
line diff
--- a/src/java.management/share/classes/javax/management/BadAttributeValueExpException.java	Thu Mar 12 11:54:39 2020 -0400
+++ b/src/java.management/share/classes/javax/management/BadAttributeValueExpException.java	Thu Mar 12 11:57:35 2020 -0400
@@ -45,7 +45,7 @@
 
     /**
      * @serial A string representation of the attribute that originated this exception.
-     * for example, the string value can be the return of {@code attribute.toString()}
+     * For example, the string value can be the return of {@code attribute.toString()}.
      */
     @SuppressWarnings("serial") // See handling in constructor and readObject
     private String val;
@@ -68,6 +68,16 @@
         return "BadAttributeValueException: " + val;
     }
 
+    /**
+     * Restores the fields of a BadAttributeValueExpException from the stream.
+     * If the 'val' field in the stream does not contain a string
+     * it is replaced with an implementation specific string representation
+     * of the value in the stream.
+     *
+     * @param ois an ObjectInput Stream
+     * @throws IOException thrown if an error occurs
+     * @throws ClassNotFoundException if a class can not be found
+     */
     private void readObject(ObjectInputStream ois) throws IOException, ClassNotFoundException {
         ObjectInputStream.GetField gf = ois.readFields();
         Object valObj = gf.get("val", null);