CVSROOT: /cvsroot/classpath
Module name: classpath
Changes by: Andrew John Hughes <gnu_andrew> 06/06/15 21:18:54
Modified files:
. : ChangeLog
javax/management: AttributeList.java
RuntimeOperationsException.java
Added files:
javax/management: DynamicMBean.java MBeanInfo.java
Log message:
2006-06-15 Andrew John Hughes <[EMAIL PROTECTED]>
* javax/management/AttributeList.java:
Add serialization UID.
* javax/management/DynamicMBean.java:
New file.
* javax/management/JMRuntimeException.java:
Add serialization UID and correct name
of serialized field.
* javax/management/MBeanInfo.java: New file.
CVSWeb URLs:
http://cvs.savannah.gnu.org/viewcvs/classpath/ChangeLog?cvsroot=classpath&r1=1.7835&r2=1.7836
http://cvs.savannah.gnu.org/viewcvs/classpath/javax/management/AttributeList.java?cvsroot=classpath&r1=1.1&r2=1.2
http://cvs.savannah.gnu.org/viewcvs/classpath/javax/management/RuntimeOperationsException.java?cvsroot=classpath&r1=1.1&r2=1.2
http://cvs.savannah.gnu.org/viewcvs/classpath/javax/management/DynamicMBean.java?cvsroot=classpath&rev=1.1
http://cvs.savannah.gnu.org/viewcvs/classpath/javax/management/MBeanInfo.java?cvsroot=classpath&rev=1.1
Patches:
Index: ChangeLog
===================================================================
RCS file: /cvsroot/classpath/classpath/ChangeLog,v
retrieving revision 1.7835
retrieving revision 1.7836
diff -u -b -r1.7835 -r1.7836
--- ChangeLog 15 Jun 2006 19:37:46 -0000 1.7835
+++ ChangeLog 15 Jun 2006 21:18:53 -0000 1.7836
@@ -1,5 +1,16 @@
2006-06-15 Andrew John Hughes <[EMAIL PROTECTED]>
+ * javax/management/AttributeList.java:
+ Add serialization UID.
+ * javax/management/DynamicMBean.java:
+ New file.
+ * javax/management/JMRuntimeException.java:
+ Add serialization UID and correct name
+ of serialized field.
+ * javax/management/MBeanInfo.java: New file.
+
+2006-06-15 Andrew John Hughes <[EMAIL PROTECTED]>
+
* javax/management/AttributeList.java,
* javax/management/JMRuntimeException.java,
* javax/management/RuntimeOperationsException.java:
Index: javax/management/AttributeList.java
===================================================================
RCS file: /cvsroot/classpath/classpath/javax/management/AttributeList.java,v
retrieving revision 1.1
retrieving revision 1.2
diff -u -b -r1.1 -r1.2
--- javax/management/AttributeList.java 15 Jun 2006 19:37:47 -0000 1.1
+++ javax/management/AttributeList.java 15 Jun 2006 21:18:54 -0000 1.2
@@ -53,6 +53,11 @@
{
/**
+ * Compatible with JDK 1.5
+ */
+ private static final long serialVersionUID = -4077085769279709076L;
+
+ /**
* Constructs an empty list with an initial capacity of ten.
*
* @see java.util.ArrayList#ArrayList()
Index: javax/management/RuntimeOperationsException.java
===================================================================
RCS file:
/cvsroot/classpath/classpath/javax/management/RuntimeOperationsException.java,v
retrieving revision 1.1
retrieving revision 1.2
diff -u -b -r1.1 -r1.2
--- javax/management/RuntimeOperationsException.java 15 Jun 2006 19:37:47
-0000 1.1
+++ javax/management/RuntimeOperationsException.java 15 Jun 2006 21:18:54
-0000 1.2
@@ -53,6 +53,11 @@
extends JMRuntimeException
{
+ /**
+ * Compatible with JDK 1.5
+ */
+ private static final long serialVersionUID = -8408923047489133588L;
+
/* Sun re-implemented causality -- don't know why, but
serialization demands we do too... */
@@ -61,7 +66,7 @@
*
* @serial the target exception.
*/
- private RuntimeException exception;
+ private RuntimeException runtimeException;
/**
* Constructs a new <code>RuntimeOperationsException</code>
@@ -72,7 +77,7 @@
public RuntimeOperationsException(RuntimeException e)
{
super();
- exception = e;
+ runtimeException = e;
}
/**
@@ -87,7 +92,7 @@
String message)
{
super(message);
- exception = e;
+ runtimeException = e;
}
/**
@@ -98,7 +103,7 @@
*/
public Throwable getCause()
{
- return exception;
+ return runtimeException;
}
/**
@@ -109,7 +114,7 @@
*/
public RuntimeException getTargetException()
{
- return exception;
+ return runtimeException;
}
}
Index: javax/management/DynamicMBean.java
===================================================================
RCS file: javax/management/DynamicMBean.java
diff -N javax/management/DynamicMBean.java
--- /dev/null 1 Jan 1970 00:00:00 -0000
+++ javax/management/DynamicMBean.java 15 Jun 2006 21:18:54 -0000 1.1
@@ -0,0 +1,162 @@
+/* DynamicMBean.java -- A management bean with a dynamic interface.
+ Copyright (C) 2006 Free Software Foundation, Inc.
+
+This file is part of GNU Classpath.
+
+GNU Classpath is free software; you can redistribute it and/or modify
+it under the terms of the GNU General Public License as published by
+the Free Software Foundation; either version 2, or (at your option)
+any later version.
+
+GNU Classpath is distributed in the hope that it will be useful, but
+WITHOUT ANY WARRANTY; without even the implied warranty of
+MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
+General Public License for more details.
+
+You should have received a copy of the GNU General Public License
+along with GNU Classpath; see the file COPYING. If not, write to the
+Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA
+02110-1301 USA.
+
+Linking this library statically or dynamically with other modules is
+making a combined work based on this library. Thus, the terms and
+conditions of the GNU General Public License cover the whole
+combination.
+
+As a special exception, the copyright holders of this library give you
+permission to link this library with independent modules to produce an
+executable, regardless of the license terms of these independent
+modules, and to copy and distribute the resulting executable under
+terms of your choice, provided that you also meet, for each linked
+independent module, the terms and conditions of the license of that
+module. An independent module is a module which is not derived from
+or based on this library. If you modify this library, you may extend
+this exception to your version of the library, but you are not
+obligated to do so. If you do not wish to do so, delete this
+exception statement from your version. */
+
+package javax.management;
+
+/**
+ * Represents a management bean that provides a
+ * dynamic interface. Users of a [EMAIL PROTECTED] DynamicMBean}
+ * may retrieve information about its attributes at
+ * runtime and use this information to dynamically
+ * obtain the corresponding values of these attributes.
+ *
+ * @author Andrew John Hughes ([EMAIL PROTECTED])
+ * @since 1.5
+ */
+public interface DynamicMBean
+{
+
+ /**
+ * Obtains the value of the specified attribute of the
+ * management bean. The management bean should perform
+ * a lookup for the named attribute, and return its value
+ * by calling the appropriate getter method, if possible.
+ *
+ * @param name the name of the attribute to retrieve.
+ * @return the value of the specified attribute.
+ * @throws AttributeNotFoundException if the name does not
+ * correspond to an attribute
+ * of the bean.
+ * @throws MBeanException if retrieving the attribute causes
+ * the bean to throw an exception (which
+ * becomes the cause of this exception).
+ * @throws ReflectionException if an exception occurred in trying
+ * to use the reflection interface
+ * to lookup the attribute. The
+ * thrown exception is the cause of
+ * this exception.
+ * @see #setAttribute(String)
+ */
+ Object getAttribute(String name)
+ throws AttributeNotFoundException, MBeanException,
+ ReflectionException;
+
+ /**
+ * Obtains the values of each of the specified attributes
+ * of the management bean. The returned list includes
+ * those attributes that were retrieved and their
+ * corresponding values.
+ *
+ * @param names the names of the attributes to retrieve.
+ * @return a list of the retrieved attributes.
+ * @see #setAttributes(AttributeList)
+ */
+ AttributeList getAttributes(String[] names);
+
+ /**
+ * Returns an information object which lists the attributes
+ * and actions associated with the management bean.
+ *
+ * @return a description of the management bean, including
+ * all exposed attributes and actions.
+ */
+ MBeanInfo getMBeanInfo();
+
+ /**
+ * Invokes the specified action on the management bean using
+ * the supplied parameters. The signature of the action is
+ * specified by a [EMAIL PROTECTED] String} array, which lists the classes
+ * corresponding to each parameter. The class loader used to
+ * load these classes is the same as that used for loading the
+ * management bean itself.
+ *
+ * @param name the name of the action to invoke.
+ * @param params the parameters used to call the action.
+ * @param signature the signature of the action.
+ * @return the return value of the action.
+ * @throws MBeanException if the action throws an exception. The
+ * thrown exception is the cause of this
+ * exception.
+ * @throws ReflectionException if an exception occurred in trying
+ * to use the reflection interface
+ * to invoke the action. The
+ * thrown exception is the cause of
+ * this exception.
+ */
+ Object invoke(String name, Object[] params, String[] signature)
+ throws MBeanException, ReflectionException;
+
+ /**
+ * Sets the value of the specified attribute of the
+ * management bean. The management bean should perform
+ * a lookup for the named attribute, and sets its value
+ * using the associated setter method, if possible.
+ *
+ * @param attribute the attribute to set.
+ * @throws AttributeNotFoundException if the attribute does not
+ * correspond to an attribute
+ * of the bean.
+ * @throws InvalidAttributeValueException if the value is invalid
+ * for this particular
+ * attribute of the bean.
+ * @throws MBeanException if setting the attribute causes
+ * the bean to throw an exception (which
+ * becomes the cause of this exception).
+ * @throws ReflectionException if an exception occurred in trying
+ * to use the reflection interface
+ * to lookup the attribute. The
+ * thrown exception is the cause of
+ * this exception.
+ * @see #getAttribute(String)
+ */
+ Object setAttribute(Attribute attribute)
+ throws AttributeNotFoundException, InvalidAttributeValueException,
+ MBeanException, ReflectionException;
+
+ /**
+ * Sets the value of each of the specified attributes
+ * to that supplied by the [EMAIL PROTECTED] Attribute} object.
+ * The returned list contains the attributes that were
+ * set and their new values.
+ *
+ * @param attributes the attributes to set.
+ * @return a list of the changed attributes.
+ * @see #getAttributes(AttributeList)
+ */
+ AttributeList setAttributes(AttributeList attributes);
+
+}
Index: javax/management/MBeanInfo.java
===================================================================
RCS file: javax/management/MBeanInfo.java
diff -N javax/management/MBeanInfo.java
--- /dev/null 1 Jan 1970 00:00:00 -0000
+++ javax/management/MBeanInfo.java 15 Jun 2006 21:18:54 -0000 1.1
@@ -0,0 +1,152 @@
+/* MBeanInfo.java -- Information about a management bean.
+ Copyright (C) 2006 Free Software Foundation, Inc.
+
+This file is part of GNU Classpath.
+
+GNU Classpath is free software; you can redistribute it and/or modify
+it under the terms of the GNU General Public License as published by
+the Free Software Foundation; either version 2, or (at your option)
+any later version.
+
+GNU Classpath is distributed in the hope that it will be useful, but
+WITHOUT ANY WARRANTY; without even the implied warranty of
+MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
+General Public License for more details.
+
+You should have received a copy of the GNU General Public License
+along with GNU Classpath; see the file COPYING. If not, write to the
+Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA
+02110-1301 USA.
+
+Linking this library statically or dynamically with other modules is
+making a combined work based on this library. Thus, the terms and
+conditions of the GNU General Public License cover the whole
+combination.
+
+As a special exception, the copyright holders of this library give you
+permission to link this library with independent modules to produce an
+executable, regardless of the license terms of these independent
+modules, and to copy and distribute the resulting executable under
+terms of your choice, provided that you also meet, for each linked
+independent module, the terms and conditions of the license of that
+module. An independent module is a module which is not derived from
+or based on this library. If you modify this library, you may extend
+this exception to your version of the library, but you are not
+obligated to do so. If you do not wish to do so, delete this
+exception statement from your version. */
+
+package javax.management;
+
+import java.io.Serializable;
+
+/**
+ * <p>
+ * Describes the interface of a management bean. This allows
+ * the user to access the bean dynamically, without knowing
+ * the details of any of its attributes, operations,
+ * constructors or notifications beforehand. The information
+ * is immutable as standard. Of course, subclasses may change
+ * this, but this behaviour is not recommended.
+ * </p>
+ * <p>
+ * The contents of this class, for standard management beans,
+ * are dynamically compiled using reflection.
+ * [EMAIL PROTECTED] #getClassName()} and [EMAIL PROTECTED] #getConstructors()}
+ * return the name of the class and its constructors, respectively.
+ * This is much the same as could be obtained by reflection on the
+ * bean. [EMAIL PROTECTED] #getAttributes()} and [EMAIL PROTECTED]
#getOperations()},
+ * however, do something more in splitting the methods of the
+ * class into two sets. Those of the form, <code>getXXX</code>,
+ * <code>setXXX</code> and <code>isXXX</code> are taken to be
+ * the accessors and mutators of a series of attributes, with
+ * <code>XXX</code> being the attribute name. These are returned
+ * by [EMAIL PROTECTED] getAttributes()} and the [EMAIL PROTECTED] Attribute}
class can
+ * be used to manipulate them. The remaining methods are classified
+ * as operations and returned by [EMAIL PROTECTED] getOperations()}.
+ * </p>
+ * <p>
+ * Beans can also broadcast notifications. If the bean provides this
+ * facility, by implementing the [EMAIL PROTECTED] NotificationBroadcaster}
+ * interface, then an array of [EMAIL PROTECTED] MBeanNotificationInfo} objects
+ * may be obtained from [EMAIL PROTECTED] #getNotifications()}, which describe
+ * the notifications emitted.
+ * </p>
+ * <p>
+ * Model management beans and open management beans also supply an
+ * instance of this class, as part of implementing the
+ * [EMAIL PROTECTED] DynamicMBean#getMBeanInfo()} method of [EMAIL PROTECTED]
DynamicMBean}.
+ * </p>
+ *
+ * @author Andrew John Hughes ([EMAIL PROTECTED])
+ * @since 1.5
+ */
+public class MBeanInfo
+ implements Cloneable, Serializable
+{
+
+ /**
+ * Compatible with JDK 1.5
+ */
+ private static final long serialVersionUID = -6451021435135161911L;
+
+ /**
+ * A description of the bean.
+ *
+ * @serial The bean's description.
+ */
+ private String description;
+
+ /**
+ * The class name of the management bean.
+ *
+ * @serial The bean's class name.
+ */
+ private String className;
+
+ /**
+ * Returns a shallow clone of the information. This is
+ * simply a new copy of each string and a clone
+ * of each array, which still references the same objects,
+ * as obtained by the [EMAIL PROTECTED] Object} implementation of
+ * [EMAIL PROTECTED] Object#clone()}. As the fields can not be
+ * changed, this method is only really of interest to
+ * subclasses which may add new mutable fields or make
+ * the existing ones mutable.
+ *
+ * @return a shallow clone of this [EMAIL PROTECTED] MBeanInfo}.
+ */
+ public Object clone()
+ {
+ MBeanInfo clone = null;
+ try
+ {
+ clone = (MBeanInfo) super.clone();
+ }
+ catch (CloneNotSupportedException e)
+ {
+ /* This won't happen as we implement Cloneable */
+ }
+ return clone;
+ }
+
+ /**
+ * Returns the class name of the management bean.
+ *
+ * @return the bean's class name.
+ */
+ public String getClassName()
+ {
+ return className;
+ }
+
+ /**
+ * Returns a description of the management bean.
+ *
+ * @return the bean's description.
+ */
+ public String getDescription()
+ {
+ return description;
+ }
+
+}
