Класс MBeanServerInvocationHandler

public class MBeanServerInvocationHandler
extends Object
implements InvocationHandler

InvocationHandler, перенаправляющий методы интерфейса управления MBean через сервер управления MBean в сам MBean.

Используя подключение к MBeanServerConnection, ObjectName MBean внутри этого сервера управления MBean и Java-интерфейс Intf, описывающий интерфейс управления MBean, используя шаблоны для Standard MBean или MXBean, этот класс может быть использован для создания прокси-объекта для MBean. Прокси-объект реализует интерфейс Intf, так что все его методы перенаправляются через сервер управления MBean в сам MBean.

Если подключение InvocationHandler относится к MXBean, то параметры метода преобразуются из типа, объявленного в интерфейсе MXBean, в соответствующий отображенный тип, а возвращаемое значение преобразуется из отображенного типа в объявленный тип. Например, для метода
public List<String> reverse(List<String> list);
и если отображенный тип для List<String> — String[], вызов proxy.reverse(someList) преобразует someList из List<String> в String[], вызовет операцию MBean reverse, а затем преобразует возвращаемое значение String[] из List<String>.

Методы Object.toString(), Object.hashCode() или Object.equals(Object), вызванные на прокси-объекте с помощью этого обработчика вызовов, перенаправляются на сервер управления MBean как методы на проксируемом MBean, только если они присутствуют в одном из интерфейсов прокси. Для прокси, созданного с помощью JMX.newMBeanProxy или JMX.newMXBeanProxy, это означает, что метод должен быть в интерфейсе Standard MBean или MXBean. В противном случае эти методы ведут себя следующим образом:

• toString() возвращает строковое представление прокси
• hashCode() возвращает хэш-код для прокси таким образом, что два равных прокси имеют одинаковый хэш-код
• equals(Object) возвращает true только в том случае, если объект-аргумент относится к тому же классу прокси, что и этот прокси, с MBeanServerInvocationHandler, имеющим одинаковое MBeanServerConnection и ObjectName; если один из MBeanServerInvocationHandler был создан с Class аргументом, то другой должен быть создан с тем же Class для equals вернуть true.

Конструкторы

MBeanServerInvocationHandler

public MBeanServerInvocationHandler(MBeanServerConnection connection,
                                    ObjectName objectName)

Параметры:

connection - подключение к серверу MBean, через которое будут перенаправляться все методы прокси, использующего этот обработчик.

objectName - имя MBean на сервере MBean, к которому будут перенаправляться методы.

MBeanServerInvocationHandler

public MBeanServerInvocationHandler(MBeanServerConnection connection,
                                    ObjectName objectName,
                                    boolean isMXBean)

Параметры:

connection - подключение к серверу MBean, через которое будут перенаправляться все методы прокси, использующего этот обработчик.

objectName - имя MBean на сервере MBean, к которому будут перенаправляться методы.

isMXBean - если true, прокси предназначен для MXBean, и будут применены соответствующие отображения к параметрам методов и возвращаемым значениям.

С:

1.6

Методы

getMBeanServerConnection

public MBeanServerConnection getMBeanServerConnection()

Возвращает:

подключение к серверу MBean.

С:

1.6

getObjectName

public ObjectName getObjectName()

Возвращает:

имя объекта.

С:

1.6

isMXBean

public boolean isMXBean()

Возвращает:

является ли прокси для MXBean.

С:

1.6

newProxyInstance

public static <T> T newProxyInstance(MBeanServerConnection connection,
                                     ObjectName objectName,
                                     Class<T> interfaceClass,
                                     boolean notificationBroadcaster)

Параметры типа:

T - позволяет компилятору знать, что если параметр interfaceClass равен MyMBean.class, например, то возвращаемый тип равен MyMBean.

Параметры:

connection - сервер MBean для перенаправления.

objectName - имя MBean в connection для перенаправления.

interfaceClass - интерфейс управления, который экспортирует MBean, который также будет реализован возвращаемым прокси.

notificationBroadcaster - заставить возвращаемый прокси реализовать NotificationEmitter, перенаправляя его методы через connection. Вызов NotificationBroadcaster.addNotificationListener(javax.management.NotificationListener, javax.management.NotificationFilter, java.lang.Object) на прокси приведет к вызову MBeanServerConnection.addNotificationListener(ObjectName, NotificationListener, NotificationFilter, Object), и аналогично для других методов NotificationBroadcaster и NotificationEmitter.

Возвращает:

новый экземпляр прокси.

См. также:

JMX.newMBeanProxy(MBeanServerConnection, ObjectName, Class, boolean)

invoke

public Object invoke(Object proxy,
                     Method method,
                     Object[] args)
              throws Throwable

Описание скопировано из интерфейса: InvocationHandler

Обрабатывает вызов метода на экземпляре прокси и возвращает результат. Этот метод будет вызван на обработчике вызовов, когда метод вызывается на экземпляре прокси, с которым он связан.

Определено в:

invoke в интерфейсе InvocationHandler

Параметры:

proxy - экземпляр прокси, на котором был вызван метод

method - экземпляр Method , соответствующий интерфейсному методу, вызванному на экземпляре прокси. Класс объявления объекта Method будет интерфейсом, в котором был объявлен метод, который может быть суперинтерфейсом интерфейса прокси, который класс прокси наследует метод через.

args - массив объектов, содержащий значения аргументов, переданных в вызов метода на экземпляре прокси, или null , если интерфейсный метод не принимает аргументов. Аргументы примитивных типов оборачиваются в экземпляры соответствующего класса оболочки примитивного типа, например, java.lang.Integer или java.lang.Boolean.

Возвращает:

значение, которое должно быть возвращено из вызова метода на экземпляре прокси. Если объявленный возвращаемый тип интерфейсного метода является примитивным типом, то возвращаемое этим методом значение должно быть экземпляром соответствующего класса оболочки примитивного типа; в противном случае оно должно быть типом, присваиваемым объявленному возвращаемому типу. Если значение, возвращаемое этим методом, равно null и возвращаемый тип интерфейсного метода является примитивным, то метод вызова на экземпляре прокси выбросит NullPointerException. Если возвращаемое этим методом значение по другим причинам несовместимо с объявленным возвращаемым типом интерфейсного метода, как описано выше, вызов метода на экземпляре прокси выбросит ClassCastException.

Бросает:

Throwable - исключение, которое следует бросить при вызове метода на экземпляре прокси. Тип исключения должен быть присваиваем любому из типов исключений, объявленных в throws разделе интерфейсного метода, или к необрабатываемым типам исключений java.lang.RuntimeException или java.lang.Error. Если этот метод выбросит checked исключение, которое не присваивается ни одному из типов исключений, объявленных в throws разделе интерфейсного метода, то будет брошен UndeclaredThrowableException, содержащий исключение, которое было выброшено этим методом, при вызове метода на экземпляре прокси.

См. также:

UndeclaredThrowableException