javax.management
클래스 MBeanServerInvocationHandler

java.lang.Object 
  javax.management.MBeanServerInvocationHandler

모든 구현된 인터페이스:

InvocationHandler

public class MBeanServerInvocationHandler
extends Object 
implements InvocationHandler 

MBean 관리 인터페이스내에서 MBean 서버로부터 MBean에 메서드를 건네주는 InvocationHandler 입니다.

MBeanServerConnection, 그 MBean 서버내의 MBean ObjectName 및 Standard MBean 패턴을 사용하는 MBean 관리 인터페이스를 기술하는 Java 인터페이스 Intf에 의해 이 클래스를 사용해 MBean 프록시를 구축할 수 있습니다. 프록시는 모든 메서드가 MBean 서버로부터 MBean에 건네받도록, Intf인터페이스를 구현합니다.

MBean 서버 mbs에 ObjectName name를 가지는 MBean가 포함되어 있어, MBean 관리 인터페이스가 Java 인터페이스 Intf에 의해 기술되고 있는 경우는 다음과 같이의해 MBean 프록시를 구축할 수 있습니다.

 Intf proxy = (Intf)
     MBeanServerInvocationHandler. newProxyInstance (mbs,
                                                   name,
                                                   Intf.class,
                                                   false);
 

Intf는 다음과 같이 됩니다.

 public interface Intf {
     public String getSomeAttribute();
     public void setSomeAttribute(String value);
     public void someOperation(String param1, int param2);
 }
 

이것으로 다음의 내용을 실행할 수 있습니다.

• proxy.getSomeAttribute() - mbs. getAttribute (name, "SomeAttribute")를 호출한다
• proxy.getSomeAttribute() - mbs. getAttribute (name, "SomeAttribute")을 호출한다
• proxy.someOperation("param1", 2) - mbs. invoke (name, "someOperation", <etc>) 호출에 변환된다

newProxyInstance 마지막 파라미터가 true인 경우, MBean는 NotificationBroadcaster 또는 NotificationEmitter 라고 보여져NotificationEmitter를 구현하는 프록시가 리턴됩니다 . 이 프록시상에서 NotificationBroadcaster.addNotificationListener(javax.management.NotificationListener, javax.management.NotificationFilter, java.lang.Object)를 호출하면, MBeanServerConnection.addNotificationListener(ObjectName, NotificationListener, NotificationFilter, Object) 가 호출됩니다. NotificationBroadcaster 및 NotificationEmitter 그 외의 메서드의 경우도 같습니다.

이 호출 핸들러에의해 프록시상에서 Object.toString(), Object.hashCode() 및 Object.equals(Object) 메서드를 호출하면, 이것들은 위임된 MBean 상의 메서드로서 MBean 서버에게 건네집니다. 다만, 이 때문에는 MBean 관리 인터페이스에 이러한 메서드가 선언되고 있을 필요가 있습니다.

도입된 버전 :

1.5

생성자 개요

MBeanServerInvocationHandler (MBeanServerConnection connection, ObjectName objectName)
메서드를 MBean 서버로부터 송신하는 호출 핸들러입니다.

메서드 개요

Object	invoke (Object proxy, Method method, Object [] args) 프록시 인스턴스로 메서드 호출을 처리해, 그 결과를 리턴합니다.
static Object	newProxyInstance (MBeanServerConnection connection, ObjectName objectName, Class interfaceClass, boolean notificationBroadcaster) 지정의 MBean 서버로부터 MBean에 메서드를 건네주는 것으로 지정된 인터페이스를 구현하는 프록시를 리턴합니다.

클래스 java.lang. Object 로부터 상속된 메서드

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

생성자 상세

MBeanServerInvocationHandler

public MBeanServerInvocationHandler(MBeanServerConnection  connection,
                                    ObjectName  objectName)

메서드를 MBean 서버로부터 송신하는 호출 핸들러입니다. 이 생성자는 예를 들어, Proxy.newProxyInstance에 다른 ClassLoader를 건네주고 싶은 경우에 newProxyInstance(javax.management.MBeanServerConnection, javax.management.ObjectName, java.lang.Class, boolean) 대신에 호출합니다.

파라미터:

connection - MBean 서버 접속. 이 핸들러를 사용하는 프록시의 모든 메서드는 이 접속을 개입시켜 건네받는

objectName - MBean 서버내의 MBean 이름. 메서드는 이 MBean 에게 건네진다

메서드의 상세

newProxyInstance

public static Object  newProxyInstance(MBeanServerConnection  connection,
                                      ObjectName  objectName,
                                      Class  interfaceClass,
                                      boolean notificationBroadcaster)

지정의 MBean 서버로부터 MBean에 메서드를 건네주는 것으로 지정된 인터페이스를 구현하는 프록시를 리턴합니다.

이 메서드는 Proxy.newProxyInstance (interfaceClass.getClassLoader(), interfaces, handler)와 동등합니다. handler는 new MBeanServerInvocationHandler(connection, objectName) 결과입니다. interfaces는 notificationBroadcaster가 false 인 경우에 1개 요소를 가져, true 인 경우에 2개 요소를 가지는 배열입니다. interfaces 최초의 요소는 interfaceClass, 2번째의 요소는 NotificationEmitter.class (존재하는 경우)입니다.

파라미터:

connection - 송신지의 MBean 서버

objectName - connection 내에서 건네받는 MBean 이름

interfaceClass - MBean가 export 하는 관리 인터페이스. 리턴된 프록시도, 이것을 구현하는

notificationBroadcaster - connection로 부터 메서드를 송신하는 것으로써, 리턴된 프록시에 NotificationEmitter를 구현시킨다

반환값:

새로운 프록시의 인스턴스

invoke

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

인터페이스 InvocationHandler 기술:

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

정의:

인터페이스 InvocationHandler 내의 invoke

파라미터:

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