java.lang.reflect
인터페이스 InvocationHandler

알려진 구현 클래스 목록:

EventHandler, MBeanServerInvocationHandler, RemoteObjectInvocationHandler

public interface InvocationHandler

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

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

도입된 버전 :

JDK1. 3

관련 항목:

Proxy

메서드 개요

Object

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

메서드의 상세

invoke

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

프록시 인스턴스로 메서드 호출을 처리해, 그 결과를 리턴합니다. 관련한 프록시 인스턴스로 메서드가 불려가 면, 이 메서드는 호출해 핸들러로 호출합니다.

파라미터:

proxy - 메서드가 호출되는 프록시 인스턴스

method - 프록시 인스턴스로 호출되는 인터페이스 메서드에 대응하는 Method인스턴스. Method 객체의 선언 클래스는 메서드를 선언한 인터페이스가 된다. 프록시 클래스가 메서드의 상속에 사용하는 프록시 인터페이스의 슈퍼 인터페이스가 되는 경우도 있는

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

반환값:

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

예외:

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

관련 항목:

UndeclaredThrowableException