jdk-sandbox: comparison jdk/src/share/classes/java/lang/management/ManagementFactory.java

equal deleted inserted replaced

-:bcc2354430ff
+:ef01e0dccd63
 * CA 95054 USA or visit www.sun.com if you need additional information or
 * have any questions.
 */
 package java.lang.management;
+import javax.management.DynamicMBean;
 import javax.management.MBeanServer;
 import javax.management.MBeanServerConnection;
+import javax.management.MBeanServerFactory;
 import javax.management.MBeanServerPermission;
+import javax.management.NotificationEmitter;
+import javax.management.ObjectInstance;
 import javax.management.ObjectName;
+import javax.management.InstanceAlreadyExistsException;
 import javax.management.InstanceNotFoundException;
 import javax.management.MalformedObjectNameException;
+import javax.management.MBeanRegistrationException;
+import javax.management.NotCompliantMBeanException;
+import javax.management.StandardEmitterMBean;
+import javax.management.StandardMBean;
+import java.util.Collections;
+import java.util.ArrayList;
 import java.util.List;
 import java.security.AccessController;
 import java.security.Permission;
 import java.security.PrivilegedAction;
+import java.security.PrivilegedActionException;
+import java.security.PrivilegedExceptionAction;
 import javax.management.JMX;
+import sun.management.ManagementFactoryHelper;
 /**
 * The <tt>ManagementFactory</tt> class is a factory class for getting
 * managed beans for the Java platform.
 * This class consists of static methods each of which returns
 * <p>
 * An application can access a platform MXBean in the following ways:
 * <ul>
 * <li><i>Direct access to an MXBean interface</i>
 *     <ol type="a">
-*     <li>Get the MXBean instance through the static factory method
+*     <li>Get the MXBean instance through the static factory method,
+*         or the {@link #getPlatformMXBeans(Class)} method
 *         and access the MXBean locally of the running
 *         virtual machine.
 *         </li>
 *     <li>Construct an MXBean proxy instance that forwards the
 *         method calls to a given {@link MBeanServer MBeanServer} by calling
-*         {@link #newPlatformMXBeanProxy newPlatfromMXBeanProxy}.
+*         the {@link #newPlatformMXBeanProxy newPlatformMXBeanProxy} method
+*         or the {@link #getPlatformMXBeans(MBeanServerConnection, Class)}
+*         method.
 *         A proxy is typically constructed to remotely access
 *         an MXBean of another running virtual machine.
 *         </li>
 *     </ol></li>
 * <li><i>Indirect access to an MXBean interface via MBeanServer</i>
 * A platform MXBean is a <i>managed bean</i> that conforms to
 * the JMX Instrumentation Specification and only uses
 * a set of basic data types described below.
 * See <a href="../../../javax/management/MXBean.html#MXBean-spec">
 * the specification of MXBeans</a> for details.
+* All platform MXBean interfaces extend {@link PlatformManagedObject}s
+* and new methods may be added in these interfaces
+* in future Java SE releases.
+* <p>
 * A JMX management application and the platform <tt>MBeanServer</tt>
 * can interoperate without requiring classes for MXBean specific
 * data types.
 * The data types being transmitted between the JMX connector
 * server and the connector client are
 * </blockquote>
 *
 * <h4><a name="MXBeanNames">MXBean Names</a></h4>
 * Each platform MXBean for a Java virtual machine has a unique
 * {@link javax.management.ObjectName ObjectName} for
-* registration in the platform <tt>MBeanServer</tt>.
+* registration in the platform <tt>MBeanServer</tt> that can
+* be obtained by calling the {@link PlatformManagedObject#getObjectName}
+* method.
+*
 * A Java virtual machine has a single instance of the following management
 * interfaces:
 *
 * <blockquote>
 * <table border>
 * </tr>
 * </table>
 * </blockquote>
 *
 * @see <a href="../../../javax/management/package-summary.html">
-*      JMX Specification.</a>
+*      JMX Specification</a>
 * @see <a href="package-summary.html#examples">
 *      Ways to Access Management Metrics</a>
 * @see java.util.logging.LoggingMXBean
 * @see javax.management.MXBean
 *
 *
 * @return a {@link ClassLoadingMXBean} object for
 * the Java virtual machine.
 */
 public static ClassLoadingMXBean getClassLoadingMXBean() {
-return sun.management.ManagementFactory.getClassLoadingMXBean();
+return ManagementFactoryHelper.getClassLoadingMXBean();
 }
 /**
 * Returns the managed bean for the memory system of
 * the Java virtual machine.
 *
 * @return a {@link MemoryMXBean} object for the Java virtual machine.
 */
 public static MemoryMXBean getMemoryMXBean() {
-return sun.management.ManagementFactory.getMemoryMXBean();
+return ManagementFactoryHelper.getMemoryMXBean();
 }
 /**
 * Returns the managed bean for the thread system of
 * the Java virtual machine.
 *
 * @return a {@link ThreadMXBean} object for the Java virtual machine.
 */
 public static ThreadMXBean getThreadMXBean() {
-return sun.management.ManagementFactory.getThreadMXBean();
+return ManagementFactoryHelper.getThreadMXBean();
 }
 /**
 * Returns the managed bean for the runtime system of
 * the Java virtual machine.
 *
 * @return a {@link RuntimeMXBean} object for the Java virtual machine.
 */
 public static RuntimeMXBean getRuntimeMXBean() {
-return sun.management.ManagementFactory.getRuntimeMXBean();
+return ManagementFactoryHelper.getRuntimeMXBean();
 }
 /**
 * Returns the managed bean for the compilation system of
 * the Java virtual machine.  This method returns <tt>null</tt>
 * @return a {@link CompilationMXBean} object for the Java virtual
 *   machine or <tt>null</tt> if the Java virtual machine has
 *   no compilation system.
 */
 public static CompilationMXBean getCompilationMXBean() {
-return sun.management.ManagementFactory.getCompilationMXBean();
+return ManagementFactoryHelper.getCompilationMXBean();
 }
 /**
 * Returns the managed bean for the operating system on which
 * the Java virtual machine is running.
 *
 * @return an {@link OperatingSystemMXBean} object for
 * the Java virtual machine.
 */
 public static OperatingSystemMXBean getOperatingSystemMXBean() {
-return sun.management.ManagementFactory.getOperatingSystemMXBean();
+return ManagementFactoryHelper.getOperatingSystemMXBean();
 }
 /**
 * Returns a list of {@link MemoryPoolMXBean} objects in the
 * Java virtual machine.
 *
 * @return a list of <tt>MemoryPoolMXBean</tt> objects.
 *
 */
 public static List<MemoryPoolMXBean> getMemoryPoolMXBeans() {
-return sun.management.ManagementFactory.getMemoryPoolMXBeans();
+return ManagementFactoryHelper.getMemoryPoolMXBeans();
 }
 /**
 * Returns a list of {@link MemoryManagerMXBean} objects
 * in the Java virtual machine.
 *
 * @return a list of <tt>MemoryManagerMXBean</tt> objects.
 *
 */
 public static List<MemoryManagerMXBean> getMemoryManagerMXBeans() {
-return sun.management.ManagementFactory.getMemoryManagerMXBeans();
+return ManagementFactoryHelper.getMemoryManagerMXBeans();
 }
 /**
 * Returns a list of {@link GarbageCollectorMXBean} objects
 *
 * @return a list of <tt>GarbageCollectorMXBean</tt> objects.
 *
 */
 public static List<GarbageCollectorMXBean> getGarbageCollectorMXBeans() {
-return sun.management.ManagementFactory.getGarbageCollectorMXBeans();
+return ManagementFactoryHelper.getGarbageCollectorMXBeans();
 }
 private static MBeanServer platformMBeanServer;
 /**
 * Returns the platform {@link javax.management.MBeanServer MBeanServer}.
 Permission perm = new MBeanServerPermission("createMBeanServer");
 sm.checkPermission(perm);
 }
 if (platformMBeanServer == null) {
-platformMBeanServer =
+platformMBeanServer = MBeanServerFactory.createMBeanServer();
-sun.management.ManagementFactory.createPlatformMBeanServer();
+for (PlatformComponent pc : PlatformComponent.values()) {
+List<? extends PlatformManagedObject> list =
+pc.getMXBeans(pc.getMXBeanInterface());
+for (PlatformManagedObject o : list) {
+// Each PlatformComponent represents one management
+// interface. Some MXBean may extend another one.
+// The MXBean instances for one platform component
+// (returned by pc.getMXBeans()) might be also
+// the MXBean instances for another platform component.
+// e.g. com.sun.management.GarbageCollectorMXBean
+//
+// So need to check if an MXBean instance is registered
+// before registering into the platform MBeanServer
+if (!platformMBeanServer.isRegistered(o.getObjectName())) {
+addMXBean(platformMBeanServer, o);
+}
+}
+}
 }
 return platformMBeanServer;
 }
 /**
 iae.initCause(e);
 throw iae;
 }
 }
+/**
+* Returns the list of platform MXBeans that implement
+* the given {@code mxbeanInterface} in the running Java
+* virtual machine.
+* The returned list may contain zero, one, or more instances.
+* The number of instances in the returned list is defined
+* in the specification of the given management interface.
+*
+* @param mxbeanInterface a management interface for a platform
+*                        MXBean
+*
+* @return the list of platform MXBeans that implements
+* {@code mxbeanInterface}.
+*
+* @throws IllegalArgumentException if {@code mxbeanInterface}
+* is not a management interface for the platform.
+*
+* @since 1.7
+*/
+public static <T extends PlatformManagedObject> List<T>
+getPlatformMXBeans(Class<T> mxbeanInterface) {
+String className = mxbeanInterface.getName();
+for (PlatformComponent component: PlatformComponent.values()) {
+// comparing the class name first instead of the Class instance
+// to avoid causing unnecessary class loading of
+// the other MXBean interfaces
+if (className.equals(component.getMXBeanInterfaceName())) {
+if (component.getMXBeanInterface() == mxbeanInterface) {
+return component.getMXBeans(mxbeanInterface);
+}
+}
+}
+throw new IllegalArgumentException(mxbeanInterface.getName() +
+" is not implemented by any of the platform MXBeans.");
+}
+/**
+* Returns the list of the platform MXBean proxies for
+* forwarding the method calls of the {@code mxbeanInterface}
+* through the given {@code MBeanServerConnection}.
+* The returned list may contain zero, one, or more instances.
+* The number of instances in the returned list is defined
+* in the specification of the given management interface.
+*
+* @param connection the {@code MBeanServerConnection} to forward to.
+* @param mxbeanInterface a management interface for a platform
+*                        MXBean
+*
+* @return the list of platform MXBean proxies for
+* forwarding the method calls of the {@code mxbeanInterface}
+* through the given {@code MBeanServerConnection}.
+*
+* @throws IllegalArgumentException if {@code mxbeanInterface}
+* is not a management interface for the platform.
+*
+* @throws java.io.IOException if a communication problem
+* occurred when accessing the {@code MBeanServerConnection}.
+*
+* @since 1.7
+*/
+public static <T extends PlatformManagedObject>
+List<T> getPlatformMXBeans(MBeanServerConnection connection,
+Class<T> mxbeanInterface)
+throws java.io.IOException
+{
+String className = mxbeanInterface.getName();
+for (PlatformComponent component: PlatformComponent.values()) {
+// comparing the class name first instead of the Class instance
+// to avoid causing unnecessary class loading of
+// the other MXBean interfaces
+if (className.equals(component.getMXBeanInterfaceName())) {
+if (component.getMXBeanInterface() == mxbeanInterface) {
+return component.getMXBeans(connection,
+mxbeanInterface);
+}
+}
+}
+throw new IllegalArgumentException(mxbeanInterface.getName() +
+" is not implemented by any of the platform MXBeans.");
+}
+/**
+* Returns a list of {@code Class} objects, subinterface of
+* {@link PlatformManagedObject}, representing
+* all management interfaces for
+* monitoring and managing the Java platform.
+*
+* @return a list of {@code Class} objects, subinterface of
+* {@link PlatformManagedObject} representing
+* the management interfaces for
+* monitoring and managing the Java platform.
+*
+* @since 1.7
+*/
+public static List<Class<? extends PlatformManagedObject>> getAllPlatformMXBeanInterfaces() {
+List<Class<? extends PlatformManagedObject>> result =
+new ArrayList<Class<? extends PlatformManagedObject>>();
+for (PlatformComponent component: PlatformComponent.values()) {
+result.add(component.getMXBeanInterface());
+}
+return result;
+}
 private static final String NOTIF_EMITTER =
 "javax.management.NotificationEmitter";
+/**
+* Registers an MXBean.
+*/
+private static void addMXBean(final MBeanServer mbs, final PlatformManagedObject pmo) {
+// Make DynamicMBean out of MXBean by wrapping it with a StandardMBean
+final DynamicMBean dmbean;
+if (pmo instanceof NotificationEmitter) {
+dmbean = new StandardEmitterMBean(pmo, null, true, (NotificationEmitter) pmo);
+} else {
+dmbean = new StandardMBean(pmo, null, true);
+}
+try {
+AccessController.doPrivileged(new PrivilegedExceptionAction<Void>() {
+public Void run() throws InstanceAlreadyExistsException,
+MBeanRegistrationException,
+NotCompliantMBeanException {
+mbs.registerMBean(dmbean, pmo.getObjectName());
+return null;
+}
+});
+} catch (PrivilegedActionException e) {
+throw new RuntimeException(e.getException());
+}
+}
 }

changeset 401	ef01e0dccd63
parent 2	90ce3da70b43
child 715	f16baef3a20e