Класс 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(NotificationListener, NotificationFilter, 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 ведет себя так же, как прокси стандартного 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(NotificationListener, NotificationFilter, Object) для прокси приведет к вызову MBeanServerConnection.addNotificationListener(ObjectName, NotificationListener, NotificationFilter, Object); то же относится к другим методам NotificationBroadcaster и NotificationEmitter.

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