java.lang.reflect
인터페이스 InvocationHandler

기존의 구현 클래스의 일람:

EventHandler

public interface InvocationHandler

InvocationHandler 는 프록시 인스턴스의 호출 핸들러가 구현하는 인터페이스입니다.

프록시 인스턴스에는 각각 관련한 호출 핸들러가 있습니다. 프록시 인스턴스로 메소드가 불려 가면(자), 메소드의 호출이 encode 되어 각 프로 사계 인스턴스의 호출 핸들러의 invoke 메소드에 디스팟치 됩니다.

도입된 버젼:

JDK1. 3

관련 항목:

Proxy

메소드의 개요

Object

invoke (Object proxy, Method method, Object [] args) 프록시 인스턴스로 메소드 호출을 처리해, 그 결과를 돌려줍니다.

메소드의 상세

invoke

public Object  invoke(Object  proxy,
                     Method  method,
                     Object [] args)
              throws Throwable 

프록시 인스턴스로 메소드 호출을 처리해, 그 결과를 돌려줍니다. 관련한 프록시 인스턴스로 메소드가 불려 가면(자), 이 메소드는 호출해 핸들러로 불려 갑니다.

파라미터:

proxy - 메소드가 불려 가는 프록시 인스턴스

method - 프록시 인스턴스로 불려 가는 인터페이스 메소드에 대응하는 Method 인스턴스. Method 오브젝트의 선언 클래스는 메소드를 선언한 인터페이스가 된다. 프록시 클래스가 메소드의 계승에 사용하는 프록시 인터페이스의 슈퍼 인터페이스가 되는 경우도 있는

args - 프록시 인스턴스에서의 메소드 호출시에게 건네지는 인수치를 저장하는 오브젝트 배열. 인터페이스 메소드가 인수를 취하지 않는 경우, null 가 된다. 원시적형 인수는 java.lang.Integer 또는 java.lang.Boolean 와 같이 적절한 원시적형 래퍼 클래스의 인스턴스에 랩 된다

반환값:

프록시 인스턴스에서의 메소드 호출로부터의 반환값. 인터페이스 메소드의 선언된 반환값의 형태가 원시적형의 경우는 이 메소드의 반환값은 대응하는 원시적 래퍼 클래스의 인스턴스가 아니면 안된다. 그렇지 않은 경우, 선언된 반환값의 형태에 할당할 수 있는 형태가 아니면 안된다. 이 메소드에 의한 반환값이 null 로, 인터페이스 메소드의 반환값이 원시적형의 경우, 프록시 인스턴스에서의 메소드 호출에 의해 NullPointerException 가 슬로우 된다. 이외의 케이스로, 이 메소드의 반환값과 상기와 같은 인터페이스 메소드의 선언된 반환값의 형태와의 사이에 호환성이 없는 경우,ClassCastException 는 프록시 인스턴스에서의 메소드 호출에 의해 슬로우 되게 된다

예외:

Throwable - 프록시 인스턴스에서의 메소드 호출로부터 슬로우 되는 예외. 이 예외의 타입은 인터페이스 메소드의 throws 절에 선언되는 예외 타입인가, 또는 체크되지 않는 예외 타입의 java.lang.RuntimeException 또는 java.lang.Error 에 할당할 수 없으면 안 된다. 이 메소드에 의해 슬로우 되는 체크 예외가, 인터페이스 메소드의 throws 절에 선언된 예외 타입에 할당할 수 없는 경우, 이 메소드가 슬로우 한 예외를 저장하는 UndeclaredThrowableException 가 프록시 인스턴스에서의 메소드 호출에 의해 슬로우 되게 되는

관련 항목:

UndeclaredThrowableException