Класс JMX

Создание прокси для стандартного MBean в локальном или удалённом сервере MBean.

Если у вас есть сервер MBean mbs, содержащий MBean с ObjectName name, и если интерфейс управления MBean описывается Java-интерфейсом MyMBean, вы можете создать прокси для MBean следующим образом:

 MyMBean proxy = JMX.newMBeanProxy(mbs, name, MyMBean.class);
 

Предположим, например, MyMBean выглядит так:

 public interface MyMBean {
     public String getSomeAttribute();
     public void setSomeAttribute(String value);
     public void someOperation(String param1, int param2);
 }
 

Тогда вы можете выполнить:

• proxy.getSomeAttribute(), что приведёт к вызову mbs.getAttribute(name, "SomeAttribute").
• proxy.setSomeAttribute("whatever"), что приведёт к вызову mbs.setAttribute(name, new Attribute("SomeAttribute", "whatever")).
• proxy.someOperation("param1", 2), что будет переведено в вызов mbs.invoke(name, "someOperation", <etc>).

Объект, возвращаемый этим методом, является Proxy, чей InvocationHandler — MBeanServerInvocationHandler.

Этот метод эквивалентен newMBeanProxy(connection, objectName, interfaceClass, false).

Создание прокси для стандартного MBean в локальном или удалённом сервере MBean, который также может поддерживать методы NotificationEmitter.

Этот метод работает так же, как newMBeanProxy(MBeanServerConnection, ObjectName, Class), но дополнительно, если notificationEmitter — true, то MBean предполагается NotificationBroadcaster или NotificationEmitter, а возвращаемый прокси будет реализовывать NotificationEmitter наряду с interfaceClass. Вызов NotificationBroadcaster.addNotificationListener(javax.management.NotificationListener, javax.management.NotificationFilter, java.lang.Object) на прокси приведёт к вызову MBeanServerConnection.addNotificationListener(ObjectName, NotificationListener, NotificationFilter, Object), и аналогично для других методов NotificationBroadcaster и NotificationEmitter.

Если у вас есть сервер MBean mbs, содержащий MXBean с ObjectName name, и если интерфейс управления MXBean описывается Java-интерфейсом MyMXBean, вы можете создать прокси для MXBean следующим образом:

 MyMXBean proxy = JMX.newMXBeanProxy(mbs, name, MyMXBean.class);
 

Предположим, например, MyMXBean выглядит так:

 public interface MyMXBean {
     public String getSimpleAttribute();
     public void setSimpleAttribute(String value);
     public MemoryUsage getMappedAttribute();
     public void setMappedAttribute(MemoryUsage memoryUsage);
     public MemoryUsage someOperation(String param1, MemoryUsage param2);
 }
 

Тогда:

• proxy.getSimpleAttribute() приведёт к вызову mbs.getAttribute(name, "SimpleAttribute").

• proxy.setSimpleAttribute("whatever") приведёт к вызову mbs.setAttribute(name, new Attribute("SimpleAttribute", "whatever")).

  Поскольку String является простым типом в смысле SimpleType, он не изменяется в контексте MXBean. Прокси MXBean ведёт себя так же, как прокси Standard MBean (см. newMBeanProxy) для атрибута SimpleAttribute.

• proxy.getMappedAttribute() приведёт к вызову mbs.getAttribute("MappedAttribute"). Правила сопоставления MXBean означают, что фактический тип атрибута MappedAttribute будет CompositeData, и именно это значение вернёт вызов mbs.getAttribute. Затем прокси преобразует CompositeData обратно в ожидаемый тип MemoryUsage, используя правила сопоставления MXBean.

• Аналогично, proxy.setMappedAttribute(memoryUsage) преобразует аргумент MemoryUsage в CompositeData перед вызовом mbs.setAttribute.

• proxy.someOperation("whatever", memoryUsage) преобразует аргумент MemoryUsage в CompositeData и вызовет mbs.invoke. Возвращаемое значение mbs.invoke также будет CompositeData, и прокси преобразует его в ожидаемый тип MemoryUsage, используя правила сопоставления MXBean.

Объект, возвращаемый этим методом, является Proxy, чей InvocationHandler является MBeanServerInvocationHandler.

Этот метод эквивалентен newMXBeanProxy(connection, objectName, interfaceClass, false).

Создайте прокси для MXBean в локальном или удалённом сервере MBean, который также может поддерживать методы NotificationEmitter.

Этот метод работает так же, как newMXBeanProxy(MBeanServerConnection, ObjectName, Class), но дополнительно, если notificationEmitter равно true, то предполагается, что MXBean является NotificationBroadcaster или NotificationEmitter, и возвращаемый прокси будет реализовывать NotificationEmitter, а также interfaceClass. Вызов NotificationBroadcaster.addNotificationListener(javax.management.NotificationListener, javax.management.NotificationFilter, java.lang.Object) на прокси приведет к вызову MBeanServerConnection.addNotificationListener(ObjectName, NotificationListener, NotificationFilter, Object), и то же самое относится к другим методам NotificationBroadcaster и NotificationEmitter.

Проверить, является ли интерфейс интерфейсом MXBean. Интерфейс является интерфейсом MXBean, если он общедоступный, аннотирован @MXBean или @MXBean(true) или если у него нет аннотации @MXBean, и его имя заканчивается на "MXBean".