Класс JMX

Создать прокси для Standard 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).

Создать прокси для Standard 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, если он public, аннотирован @MXBean или @MXBean(true) или если у него нет аннотации @MXBean и его имя заканчивается на "MXBean".