示例#1
0
  /**
   * Returns the platform {@link javax.management.MBeanServer MBeanServer}. On the first call to
   * this method, it first creates the platform <tt>MBeanServer</tt> by calling the {@link
   * javax.management.MBeanServerFactory#createMBeanServer MBeanServerFactory.createMBeanServer}
   * method and registers the platform MXBeans in this platform <tt>MBeanServer</tt> using the <a
   * href="#MXBeanNames">MXBean names</a> defined in the class description. This method, in
   * subsequent calls, will simply return the initially created platform <tt>MBeanServer</tt>.
   *
   * <p>MXBeans that get created and destroyed dynamically, for example, memory {@link
   * MemoryPoolMXBean pools} and {@link MemoryManagerMXBean managers}, will automatically be
   * registered and deregistered into the platform <tt>MBeanServer</tt>.
   *
   * <p>If the system property <tt>javax.management.builder.initial</tt> is set, the platform
   * <tt>MBeanServer</tt> creation will be done by the specified {@link
   * javax.management.MBeanServerBuilder}.
   *
   * <p>It is recommended that this platform MBeanServer also be used to register other application
   * managed beans besides the platform MXBeans. This will allow all MBeans to be published through
   * the same <tt>MBeanServer</tt> and hence allow for easier network publishing and discovery. Name
   * conflicts with the platform MXBeans should be avoided.
   *
   * @return the platform <tt>MBeanServer</tt>; the platform MXBeans are registered into the
   *     platform <tt>MBeanServer</tt> at the first time this method is called.
   * @exception SecurityException if there is a security manager and the caller does not have the
   *     permission required by {@link javax.management.MBeanServerFactory#createMBeanServer}.
   * @see javax.management.MBeanServerFactory
   * @see javax.management.MBeanServerFactory#createMBeanServer
   */
  public static synchronized MBeanServer getPlatformMBeanServer() {
    SecurityManager sm = System.getSecurityManager();
    if (sm != null) {
      Permission perm = new MBeanServerPermission("createMBeanServer");
      sm.checkPermission(perm);
    }

    if (platformMBeanServer == null) {
      platformMBeanServer = MBeanServerFactory.createMBeanServer();
      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;
  }
 /**
  * Returns the list of platform MXBeans implementing the given {@code mxbeanInterface} in the 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. The order is undefined and there is no guarantee that the list returned is in the
  * same order as previous invocations.
  *
  * @param mxbeanInterface a management interface for a platform MXBean
  * @return the list of platform MXBeans that implement {@code mxbeanInterface}.
  * @throws IllegalArgumentException if {@code mxbeanInterface} is not a platform management
  *     interface.
  * @since 1.7
  */
 public static <T extends PlatformManagedObject> List<T> getPlatformMXBeans(
     Class<T> mxbeanInterface) {
   PlatformComponent pc = PlatformComponent.getPlatformComponent(mxbeanInterface);
   if (pc == null)
     throw new IllegalArgumentException(
         mxbeanInterface.getName() + " is not a platform management interface");
   return Collections.unmodifiableList(pc.getMXBeans(mxbeanInterface));
 }
 /**
  * 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. The order is undefined and there is no
  * guarantee that the list returned is in the same order as previous invocations.
  *
  * @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 platform management
  *     interface.
  * @throws java.io.IOException if a communication problem occurred when accessing the {@code
  *     MBeanServerConnection}.
  * @see #newPlatformMXBeanProxy
  * @since 1.7
  */
 public static <T extends PlatformManagedObject> List<T> getPlatformMXBeans(
     MBeanServerConnection connection, Class<T> mxbeanInterface) throws java.io.IOException {
   PlatformComponent pc = PlatformComponent.getPlatformComponent(mxbeanInterface);
   if (pc == null) {
     throw new IllegalArgumentException(
         mxbeanInterface.getName() + " is not a platform management interface");
   }
   return Collections.unmodifiableList(pc.getMXBeans(connection, mxbeanInterface));
 }
示例#4
0
 /**
  * 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.");
 }