8165579: Add missing javadoc information for javax.management.MBeanServer
authorvtewari
Thu, 08 Sep 2016 15:53:16 +0530
changeset 40968 626487a7488a
parent 40967 d3928f9ab663
child 40969 482eb34be191
child 41110 7344bf3b3a6f
child 41112 15f038151608
8165579: Add missing javadoc information for javax.management.MBeanServer Summary: Added missing @implSpec javadoc information for deserialize api’s Reviewed-by: dfuchs, dholmes Contributed-by: amit.sapre@oracle.com
jdk/src/java.management/share/classes/javax/management/MBeanServer.java
--- a/jdk/src/java.management/share/classes/javax/management/MBeanServer.java	Thu Sep 08 15:00:39 2016 +0530
+++ b/jdk/src/java.management/share/classes/javax/management/MBeanServer.java	Thu Sep 08 15:53:16 2016 +0530
@@ -655,6 +655,8 @@
      * used for the de-serialization.
      * @param data The byte array to be de-sererialized.
      *
+     * @implSpec This method throws {@link UnsupportedOperationException} by default.
+     *
      * @return The de-serialized object stream.
      *
      * @exception InstanceNotFoundException The MBean specified is not
@@ -665,7 +667,7 @@
      * @deprecated Use {@link #getClassLoaderFor getClassLoaderFor} to
      * obtain the appropriate class loader for deserialization.
      */
-    @Deprecated
+    @Deprecated(since="1.5")
     default public ObjectInputStream deserialize(ObjectName name, byte[] data)
             throws InstanceNotFoundException, OperationsException {
         throw new UnsupportedOperationException("Not supported.");
@@ -683,6 +685,8 @@
      * used for the de-serialization.
      * @param data The byte array to be de-sererialized.
      *
+     * @implSpec This method throws {@link UnsupportedOperationException} by default.
+     *
      * @return  The de-serialized object stream.
      *
      * @exception OperationsException Any of the usual Input/Output
@@ -693,7 +697,7 @@
      * @deprecated Use {@link #getClassLoaderRepository} to obtain the
      * class loader repository and use it to deserialize.
      */
-    @Deprecated
+    @Deprecated(since="1.5")
     default public ObjectInputStream deserialize(String className, byte[] data)
             throws OperationsException, ReflectionException {
         throw new UnsupportedOperationException("Not supported.");
@@ -714,6 +718,8 @@
      * loading the specified class.  If null, the MBean Server's class
      * loader will be used.
      *
+     * @implSpec This method throws {@link UnsupportedOperationException} by default.
+     *
      * @return  The de-serialized object stream.
      *
      * @exception InstanceNotFoundException The specified class loader
@@ -726,7 +732,7 @@
      * @deprecated Use {@link #getClassLoader getClassLoader} to obtain
      * the class loader for deserialization.
      */
-    @Deprecated
+    @Deprecated(since="1.5")
     default public ObjectInputStream deserialize(String className,
                                          ObjectName loaderName,
                                          byte[] data)