compact1, compact2, compact3

java.lang.reflect

Class Proxy

java.lang.Object

java.lang.reflect.Proxy

All Implemented Interfaces:

Serializable

public class Proxy
extends Object
implements Serializable

Proxy创建动态代理类的实例提供了静态方法，也是所有动态代理类的父类的方法创建。

创建一个接口Foo代理：

InvocationHandler处理器=新myinvocationhandler（…）；班<？> proxyclass =代理，动态代理类（foo。类。getclassloader()，foo类）；Foo f =（Foo）proxyclass。getconstructor（InvocationHandler。类）。newInstance（处理）；

或者更简单的：

Foo f =（Foo）代理。代理实例（foo。getclassloader()类，新班<？> [ ] { foo.class }，处理程序）；

空动态代理类（简称为空代理类）是一个类实现的接口列表，指定在运行时创建的类，用行为描述如下。空代理接口是一个接口，由一个代理类实现。空代理实例是代理类的一个实例。每个代理实例有一个相关的零调用处理程序对象，它实现了接口InvocationHandler。方法调用一个代理实例通过其代理接口将被派遣到该实例的调用处理程序的invoke方法，通过代理实例，一个java.lang.reflect.Method对象被调用的方法识别和Object型含参数数组。调用处理程序以适当的方式处理编码的方法调用，结果返回的结果将作为代理实例的方法调用的结果返回。

代理类具有以下属性：

• 代理类是公共的，最终的，而不是抽象的，如果所有的代理接口都是公共的。
• 代理类是非公开的、最终的，而不是抽象的，如果代理接口的任何一个都是非公开的。
• 代理类的不合格名称是未指定的。班级名称以字符串"$Proxy"开始空间是应该的，但是，保留代理类。
• 代理类扩展java.lang.reflect.Proxy。
• 代理类实现了在相同的命令中指定的创建的接口。
• 如果一个代理类实现一个非公开的接口，那么它将被定义在同一个包中，作为该接口。否则，代理类的包也未指定。注意包装密封不会阻止代理类在运行时被成功地在一个特定的包中定义的，并没有将已经定义的相同的类加载器和特别签名同一包中的类。
• 由于代理类实现了所有在其创作中指定的接口，调用getInterfaces其类对象将返回一个数组包含接口相同的列表（在创建时指定的顺序），调用getMethods其类对象将返回方法对象包括所有这些接口方法的数组，和getMethod会找到方法调用代理接口可以预期。
• 的Proxy.isProxyClass方法将返回true如果是通过一个代理类的Proxy.getProxyClass或一个对象的类返回的类返回Proxy.newProxyInstance --否则为假。
• 一个代理类的java.security.ProtectionDomain是为系统类引导类加载器加载相同，如java.lang.Object，因为代理类的代码是由受信任的系统代码生成。这个保护域通常会被授予java.security.AllPermission。
• 每个代理类有一个公共构造函数之一，InvocationHandler接口的实现，为一个代理实例的调用处理程序。而不是使用反射API访问公共构造函数，一个代理实例可以通过调用Proxy.newProxyInstance方法创建，并结合调用构造函数调用句柄调用Proxy.getProxyClass行动。

代理实例具有以下属性：

• 给定一个代理实例proxy和其中一个接口的代理类Foo实施，下面的表达式将返回true：

   proxy instanceof Foo

  以下铸造操作成功（而不是抛出一个ClassCastException）：

   (Foo) proxy

• 每个代理实例都有一个相关的调用处理程序，该处理程序传递给它的构造函数。静态Proxy.getInvocationHandler方法将返回作为参数传递代理实例的调用处理程序。
• 在一个代理实例的接口方法调用将被编码并发送到调用处理程序的invoke方法为文档中的说明方法。
• 该hashCode，equals调用，或toString方法宣布java.lang.Object在代理实例将被编码并发送到以相同的方式调用处理程序的invoke方法作为接口方法调用进行编码和发送，如上面所描述的。声明类的对象传递给invoke 方法将java.lang.Object。一个代理实例继承java.lang.Object其他公共方法不使用代理类中重写，所以这些方法的调用，就像他们做的java.lang.Object。

方法在多个代理接口中复制

当一个代理类的两个或多个接口包含相同的名称和参数签名的方法时，代理类的接口的顺序变得显着。当这样的一个空重复方法在代理实例的调用，方法对象通过调用处理程序不一定是一个声明类转让从接口调用通过代理的方法的引用类型。此限制存在，因为生成的代理类中的相应方法实现不能确定调用的接口是通过。因此，当一个重复的方法是一个代理实例的调用，在包含该方法的最重要的方法对象接口的方法（直接或通过继承一个超接口）接口的代理类的列表是通过调用处理程序的invoke方法，无论对引用类型的方法调用发生。

如果一个代理接口包含一个具有相同的名称和参数签名方法为hashCode，equals，或toString方法java.lang.Object，当这样的一个方法是在一个代理实例的调用，方法对象通过调用处理程序会有java.lang.Object作为其声明类。换句话说，公众的java.lang.Object非final方法在逻辑上先于所有的代理接口，方法对象通过调用处理程序的确定。

注意，当一个重复的方法分派给调用处理程序，该invoke方法只能把检查的异常类型是分配到一个异常类型在空全部的代理接口方法的throws条款，它可以通过调用。如果invoke方法抛出一个异常，不能分配给任何的异常类型声明的方法，它可以通过调用代理接口，然后选中UndeclaredThrowableException将通过代理实例的调用抛出。这种限制意味着，并非所有的异常类型getExceptionTypes上通过调用传递给invoke方法返回的对象可以被方法必然成功的invoke方法。

从以下版本开始：

一点三

另请参见：

InvocationHandler， Serialized Form

Field Summary

Fields

Modifier and Type	Field and Description
protected InvocationHandler	h 此代理实例的调用处理程序。

构造方法摘要

构造方法

Modifier	Constructor and Description
protected	Proxy(InvocationHandler h) 从一个类构造一个新的 Proxy实例（通常情况下，一个动态代理类）对其调用处理程序指定的值。

方法摘要

Modifier and Type	Method and Description
static InvocationHandler	getInvocationHandler(Object proxy) 返回指定的代理实例的调用处理程序。
static 类<?>	getProxyClass(ClassLoader loader, 类<?>... interfaces) 返回 java.lang.Class对象的代理类，给出了类装载器和一个阵列的接口。
static boolean	isProxyClass(类<?> cl) 如果指定的类是动态生成的可利用 getProxyClass法或代理类 newProxyInstance方法返回true。
static Object	newProxyInstance(ClassLoader loader, 类<?>[] interfaces, InvocationHandler h) 返回指定的接口，将方法调用指定的调用处理程序的代理类的一个实例。

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

h

protected InvocationHandler h

此代理实例的调用处理程序。

Constructor Detail

Proxy

protected Proxy(InvocationHandler h)

从一个类构造一个新的 Proxy实例（通常情况下，一个动态代理类）对其调用处理程序指定的值。

参数

h -这个代理实例的调用处理程序

异常

NullPointerException如果给定调用处理程序， h，是 null。

方法详细信息

getProxyClass

public static 类<?> getProxyClass(ClassLoader loader,
                                     类<?>... interfaces)
                              throws IllegalArgumentException

返回 java.lang.Class对象的代理类，给出了类装载器和一个阵列的接口。代理类将由指定的类装载器定义，并将实现所有提供的接口。如果任何给定的接口是非公开的，代理类将是非公开的。如果为相同的接口排列的代理类已被类装入器定义，那么将返回现有的代理类；否则，这些接口的代理类将由类装载器动态生成和定义。

有可能通过Proxy.getProxyClass参数的一些限制：

• 在interfaces阵列所有的类对象必须是类或接口，而不是原始类型。
• 在interfaces阵列没有两元素可能指的是相同的类对象。
• 所有的接口类型必须通过名称可见，通过指定的类加载程序。换句话说，对于每个接口的类装载器cl i，下面的表达式必须是真实的：

  类。forName（即getname()，虚假，CL）= =我

• 所有非公共接口必须在同一个包中，否则，它将不可能为代理类实现所有的接口，无论它是定义在什么包。
• 对于任何一组指定的接口具有相同签名的成员方法：
  • 如果任何方法的返回类型是原始类型或空，那么所有的方法都必须具有相同的返回类型。
  • 否则，一个方法必须有返回类型，分配给所有的其他方法的返回类型。
• 由此产生的代理类不得超过虚拟机对类所施加的任何限制。例如，虚拟机可能会限制一个类可以实现65535的接口数；在这种情况下，该interfaces数组的大小不能超过65535。

如果这些限制被侵犯，Proxy.getProxyClass将抛出一个IllegalArgumentException。如果interfaces数组参数或其任何元素null，一NullPointerException将抛出。

请注意，指定的代理接口的顺序是显着的：两个请求的代理类的接口相同的组合，但在一个不同的顺序将导致两个不同的代理类。

参数

loader的类装载器来定义代理类

interfaces -为代理类实现的接口列表

结果

在指定的类加载程序中定义的代理类，并实现了指定的接口

异常

IllegalArgumentException -如果有的话，可以通过 getProxyClass参数的限制是违反

SecurityException -如果一个安全经理，是目前任何满足以下条件：

• 给定的loader是null和调用者的类装载器是不null与RuntimePermission("getClassLoader") s.checkPermission调用拒绝访问权限。
• 每个代理接口，intf，调用者的类装载器是不一样的或祖先的intf和调用s.checkPackageAccess()类加载器拒绝访问intf。

NullPointerException -如果 interfaces数组参数或其任何元素 null

newProxyInstance

public static Object newProxyInstance(ClassLoader loader,
                                      类<?>[] interfaces,
                                      InvocationHandler h)
                               throws IllegalArgumentException

返回指定的接口，将方法调用指定的调用处理程序的代理类的一个实例。

Proxy.newProxyInstance抛出IllegalArgumentException，Proxy.getProxyClass不一样的原因。

参数

loader的类装载器来定义代理类

interfaces -为代理类实现的接口列表

h -调用处理程序调度方法调用

结果

指定由指定的类装入器定义的代理类的指定调用处理程序的代理实例，并实现指定的接口

异常

IllegalArgumentException -如果有的话，可以通过 getProxyClass参数的限制是违反

SecurityException -如果一个安全经理，是目前任何满足以下条件：

• 给定的loader是null和调用者的类装载器是不null与RuntimePermission("getClassLoader") s.checkPermission调用拒绝访问权限；
• 每个代理接口，intf，调用者的类装载器是不一样的或祖先的intf和调用s.checkPackageAccess()类加载器拒绝访问intf；
• 任何给定的代理接口是公开和调用类不在同一runtime package为非公开接口与ReflectPermission("newProxyInPackage.{package name}") s.checkPermission调用拒绝访问权限。

NullPointerException -如果 interfaces数组参数或其任何元素 null，或者调用处理程序， h，是 null

isProxyClass

public static boolean isProxyClass(类<?> cl)

如果指定的类是动态生成的可利用 getProxyClass法或代理类 newProxyInstance方法返回true。

这种方法的可靠性，用它来做出安全决策的能力是很重要的，所以它的实施不应只是测试如果类问题延伸Proxy。

参数

cl -课堂测试

结果

true如果类是代理类和 false否则

异常

如果是 null cl NullPointerException

getInvocationHandler

public static InvocationHandler getInvocationHandler(Object proxy)
                                              throws IllegalArgumentException

返回指定的代理实例的调用处理程序。

参数

proxy -代理实例返回调用处理程序

结果

用于代理实例的调用处理程序

异常

IllegalArgumentException如果参数不是一个代理实例

SecurityException -如果一个安全经理，是目前和调用者的类装载器是不一样的或祖先的类装载器的调用处理程序和调用 s.checkPackageAccess()拒绝访问调用处理程序的类。