public interface InvocationHandler
InvocationHandler
is the interface implemented by the invocation handler of a proxy instance.
InvocationHandler
是代理实例的调用处理程序 实现的接口。
Each proxy instance has an associated invocation handler. When a method is invoked on a proxy instance, the method invocation is encoded and dispatched to the invoke
method of its invocation handler.
每个代理实例都具有一个关联的调用处理程序invocation handler。对代理实例调用方法时,将对方法调用进行编码并将其指派到它的调用处理程序的 invoke
方法(调用处理程序要实现InvocationHandler接口)。
方法摘要
Object | invoke(Object proxy, Method method, Object[] args) 在代理实例上处理方法调用并返回结果, 当在与之关联的代理实例上调用方法时,将在调用处理程序中调用此方法。 |
参数:
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。
例子:
接口
package com.proxy;
public interface BookFacade {
public void addBook();
}
纸质书实现类
package com.proxy;
public class PaperBookFacadeImpl implements BookFacade {
@Override
public void addBook() {
System.out.println("增加纸质书本");
}
}
电子书实现类
package com.proxy;
public class EBookFacadeImpl implements BookFacade {
@Override
public void addBook() {
System.out.println("增加电子书本");
}
}
代理类
package com.proxy;
import java.lang.reflect.InvocationHandler;
import java.lang.reflect.Method;
import java.lang.reflect.Proxy;
public class BookFacadeProxy implements InvocationHandler {
private Object target;
/**
* 绑定委托对象并返回一个代理类
*
* @param target
* @return
*/
public Object bind(Object target) {
this.target = target;
// 取得代理对象
return Proxy.newProxyInstance(target.getClass().getClassLoader(), target.getClass().getInterfaces(), this);
}
@Override
/**
* 调用方法
*/
public Object invoke(Object proxy, Method method, Object[] args) throws Throwable {
Object result = null;
System.out.println("------事物开始------");
// 执行方法
result = method.invoke(target, args);
System.out.println("------事物结束------");
return result;
}
}
测试类
package com.proxy;
public class TestProxy {
public static void main(String[] args) {
// 纸质书本代理
BookFacadeProxy proxy = new BookFacadeProxy();
BookFacade bookProxy = (BookFacade) proxy.bind(new PaperBookFacadeImpl());
bookProxy.addBook();
// 电子书本代理
BookFacadeProxy e_proxy = new BookFacadeProxy();
BookFacade e_bookProxy = (BookFacade) e_proxy.bind(new EBookFacadeImpl());
e_bookProxy.addBook();
}
}
打印结果
------事物开始------
增加纸质书本
------事物结束------
------事物开始------
增加电子书本
------事物结束------