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(); 
	} 
 
}  

打印结果

 ------事物开始------ 
增加纸质书本 
------事物结束------ 
------事物开始------ 
增加电子书本 
------事物结束------  

源于：