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接口)。
方法摘要
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.Runtime Exception 或 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();
}
}
打印结果
------事物开始------
增加纸质书本
------事物结束------
------事物开始------
增加电子书本
------事物结束------
源于: