Пакет java.lang.management

Предоставляет интерфейсы управления для мониторинга и управления виртуальной машиной Java и другими компонентами в среде выполнения Java. Он позволяет осуществлять локальный и удаленный мониторинг и управление работающей виртуальной машиной Java.

MXBean платформы

MXBean платформы — это управляемый компонент, который соответствует спецификации инструментации JMX и использует только набор основных типов данных. Каждый MXBean платформы является PlatformManagedObject с уникальным именем.

ManagementFactory

Класс ManagementFactory — это фабричный класс для управления платформой Java. Этот класс предоставляет набор статических фабричных методов для получения MXBeans для платформы Java, что позволяет приложению напрямую получить доступ к MXBeans.

Доступ к серверу MBean платформы можно получить с помощью метода getPlatformMBeanServer. При первом вызове этого метода создается сервер MBean платформы и регистрируются все MXBeans платформы, включая MXBeans платформы. Каждый MXBean платформы регистрируется с уникальным именем, определенным в спецификации интерфейса управления. Это единственный сервер MBean, который может быть общим для разных управляемых компонентов, работающих в одной виртуальной машине Java.

Взаимодействие

Приложение управления и сервер MBean платформы работающей виртуальной машины могут взаимодействовать без необходимости использовать классы, используемые интерфейсами MXBean платформы. Типы данных, передаваемые между сервером JMX-соединителя и клиентом-соединителем, представляют собой JMX открытые типы, что позволяет обеспечить межверсионное взаимодействие. Тип данных, используемый интерфейсами MXBean, преобразуется в открытый тип при доступе через интерфейс MBeanServer. Подробности см. в спецификации MXBean.

Способы доступа к MXBean

Приложение может отслеживать инструментацию виртуальной машины Java и среды выполнения следующими способами:

1. Прямой доступ к интерфейсу MXBean

• Получение экземпляра MXBean локально в работающей виртуальной машине Java:

     RuntimeMXBean mxbean = ManagementFactory.getRuntimeMXBean();
  
     // Get the standard attribute "VmVendor"
     String vendor = mxbean.getVmVendor();
  

  Или вызывая метод getPlatformMXBean или getPlatformMXBeans:

     RuntimeMXBean mxbean = ManagementFactory.getPlatformMXBean(RuntimeMXBean.class);
  
     // Get the standard attribute "VmVendor"
     String vendor = mxbean.getVmVendor();
  

• Создание экземпляра прокси MXBean, который перенаправляет вызовы методов на заданный сервер MBean:

     MBeanServerConnection mbs;
  
     // Connect to a running JVM (or itself) and get MBeanServerConnection
     // that has the JVM MBeans registered in it
     ...
  
     // Get a MBean proxy for RuntimeMXBean interface
     RuntimeMXBean proxy =
         ManagementFactory.getPlatformMXBean(mbs,
                                             RuntimeMXBean.class);
     // Get standard attribute "VmVendor"
     String vendor = proxy.getVmVendor();
  

  Прокси обычно используется для доступа к MXBean в удаленной виртуальной машине Java. Альтернативный способ создания прокси MXBean:

     RuntimeMXBean proxy =
         ManagementFactory.newPlatformMXBeanProxy(mbs,
                                                  ManagementFactory.RUNTIME_MXBEAN_NAME,
                                                  RuntimeMXBean.class);
  

2. Непрямой доступ к интерфейсу MXBean через MBeanServer

• Обращение к platform MBeanServer для доступа к MXBeans локально или к конкретному MBeanServerConnection для доступа к MXBeans удаленно. Атрибуты и операции MXBean используют только открытые типы JMX, которые включают базовые типы данных, CompositeData, и TabularData, определенные в OpenType.

     MBeanServerConnection mbs;
  
     // Connect to a running JVM (or itself) and get MBeanServerConnection
     // that has the JVM MXBeans registered in it
     ...
  
     try {
         // Assuming the RuntimeMXBean has been registered in mbs
         ObjectName oname = new ObjectName(ManagementFactory.RUNTIME_MXBEAN_NAME);
  
         // Get standard attribute "VmVendor"
         String vendor = (String) mbs.getAttribute(oname, "VmVendor");
     } catch (....) {
         // Catch the exceptions thrown by ObjectName constructor
         // and MBeanServer.getAttribute method
         ...
     }
  

Расширение платформы

Реализация виртуальной машины Java может добавить свое расширение платформы к интерфейсу управления, определив зависящие от платформы интерфейсы, которые расширяют стандартные интерфейсы управления, чтобы включить платформенно-специфические метрики и операции управления. Статические фабричные методы в классе ManagementFactory вернут MXBeans с расширением платформы.

Рекомендуется использовать префикс, специфичный для поставщика, такой как имя поставщика, для именования платформенно-специфических атрибутов, чтобы избежать коллизий имен атрибутов между будущим расширением стандартного интерфейса управления и расширением платформы. Если будущее расширение стандартного интерфейса управления определяет новый атрибут для интерфейса управления, а имя атрибута совпадает с именем некоторого атрибута, специфичного для поставщика, приложениям, обращающимся к этому атрибуту, необходимо будет внести изменения, чтобы справиться с проблемами версии и совместимости.

Ниже приведен пример доступа к атрибуту из расширения платформы:

1) Прямой доступ к интерфейсу MXBean, специфичному для Oracle

   List<com.sun.management.GarbageCollectorMXBean> mxbeans =
       ManagementFactory.getPlatformMXBeans(com.sun.management.GarbageCollectorMXBean.class);

   for (com.sun.management.GarbageCollectorMXBean gc : mxbeans) {
       // Get the standard attribute "CollectionCount"
       String count = mxbean.getCollectionCount();

       // Get the platform-specific attribute "LastGcInfo"
       GcInfo gcinfo = gc.getLastGcInfo();
       ...
   }

2) Доступ к интерфейсу MXBean, специфичному для Oracle, через MBeanServer через прокси

   MBeanServerConnection mbs;

   // Connect to a running JVM (or itself) and get MBeanServerConnection
   // that has the JVM MXBeans registered in it
   ...

   List<com.sun.management.GarbageCollectorMXBean> mxbeans =
       ManagementFactory.getPlatformMXBeans(mbs, com.sun.management.GarbageCollectorMXBean.class);

   for (com.sun.management.GarbageCollectorMXBean gc : mxbeans) {
       // Get the standard attribute "CollectionCount"
       String count = mxbean.getCollectionCount();

       // Get the platform-specific attribute "LastGcInfo"
       GcInfo gcinfo = gc.getLastGcInfo();
       ...
   }

Если не указано иное, передача аргумента null в конструктор или метод любого класса или интерфейса в этом пакете приведет к тому, что будет выброшено исключение NullPointerException.

API java.lang.management потокобезопасен.