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 <ObjectInstance >	queryMBeans (ObjectName name, QueryExp query) MBean 서버에 의해 제어되는 MBean 를 가져옵니다.
Set <ObjectName >	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 interface) 메소드가 예외를 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 interface) 메소드가 예외를 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 interface) 메소드가 예외를 throw 했을 경우. Bean 는 등록되지 않는다

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 interface) 메소드가 예외를 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 interface) 메소드가 예외를 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 <ObjectInstance > 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 가 존재하지 않는 경우, 빈 상태(empty)의 리스트가 반환된다

예외:

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

queryNames

Set <ObjectName > 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 가 존재하지 않는 경우, 빈 상태(empty)의 리스트가 반환된다

예외:

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 의 취득 메소드에 의해 throw 되는 예외를 랩 하는 경우

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

ReflectionException - 설정 메소드의 호출시에 throw 되는 java.lang.Exception 를 랩 하는 경우

RuntimeOperationsException - java.lang.IllegalArgumentException 를 랩 하는 경우. 즉, 파라미터내의 객체명이 null 인지, 파라미터내의 속성이 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 의 설정 메소드에 의해 throw 되는 예외를 랩 하는 경우

ReflectionException - 설정 메소드의 호출시에 throw 되는 java.lang.Exception 를 랩 하는 경우

RuntimeOperationsException - java.lang.IllegalArgumentException 를 랩 하는 경우. 즉, 파라미터내의 객체명이 null 인지, 파라미터내의 속성이 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 의 호출 메소드에 의해 throw 되는 예외를 랩 하는 경우

ReflectionException - 메소드의 호출시에 throw 되는 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 - 삭제되는 청취자의 객체명

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 - 삭제되는 청취자

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 - 인트로스페크션중에 예외가 발생했을 경우

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 가 className 를 정상적으로 로드해, X 가 이 클래스의 인스턴스인 경우, 결과는 true 입니다.

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

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

파라미터:

name - MBean 의 ObjectName

className - 클래스의 이름

반환값:

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

예외:

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

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

관련 항목:

Class.isInstance(java.lang.Object)