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