Java 动态代理是一种代理机制,它允许我们动态地、在不修改原代码的基础上,让代码完成它本来无法完成的工作。
静态代理是什么
哎哎?标题不是在讲动态代理吗?
要想知道动态代理,必须先知道静态代理。
静态代理模式可以在不修改被代理对象的基础上,通过扩展代理类,进行一些功能的附加与增强。值得注意的是,代理类和被代理类应该共同实现一个接口,或者是共同继承某个类。它的类型是事先预定好的,在编译时会被编译进 .class 文件中。
举个例子。
比如我电影院要放电影,放电影之前要放广告吧,但是电影本身是不能进行修改的,我们就可以用代理的方法,在电影的前、后都加入广告的播放功能。
首先我们设计一个接口,有了通用接口,才有了代理模式实现的基础。
package com.debugLife.proxyTest;
public interface Movie {
public void play();
}
接下来我们来一部电影(被代理类):
public com.debugLife.proxyTest;
public class AMovie implements Movie {
@Override
public void play() {
System.out.println("正在播放电影 -《指环王》");
}
}
它实现了 Movie 接口,当调用play()
方法时,电影就开始播放了。
接下来是电影院(代理类):
public com.debugLife.proxyTest;
public class Cinema implements Movie {
AMovie aMovie;
public Cinema(AMovie aMovie) {
super();
this.aMovie = aMovie;
}
@Override
public void play() {
playAds();
aMovie.play();
playAds();
}
private void playAds() {
System.out.println("得了痔疮怎么办?大铁棍子医院找捅主任!");
}
}
此时的 Cinema 已经是代理对象了,它有一个play()
方法,里面有它自己的一些小九九。
而影院开始运营时,就是这样了:
package com.debugLife.proxyTest;
public class WandaCinema {
public static void main(String[] args) {
AMovie aMovie = new AMovie();
Movie movie = new Cinema(aMovie);
movie.play();
}
}
结果不必多想,肯定如下:
得了痔疮怎么办?大铁棍子医院找捅主任!
正在播放电影 -《指环王》
得了痔疮怎么办?大铁棍子医院找捅主任!
静态代理的缺点是什么呢?
它通常只能代理一个类,这对于日益增长的需求来看,100个类,就几乎要写100个代理方法,这显然是不合实际的。
那么,能否不写代理类,而直接得到代理 Class 对象,然后根据它创建代理实例(反射)呢?为了解决这种问题,出现了动态代理。
动态代理是什么
Java 的动态代理机制可谓是『狸猫换太子』的典范了。为了不暴露内部的接口,采取了为其他对象提供一个代理以控制对某个对象的访问。代理类主要负责为委托类(真实对象)预处理消息、过滤消息、传递消息给委托类,代理类不现实具体服务,而是利用委托类来完成服务,并将执行结果封装处理。
JDK 提供了java.lang.reflect.InvocationHandler
接口和java.lang.reflect.Proxy
类,这两个类相互配合,入口是 Proxy,所以我们先聊它。
Proxy有个静态方法:getProxyClass(ClassLoader, interfaces)
,只要你给它传入类加载器和一组接口,它就给你返回代理 Class 对象。
用通俗的话说,getProxyClass()
这个方法,会从你传入的接口 Class 中,『拷贝』类结构信息到一个新的 Class 对象中,但新的 Class 对象带有构造器,是可以创建对象的。打个比方,一个大内太监(接口Class),空有一身武艺(类信息),但是无法传给后人。现在江湖上有个妙手神医(Proxy类),发明了克隆大法(getProxyClass),不仅能克隆太监的一身武艺,还保留了小DD(构造器)。
所以,一旦我们明确接口,完全可以通过接口的Class对象,创建一个代理Class,通过代理Class即可创建代理对象。
大体思路如下:
其中静态代理的机制如下:
动态代理的机制如下:
所以,Proxy.getProxyClass()
这个方法的本质就是:用 Class 来制造 Class
但在实际开发中,一般都会使用Proxy.newProxyInstance()
直接返回代理实例,中间的过程全部隐藏。
还是来看刚才电影院的例子。使用动态代理的话,应该是下面这种方式:
Movie proxyMovie = (Movie)Proxy.newProxyInstance(
Movie.class.getClassLoader(),
new Class<?>[] { Movie.class } ,
new InvocationHandler() {
@Override
public Object invoke(Object proxy, Method method, Object[] args) throws Throwable {
System.out.println("得了痔疮怎么办?大铁棍子医院找捅主任!");
Movie movie = new AMovie();
method.invoke(movie, args);
System.out.println("得了痔疮怎么办?大铁棍子医院找捅主任!");
return null;
}
});
proxyMovie.play();
可以看出,我们已经不再需要静态代理类『Cinema』了,可以直接想怎么玩就怎么玩了,甚至我可以不调用method.invoke()
方法,让proxyMovie.play()
时,不再调用AMovie.play()
方法,直接全程广告!
Movie proxyMovie = (Movie)Proxy.newProxyInstance(
Movie.class.getClassLoader(),
new Class<?>[] { Movie.class } ,
new InvocationHandler() {
@Override
public Object invoke(Object proxy, Method method, Object[] args) throws Throwable {
System.out.println("得了痔疮怎么办?大铁棍子医院找捅主任!");
// Movie movie = new AMovie();
// method.invoke(movie, args);
System.out.println("得了痔疮怎么办?大铁棍子医院找捅主任!");
return null;
}
});
proxyMovie.play();
输入结果就如下:
得了痔疮怎么办?大铁棍子医院找捅主任!
得了痔疮怎么办?大铁棍子医院找捅主任!
真是干(sang)得(xin)漂(bing)亮(kuang)。有了动态代理机制,可以在原有接口和被代理类的基础上做出任何拓展,而不会影响到原有接口和被代理类。而且还省掉了一个代理类。
如果新添加了一部电影(被代理类)叫BMovie,那么我就得改invoke()
方法了,这种方法忒差劲,我们可以改进一下:
public static void main(String[] args) throws Exception {
Movie aMovie = (Movie)getProxy(new AMovie());
Movie bMovie = (Movie)getProxy(new BMovie());
aMovie.play();
bMovie.play();
}
private static Object getProxy(final Object target) throws Exception {
return Proxy.newProxyInstance(target.getClass().getClassLoader(),
target.getClass().getInterfaces(),
new InvocationHandler() {
@Override
public Object invoke(Object proxy, Method method, Object[] args) throws Throwable {
System.out.println("得了痔疮怎么办?大铁棍子医院找捅主任!");
method.invoke(target, args);
System.out.println("得了痔疮怎么办?大铁棍子医院找捅主任!");
return null;
}
});
}
就可以输出下面的结果:
得了痔疮怎么办?大铁棍子医院找捅主任!
正在播放电影 -《指环王》
得了痔疮怎么办?大铁棍子医院找捅主任!
得了痔疮怎么办?大铁棍子医院找捅主任!
正在播放电影 -《断背山》
得了痔疮怎么办?大铁棍子医院找捅主任!
为何要使用动态代理机制
- 设计模式中有一个设计原则是开闭原则,是说对修改关闭,对扩展开放。我们在工作中有时会接手很多前人的代码,里面代码逻辑让人摸不着头脑,这时就很难去下手修改代码,那么这时我们就可以通过代理对类进行增强。
- 实现无侵入式的代码扩展,也就是方法的增强。同时让你可以在不用修改源码的情况下,增强一些方法,甚至在方法的前后你可以做你任何想做的事情(甚至不去执行这个方法都可以)。
- 采用动态代理的机制可以实现面向切面编程。
动态代理的实现原理
上面的例子中,我们是通过Proxy.newInstance()
来创建的代理对象,我们来看看它是如何实现的:
// java.lang.reflect.Proxy.java
public static Object newProxyInstance(ClassLoader loader, Class<?>[] interfaces, InvocationHandler h)
throws IllegalArgumentException {
Objects.requireNonNull(h);
final Class<?>[] intfs = interfaces.clone();
// Android 中会移除下面几行代码:SecurityManager 相关
final SecurityManager sm = System.getSecurityManager();
if (sm != null) {
checkProxyAccess(Reflection.getCallerClass(), loader, intfs);
}
// 查找或者生成指定的代理类
Class<?> cl = getProxyClass0(loader, intfs);
// 使用指定的调用者调用它的构造函数
try {
if (sm != null) {
checkNewProxyPermission(Reflection.getCallerClass(), cl);
}
final Constructor<?> cons = cl.getConstructor(constructorParams);
final InvocationHandler ih = h;
if (!Modifier.isPublic(cl.getModifiers())) {
AccessController.doPrivileged(new PrivilegedAction<Void>() {
public Void run() {
cons.setAccessible(true);
return null;
}
});
}
return cons.newInstance(new Object[]{h});
} catch (IllegalAccessException|InstantiationException e) {
throw new InternalError(e.toString(), e);
} catch (InvocationTargetException e) {
Throwable t = e.getCause();
if (t instanceof RuntimeException) {
throw (RuntimeException) t;
} else {
throw new InternalError(t.toString(), t);
}
} catch (NoSuchMethodException e) {
throw new InternalError(e.toString(), e);
}
}
上方代码中,getProxyClass0()
方法如下:
// java.lang.reflect.Proxy.java
// 生成代理类。在调用这里之前,必须要先调用 checkProxyAccess() 方法
private static Class<?> getProxyClass0(ClassLoader loader,
Class<?>... interfaces) {
if (interfaces.length > 65535) {
throw new IllegalArgumentException("interface limit exceeded");
}
// 如果指定接口的代理类已经存在于缓存 proxyClassCache 中,直接从缓存中取了返回即可;
// 如果缓存中没有指定代理对象,则通过 ProxyClassFactory 来创建一个代理类。
return proxyClassCache.get(loader, interfaces);
}
继续看 ProxyClassFactory 是怎样创建代理类的:
// java.lang.reflect.Proxy.java
/**
* 一个工厂方法,给定 ClassLoader 和 interface 的列表之后,可以创建、定义并返回代理类
*/
private static final class ProxyClassFactory
implements BiFunction<ClassLoader, Class<?>[], Class<?>>
{
// 所有的代理类名前缀给它搞成 "$Proxy"
private static final String proxyClassNamePrefix = "$Proxy";
// 每个代理类名生成时再来个数字编号
private static final AtomicLong nextUniqueNumber = new AtomicLong();
@Override
public Class<?> apply(ClassLoader loader, Class<?>[] interfaces) {
Map<Class<?>, Boolean> interfaceSet = new IdentityHashMap<>(interfaces.length);
for (Class<?> intf : interfaces) {
Class<?> interfaceClass = null;
try {
// 用Class.forName 查找一下给定的接口是否存在
interfaceClass = Class.forName(intf.getName(), false, loader);
} catch (ClassNotFoundException e) {
}
// 然后对比 apply 中传入的 class 是否与 ClassLoader 中找到的 class 是否相同
if (interfaceClass != intf) {
throw new IllegalArgumentException(
intf + " is not visible from class loader");
}
// 验证这个 class 是不是接口
if (!interfaceClass.isInterface()) {
throw new IllegalArgumentException(
interfaceClass.getName() + " is not an interface");
}
// 验证这个 class 的唯一性
if (interfaceSet.put(interfaceClass, Boolean.TRUE) != null) {
throw new IllegalArgumentException(
"repeated interface: " + interfaceClass.getName());
}
}
String proxyPkg = null; // 要生成的代理类的包名
int accessFlags = Modifier.PUBLIC | Modifier.FINAL;
// 记录下一个非 public 的 class 的包名,代理类也将会被定义在这个包里。
// 同时验证所有的非 public 的 class 都在这个包里。
for (Class<?> intf : interfaces) {
int flags = intf.getModifiers();
if (!Modifier.isPublic(flags)) {
accessFlags = Modifier.FINAL;
String name = intf.getName();
int n = name.lastIndexOf('.');
String pkg = ((n == -1) ? "" : name.substring(0, n + 1));
if (proxyPkg == null) {
proxyPkg = pkg;
} else if (!pkg.equals(proxyPkg)) {
throw new IllegalArgumentException(
"non-public interfaces from different packages");
}
}
}
// 如果没有非 public 的 class,就使用 com.sun.proxy 包
if (proxyPkg == null) {
proxyPkg = ReflectUtil.PROXY_PACKAGE + ".";
}
// 搞个名字给这个代理类
long num = nextUniqueNumber.getAndIncrement();
String proxyName = proxyPkg + proxyClassNamePrefix + num;
// 生成这个代理类的字节码
byte[] proxyClassFile = ProxyGenerator.generateProxyClass(
proxyName, interfaces, accessFlags);
try {
// 调用 native 方法
// private static native Class<?> defineClass0(ClassLoader loader, String name,
// byte[] b, int off, int len);
return defineClass0(loader, proxyName,
proxyClassFile, 0, proxyClassFile.length);
} catch (ClassFormatError e) {
/*
* A ClassFormatError here means that (barring bugs in the
* proxy class generation code) there was some other
* invalid aspect of the arguments supplied to the proxy
* class creation (such as virtual machine limitations
* exceeded).
*/
throw new IllegalArgumentException(e.toString());
}
}
}
看来主要生成 class 的过程在ProxyGenerator.generateProxyClass()
中,继续跟踪:
// sun.misc.ProxyGenerator.java
// 此处是 Java 的一个系统变量,是否要保存生成的文件
private static final boolean saveGeneratedFiles = (Boolean)AccessController.doPrivileged(new GetBooleanAction("sun.misc.ProxyGenerator.saveGeneratedFiles"));
public static byte[] generateProxyClass(final String var0, Class<?>[] var1, int var2) {
ProxyGenerator var3 = new ProxyGenerator(var0, var1, var2);
// 生成字节码文件
final byte[] var4 = var3.generateClassFile();
if (saveGeneratedFiles) {
AccessController.doPrivileged(new PrivilegedAction<Void>() {
public Void run() {
try {
int var1 = var0.lastIndexOf(46);
Path var2;
if (var1 > 0) {
Path var3 = Paths.get(var0.substring(0, var1).replace('.', File.separatorChar));
Files.createDirectories(var3);
var2 = var3.resolve(var0.substring(var1 + 1, var0.length()) + ".class");
} else {
var2 = Paths.get(var0 + ".class");
}
Files.write(var2, var4, new OpenOption[0]);
return null;
} catch (IOException var4x) {
throw new InternalError("I/O exception saving generated file: " + var4x);
}
}
});
}
return var4;
}
// 生成 class 文件
private byte[] generateClassFile() {
// 将 Object 中的一些方法添加到代理类中
this.addProxyMethod(hashCodeMethod, Object.class);
this.addProxyMethod(equalsMethod, Object.class);
this.addProxyMethod(toStringMethod, Object.class);
Class[] var1 = this.interfaces;
int var2 = var1.length;
int var3;
Class var4;
for(var3 = 0; var3 < var2; ++var3) {
var4 = var1[var3];
Method[] var5 = var4.getMethods();
int var6 = var5.length;
// 将 interface 中的方法添加到代理类中
for(int var7 = 0; var7 < var6; ++var7) {
Method var8 = var5[var7];
this.addProxyMethod(var8, var4);
}
}
Iterator var11 = this.proxyMethods.values().iterator();
List var12;
while(var11.hasNext()) {
var12 = (List)var11.next();
checkReturnTypes(var12);
}
Iterator var15;
try {
// 添加构造函数
this.methods.add(this.generateConstructor());
var11 = this.proxyMethods.values().iterator();
while(var11.hasNext()) {
var12 = (List)var11.next();
var15 = var12.iterator();
while(var15.hasNext()) {
ProxyGenerator.ProxyMethod var16 = (ProxyGenerator.ProxyMethod)var15.next();
this.fields.add(new ProxyGenerator.FieldInfo(var16.methodFieldName, "Ljava/lang/reflect/Method;", 10));
this.methods.add(var16.generateMethod());
}
}
// 添加静态方法
this.methods.add(this.generateStaticInitializer());
} catch (IOException var10) {
throw new InternalError("unexpected I/O Exception", var10);
}
if (this.methods.size() > 65535) {
throw new IllegalArgumentException("method limit exceeded");
} else if (this.fields.size() > 65535) {
throw new IllegalArgumentException("field limit exceeded");
} else {
this.cp.getClass(dotToSlash(this.className));
this.cp.getClass("java/lang/reflect/Proxy");
var1 = this.interfaces;
var2 = var1.length;
for(var3 = 0; var3 < var2; ++var3) {
var4 = var1[var3];
this.cp.getClass(dotToSlash(var4.getName()));
}
this.cp.setReadOnly();
ByteArrayOutputStream var13 = new ByteArrayOutputStream();
DataOutputStream var14 = new DataOutputStream(var13);
try {
var14.writeInt(-889275714);
var14.writeShort(0);
var14.writeShort(49);
this.cp.write(var14);
var14.writeShort(this.accessFlags);
var14.writeShort(this.cp.getClass(dotToSlash(this.className)));
var14.writeShort(this.cp.getClass("java/lang/reflect/Proxy"));
var14.writeShort(this.interfaces.length);
Class[] var17 = this.interfaces;
int var18 = var17.length;
for(int var19 = 0; var19 < var18; ++var19) {
Class var22 = var17[var19];
var14.writeShort(this.cp.getClass(dotToSlash(var22.getName())));
}
var14.writeShort(this.fields.size());
var15 = this.fields.iterator();
while(var15.hasNext()) {
ProxyGenerator.FieldInfo var20 = (ProxyGenerator.FieldInfo)var15.next();
var20.write(var14);
}
var14.writeShort(this.methods.size());
var15 = this.methods.iterator();
while(var15.hasNext()) {
ProxyGenerator.MethodInfo var21 = (ProxyGenerator.MethodInfo)var15.next();
var21.write(var14);
}
var14.writeShort(0);
return var13.toByteArray();
} catch (IOException var9) {
throw new InternalError("unexpected I/O Exception", var9);
}
}
}
private void addProxyMethod(Method var1, Class<?> var2) {
String var3 = var1.getName();
Class[] var4 = var1.getParameterTypes();
Class var5 = var1.getReturnType();
Class[] var6 = var1.getExceptionTypes();
String var7 = var3 + getParameterDescriptors(var4);
Object var8 = (List)this.proxyMethods.get(var7);
if (var8 != null) {
Iterator var9 = ((List)var8).iterator();
while(var9.hasNext()) {
ProxyGenerator.ProxyMethod var10 = (ProxyGenerator.ProxyMethod)var9.next();
if (var5 == var10.returnType) {
ArrayList var11 = new ArrayList();
collectCompatibleTypes(var6, var10.exceptionTypes, var11);
collectCompatibleTypes(var10.exceptionTypes, var6, var11);
var10.exceptionTypes = new Class[var11.size()];
var10.exceptionTypes = (Class[])var11.toArray(var10.exceptionTypes);
return;
}
}
} else {
var8 = new ArrayList(3);
this.proxyMethods.put(var7, var8);
}
((List)var8).add(new ProxyGenerator.ProxyMethod(var3, var4, var5, var6, var2));
}
字节码生成之后,调用 native 方法defineClass0()
来解析字节码,生成了代理类。
native 层的具体实现看这个链接
用一个流程图来总结一下: