java.lang.reflect
클래스 Proxy

java.lang.Object 
  java.lang.reflect.Proxy

모든 구현된 인터페이스:

Serializable

public class Proxy
extends Object 
implements Serializable 

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

인터페이스 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」로 시작되는 클래스명의 영역을 프록시 클래스를 위해서 확보해 둘 필요가 있다
• 프록시 클래스는 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 생성자가 있다. 리플렉션 API를 사용해 public 생성자에 액세스 하는 것 외에 Proxy.newInstance 메서드를 호출해 프록시 인스턴스를 생성할 수도 있다. 이 메서드는 Proxy.getProxyClass 호출 동작을 호출 핸들러를 가지는 생성자 호출과 결합한다

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

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

  
       proxy instanceof Foo
   

  또, 다음의 캐스트 조작이 성공한다 (ClassCastException는 Throw 되지 않는다)

  
       (Foo) proxy
   

• 각 프록시 인스턴스에는 그 생성자에 인도해진, 관련된 호출 핸들러가 있다. 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개에 할당하고 가능한 확인이 끝난 예외 타입만을 Throw 할 수 있습니다. invoke 메서드가 호출에 사용할 수 있는 프록시 인터페이스의 1개의 메서드로 선언된 예외 타입의 어느 것에도 할당하고 할 수 없는 확인이 끝난 예외를 Throw 했을 경우, 확인되어 있지 않은 UndeclaredThrowableException가 프록시 인스턴스에서의 호출에 의해 발생 됩니다. 이 제한은, invoke 메서드에 인도해진 Method 객체에서의 getExceptionTypes 호출에 의해 리턴된 예외 타입이 invoke 메서드에 의해 예외가 발생되어 도, 모두 반드시 성공한다고는 할 수 없는 것을의미합니다.

도입된 버전 :

1.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가 아닌 인터페이스는 모두 같은 패키지에 없으면 안 된다. 그렇지 않은 경우, 프록시 클래스가 어느 패키지로 정의되고 있을까에 관계없이, 프록시 클래스가 인터페이스를 모두 구현하는 것은 불가능하다
• 같은 서명을 가지는 지정된 인터페이스의 멤버 메서드세트의 경우,
  • 메서드의 어떤 것인가의 반환값의 형태가 원시형 또는 void인 경우, 모든 메서드는 같은 반환값의 형태를 가지지 않으면 안 된다
  • 그렇지 않은 경우, 메서드의 1개는 그 이외의 메서드의 모든 반환값의 형태에 할당할 수 있는 반환값의 형태를 가지지 않으면 안 된다
• 결과의 프록시 클래스는 가상 머신에 의해 클래스로 설정된 제한을 넘을 수 없다. 예를 들어가상 머신은 클래스를 구현할 수 있는 인터페이스의 수를 65535에 제한한다. 이 경우 interfaces 배열의 사이즈는 65535를 넘어서는 안 된다

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

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

파라미터:

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을 Throw 합니다.

파라미터:

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 - 인수가 프록시 인스턴스가 아닌 경우