Proxy源码分析

GetStudyMessages

墨衍会员 · AI 创作全网分发码龄17年

关注

转载最新推荐文章于 2026-04-16 11:54:12 发布 3.2k 阅读 AI 写同款· GEO 优化 ›

openstack 源码分析之swift proxy 服务启动 1 test 阅读详情

1.验证InvocationHandler是否空

2.生成代理类的Class对象，这里戏份比较多，代码中详细注释。

(1).通过类加载器去加载得到Class实例，比较是否想通的Class

(2).判断是否是接口

(3).去重Class，并通过String[]保存接口名

(4).从缓存中创建根据类加载器取得Map，如果没有则创建一个，保存到WeakHashMap

(5). put key,value<一堆接口，正在创建代理的标志> into Map

(6).记录包可见的代理接口，for循环中是校验非公有接口是否在同一包下

(7).生成类名，并生成代理类

(8).把代理类放入代理类缓存

(9).获得有一个InvocationHandler对象参数的构造函数,并创建实例.

Java还是外层的东东

Java代码

package com.alipay.home.proxy;
import java.lang.ref.Reference;
import java.lang.ref.WeakReference;
import java.lang.reflect.Constructor;
import java.lang.reflect.InvocationHandler;
import java.lang.reflect.InvocationTargetException;
import java.lang.reflect.Modifier;
import java.util.Arrays;
import java.util.Collections;
import java.util.HashMap;
import java.util.HashSet;
import java.util.Map;
import java.util.Set;
import java.util.WeakHashMap;
import sun.misc.ProxyGenerator;
/**
* <code>Proxy</code> provides static methods for creating dynamic proxy
* classes and instances, and it is also the superclass of all
* dynamic proxy classes created by those methods.
*
* To create a proxy for some interface <code>Foo</code>:
* <pre>
* InvocationHandler handler = new MyInvocationHandler(...);
* Class proxyClass = Proxy.getProxyClass(
* Foo.class.getClassLoader(), new Class[] { Foo.class });
* Foo f = (Foo) proxyClass.
* getConstructor(new Class[] { InvocationHandler.class }).
* newInstance(new Object[] { handler });
* </pre>
* or more simply:
* <pre>
* Foo f = (Foo) Proxy.newProxyInstance(Foo.class.getClassLoader(),
* new Class[] { Foo.class },
* handler);
* </pre>
*
* A dynamic proxy class (simply referred to as a proxy
* class below) is a class that implements a list of interfaces
* specified at runtime when the class is created, with behavior as
* described below.
*
* A proxy interface is such an interface that is implemented
* by a proxy class.
*
* A proxy instance is an instance of a proxy class.
*
* Each proxy instance has an associated invocation handler
* object, which implements the interface {@link InvocationHandler}.
* A method invocation on a proxy instance through one of its proxy
* interfaces will be dispatched to the {@link InvocationHandler#invoke
* invoke} method of the instance's invocation handler, passing the proxy
* instance, a <code>java.lang.reflect.Method</code> object identifying
* the method that was invoked, and an array of type <code>Object</code>
* containing the arguments. The invocation handler processes the
* encoded method invocation as appropriate and the result that it
* returns will be returned as the result of the method invocation on
* the proxy instance.
*
* A proxy class has the following properties:
*
* <ul>
* <li>Proxy classes are public, final, and not abstract.
*
* <li>The unqualified name of a proxy class is unspecified. The space
* of class names that begin with the string <code>"$Proxy"</code>
* should be, however, reserved for proxy classes.
*
* <li>A proxy class extends <code>java.lang.reflect.Proxy</code>.
*
* <li>A proxy class implements exactly the interfaces specified at its
* creation, in the same order.
*
* <li>If a proxy class implements a non-public interface, then it will
* be defined in the same package as that interface. Otherwise, the
* package of a proxy class is also unspecified. Note that package
* sealing will not prevent a proxy class from being successfully defined
* in a particular package at runtime, and neither will classes already
* defined by the same class loader and the same package with particular
* signers.
*
* <li>Since a proxy class implements all of the interfaces specified at
* its creation, invoking <code>getInterfaces</code> on its
* <code>Class</code> object will return an array containing the same
* list of interfaces (in the order specified at its creation), invoking
* <code>getMethods</code> on its <code>Class</code> object will return
* an array of <code>Method</code> objects that include all of the
* methods in those interfaces, and invoking <code>getMethod</code> will
* find methods in the proxy interfaces as would be expected.
*
* <li>The {@link Proxy#isProxyClass Proxy.isProxyClass} method will
* return true if it is passed a proxy class-- a class returned by
* <code>Proxy.getProxyClass</code> or the class of an object returned by
* <code>Proxy.newProxyInstance</code>-- and false otherwise.
*
* <li>The <code>java.security.ProtectionDomain</code> of a proxy class
* is the same as that of system classes loaded by the bootstrap class
* loader, such as <code>java.lang.Object</code>, because the code for a
* proxy class is generated by trusted system code. This protection
* domain will typically be granted
* <code>java.security.AllPermission</code>.
*
* <li>Each proxy class has one public constructor that takes one argument,
* an implementation of the interface {@link InvocationHandler}, to set
* the invocation handler for a proxy instance. Rather than having to use
* the reflection API to access the public constructor, a proxy instance
* can be also be created by calling the {@link Proxy#newProxyInstance
* Proxy.newInstance} method, which combines the actions of calling
* {@link Proxy#getProxyClass Proxy.getProxyClass} with invoking the
* constructor with an invocation handler.
* </ul>
*
* A proxy instance has the following properties:
*
* <ul>
* <li>Given a proxy instance <code>proxy</code> and one of the
* interfaces implemented by its proxy class <code>Foo</code>, the
* following expression will return true:
* <pre>
* <code>proxy instanceof Foo</code>
* </pre>
* and the following cast operation will succeed (rather than throwing
* a <code>ClassCastException</code>):
* <pre>
* <code>(Foo) proxy</code>
* </pre>
*
* <li>Each proxy instance has an associated invocation handler, the one
* that was passed to its constructor. The static
* {@link Proxy#getInvocationHandler Proxy.getInvocationHandler} method
* will return the invocation handler associated with the proxy instance
* passed as its argument.
*
* <li>An interface method invocation on a proxy instance will be
* encoded and dispatched to the invocation handler's {@link
* InvocationHandler#invoke invoke} method as described in the
* documentation for that method.
*
* <li>An invocation of the <code>hashCode</code>,
* <code>equals</code>, or <code>toString</code> methods declared in
* <code>java.lang.Object</code> on a proxy instance will be encoded and
* dispatched to the invocation handler's <code>invoke</code> method in
* the same manner as interface method invocations are encoded and
* dispatched, as described above. The declaring class of the
* <code>Method</code> object passed to <code>invoke</code> will be
* <code>java.lang.Object</code>. Other public methods of a proxy
* instance inherited from <code>java.lang.Object</code> are not
* overridden by a proxy class, so invocations of those methods behave
* like they do for instances of <code>java.lang.Object</code>.
* </ul>
*
* <h3>Methods Duplicated in Multiple Proxy Interfaces</h3>
*
* When two or more interfaces of a proxy class contain a method with
* the same name and parameter signature, the order of the proxy class's
* interfaces becomes significant. When such a duplicate method
* is invoked on a proxy instance, the <code>Method</code> object passed
* to the invocation handler will not necessarily be the one whose
* declaring class is assignable from the reference type of the interface
* that the proxy's method was invoked through. This limitation exists
* because the corresponding method implementation in the generated proxy
* class cannot determine which interface it was invoked through.
* Therefore, when a duplicate method is invoked on a proxy instance,
* the <code>Method</code> object for the method in the foremost interface
* that contains the method (either directly or inherited through a
* superinterface) in the proxy class's list of interfaces is passed to
* the invocation handler's <code>invoke</code> method, regardless of the
* reference type through which the method invocation occurred.
*
* If a proxy interface contains a method with the same name and
* parameter signature as the <code>hashCode</code>, <code>equals</code>,
* or <code>toString</code> methods of <code>java.lang.Object</code>,
* when such a method is invoked on a proxy instance, the
* <code>Method</code> object passed to the invocation handler will have
* <code>java.lang.Object</code> as its declaring class. In other words,
* the public, non-final methods of <code>java.lang.Object</code>
* logically precede all of the proxy interfaces for the determination of
* which <code>Method</code> object to pass to the invocation handler.
*
* Note also that when a duplicate method is dispatched to an
* invocation handler, the <code>invoke</code> method may only throw
* checked exception types that are assignable to one of the exception
* types in the <code>throws</code> clause of the method in all of
* the proxy interfaces that it can be invoked through. If the
* <code>invoke</code> method throws a checked exception that is not
* assignable to any of the exception types declared by the method in one
* of the proxy interfaces that it can be invoked through, then an
* unchecked <code>UndeclaredThrowableException</code> will be thrown by
* the invocation on the proxy instance. This restriction means that not
* all of the exception types returned by invoking
* <code>getExceptionTypes</code> on the <code>Method</code> object
* passed to the <code>invoke</code> method can necessarily be thrown
* successfully by the <code>invoke</code> method.
*
* @author Peter Jones
* @version 1.22, 05/11/17
* @see InvocationHandler
* @since 1.3
*/
public class Proxy implements java.io.Serializable {
private static final long serialVersionUID = -2222568056686623797L;
/** prefix for all proxy class names */
private final static String proxyClassNamePrefix = "$Proxy";
/** parameter types of a proxy class constructor */
private final static Class[] constructorParams =
{ InvocationHandler.class };
/** maps a class loader to the proxy class cache for that loader */
private static Map loaderToCache = new WeakHashMap();//弱HashMap
/** marks that a particular proxy class is currently being generated */
private static Object pendingGenerationMarker = new Object();//代理正在被创建的标志！！
/** next number to use for generation of unique proxy class names */
private static long nextUniqueNumber = 0;
private static Object nextUniqueNumberLock = new Object();
/** set of all generated proxy classes, for isProxyClass implementation */
private static Map proxyClasses =
Collections.synchronizedMap(new WeakHashMap());//线程安全的弱HahsMap
/**
* the invocation handler for this proxy instance.
* @serial
*/
protected InvocationHandler h;
/**
* Prohibits instantiation.
*/
private Proxy() {
}
/**
* Constructs a new <code>Proxy</code> instance from a subclass
* (typically, a dynamic proxy class) with the specified value
* for its invocation handler.
*
* @param h the invocation handler for this proxy instance
*/
protected Proxy(InvocationHandler h) {
this.h = h;
}
/**
* Returns the <code>java.lang.Class</code> object for a proxy class
* given a class loader and an array of interfaces. The proxy class
* will be defined by the specified class loader and will implement
* all of the supplied interfaces. If a proxy class for the same
* permutation of interfaces has already been defined by the class
* loader, then the existing proxy class will be returned; otherwise,
* a proxy class for those interfaces will be generated dynamically
* and defined by the class loader.
*
* There are several restrictions on the parameters that may be
* passed to <code>Proxy.getProxyClass</code>:
*
* <ul>
* <li>All of the <code>Class</code> objects in the
* <code>interfaces</code> array must represent interfaces, not
* classes or primitive types.
*
* <li>No two elements in the <code>interfaces</code> array may
* refer to identical <code>Class</code> objects.
*
* <li>All of the interface types must be visible by name through the
* specified class loader. In other words, for class loader
* <code>cl</code> and every interface <code>i</code>, the following
* expression must be true:
* <pre>
* Class.forName(i.getName(), false, cl) == i
* </pre>
*
* <li>All non-public interfaces must be in the same package;
* otherwise, it would not be possible for the proxy class to
* implement all of the interfaces, regardless of what package it is
* defined in.
*
* <li>For any set of member methods of the specified interfaces
* that have the same signature:
* <ul>
* <li>If the return type of any of the methods is a primitive
* type or void, then all of the methods must have that same
* return type.
* <li>Otherwise, one of the methods must have a return type that
* is assignable to all of the return types of the rest of the
* methods.
* </ul>
*
* <li>The resulting proxy class must not exceed any limits imposed
* on classes by the virtual machine. For example, the VM may limit
* the number of interfaces that a class may implement to 65535; in
* that case, the size of the <code>interfaces</code> array must not
* exceed 65535.
* </ul>
*
* If any of these restrictions are violated,
* <code>Proxy.getProxyClass</code> will throw an
* <code>IllegalArgumentException</code>. If the <code>interfaces</code>
* array argument or any of its elements are <code>null</code>, a
* <code>NullPointerException</code> will be thrown.
*
* Note that the order of the specified proxy interfaces is
* significant: two requests for a proxy class with the same combination
* of interfaces but in a different order will result in two distinct
* proxy classes.
*
* @param loader the class loader to define the proxy class
* @param interfaces the list of interfaces for the proxy class
* to implement
* @return a proxy class that is defined in the specified class loader
* and that implements the specified interfaces
* @throws IllegalArgumentException if any of the restrictions on the
* parameters that may be passed to <code>getProxyClass</code>
* are violated
* @throws NullPointerException if the <code>interfaces</code> array
* argument or any of its elements are <code>null</code>
*/
public static Class<?> getProxyClass(ClassLoader loader,
Class<?>... interfaces)
throws IllegalArgumentException
{//大于65535个接口抛异常
if (interfaces.length > 65535) {
throw new IllegalArgumentException("interface limit exceeded");
}
Class proxyClass = null;
/* collect interface names to use as key for proxy class cache */
String[] interfaceNames = new String[interfaces.length];//存放接口名
Set interfaceSet = new HashSet(); // for detecting duplicates//去重复接口的集合
for (int i = 0; i < interfaces.length; i++) {
/*
* Verify that the class loader resolves the name of this
* interface to the same Class object.
* 通过类加载器去加载，验证类实现是否实现接口
*/
String interfaceName = interfaces[i].getName();
Class interfaceClass = null;
try {
//参数false表示类加载器加载时候不解释improt
interfaceClass = Class.forName(interfaceName, false, loader);
} catch (ClassNotFoundException e) {
}
if (interfaceClass != interfaces[i]) {
throw new IllegalArgumentException(
interfaces[i] + " is not visible from class loader");
}
/*
* Verify that the Class object actually represents an
* interface.
* 验证是不是接口
*/
if (!interfaceClass.isInterface()) {
throw new IllegalArgumentException(
interfaceClass.getName() + " is not an interface");
}
/*
* Verify that this interface is not a duplicate.
* 去重复
*/
if (interfaceSet.contains(interfaceClass)) {
throw new IllegalArgumentException(
"repeated interface: " + interfaceClass.getName());
}
interfaceSet.add(interfaceClass);
//保存接口名
interfaceNames[i] = interfaceName;
}
/*
* Using string representations of the proxy interfaces as
* keys in the proxy class cache (instead of their Class
* objects) is sufficient because we require the proxy
* interfaces to be resolvable by name through the supplied
* class loader, and it has the advantage that using a string
* representation of a class makes for an implicit weak
* reference to the class.
* 用代理接口的字符串形式表示key存在缓存里尔不是Class对象足够了，因为我们需要
* 代理接口去通过类加载器用名字渲染。并且这样带来的好处是使用字符串形式表述class能不明显的依赖class
*/
Object key = Arrays.asList(interfaceNames);
/*
* Find or create the proxy class cache for the class loader.
* 从弱HahsMap中取得类加载器,如果不存在，放入弱HashMap
*/
Map cache;
synchronized (loaderToCache) {
cache = (Map) loaderToCache.get(loader);
if (cache == null) {
cache = new HashMap();
loaderToCache.put(loader, cache);
}
/*
* This mapping will remain valid for the duration of this
* method, without further synchronization, because the mapping
* will only be removed if the class loader becomes unreachable.
*/
}
/*
* Look up the list of interfaces in the proxy class cache using
* the key. This lookup will result in one of three possible
* kinds of values:
* null, if there is currently no proxy class for the list of
* interfaces in the class loader,
* the pendingGenerationMarker object, if a proxy class for the
* list of interfaces is currently being generated,
* or a weak reference to a Class object, if a proxy class for
* the list of interfaces has already been generated.
*/
synchronized (cache) {
/*
* Note that we need not worry about reaping the cache for
* entries with cleared weak references because if a proxy class
* has been garbage collected, its class loader will have been
* garbage collected as well, so the entire cache will be reaped
* from the loaderToCache map.
* 注意我们不用担心从缓存中得到已经被清楚的弱引用对应的Class实例(这里弱引用是key,实体是value)
* 因为一个代理class会被垃圾回收，
* 它的类加载器也会被垃圾回收，所以实体缓存会从loaderToCache map中获得
*
* 三种情况:
* 1如果当前缓存总没有此Proxy类则返回null
* 2如果Proxy类正在创建则返回pendingGenerationMarker对象
* 3如果此Proxy类已经被创建,则返回WeakReference对象
*
*/
do {
Object value = cache.get(key);
if (value instanceof Reference) {
proxyClass = (Class) ((Reference) value).get();
}
if (proxyClass != null) {
// proxy class already generated: return it
return proxyClass;
} else if (value == pendingGenerationMarker) {
// proxy class being generated: wait for it
try {
cache.wait();
} catch (InterruptedException e) {
/*
* The class generation that we are waiting for should
* take a small, bounded time, so we can safely ignore
* thread interrupts here.
*/
}
continue;
} else {
/*
* No proxy class for this list of interfaces has been
* generated or is being generated, so we will go and
* generate it now. Mark it as pending generation.
* 没有这堆接口的代理类生成或者正在被创建，我们创建it now!~标记为正在创建，跳出循环
*/
cache.put(key, pendingGenerationMarker);
break;
}
} while (true);
}
try {
String proxyPkg = null; // package to define proxy class in
/*
* 记录包可见的代理接口，for循环中是校验非公有接口是否在同一包下的算法
* Record the package of a non-public proxy interface so that the
* proxy class will be defined in the same package. Verify that
* all non-public proxy interfaces are in the same package.
*/
for (int i = 0; i < interfaces.length; i++) {
int flags = interfaces[i].getModifiers();
if (!Modifier.isPublic(flags)) {
String name = interfaces[i].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");
}
}
}
if (proxyPkg == null) { // if no non-public proxy interfaces,
proxyPkg = ""; // use the unnamed package
}
{
/*
* Choose a name for the proxy class to generate.
*/
long num;
synchronized (nextUniqueNumberLock) {
//这里使用静态属性作为锁,保护了同步区域内的数据
//因为num是long型的,无法对原始对象加锁(只能对类加锁)
//而如果对整个当前对象加锁会浪费性能
//使用一个锁对象,还可达到同时保护多个数据(对象,原始类型)的效果
num = nextUniqueNumber++;
}
String proxyName = proxyPkg + proxyClassNamePrefix + num;//$Proxy+num
/*
* Verify that the class loader hasn't already
* defined a class with the chosen name.
*/
/*
* Generate the specified proxy class.
* //生成Class类的字节码
*/
byte[] proxyClassFile = ProxyGenerator.generateProxyClass(
proxyName, interfaces);
try {
//加载代理类
proxyClass = 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());
}
}
// add to set of all generated proxy classes, for isProxyClass
proxyClasses.put(proxyClass, null);
} finally {
/*
* We must clean up the "pending generation" state of the proxy
* class cache entry somehow. If a proxy class was successfully
* generated, store it in the cache (with a weak reference);
* otherwise, remove the reserved entry. In all cases, notify
* all waiters on reserved entries in this cache.
*/
synchronized (cache) {
if (proxyClass != null) {
cache.put(key, new WeakReference(proxyClass));//key是一堆接口的集合,并除去标记正在生成代理的pending generation对象
} else {
cache.remove(key);
}
cache.notifyAll();
}
}
return proxyClass;
}
/**
* Returns an instance of a proxy class for the specified interfaces
* that dispatches method invocations to the specified invocation
* handler. This method is equivalent to:
* <pre>
* Proxy.getProxyClass(loader, interfaces).
* getConstructor(new Class[] { InvocationHandler.class }).
* newInstance(new Object[] { handler });
* </pre>
*
* <code>Proxy.newProxyInstance</code> throws
* <code>IllegalArgumentException</code> for the same reasons that
* <code>Proxy.getProxyClass</code> does.
*
* @param loader the class loader to define the proxy class
* @param interfaces the list of interfaces for the proxy class
* to implement
* @param h the invocation handler to dispatch method invocations to
* @return a proxy instance with the specified invocation handler of a
* proxy class that is defined by the specified class loader
* and that implements the specified interfaces
* @throws IllegalArgumentException if any of the restrictions on the
* parameters that may be passed to <code>getProxyClass</code>
* are violated
* @throws NullPointerException if the <code>interfaces</code> array
* argument or any of its elements are <code>null</code>, or
* if the invocation handler, <code>h</code>, is
* <code>null</code>
*/
//类加载器，接口的Class数组，类加载器，通常是APPClassLoader
public static Object newProxyInstance(ClassLoader loader,
Class<?>[] interfaces,
InvocationHandler h)
throws IllegalArgumentException
{
if (h == null) {
throw new NullPointerException();
}
/*
* Look up or generate the designated proxy class.
*/
//生成代理类的Class对象
Class cl = getProxyClass(loader, interfaces);
/*
* Invoke its constructor with the designated invocation handler.
*/
try {
//获得有一个InvocationHandler对象参数的构造函数
Constructor cons = cl.getConstructor(constructorParams);
//创建并返回实例
return (Object) cons.newInstance(new Object[] { h });
} catch (NoSuchMethodException e) {
throw new InternalError(e.toString());
} catch (IllegalAccessException e) {
throw new InternalError(e.toString());
} catch (InstantiationException e) {
throw new InternalError(e.toString());
} catch (InvocationTargetException e) {
throw new InternalError(e.toString());
}
}
/**
* Returns true if and only if the specified class was dynamically
* generated to be a proxy class using the <code>getProxyClass</code>
* method or the <code>newProxyInstance</code> method.
*
* The reliability of this method is important for the ability
* to use it to make security decisions, so its implementation should
* not just test if the class in question extends <code>Proxy</code>.
*
* @param cl the class to test
* @return <code>true</code> if the class is a proxy class and
* <code>false</code> otherwise
* @throws NullPointerException if <code>cl</code> is <code>null</code>
*/
public static boolean isProxyClass(Class<?> cl) {
if (cl == null) {
throw new NullPointerException();
}
return proxyClasses.containsKey(cl);
}
/**
* Returns the invocation handler for the specified proxy instance.
*
* @param proxy the proxy instance to return the invocation handler for
* @return the invocation handler for the proxy instance
* @throws IllegalArgumentException if the argument is not a
* proxy instance
*/
public static InvocationHandler getInvocationHandler(Object proxy)
throws IllegalArgumentException
{
/*
* Verify that the object is actually a proxy instance.
*/
if (!isProxyClass(proxy.getClass())) {
throw new IllegalArgumentException("not a proxy instance");
}
Proxy p = (Proxy) proxy;
return p.h;
}
private static native Class defineClass0(ClassLoader loader, String name,
byte[] b, int off, int len);
}