compact3

javax.management

Class MBeanServerInvocationHandler

java.lang.Object

javax.management.MBeanServerInvocationHandler

All Implemented Interfaces:

InvocationHandler

public class MBeanServerInvocationHandler
extends Object
implements InvocationHandler

InvocationHandler转发方法的MBean的管理界面通过MBean服务器MBean。

给定一个MBeanServerConnection，在MBean的ObjectName MBean服务器，以及描述使用模式，一个标准MBean或MXBean MBean管理界面的Intf java接口，这个类可以用来构造MBean代理。代理实现的接口Intf，其方法是通过MBean服务器转发的MBean。

如果是一个InvocationHandler MXBean，然后一个方法的参数的类型声明的MXBean接口为相应的映射类型转换，并返回值转换成映射的类型声明的类型。例如，与method
public List<String> reverse(List<String> list);
鉴于映射类型List<String>是String[]，电话proxy.reverse(someList)将someList从List<String>到String[]，叫MBean reverse操作，然后将返回到一个List<String> String[]。

方法对象。tostring()，对象。hashcode()，或对象。等于（对象），当调用代理使用这种调用处理程序，转发到MBean服务器作为代理的MBean方法看来只有一个代理的接口。一个代理JMX.newMBeanProxy或JMX.newMXBeanProxy创建，这意味着该方法必须出现在标准MBean或MXBean接口。否则，这些方法有以下行为：

• tostring()返回代理的字符串表示
• hashcode()返回哈希代码的代理，两个代理具有相同的哈希代码
• 等于（对象）当且仅当对象参数是相同的代理类，这个代理返回true，一个mbeanserverinvocationhandler具有相同的mbeanserverconnection和对象；如果其中的一个MBeanServerInvocationHandlers与类论点然后其他必须与equals回到真实的同一类构筑起。

从以下版本开始：

一点五

构造方法摘要

构造方法

Constructor and Description
MBeanServerInvocationHandler(MBeanServerConnection connection, ObjectName objectName) 调用处理程序，提出了通过MBean服务器标准MBean。
MBeanServerInvocationHandler(MBeanServerConnection connection, ObjectName objectName, boolean isMXBean) 调用处理程序，可以通过MBean服务器向标准MBean或MXBean。

方法摘要

Modifier and Type	Method and Description
MBeanServerConnection	getMBeanServerConnection() MBean服务器的连接通过一个代理使用这种处理方法转发。
ObjectName	getObjectName() 姓名的MBean在MBean服务器转发的方法。
Object	invoke(Object proxy, 方法 method, Object[] args) 在代理实例上处理方法调用，并返回结果。
boolean	isMXBean() 如果是真的，代理是一个MXBean，和适当的映射应用于方法参数和返回值。
static <T> T	newProxyInstance(MBeanServerConnection connection, ObjectName objectName, 类<T> interfaceClass, boolean notificationBroadcaster) 返回一个代理实现了转发的方法通过给定的MBean服务器的命名MBean接口。

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

MBeanServerInvocationHandler

public MBeanServerInvocationHandler(MBeanServerConnection connection,
                                    ObjectName objectName)

调用处理程序，提出了通过MBean服务器标准MBean。此构造函数可以被称为不依赖JMX.newMBeanProxy，例如如果你需要Proxy.newProxyInstance供应不同的ClassLoader。

此构造函数不适合一个MXBean。使用MBeanServerInvocationHandler(MBeanServerConnection, ObjectName, boolean)。此构造函数相当于new MBeanServerInvocationHandler(connection, objectName, false)。

参数

connection的MBean服务器的连接通过一个代理使用这种处理方法会转发。

objectName - MBean的名字在MBean服务器的方法将被转发。

MBeanServerInvocationHandler

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

调用处理程序，可以通过MBean服务器向标准MBean或MXBean。此构造函数可以被称为不依赖JMX.newMXBeanProxy，例如如果你需要Proxy.newProxyInstance供应不同的ClassLoader。

参数

connection的MBean服务器的连接通过一个代理使用这种处理方法会转发。

objectName - MBean的名字在MBean服务器的方法将被转发。

isMXBean -如果是真的，代理是一个 MXBean，和适当的映射将应用于方法参数和返回值。

从以下版本开始：

一点六

方法详细信息

getMBeanServerConnection

public MBeanServerConnection getMBeanServerConnection()

MBean服务器的连接通过一个代理使用这种处理方法转发。

结果

MBean服务器连接。

从以下版本开始：

一点六

getObjectName

public ObjectName getObjectName()

姓名的MBean在MBean服务器转发的方法。

结果

对象名称。

从以下版本开始：

一点六

isMXBean

public boolean isMXBean()

如果是真的，代理是一个MXBean，和适当的映射应用于方法参数和返回值。

结果

无论是代理是一个MXBean。

从以下版本开始：

一点六

newProxyInstance

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

返回一个代理实现了转发的方法通过给定的MBean服务器的命名MBean接口。为1.6，方法JMX.newMBeanProxy(MBeanServerConnection, ObjectName, Class)和JMX.newMBeanProxy(MBeanServerConnection, ObjectName, Class, boolean)是首选的方法。

这种方法相当于Proxy.newProxyInstance(interfaceClass.getClassLoader(), interfaces, handler)。这里handler是new MBeanServerInvocationHandler(connection, objectName)的结果，和interfaces是一个数组，一个元素，如果这是真是假，两notificationBroadcaster。interfaces的第一要素是interfaceClass和第二，如果存在，是NotificationEmitter.class。

参数类型

T -允许编译器知道如果 interfaceClass参数 MyMBean.class，例如，然后返回类型是 MyMBean。

参数

connection的MBean服务器转发到。

objectName - MBean的名字在 connection期待。

interfaceClass的管理界面，MBean的出口，这也将返回到代理的实现。

通过转发的方法通过 connection使 notificationBroadcaster -返回的代理实现 NotificationEmitter。一个叫 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,
                     Object[] args)
              throws Throwable

从接口复制的描述： InvocationHandler

在代理实例上处理方法调用，并返回结果。当在与它关联的代理实例上调用方法时，该方法将在调用处理程序上调用此方法。

Specified by:

invoke 接口 InvocationHandler

参数

proxy -代理实例，调用的方法

对接口方法的调用相应的 method代理实例的 方法实例。声明类的 方法对象将接口的方法声明，这可能是一个超接口代理接口，代理类继承的方法。

args -包含在方法上通过代理实例调用的实参的值对象的数组，或 null如果接口方法不需要参数。原始类型的实参是包裹在适当的原始包装类的实例，如 java.lang.Integer或 java.lang.Boolean。

结果

在代理实例上的方法调用返回的值。如果声明的返回类型的接口方法是比较原始的类型，则该方法返回的值必须是相应的原始包装类的一个实例；否则，它必须是一个类型分配给声明的返回类型。如果此方法返回的值是 null和接口方法的返回类型是原始的，然后 NullPointerException将由法对代理实例调用抛出。如果该方法返回的值是不兼容的接口的方法声明的返回类型如上所述，一个 ClassCastException将由法对代理实例调用抛出。

异常

Throwable -把从方法上代理实例调用的例外。异常的类型必须是可转让或任何的异常类型的接口方法的 throws条款或对未检查的异常类型 java.lang.RuntimeException或 java.lang.Error宣布。如果用这种方法，是不可转让的任何异常类型的接口方法的 throws条款声明抛出检查异常，然后 UndeclaredThrowableException包含异常，通过该方法抛出将由法对代理实例调用抛出。

另请参见：

UndeclaredThrowableException