java.lang.reflect
클래스 Proxy

java.lang.Object 
  |
  +--java.lang.reflect.Proxy

모든 구현 인터페이스:

Serializable

public class Proxy

extends Object

implements Serializable

Proxy 는 동적 프록시의 클래스 및 인스턴스를 생성하는 정적 메소드를 제공해, 또, 그러한 메소드에 의해 생성된 동적 프록시 클래스 모든 슈퍼 클래스이기도 합니다.

인터페이스 Foo 의 프록시를 생성하려면 , 다음과 같이 설정합니다.

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

혹은 좀 더 단순하게, 다음과 같이 설정합니다.

     Foo f = (Foo) Proxy.newProxyInstance(Foo.class.getClassLoader(),
                                          new Class[] { Foo.class },
                                          handler);
 

동적 프록시 클래스 (이하 단지 프록시 클래스라고 부른다)는 클래스 생성의 실행시로 지정된 인터페이스의 리스트를 구현하는 클래스에서, 이하에 말하는 동작을 합니다. 프록시 인터페이스는 프록시 클래스가 구현하는 인터페이스입니다. 프록시 인스턴스는 프록시 클래스의 인스턴스입니다. 각 프록시 인스턴스에는 관련한 호출 핸들러 오브젝트가 있어, 이것은 인터페이스 InvocationHandler 를 구현하고 있습니다. 프록시 인터페이스의 1 개를 사용한 프록시 인스턴스에서의 메소드 호출은 인스턴스의 호출 핸들러의 invoke 메소드에 디스팟치 되어 불려 간 메소드를 식별하는 java.lang.reflect.Method 오브젝트, 및 인수를 저장하는 Object 형의 배열을 프록시 인스턴스에 인도합니다. 호출 핸들러는 encode 된 메소드 호출을 적절히 처리해, 호출 핸들러가 돌려주는 결과가, 프록시 인스턴스에서의 메소드 호출의 결과로서 돌려주어집니다.

프록시 클래스에는 이하의 프로퍼티가 있습니다.

• 프록시 클래스는 public 이며 final 이며, abstract 가 아닙니다.
• 프록시 클래스의 비수식명은 지정되고 있지 않습니다. 다만 캐릭터 라인 "$Proxy" 로 시작되는 클래스명의 area를 프록시 클래스를 위해서(때문에) 확보해 둘 필요가 있습니다.
• 프록시 클래스는 java.lang.reflect.Proxy 를 확장합니다.
• 프록시 클래스는 그 생성시로 지정되었던 대로의 인터페이스를, 같은 순서로 구현합니다.
• 프록시 클래스가 public 가 아닌 인터페이스를 구현하는 경우, 프록시 클래스는 그 인터페이스와 같은 패키지로 정의됩니다. 그렇지 않은 경우는 프록시 클래스의 패키지도 지정되지 않습니다. 패키지의 실링은 프록시 클래스가 실행시에 특정의 패키지로 정의되는 방해로는 되지 않습니다. 특정의 서명자를 가지는 같은 클래스 로더와 같은 패키지로 벌써 정의되고 있는 클래스에 대해서도 같습니다.
• 프록시 클래스는 그 생성시로 지정된 인터페이스를 모두 구현하고 있기 (위해)때문에, 그 Class 오브젝트로 getInterfaces 를 호출하면(자), 같은 인터페이스의 리스트를 생성시로 지정된 순서로 저장하는 배열이 돌려주어집니다. Class 오브젝트로 getMethods 를 호출하면(자), 그러한 인터페이스의 메소드 모든 것을 포함한 Method 오브젝트의 배열이 돌려주어집니다. getMethod 를 호출하면(자), 예상되는 메소드가 프록시 인터페이스로 발견됩니다.
• Proxy.isProxyClass 메소드는 Proxy.getProxyClass 에 의해 돌려주어진 프록시 클래스, 혹은 Proxy.newProxyInstance 에 의해 돌려주어진 오브젝트의 클래스등의 프록시 클래스에 인도해졌을 경우에 true 를 돌려줍니다. 그 이외의 경우는 false 를 돌려줍니다.
• 프록시 클래스의 java.security.ProtectionDomain 는 java.lang.Object 등의 bootstrap 클래스 로더에 의해 로드 된 시스템 클래스의 java.security.ProtectionDomain 와 같습니다. 프록시 클래스의 코드가 신뢰성이 있는 시스템 코드에 의해 생성되기 (위해)때문에입니다. 이 보호 도메인은 통상,java.security.AllPermission 가 허가됩니다.
• 각 프록시 클래스에는 프록시 인스턴스의 호출 핸들러를 설정하기 위해서, 1 개의 인수 즉 인터페이스 InvocationHandler 의 구현을 취하는 1 개의 public constructor 이 있습니다. 리플렉션 API 를 사용해 public constructor 에 액세스 하는 것 외에,Proxy.newInstance 메소드를 호출해 프록시 인스턴스를 생성할 수도 있습니다. 이 메소드는 Proxy.getProxyClass 의 호출 동작을, 호출 핸들러를 가지는 constructor 의 호출과 결합합니다.

프록시 인스턴스에는 이하의 프로퍼티가 있습니다.

• 프록시 클래스 Foo 가 프록시 인스턴스 proxy 및 인터페이스의 1 개를 구현하고 있는 경우, 다음의 식이 true 를 돌려줍니다.

       proxy instanceof Foo
   

  또, 다음의 캐스트 조작이 성공합니다 (ClassCastException 를 슬로우 하는 경우를 제외하다).

       (Foo) proxy
   

• 각 프록시 인스턴스에는 그 constructor 에 인도해진, 관련하는 호출 핸들러가 있습니다. static 의 Proxy.getInvocationHandler 메소드는 그 인수로서 건네받은 프록시 인스턴스에 관련하는 호출 핸들러를 돌려줍니다.
• 프록시 인스턴스에서의 인터페이스 메소드의 호출은 그 메소드의 문서로 진술되고 있게 encode 되어 호출 핸들러의 invoke 메소드에 디스팟치 됩니다.
• java.lang.Object 로 선언되고 있는 hashCode,equals, 또는 toString 의 각 메소드의 프록시 인스턴스에서의 호출은 인터페이스 메소드 호출이 위에서 설명한 바와 같이 encode 되어 디스팟치 되는 것과 같은 방법으로, encode 되어 호출 핸들러의 invoke 메소드에 디스팟치 됩니다. invoke 에 인도해진 Method 오브젝트의 선언 클래스는 java.lang.Object 가 됩니다. java.lang.Object 로부터 계승된 프록시 인스턴스의 다른 public 메소드는 프록시 메소드에 의해 오버라이드(override) 되지 않기 때문에, 그러한 메소드의 호출은 java.lang.Object 의 인스턴스를 호출하는 것과 같은 동작을 합니다.

복수의 프록시 인터페이스로 중복 하는 메소드

프록시 클래스의 2 개 이상의 인터페이스가 같은 이름과 파라메이타형태를 가지는 메소드를 포함한 경우, 프록시 클래스의 인터페이스의 순서가 중요하게 됩니다. 프록시 인스턴스로 이러한 중복 메소드가 불려 갔을 경우, 호출 핸들러에 인도해진 Method 오브젝트는 반드시, 프록시의 메소드의 호출에 사용된 인터페이스의 참조형으로부터 선언 클래스를 할당하고 할 수 있는 오브젝트일 필요는 없습니다. 이 제한이 있는 것은 생성된 프록시 클래스의 해당의 메소드 구현이, 호출에 사용된 인터페이스를 판정할 수 없기 때문입니다. 따라서, 중복 메소드가 프록시 인스턴스로 불려 갔을 경우, 메소드 호출이 발생한 참조형에 관계없이, 프록시 클래스의 인터페이스의 리스트의 메소드를 직접, 또는 슈퍼 인터페이스 경유로 계승해 포함한 주요한 인터페이스의 메소드의 Method 오브젝트가, 호출 핸들러의 invoke 메소드에 인도해집니다.

프록시 인터페이스가 java.lang.Object 의 hashCode,equals, 또는 toString 의 각 메소드와 같은 이름과 파라메이타형태를 가지고 있는 메소드를 포함한 경우, 프록시 인스턴스로 이러한 메소드가 불려 가면(자), 호출 핸들러에 인도해진 Method 오브젝트는 그 선언 클래스로서 java.lang.Object 를 가집니다. 바꾸어 말하면(자),java.lang.Object 의, public 이며 final 가 아닌 메소드는 호출 핸들러에 어느 Method 오브젝트를 인도할까를 결정할 때에, 프록시 인터페이스의 모두에게 논리적으로 우선합니다.

중복 메소드가 호출해 핸들러에 디스팟치 되는 경우,invoke 메소드는 호출에 사용할 수 있는 모든 프록시 인터페이스의 메소드의 throws 절의 예외 타입의 1 개에 할당하고 가능한 확인이 끝난 예외 타입만을 슬로우 할 수 있습니다. invoke 메소드가, 호출에 사용할 수 있는 프록시 인터페이스의 1 개의 메소드로 선언된 예외 타입의 어느 것에도 할당하고 할 수 없는 확인이 끝난 예외를 슬로우 했을 경우, 확인되어 있지 않은 UndeclaredThrowableException 가 프록시 인스턴스에서의 호출에 의해 슬로우 됩니다. 이 제한은 invoke 메소드에 인도해진 Method 오브젝트에서의 getExceptionTypes 의 호출에 의해 돌려주어진 예외 타입이 invoke 메소드에 의해 슬로우 되어도, 모두 반드시 성공한다고는 할 수 없는 것을 의미합니다.

도입된 버젼:

JDK1. 3

관련 항목:

InvocationHandler , 직렬화 된 형식

필드의 개요

protected InvocationHandler

h 이 프록시 인스턴스의 호출 핸들러입니다.

생성자의 개요

protected

Proxy (InvocationHandler h) 지정된 값으로, 서브 클래스 (통상은 동적 프록시 클래스)로부터 그 호출 핸들러에 새로운 Proxy 인스턴스를 구축합니다.

메소드의 개요

static InvocationHandler	getInvocationHandler (Object proxy) 지정된 프록시 인스턴스의 호출 핸들러를 돌려줍니다.
static Class	getProxyClass (ClassLoader loader, Class [] interfaces) 클래스 로더와 인터페이스의 배열의 지정된 프록시 클래스의 java.lang.Class 오브젝트를 돌려줍니다.
static boolean	isProxyClass (Class cl) 지정된 클래스가 getProxyClass 메소드 또는 newProxyInstance 메소드를 사용해 동적으로 생성되어 프록시 클래스가 되는 경우에만, true 를 돌려줍니다.
static Object	newProxyInstance (ClassLoader loader, Class [] interfaces, InvocationHandler h) 지정된 호출 핸들러에 대해서 메소드 호출을 디스팟치 하는 지정된 인터페이스의 프록시 클래스의 인스턴스를 돌려줍니다.

클래스 java.lang. Object 에서 상속받은 메소드

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

필드의 상세

h

protected InvocationHandler  h

이 프록시 인스턴스의 호출 핸들러입니다.

생성자의 상세

Proxy

protected Proxy(InvocationHandler  h)

지정된 값으로, 서브 클래스 (통상은 동적 프록시 클래스)로부터 그 호출 핸들러에 새로운 Proxy 인스턴스를 구축합니다.

파라미터:

h - 이 프록시 인스턴스의 호출 핸들러

메소드의 상세

getProxyClass

public static Class  getProxyClass(ClassLoader  loader,
                                  Class [] interfaces)
                           throws IllegalArgumentException 

클래스 로더와 인터페이스의 배열의 지정된 프록시 클래스의 java.lang.Class 오브젝트를 돌려줍니다. 프록시 클래스는 지정된 클래스 로더로 정의되어 지정된 인터페이스를 모두 구현합니다. 인터페이스의 같은 순열의 프록시 클래스가 벌써 클래스 로더로 정의되고 있는 경우, 기존의 프록시 클래스가 돌려주어집니다. 그렇지 않은 경우는 이러한 인터페이스의 프록시 클래스가 동적으로 생성되어 클래스 로더로 정의됩니다.

Proxy.getProxyClass 에 인도해지는 파라미터에는 몇개의 제약이 있습니다.

• interfaces 배열의 Class 오브젝트는 모두, 클래스 또는 원시적형은 아니고 인터페이스를 나타낼 필요가 있다
• interfaces 배열의 2 개의 요소가 동일한 Class 오브젝트를 참조할 수 없다
• 어느 인터페이스형도, 지정된 클래스 로더를 통해 이름에 의해 가시가 아니면 안된다. 바꾸어 말하면(자), 클래스 로더 cl 및 전인터페이스 i 에 대해, 이하의 식이 true 가 아니면 안된다

       Class.forName(i.getName(), false, cl) == i
   

• public 가 아닌 인터페이스는 모두 같은 패키지에 없으면 안 된다. 그렇지 않은 경우, 프록시 클래스가 어느 패키지로 정의되고 있을까에 관계없이, 프록시 클래스가 인터페이스를 모두 구현하는 것은 불가능하다
• 이름과 파라메이타형태는 같아 반환값의 형태가 다른 메소드를, 2 개의 인터페이스가 동시에 가질 수 없다
• 결과의 프록시 클래스는 가상 머신에 의해 클래스로 설정된 제한을 넘을 수 없다. 예를 들어, 가상 머신은 클래스를 구현할 수 있는 인터페이스의 수를 65535 에 제한한다. 이 경우,interfaces 배열의 사이즈는 65535 를 넘어서는 안 된다

이러한 제약에 1 개에서도 위반하는 경우는 Proxy.getProxyClass 에 의해 IllegalArgumentException 가 슬로우 됩니다. interfaces 배열의 인수 또는 그 요소의 어떤 것인가가 null 의 경우는 NullPointerException 가 슬로우 됩니다.

지정된 프록시 인터페이스의 순서는 중요한 의미를 가집니다. 프록시 클래스에 대한, 같은 인터페이스의 편성으로 순서가 다른 2 개의 요구의 결과는 2 kr의 개별의 프록시 클래스가 됩니다.

파라미터:

loader - 프록시 클래스를 정의하는 클래스 로더

interfaces - 프록시 클래스가 구현하는 인터페이스의 리스트

반환값:

지정된 클래스 로더로 정의되어 지정된 인터페이스를 구현하는 프록시 클래스

예외:

IllegalArgumentException - getProxyClass 에 인도해지는 파라미터에 관한 제약의 어떤 것인가가 지켜질 수 없었던 경우

NullPointerException - interfaces 배열의 인수 또는 그 요소의 어떤 것인가가 null 의 경우

newProxyInstance

public static Object  newProxyInstance(ClassLoader  loader,
                                      Class [] interfaces,
                                      InvocationHandler  h)
                               throws IllegalArgumentException 

지정된 호출 핸들러에 대해서 메소드 호출을 디스팟치 하는 지정된 인터페이스의 프록시 클래스의 인스턴스를 돌려줍니다. 이 메소드는 이하와 동등합니다.

     Proxy.getProxyClass(loader, interfaces).
         getConstructor(new Class[] { InvocationHandler.class }).
         newInstance(new Object[] { handler });
 

Proxy.getProxyClass 의 경우와 같은 이유로써,Proxy.newProxyInstance 는 IllegalArgumentException 를 슬로우 합니다.

파라미터:

loader - 프록시 클래스를 정의하는 클래스 로더

interfaces - 프록시 클래스가 구현하는 인터페이스의 리스트

h - 메소드 호출의 디스팟치처의 호출 핸들러

반환값:

지정된 클래스 로더로 정의되고 지정된 인터페이스를 구현하는 프록시 클래스의, 지정된 호출 핸들러를 가지는 프록시 인터페이스

예외:

IllegalArgumentException - getProxyClass 에 인도해지는 파라미터에 관한 제약의 어떤 것인가가 지켜질 수 없었던 경우

NullPointerException - interfaces 배열의 인수 또는 그 요소의 어떤 것인가가 null 의 경우, 또는 호출해 핸들러 h 가 null 의 경우

isProxyClass

public static boolean isProxyClass(Class  cl)

지정된 클래스가 getProxyClass 메소드 또는 newProxyInstance 메소드를 사용해 동적으로 생성되어 프록시 클래스가 되는 경우에만, true 를 돌려줍니다.

이 메소드의 신뢰성은 이 메소드에 의해 시큐러티 보호를 할 수 있을지 어떨지를 결정할 때에 중요합니다. 이 때문에, 해당 클래스가 Proxy 를 확장할지 어떨지를 이 메소드의 구현으로 테스트하는 것 만으로는 충분하다고는 말할 수 없습니다.

파라미터:

cl - 테스트하는 클래스

반환값:

클래스가 프록시 클래스의 경우는 true, 그렇지 않은 경우는 false

예외:

NullPointerException - cl 가 null 의 경우

getInvocationHandler

public static InvocationHandler  getInvocationHandler(Object  proxy)
                                              throws IllegalArgumentException 

지정된 프록시 인스턴스의 호출 핸들러를 돌려줍니다.

파라미터:

proxy - 호출 핸들러를 돌려주는 프록시 인스턴스

반환값:

프록시 인스턴스의 호출 핸들러

예외:

IllegalArgumentException - 인수가 프록시 인스턴스가 아닌 경우