Класс MBeanServerInvocationHandler

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.