Класс 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".