java.lang.Object javax.management.openmbean.CompositeDataInvocationHandler
public class CompositeDataInvocationHandler
将获取方法转发给 CompositeData
的 InvocationHandler
。如果有只包含获取方法(如 String getName()
或 boolean isActive()
)的接口,则可以将此类与 Proxy
类一起使用,以产生一个接口实现,在该接口中,每个设置方法都返回 CompositeData
中对应项的值。
例如,假定您有如下所示接口:
以及使用以下方式构造的public interface NamedNumber { public int getNumber(); public String getName(); }
CompositeData
:
那么您可以构造一个实现CompositeData cd = newCompositeDataSupport
( someCompositeType, new String[] {"number", "name"}, new Object[] {5, "five"} );
NamedNumber
且受对象
cd
支持的对象,如下所示:
对InvocationHandler handler = new CompositeDataInvocationHandler(cd); NamedNumber nn = (NamedNumber) Proxy.newProxyInstance(NamedNumber.class.getClassLoader(), new Class[] {NamedNumber.class}, handler);
nn.getNumber()
的调用将返回
5。
如果设置方法定义的属性的第一个字母是大写字母,则此处理程序将首先在 CompositeData
中查找以大写字母开头的项,然后,如果找不到这样的项,则查找以相应的小写字母或代码点开头的项。对于名为 getNumber()
的获取方法,该处理程序将首先查找名为 Number
的项,然后查找名为 number
的项。如果设置方法名为 getnumber()
,则查找项必须名为 number
。
如果为 invoke
提供的方法是从 Object
继承的方法 boolean equals(Object)
,则当且仅当参数是一个其 InvocationHandler
也是 CompositeDataInvocationHandler
且其后备 CompositeData
等于(不必相同)此对象的 CompositeData
的 Proxy
时,它将返回 true。如果为 invoke
提供的方法是从 Object
继承的方法 int hashCode()
,那么它将返回一个与 equals
的定义一致的值:如果根据 equals
判断两个对象是相等的,则它们将具有相同的 hashCode
。
构造方法摘要 | |
---|---|
CompositeDataInvocationHandler(CompositeData compositeData) 构造一个受给定 CompositeData 支持的处理程序。 |
方法摘要 | |
---|---|
CompositeData |
getCompositeData() 返回提供给构造方法的 CompositeData 。 |
Object |
invoke(Object proxy, Method method, Object[] args) 在代理实例上处理方法调用并返回结果。 |
从类 java.lang.Object 继承的方法 |
---|
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
构造方法详细信息 |
---|
public CompositeDataInvocationHandler(CompositeData compositeData)
构造一个受给定 CompositeData
支持的处理程序。
compositeData
- 将为设置方法提供信息的
CompositeData
。
IllegalArgumentException
- 如果
compositeData
为 null。
方法详细信息 |
---|
public CompositeData getCompositeData()
CompositeData
。
CompositeData
。返回值永远不可以为 null。
public Object invoke(Object proxy, Method method, Object[] args) throws Throwable
InvocationHandler
复制的描述
InvocationHandler
中的
invoke
proxy
- 在其上调用方法的代理实例
method
- 对应于在代理实例上调用的接口方法的
Method
实例。
Method
对象的声明类将是在其中声明方法的接口,该接口可以是代理类赖以继承方法的代理接口的超接口。
args
- 包含传入代理实例上方法调用的参数值的对象数组,如果接口方法不使用参数,则为
null
。基本类型的参数被包装在适当基本包装器类(如
java.lang.Integer
或
java.lang.Boolean
)的实例中。
null
并且接口方法的返回类型是基本类型,则代理实例上的方法调用将抛出
NullPointerException
。否则,如果此方法返回的值与上述接口方法的声明返回类型不兼容,则代理实例上的方法调用将抛出
ClassCastException
。
Throwable
- 从代理实例上的方法调用抛出的异常。该异常的类型必须可以分配到在接口方法的
throws
子句中声明的任一异常类型或未经检查的异常类型
java.lang.RuntimeException
或
java.lang.Error
。如果此方法抛出经过检查的异常,该异常不可分配到在接口方法的
throws
子句中声明的任一异常类型,代理实例的方法调用将抛出包含此方法曾抛出的异常的
UndeclaredThrowableException
。
UndeclaredThrowableException