javax.management
인터페이스 MBeanServerConnection

알려진 서브 인터페이스 목록 :

MBeanServer, MBeanServerForwarder

public interface MBeanServerConnection

이 인터페이스는 MBean 서버 (로컬 또는 리모트)와의 통신 방법을 나타냅니다. 로컬 MBean 서버를 나타내는 MBeanServer 인터페이스에 의해 확장됩니다.

도입된 버전 :

1.5

메서드 개요

void	addNotificationListener (ObjectName name, NotificationListener listener, NotificationFilter filter, Object handback) 등록이 끝난 MBean에 리스너를 추가합니다.
void	addNotificationListener (ObjectName name, ObjectName listener, NotificationFilter filter, Object handback) 등록이 끝난 MBean에 리스너를 추가합니다.
ObjectInstance	createMBean (String className, ObjectName name) MBean를 인스턴스화해, MBean 서버에 등록합니다.
ObjectInstance	createMBean (String className, ObjectName name, Object [] params, String [] signature) MBean를 인스턴스화해, MBean 서버에 등록합니다.
ObjectInstance	createMBean (String className, ObjectName name, ObjectName loaderName) MBean를 인스턴스화해, MBean 서버에 등록합니다.
ObjectInstance	createMBean (String className, ObjectName name, ObjectName loaderName, Object [] params, String [] signature) MBean를 인스턴스화해, MBean 서버에 등록합니다.
Object	getAttribute (ObjectName name, String attribute) 지정된 MBean 특정의 속성의 값을 취득합니다.
AttributeList	getAttributes (ObjectName name, String [] attributes) 지정된 MBean 복수의 속성의 값을 유효화합니다.
String	getDefaultDomain () MBean 지정에 사용하는 디폴트의 도메인을 리턴합니다.
String []	getDomains () MBean가 현재 등록되어 있는 도메인의 리스트를 리턴합니다.
Integer	getMBeanCount () MBean 서버에 등록되어 있는 MBean 수를 리턴합니다.
MBeanInfo	getMBeanInfo (ObjectName name) 이 메서드는 MBean가 관리용으로서 공개하고 있는 속성과 오퍼레이션을 검출합니다.
ObjectInstance	getObjectInstance (ObjectName name) MBean에 등록된 MBean ObjectInstance를 취득합니다.
Object	invoke (ObjectName name, String operationName, Object [] params, String [] signature) MBean상에서 오퍼레이션을 호출합니다.
boolean	isInstanceOf (ObjectName name, String className) 지정된 MBean가 지정된 클래스의 인스턴스인 경우는 true, 그렇지 않은 경우는 false를 리턴합니다.
boolean	isRegistered (ObjectName name) 이 객체명으로 식별되는 MBean 가 이미 MBean 서버에 등록되어 있는지를 체크합니다.
Set	queryMBeans (ObjectName name, QueryExp query) MBean 서버에 의해 제어되는 MBean를 취득합니다.
Set	queryNames (ObjectName name, QueryExp query) MBean 서버에 의해 제어되는 MBean 이름을 취득합니다.
void	removeNotificationListener (ObjectName name, NotificationListener listener) 등록이 끝난 MBean 로부터 리스너를 삭제합니다.
void	removeNotificationListener (ObjectName name, NotificationListener listener, NotificationFilter filter, Object handback) 등록이 끝난 MBean 로부터 리스너를 삭제합니다.
void	removeNotificationListener (ObjectName name, ObjectName listener) 등록이 끝난 MBean 로부터 리스너를 삭제합니다.
void	removeNotificationListener (ObjectName name, ObjectName listener, NotificationFilter filter, Object handback) 등록이 끝난 MBean 로부터 리스너를 삭제합니다.
void	setAttribute (ObjectName name, Attribute attribute) 지정된 MBean 특정의 속성의 값을 설정합니다.
AttributeList	setAttributes (ObjectName name, AttributeList attributes) 지정된 MBean 복수의 속성의 값을 설정합니다.
void	unregisterMBean (ObjectName name) MBean 서버로부터 MBean 등록을 해제합니다.

메서드의 상세

createMBean

ObjectInstance  createMBean(String  className,
                           ObjectName  name)
                           throws ReflectionException,

                                  InstanceAlreadyExistsException,

                                  MBeanRegistrationException,

                                  MBeanException,

                                  NotCompliantMBeanException,

                                  IOException 

MBean를 인스턴스화해, MBean 서버에 등록합니다. MBean 서버는 디폴트의 로더 리포지터리(repository)를 사용해, 이 MBean 클래스를 로드합니다. MBean에는 객체명을 관련지을 수 있습니다. 이 객체명이 null인 경우, MBean는 MBeanRegistration 인터페이스를 구현해, preRegister 메서드로부터 리턴된 독자적인 이름을 사용할 필요가 있습니다.

이 메서드는 createMBean(className, name, (Object[]) null, (String[]) null) 라고 동등합니다.

파라미터:

className - 인스턴스화하는 MBean 클래스명

name - MBean 객체명. null도 가능

반환값:

새롭고 인스턴스화 된 MBean ObjectName와 Java 클래스명을 포함한 ObjectInstance. ObjectName가 n인 경우, Java 클래스명은 getMBeanInfo(n) . getClassName()

예외:

ReflectionException - MBean 생성자 호출시에 발행되는 java.lang.ClassNotFoundException 또는 java.lang.Exception를 감싸는 경우

InstanceAlreadyExistsException - MBean가 이미 MBean 서버에 의해 제어되고 있는 경우

MBeanRegistrationException - MBean preRegister (MBeanRegistration 인터페이스) 메서드가 예외를 Throw 했을 경우. MBean는 등록되지 않는다

MBeanException - MBean 생성자가 예외를 Throw 했을 경우

NotCompliantMBeanException - 이 클래스가 JMX 준거의 MBean가 아닌 경우

RuntimeOperationsException - java.lang.IllegalArgumentException를 감싸는 경우. 즉, 파라미터에게 건네지는 className가 null 인지, 파라미터에게 건네지는 ObjectName 이 패턴인지, MBean에 ObjectName가 지정되어 있지 않은 경우

IOException - MBean 서버와의 통신시에 발생한 문제

createMBean

ObjectInstance  createMBean(String  className,
                           ObjectName  name,
                           ObjectName  loaderName)
                           throws ReflectionException,

                                  InstanceAlreadyExistsException,

                                  MBeanRegistrationException,

                                  MBeanException,

                                  NotCompliantMBeanException,

                                  InstanceNotFoundException,

                                  IOException 

MBean를 인스턴스화해, MBean 서버에 등록합니다. 사용하는 클래스 로더는 객체명으로 식별됩니다. MBean에는 객체명을 관련지을 수 있습니다. 로더의 객체명이 null인 경우, MBean 서버의 로드에 사용한 ClassLoader가 사용됩니다. MBean 객체명이 null인 경우, MBean는 MBeanRegistration 인터페이스를 구현해, preRegister 메서드로부터 리턴된 독자적인 이름을 사용할 필요가 있습니다.

이 메서드는 createMBean(className, name, loaderName, (Object[]) null, (String[]) null) 라고 동등합니다.

파라미터:

className - 인스턴스화하는 MBean 클래스명

name - MBean 객체명. null도 가능

loaderName - 사용하는 클래스 로더의 객체명

반환값:

새롭고 인스턴스화 된 MBean ObjectName와 Java 클래스명을 포함한 ObjectInstance. ObjectName가 n인 경우, Java 클래스명은 getMBeanInfo(n) . getClassName()

예외:

ReflectionException - MBean 생성자 호출시에 발행되는 java.lang.ClassNotFoundException 또는 java.lang.Exception를 감싸는 경우

InstanceAlreadyExistsException - MBean가 이미 MBean 서버에 의해 제어되고 있는 경우

MBeanRegistrationException - MBean preRegister (MBeanRegistration 인터페이스) 메서드가 예외를 Throw 했을 경우. MBean는 등록되지 않는다

MBeanException - MBean 생성자가 예외를 Throw 했을 경우

NotCompliantMBeanException - 이 클래스가 JMX 준거의 MBean가 아닌 경우

InstanceNotFoundException - 지정된 클래스 로더가 MBean 서버에 등록되지 않은 경우

RuntimeOperationsException - java.lang.IllegalArgumentException를 감싸는 경우. 즉, 파라미터에게 건네지는 className가 null 인지, 파라미터에게 건네지는 ObjectName 이 패턴인지, MBean에 ObjectName가 지정되어 있지 않은 경우

IOException - MBean 서버와의 통신시에 발생한 문제

createMBean

ObjectInstance  createMBean(String  className,
                           ObjectName  name,
                           Object [] params,
                           String [] signature)
                           throws ReflectionException,

                                  InstanceAlreadyExistsException,

                                  MBeanRegistrationException,

                                  MBeanException,

                                  NotCompliantMBeanException,

                                  IOException 

MBean를 인스턴스화해, MBean 서버에 등록합니다. MBean 서버는 디폴트의 로더 리포지터리(repository)를 사용해, 이 MBean 클래스를 로드합니다. MBean에는 객체명을 관련지을 수 있습니다. 이 객체명이 null인 경우, MBean는 MBeanRegistration 인터페이스를 구현해, preRegister 메서드로부터 리턴된 독자적인 이름을 사용할 필요가 있습니다.

파라미터:

className - 인스턴스화하는 MBean 클래스명

name - MBean 객체명. null도 가능

params - 호출되는 생성자 파라미터를 포함한 배열

signature - 호출되는 생성자 시그니쳐를 포함한 배열

반환값:

새롭고 인스턴스화 된 MBean ObjectName와 Java 클래스명을 포함한 ObjectInstance. ObjectName가 n인 경우, Java 클래스명은 getMBeanInfo(n) . getClassName()

예외:

ReflectionException - MBean 생성자 호출시에 발행되는 java.lang.ClassNotFoundException 또는 java.lang.Exception를 감싸는 경우

InstanceAlreadyExistsException - MBean가 이미 MBean 서버에 의해 제어되고 있는 경우

MBeanRegistrationException - MBean preRegister (MBeanRegistration 인터페이스) 메서드가 예외를 Throw 했을 경우. MBean는 등록되지 않는다

MBeanException - MBean 생성자가 예외를 Throw 했을 경우

NotCompliantMBeanException - 이 클래스가 JMX 준거의 MBean가 아닌 경우

RuntimeOperationsException - java.lang.IllegalArgumentException를 감싸는 경우. 즉, 파라미터에게 건네지는 className가 null 인지, 파라미터에게 건네지는 ObjectName 이 패턴인지, MBean에 ObjectName가 지정되어 있지 않은 경우

IOException - MBean 서버와의 통신시에 발생한 문제

createMBean

ObjectInstance  createMBean(String  className,
                           ObjectName  name,
                           ObjectName  loaderName,
                           Object [] params,
                           String [] signature)
                           throws ReflectionException,

                                  InstanceAlreadyExistsException,

                                  MBeanRegistrationException,

                                  MBeanException,

                                  NotCompliantMBeanException,

                                  InstanceNotFoundException,

                                  IOException 

MBean를 인스턴스화해, MBean 서버에 등록합니다. 사용하는 클래스 로더는 객체명으로 식별됩니다. MBean에는 객체명을 관련지을 수 있습니다. 로더의 객체명이 지정되어 있지 않은 경우, MBean 서버의 로드에 사용한 ClassLoader가 사용됩니다. MBean 객체명이 null인 경우, MBean는 MBeanRegistration 인터페이스를 구현해, preRegister 메서드로부터 리턴된 독자적인 이름을 사용할 필요가 있습니다.

파라미터:

className - 인스턴스화하는 MBean 클래스명

name - MBean 객체명. null도 가능

params - 호출되는 생성자 파라미터를 포함한 배열

signature - 호출되는 생성자 시그니쳐를 포함한 배열

loaderName - 사용하는 클래스 로더의 객체명

반환값:

새롭고 인스턴스화 된 MBean ObjectName와 Java 클래스명을 포함한 ObjectInstance. ObjectName가 n인 경우, Java 클래스명은 getMBeanInfo(n) . getClassName()

예외:

ReflectionException - MBean 생성자 호출시에 발행되는 java.lang.ClassNotFoundException 또는 java.lang.Exception를 감싸는 경우

InstanceAlreadyExistsException - MBean가 이미 MBean 서버에 의해 제어되고 있는 경우

MBeanRegistrationException - MBean preRegister (MBeanRegistration 인터페이스) 메서드가 예외를 Throw 했을 경우. MBean는 등록되지 않는다

MBeanException - MBean 생성자가 예외를 Throw 했을 경우

NotCompliantMBeanException - 이 클래스가 JMX 준거의 MBean가 아닌 경우

InstanceNotFoundException - 지정된 클래스 로더가 MBean 서버에 등록되지 않은 경우

RuntimeOperationsException - java.lang.IllegalArgumentException를 감싸는 경우. 즉, 파라미터에게 건네지는 className가 null 인지, 파라미터에게 건네지는 ObjectName 이 패턴인지, MBean에 ObjectName가 지정되어 있지 않은 경우

IOException - MBean 서버와의 통신시에 발생한 문제

unregisterMBean

void unregisterMBean(ObjectName  name)
                     throws InstanceNotFoundException,

                            MBeanRegistrationException,

                            IOException 

MBean 서버로부터 MBean 등록을 해제합니다. MBean는 객체명으로 식별됩니다. 메서드를 호출한뒤 객체명을 지정해 이 MBean에 액세스 할 수 없습니다.

파라미터:

name - 등록 해제하는 MBean 객체명

예외:

InstanceNotFoundException - 지정된 MBean가 MBean 서버에 등록되지 않은 경우

MBeanRegistrationException - MBean preDeregister (MBeanRegistration 인터페이스) 메서드가 예외를 Throw 했을 경우

RuntimeOperationsException - java.lang.IllegalArgumentException를 감싸는 경우. 즉, 파라미터내의 객체명이 null 인지, 등록 해제하려고 하고 있는 MBean가 MBeanServerDelegate 인 경우

IOException - MBean 서버와의 통신시에 발생한 문제

getObjectInstance

ObjectInstance  getObjectInstance(ObjectName  name)
                                 throws InstanceNotFoundException,

                                        IOException 

MBean에 등록된 MBean ObjectInstance를 취득합니다.

파라미터:

name - MBean 객체명

반환값:

name 로 지정된 MBean에 관련된 ObjectInstance. ObjectName는 name로 포함되는 클래스명은 getMBeanInfo(name) . getClassName()

예외:

InstanceNotFoundException - 지정된 MBean가 MBean 서버에 등록되지 않은 경우

IOException - MBean 서버와의 통신시에 발생한 문제

queryMBeans

Set  queryMBeans(ObjectName  name,
                QueryExp  query)
                throws IOException 

MBean 서버에 의해 제어되는 MBean를 취득합니다. 이 메서드는 모든 MBean, ObjectName 나 Query 식의 패턴 매칭에 의해 지정된 MBean 세트, 특정의 MBean 어느쪽이든을 리턴합니다. 객체명이 null 인 경우, 또는 도메인이나 키의 프로퍼티가 지정되어 있지 않은 경우, 모든 객체가 선택됩니다. 쿼리가 가리키는 경우는 또한 필터링이 적용됩니다. 이 메서드는 선택된 MBean에 대해서 ObjectInstance 객체세트 (ObjectName와 Java Class 명을 포함한다)를 리턴합니다.

파라미터:

name - 얻는 MBean를 식별하는 객체명 패턴. null인 경우, 또는 도메인이나 키의 프로퍼티가 지정되어 있지 않은 경우는 등록되어 모든 MBean가 취득되는

query - MBean 선택에 적용되는 쿼리식. null인 경우, MBean 선택에 쿼리식은 적용되지 않는다

반환값:

선택된 MBean ObjectInstance 객체를 포함한 세트. 쿼리의 조건을 채우는 MBean가 존재하지 않는 경우, 비어있는 리스트가 리턴된다

예외:

IOException - MBean 서버와의 통신시에 발생한 문제

queryNames

Set  queryNames(ObjectName  name,
               QueryExp  query)
               throws IOException 

MBean 서버에 의해 제어되는 MBean 이름을 취득합니다. 이 메서드는 모든 MBean 이름, ObjectName 나 Query 식의 패턴 매칭에 의해 지정된 MBean 세트의 이름, 특정의 MBean 이름의 어느쪽이든을 리턴합니다. 이것에 의해 MBean가 등록되어 있는지를 판별할 수 있습니다. 객체명이 null 인 경우, 또는 도메인이나 키의 프로퍼티가 지정되어 있지 않은 경우, 모든 객체가 선택됩니다. 쿼리가 가리키는 경우는 또한 필터링이 적용됩니다. 이 메서드는 선택된 MBean에 대해서 ObjectName 세트를 리턴합니다.

파라미터:

name - 얻는 MBean 명을 식별하는 객체명 패턴. null인 경우, 또는 도메인이나 키의 프로퍼티가 지정되어 있지 않은 경우는 등록되어 모든 MBean 이름이 취득되는

query - MBean 선택에 적용되는 쿼리식. null인 경우, MBean 선택에 쿼리식은 적용되지 않는다

반환값:

선택된 MBean ObjectName를 포함한 세트. 쿼리의 조건을 채우는 MBean가 존재하지 않는 경우, 비어있는 리스트가 리턴된다

예외:

IOException - MBean 서버와의 통신시에 발생한 문제

isRegistered

boolean isRegistered(ObjectName  name)
                     throws IOException 

이 객체명으로 식별되는 MBean 가 이미 MBean 서버에 등록되어 있는지를 체크합니다.

파라미터:

name - 체크 대상의 MBean 객체명

반환값:

MBean가 이미 MBean 서버에 등록되어 있는 경우는 true, 그렇지 않은 경우는 false

예외:

RuntimeOperationsException - java.lang.IllegalArgumentException를 감싸는 경우. 즉, 파라미터내의 객체명이 null인 경우

IOException - MBean 서버와의 통신시에 발생한 문제

getMBeanCount

Integer  getMBeanCount()
                      throws IOException 

MBean 서버에 등록되어 있는 MBean 수를 리턴합니다.

반환값:

등록을 마친 MBean 수

예외:

IOException - MBean 서버와의 통신시에 발생한 문제

getAttribute

Object  getAttribute(ObjectName  name,
                    String  attribute)
                    throws MBeanException,

                           AttributeNotFoundException,

                           InstanceNotFoundException,

                           ReflectionException,

                           IOException 

지정된 MBean 특정의 속성의 값을 취득합니다. MBean는 객체명으로 식별됩니다.

파라미터:

name - MBean 객체명. 이 MBean 속성이 취득되는

attribute - 취득되는 속성의 이름을 지정하는 String

반환값:

취득되는 속성의 값

예외:

AttributeNotFoundException - MBean 지정된 속성이 액세스 불가능한 경우

MBeanException - MBean 취득 메서드에 의해 발생되는 예외를감싸는 경우

InstanceNotFoundException - 지정된 MBean가 MBean 서버에 등록되지 않은 경우

ReflectionException - 설정 메서드의 호출시에 발생되는 java.lang.Exception를 감싸는 경우

RuntimeOperationsException - java.lang.IllegalArgumentException를 감싸는 경우. 즉, 파라미터내의 객체명이 null 인지, 파라미터내에 속성이 지정되어 있지 않은 경우

IOException - MBean 서버와의 통신시에 발생한 문제

관련 항목:

setAttribute(javax.management.ObjectName, javax.management.Attribute)

getAttributes

AttributeList  getAttributes(ObjectName  name,
                            String [] attributes)
                            throws InstanceNotFoundException,

                                   ReflectionException,

                                   IOException 

지정된 MBean 복수의 속성의 값을 유효화합니다. MBean는 객체명으로 식별됩니다.

파라미터:

name - MBean 객체명. 이 MBean 속성이 취득되는

attributes - 취득되는 속성의 리스트

반환값:

취득되는 속성의 리스트

예외:

InstanceNotFoundException - 지정된 MBean가 MBean 서버에 등록되지 않은 경우

ReflectionException - Dynamic MBean getAttributes 메서드의 호출시에 예외가 발생했을 경우

RuntimeOperationsException - java.lang.IllegalArgumentException를 감싸는 경우. 즉, 파라미터내의 객체명이 null 인지, 파라미터내의 속성이 null 인 경우

IOException - MBean 서버와의 통신시에 발생한 문제

관련 항목:

setAttributes(javax.management.ObjectName, javax.management.AttributeList)

setAttribute

void setAttribute(ObjectName  name,
                  Attribute  attribute)
                  throws InstanceNotFoundException,

                         AttributeNotFoundException,

                         InvalidAttributeValueException,

                         MBeanException,

                         ReflectionException,

                         IOException 

지정된 MBean 특정의 속성의 값을 설정합니다. MBean는 객체명으로 식별됩니다.

파라미터:

name - MBean 명. 이 MBean 속성이 설정되는

attribute - 설정되는 속성의 ID와 설정되는 값

예외:

InstanceNotFoundException - 지정된 MBean가 MBean 서버에 등록되지 않은 경우

AttributeNotFoundException - MBean 지정된 속성이 액세스 불가능한 경우

InvalidAttributeValueException - 지정된 값이, 속성에 대한 유효한 값이 아닌 경우

MBeanException - MBean 설정 메서드에 의해 발생되는 예외를감싸는 경우

ReflectionException - 설정 메서드의 호출시에 발생되는 java.lang.Exception를 감싸는 경우

RuntimeOperationsException - java.lang.IllegalArgumentException를 감싸는 경우. 즉, 파라미터내의 객체명이 null 인지, 파라미터내에 속성이 지정되어 있지 않은 경우

IOException - MBean 서버와의 통신시에 발생한 문제

관련 항목:

getAttribute(javax.management.ObjectName, java.lang.String)

setAttributes

AttributeList  setAttributes(ObjectName  name,
                            AttributeList  attributes)
                            throws InstanceNotFoundException,

                                   ReflectionException,

                                   IOException 

지정된 MBean 복수의 속성의 값을 설정합니다. MBean는 객체명으로 식별됩니다.

파라미터:

name - MBean 객체명. 이 MBean 속성이 설정되는

attributes - 속성의 리스트 (설정되는 속성의 ID와 설정되는 값)

반환값:

설정된 속성과 새로운 값의 리스트

예외:

InstanceNotFoundException - 지정된 MBean가 MBean 서버에 등록되지 않은 경우

ReflectionException - Dynamic MBean getAttributes 메서드의 호출시에 예외가 발생했을 경우

RuntimeOperationsException - java.lang.IllegalArgumentException를 감싸는 경우. 즉, 파라미터내의 객체명이 null 인지, 파라미터내의 속성이 null 인 경우

IOException - MBean 서버와의 통신시에 발생한 문제

관련 항목:

getAttributes(javax.management.ObjectName, java.lang.String[])

invoke

Object  invoke(ObjectName  name,
              String  operationName,
              Object [] params,
              String [] signature)
              throws InstanceNotFoundException,

                     MBeanException,

                     ReflectionException,

                     IOException 

MBean상에서 오퍼레이션을 호출합니다.

파라미터:

name - 메서드의 호출을 하는 MBean 객체명

operationName - 호출되는 오퍼레이션의 이름

params - 오퍼레이션의 호출시로 설정되는 파라미터를 포함한 배열

signature - 오퍼레이션의 시그니쳐를 포함한 배열. 클래스 객체의 로드에는 오퍼레이션을 호출한 MBean를 로드할 때와 같은 클래스 로더가 사용된다

반환값:

오퍼레이션에 의해 리턴된 객체. 지정된 MBean 상에서 오퍼레이션을 호출한 결과를 나타낸다

예외:

InstanceNotFoundException - 지정된 MBean가 MBean 서버에 등록되지 않은 경우

MBeanException - MBean 호출 메서드에 의해 발생되는 예외를감싸는 경우

ReflectionException - 메서드의 호출시에 발생되는 java.lang.Exception를 감싸는 경우

IOException - MBean 서버와의 통신시에 발생한 문제

getDefaultDomain

String  getDefaultDomain()
                        throws IOException 

MBean 지정에 사용하는 디폴트의 도메인을 리턴합니다. 사용자가 도메인명을 지정하지 않았던 경우, MBean ObjectName 도메인 부분에는 디폴트의 도메인명이 들어갑니다.

반환값:

디폴트의 도메인

예외:

IOException - MBean 서버와의 통신시에 발생한 문제

getDomains

String [] getDomains()
                    throws IOException 

MBean가 현재 등록되어 있는 도메인의 리스트를 리턴합니다. 리턴된 배열내에 캐릭터 라인이 포함되는 경우는 그 캐릭터 라인과 동일한 getDomain()를 가지는 ObjectName 로 1개 이상의 MBean가 등록되어 있습니다. 리턴된 배열내의 캐릭터 라인의 순서는 미정도리입니다.

반환값:

도메인의 리스트

예외:

IOException - MBean 서버와의 통신시에 발생한 문제

addNotificationListener

void addNotificationListener(ObjectName  name,
                             NotificationListener  listener,
                             NotificationFilter  filter,
                             Object  handback)
                             throws InstanceNotFoundException,

                                    IOException 

등록이 끝난 MBean에 리스너를 추가합니다.

MBean가 발행한 통지는 MBeanServer에 의해 리스너에게 전송 됩니다. 통지의 소스가 MBean 객체의 참조가 되어 있는 경우, MBean 서버는 이것을 MBean ObjectName 로 옮겨놓습니다. 그 외의 경우, 소스가 변경될 것은 없습니다.

파라미터:

name - 리스너가 추가되는 MBean 이름

listener - 등록이 끝난 MBean가 발행한 통지를 처리하는 리스너 객체

filter - 필터 객체. 필터가 null인 경우, 통지 처리전에 필터는 적용되지 않는

handback - 통지가 발행되었을 때 리스너에게 송신되는 컨텍스트

예외:

InstanceNotFoundException - 등록이 끝난 MBean 안에 지정된 MBean 명이 없는 경우

IOException - MBean 서버와의 통신시에 발생한 문제

관련 항목:

removeNotificationListener(ObjectName, NotificationListener), removeNotificationListener(ObjectName, NotificationListener, NotificationFilter, Object)

addNotificationListener

void addNotificationListener(ObjectName  name,
                             ObjectName  listener,
                             NotificationFilter  filter,
                             Object  handback)
                             throws InstanceNotFoundException,

                                    IOException 

등록이 끝난 MBean에 리스너를 추가합니다.

MBean가 발행한 통지는 MBeanServer에 의해 리스너에게 전송 됩니다. 통지의 소스가 MBean 객체의 참조가 되어 있는 경우, MBean 서버는 이것을 MBean ObjectName 로 옮겨놓습니다. 그 외의 경우, 소스가 변경될 것은 없습니다.

통지를 받는 리스너 객체는 이 메서드의 호출시로 지정된 이름으로 등록된 리스너 객체입니다. 그 후는 등록하지 않아도 계속 통지를 받습니다.

파라미터:

name - 리스너가 추가되는 MBean 이름

listener - 등록이 끝난 MBean가 발행한 통지를 처리하는 리스너의 객체명

filter - 필터 객체. 필터가 null인 경우, 통지 처리전에 필터는 적용되지 않는

handback - 통지가 발행되었을 때 리스너에게 송신되는 컨텍스트

예외:

InstanceNotFoundException - 등록이 끝난 MBean 안에 통지 리스너 또는 통지 브로드 캐스터의 MBean 명이 없는 경우

RuntimeOperationsException - IllegalArgumentException를 감싸는 경우. listener에 의해 지정된 MBean가 존재하고 있어도, NotificationListener 인터페이스를 구현하고 있지 않는 경우

IOException - MBean 서버와의 통신시에 발생한 문제

관련 항목:

removeNotificationListener(ObjectName, ObjectName), removeNotificationListener(ObjectName, ObjectName, NotificationFilter, Object)

removeNotificationListener

void removeNotificationListener(ObjectName  name,
                                ObjectName  listener)
                                throws InstanceNotFoundException,

                                       ListenerNotFoundException,

                                       IOException 

등록이 끝난 MBean 로부터 리스너를 삭제합니다.

리스너가 다른 필터 또는 콜백에 의해 여러 차례 등록되었을 경우, 이 메서드는 이것들 모든 등록을 삭제합니다.

파라미터:

name - 리스너가 삭제되는 MBean 이름

listener - 삭제되는 리스너의 객체명

예외:

InstanceNotFoundException - 등록이 끝난 MBean 안에 지정된 MBean 명이 없는 경우

ListenerNotFoundException - 리스너가 MBean에 등록되지 않은 경우

IOException - MBean 서버와의 통신시에 발생한 문제

관련 항목:

addNotificationListener(ObjectName, ObjectName, NotificationFilter, Object)

removeNotificationListener

void removeNotificationListener(ObjectName  name,
                                ObjectName  listener,
                                NotificationFilter  filter,
                                Object  handback)
                                throws InstanceNotFoundException,

                                       ListenerNotFoundException,

                                       IOException 

등록이 끝난 MBean 로부터 리스너를 삭제합니다.

MBean는 지정된 listener, filter 및 handback 파라미터와 정확하게 일치하는 리스너를 가지고 있을 필요가 있습니다. 해당하는 리스너가 복수 존재하는 경우, 그 중의 1개 만이 삭제됩니다.

삭제되는 리스너내에서 null이 가리키는 경우, filter 및 handback 파라미터는 null이 됩니다.

파라미터:

name - 리스너가 삭제되는 MBean 이름

listener - 이전에 이 MBean에 추가된 리스너

filter - 리스너의 추가시로 지정된 필터

handback - 리스너의 추가시로 지정된 핸드백

예외:

InstanceNotFoundException - 등록이 끝난 MBean 안에 지정된 MBean 명이 없는 경우

ListenerNotFoundException - 리스너가 MBean에 등록되지 않은 경우, 또는 지정된 필터 및 핸드백으로 등록되지 않은 경우

IOException - MBean 서버와의 통신시에 발생한 문제

관련 항목:

addNotificationListener(ObjectName, ObjectName, NotificationFilter, Object)

removeNotificationListener

void removeNotificationListener(ObjectName  name,
                                NotificationListener  listener)
                                throws InstanceNotFoundException,

                                       ListenerNotFoundException,

                                       IOException 

등록이 끝난 MBean 로부터 리스너를 삭제합니다.

리스너가 다른 필터 또는 콜백에 의해 여러 차례 등록되었을 경우, 이 메서드는 이것들 모든 등록을 삭제합니다.

파라미터:

name - 리스너가 삭제되는 MBean 이름

listener - 삭제되는 리스너의 객체명

예외:

InstanceNotFoundException - 등록이 끝난 MBean 안에 지정된 MBean 명이 없는 경우

ListenerNotFoundException - 리스너가 MBean에 등록되지 않은 경우

IOException - MBean 서버와의 통신시에 발생한 문제

관련 항목:

addNotificationListener(ObjectName, NotificationListener, NotificationFilter, Object)

removeNotificationListener

void removeNotificationListener(ObjectName  name,
                                NotificationListener  listener,
                                NotificationFilter  filter,
                                Object  handback)
                                throws InstanceNotFoundException,

                                       ListenerNotFoundException,

                                       IOException 

등록이 끝난 MBean 로부터 리스너를 삭제합니다.

MBean는 지정된 listener, filter 및 handback 파라미터와 정확하게 일치하는 리스너를 가지고 있을 필요가 있습니다. 해당하는 리스너가 복수 존재하는 경우, 그 중의 1개 만이 삭제됩니다.

삭제되는 리스너내에서 null이 가리키는 경우, filter 및 handback 파라미터는 null이 됩니다.

파라미터:

name - 리스너가 삭제되는 MBean 이름

listener - 이전에 이 MBean에 추가된 리스너

filter - 리스너의 추가시로 지정된 필터

handback - 리스너의 추가시로 지정된 핸드백

예외:

InstanceNotFoundException - 등록이 끝난 MBean 안에 지정된 MBean 명이 없는 경우

ListenerNotFoundException - 리스너가 MBean에 등록되지 않은 경우, 또는 지정된 필터 및 핸드백으로 등록되지 않은 경우

IOException - MBean 서버와의 통신시에 발생한 문제

관련 항목:

addNotificationListener(ObjectName, NotificationListener, NotificationFilter, Object)

getMBeanInfo

MBeanInfo  getMBeanInfo(ObjectName  name)
                       throws InstanceNotFoundException,

                              IntrospectionException,

                              ReflectionException,

                              IOException 

이 메서드는 MBean가 관리용으로서 공개하고 있는 속성과 오퍼레이션을 검출합니다.

파라미터:

name - 분석 대상의 MBean 이름

반환값:

MBeanInfo 인스턴스. 이 MBean 모든 속성과 오퍼레이션의 취득을 허가한다

예외:

IntrospectionException - An exception occurred during introspection.

InstanceNotFoundException - 지정된 MBean가 발견되지 않았던 경우

ReflectionException - Dynamic MBean getMBeanInfo 메서드의 호출시에 예외가 발생했을 경우

IOException - MBean 서버와의 통신시에 발생한 문제

isInstanceOf

boolean isInstanceOf(ObjectName  name,
                     String  className)
                     throws InstanceNotFoundException,

                            IOException 

지정된 MBean가 지정된 클래스의 인스턴스인 경우는 true, 그렇지 않은 경우는 false를 리턴합니다.

name가 MBean를 지정하고 있지 않는 경우, 이 메서드는 InstanceNotFoundException를 Throw 합니다.

그 외의 경우,
X는 name로 지정된 MBean,
L는 X ClassLoader,
N는 X MBeanInfo 내의 클래스명이 됩니다.

N가 className와 동일한 경우, 결과는 true 입니다.

그 외의 경우, L가 N와 className 양쪽 모두를 정상적으로 로드해, 최초의 클래스로부터 2번째의 클래스를 할당할 수 있는인 경우, 결과는 true 입니다.

그 외의 경우, 결과는 false 입니다.

파라미터:

name - MBean ObjectName

className - 클래스의 이름

반환값:

상기의 규칙에 따라 지정된 MBean가 지정된 클래스의 인스턴스인 경우는 true, 그렇지 않은 경우는 false

예외:

InstanceNotFoundException - 지정된 MBean가 MBean 서버에 등록되지 않은 경우

IOException - MBean 서버와의 통신시에 발생한 문제