Класс 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 только в том случае, если аргумент Object является того же класса прокси, что и этот прокси, с MBeanServerInvocationHandler, имеющим тот же MBeanServerConnection и ObjectName; если один из MBeanServerInvocationHandler был создан с аргументом Class, то другой должен быть создан с тем же Class для equals возвратить true.