javax.management
인터페이스 MBeanServer

모든 슈퍼 인터페이스:

MBeanServerConnection

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

MBeanServerForwarder

public interface MBeanServer
extends MBeanServerConnection 

에이전트측에서 MBean를 조작하기 위한 인터페이스입니다. 등록을 마친 MBean에 액세스하기 위한 메서드외, MBean를 작성, 등록, 삭제하기 위해서 필요한 메서드가 포함됩니다. 이것이, JMX 인프라스트럭쳐의 주요 컴퍼넌트가 됩니다.

보통, 사용자 코드는 이 인터페이스를 구현합니다만, MBeanServerFactory 클래스의 메서드를 이용해, 이 인터페이스를 구현하는 객체를 취득할 수 있습니다.

MBean 서버에 추가된 MBean는 모두 관리 대상이 됩니다. 이러한 MBean 속성과 오퍼레이션에는 MBean 서버에 접속된 커넥터 또는 어댑터 경유로 원격 접근 할 수 있습니다. JMX 준거의 MBean가 아닌 Java 객체는 MBean 서버에 등록할 수 없습니다.

MBean 서버에 MBean를 등록하거나 등록을 해제하거나 하면, MBeanServerNotification 통지가 발행됩니다. 객체를 MBeanServerNotifications 리스너로서 등록하려면, MBeanServerDelegate ObjectName을 지정해, MBean 서버 메서드 addNotificationListener를 호출합니다. 이 ObjectName는
JMImplementation:type=MBeanServerDelegate가 됩니다.

MBeanServerFactory 클래스의 createMBeanServer 또는 newMBeanServer 메서드로부터 취득된 객체는 그 메서드에 대해서 시큐러티 체크를 적용합니다.

시큐러티 매니저가 존재하지 않는 경우, 즉 System.getSecurityManager() 가 null인 경우, 체크는 행해지지 않습니다.

시큐러티 매니저가 존재하는 경우는 아래와 같은 체크를 합니다. className는 MBeanInfo.getClassName() 에 의해 타겟 MBean에 리턴된 캐릭터 라인입니다.

시큐러티 체크에 실패했을 경우, SecurityException을 발생시킵니다.

InstanceNotFoundException를 Throw 하는 메서드는 접근 권한의 내용에 관계없이, MBean가 존재하지 않는 경우에 이 예외를 Throw 합니다. 이것은 MBean가 존재하지 않으면, className도 존재하지 않기 때문입니다.

• invoke 메서드의 호출원래는 접근 권한으로서 MBeanPermission(className, operationName, name, "invoke")를 가지고 있을 필요가 있다

• getAttribute 메서드의 호출원래는 접근 권한으로서 MBeanPermission(className, attribute, name, "getAttribute")를 가지고 있을 필요가 있다

• getAttributes 메서드의 호출원래는 접근 권한으로서 MBeanPermission(className, null, name, "getAttribute")를 가지고 있을 필요가 있다. 호출원이 접근 권한 MBeanPermission(className, a, name, "getAttribute")를 가지고 있지 않은 경우, MBean 서버는 AttributeList 내의 속성 a가 리스트내에 존재하지 않다고 본다

• setAttribute 메서드의 호출원래는 접근 권한으로서 MBeanPermission(className, attrName, name, "setAttribute")를 가지고 있을 필요가 있다 (attrName는 attribute.getName() )

• setAttributes 메서드의 호출원래는 접근 권한으로서 MBeanPermission(className, null, name, "setAttributes")를 가지고 있을 필요가 있다. 호출원이 접근 권한 MBeanPermission(className, a, name, "setAttributes")를 가지고 있지 않은 경우, MBean 서버는 AttributeList 내의 속성 a가 리스트내에 존재하지 않다고 본다

• addNotificationListener 메서드의 호출원래는 접근 권한으로서 MBeanPermission(className, null, name, "addNotificationListener")를 가지고 있을 필요가 있다

• removeNotificationListener 메서드의 호출원래는 접근 권한으로서 MBeanPermission(className, null, name, "removeNotificationListener")를 가지고 있을 필요가 있다

• getMBeanInfo 메서드의 호출원래는 접근 권한으로서 MBeanPermission(className, null, name, "getMBeanInfo")를 가지고 있을 필요가 있다

• getObjectInstance 메서드의 호출원래는 접근 권한으로서 MBeanPermission(className, null, name, "getObjectInstance")를 가지고 있을 필요가 있다

• isInstanceOf 메서드의 호출원래는 접근 권한으로서 MBeanPermission(className, null, name, "isInstanceOf")를 가지고 있을 필요가 있다

• queryMBeans 메서드의 호출원래는 접근 권한으로서 MBeanPermission(null, null, name, "queryMBeans")를 가지고 있을 필요가 있다. 호출원이 접근 권한 MBeanPermission(className, null, name, "queryMBeans")를 가지고 있지 않은 경우, name에 일치하는 MBean 서버는 MBean가 존재하지 않다고 본다

  특정의 쿼리요소는 MBean 서버상에서 오퍼레이션을 실행한다. 호출원이 지정된 MBean를 사용하기 위해서 필요한 접근 권한을 가지고 있지 않은 경우, 이 MBean는 쿼리의 결과로부터 제외된다. 영향을 받는 표준 쿼리요소는 Query.attr(String), Query.attr(String, String) 및 Query.classattr()

• queryNames 메서드의 경우, queryMBeans와 같은 체크를 한다. 다만, MBeanPermission 객체에서는 "queryMBeans" 대신에 "queryNames"가 사용된다. 접근 권한 "queryMBeans"에는 대응하는 접근 권한 "queryNames"는 포함되지 않는다

• getDomains 메서드의 호출원래는 접근 권한으로서 MBeanPermission(null, null, name, "getDomains")를 가지고 있을 필요가 있다. 호출원이 접근 권한 MBeanPermission(null, null, new ObjectName("d:x=x"), "getDomains")를 가지고 있지 않은 경우, 리턴된 배열로부터 도메인 d가 제외된다 (x=x는 ObjectName 생성자 전용의 임의의 key=value 페어)

• getClassLoader 메서드의 호출원래는 접근 권한으로서 MBeanPermission(className, null, loaderName, "getClassLoader")를 가지고 있을 필요가 있다

• getClassLoaderFor 메서드의 호출원래는 접근 권한으로서 MBeanPermission(className, null, mbeanName, "getClassLoaderFor")를 가지고 있을 필요가 있다

• getClassLoaderRepository 메서드의 호출원래는 접근 권한으로서 MBeanPermission(null, null, null, "getClassLoaderRepository")를 가지고 있을 필요가 있다

• 추천 되지 않는 deserialize 메서드는 이러한 대체가 되는 메서드와 같은 접근 권한을 필요로 한다

• instantiate 메서드의 호출원래는 접근 권한으로서 MBeanPermission(className, null, null, "instantiate")를 가지고 있을 필요가 있다

• registerMBean 메서드의 호출원래는 접근 권한으로서 MBeanPermission(className, null, name, "registerMBean")를 가지고 있을 필요가 있는 (className는 MBeanInfo.getClassName() 가 이 클래스의 객체에 대해서 돌려주는 캐릭터 라인)

  MBeanPermission 체크에 성공했을 경우, MBean 클래스의 타당성 검사를 한다. 구체적으로는 ProtectionDomain에 MBeanTrustPermission("register") 가 포함될지 어떨지가 체크된다

  name인수가 null인 경우, MBeanRegistration.preRegister 에 의해 리턴된 ObjectName에 의해 다른 MBeanPermission 체크를 한다

• createMBean 메서드의 호출원래는 동등의 instantiate 및 registerMBean가 필요로 하는 접근 권한을 가지고 있을 필요가 있다

• unregisterMBean 메서드의 호출원래는 접근 권한으로서 MBeanPermission(className, null, name, "unregisterMBean")를 가지고 있을 필요가 있다

도입된 버전 :

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 서버에 등록합니다.
ObjectInputStream	deserialize (ObjectName name, byte[] data) 추천하지 않습니다. getClassLoaderFor를 사용해, 직렬화 복원에 사용하는 적절한 클래스 로더를 취득합니다.
ObjectInputStream	deserialize (String className, byte[] data) 추천하지 않습니다. getClassLoaderRepository()를 사용해 클래스 로더 리포지터리(repository)를 취득해, 이것을 사용해 직렬화 복원을 실시합니다.
ObjectInputStream	deserialize (String className, ObjectName loaderName, byte[] data) 추천하지 않습니다. getClassLoader를 사용해, 직렬화 복원에 사용하는 클래스 로더를 취득합니다.
Object	getAttribute (ObjectName name, String attribute) 지정된 MBean 특정의 속성의 값을 취득합니다.
AttributeList	getAttributes (ObjectName name, String [] attributes) 지정된 MBean 복수의 속성의 값을 취득합니다.
ClassLoader	getClassLoader (ObjectName loaderName) 지정된 ClassLoader를 리턴합니다.
ClassLoader	getClassLoaderFor (ObjectName mbeanName) 지정된 MBean 클래스의 로드에 사용된 ClassLoader를 리턴합니다.
ClassLoaderRepository	getClassLoaderRepository () 이 MBeanServer ClassLoaderRepository를 리턴합니다.
String	getDefaultDomain () MBean 지정에 사용하는 디폴트의 도메인을 리턴합니다.
String []	getDomains () MBean가 현재 등록되어 있는 도메인의 리스트를 리턴합니다.
Integer	getMBeanCount () MBean 서버에 등록되어 있는 MBean 수를 리턴합니다.
MBeanInfo	getMBeanInfo (ObjectName name) 이 메서드는 MBean가 관리용으로서 공개하고 있는 속성과 오퍼레이션을 검출합니다.
ObjectInstance	getObjectInstance (ObjectName name) MBean에 등록된 MBean ObjectInstance를 취득합니다.
Object	instantiate (String className) MBean 서버클래스 로더 리포지터리(repository) 내에 등록된 모든 클래스 로더의 리스트를 사용해, 객체를 인스턴스화합니다.
Object	instantiate (String className, Object [] params, String [] signature) MBean 서버클래스 로더 리포지터리(repository) 내에 등록된 모든 클래스 로더의 리스트를 사용해, 객체를 인스턴스화합니다.
Object	instantiate (String className, ObjectName loaderName) ObjectName 로 지정된 클래스 로더를 사용해, 객체를 인스턴스화합니다.
Object	instantiate (String className, ObjectName loaderName, Object [] params, String [] signature) 객체를 인스턴스화합니다.
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 이름을 취득합니다.
ObjectInstance	registerMBean (Object object, ObjectName name) 기존의 객체를 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 

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

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

정의:

인터페이스 MBeanServerConnection 내의 createMBean

파라미터:

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가 지정되어 있지 않은 경우

createMBean

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

                                  InstanceAlreadyExistsException,

                                  MBeanRegistrationException,

                                  MBeanException,

                                  NotCompliantMBeanException,

                                  InstanceNotFoundException 

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

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

정의:

인터페이스 MBeanServerConnection 내의 createMBean

파라미터:

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가 지정되어 있지 않은 경우

createMBean

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

                                  InstanceAlreadyExistsException,

                                  MBeanRegistrationException,

                                  MBeanException,

                                  NotCompliantMBeanException 

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

정의:

인터페이스 MBeanServerConnection 내의 createMBean

파라미터:

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가 지정되어 있지 않은 경우

createMBean

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

                                  InstanceAlreadyExistsException,

                                  MBeanRegistrationException,

                                  MBeanException,

                                  NotCompliantMBeanException,

                                  InstanceNotFoundException 

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

정의:

인터페이스 MBeanServerConnection 내의 createMBean

파라미터:

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가 지정되어 있지 않은 경우

registerMBean

ObjectInstance  registerMBean(Object  object,
                             ObjectName  name)
                             throws InstanceAlreadyExistsException,

                                    MBeanRegistrationException,

                                    NotCompliantMBeanException 

기존의 객체를 MBean 로서 MBean 서버에 등록합니다. 객체명이 null인 경우, MBean는 MBeanRegistration 인터페이스를 구현해, preRegister 메서드로부터 리턴된 독자적인 이름을 사용할 필요가 있습니다.

파라미터:

object - MBean 로서 등록되는 MBean

name - MBean 객체명. null도 가능

반환값:

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

예외:

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

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

NotCompliantMBeanException - 이 객체가 JMX 준거의 MBean가 아닌 경우

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

unregisterMBean

void unregisterMBean(ObjectName  name)
                     throws InstanceNotFoundException,

                            MBeanRegistrationException 

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

정의:

인터페이스 MBeanServerConnection 내의 unregisterMBean

파라미터:

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

예외:

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

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

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

getObjectInstance

ObjectInstance  getObjectInstance(ObjectName  name)
                                 throws InstanceNotFoundException 

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

정의:

인터페이스 MBeanServerConnection 내의 getObjectInstance

파라미터:

name - MBean 객체명

반환값:

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

예외:

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

queryMBeans

Set  queryMBeans(ObjectName  name,
                QueryExp  query)

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

정의:

인터페이스 MBeanServerConnection 내의 queryMBeans

파라미터:

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

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

반환값:

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

queryNames

Set  queryNames(ObjectName  name,
               QueryExp  query)

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

정의:

인터페이스 MBeanServerConnection 내의 queryNames

파라미터:

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

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

반환값:

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

isRegistered

boolean isRegistered(ObjectName  name)

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

정의:

인터페이스 MBeanServerConnection 내의 isRegistered

파라미터:

name - 체크 대상의 MBean 객체명

반환값:

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

예외:

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

getMBeanCount

Integer  getMBeanCount()

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

정의:

인터페이스 MBeanServerConnection 내의 getMBeanCount

반환값:

등록이 끝난 MBean 수. Integer에 랩 된다. 호출원의 접근 권한이 제한되고 있는 경우, 이 값은 호출원으로부터 액세스 할 수 있는 MBean 수부터 커질 가능성이 있다

getAttribute

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

                           AttributeNotFoundException,

                           InstanceNotFoundException,

                           ReflectionException 

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

정의:

인터페이스 MBeanServerConnection 내의 getAttribute

파라미터:

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

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

반환값:

취득되는 속성의 값

예외:

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

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

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

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

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

관련 항목:

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

getAttributes

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

                                   ReflectionException 

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

정의:

인터페이스 MBeanServerConnection 내의 getAttributes

파라미터:

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

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

반환값:

취득되는 속성의 리스트

예외:

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

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

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

관련 항목:

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

setAttribute

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

                         AttributeNotFoundException,

                         InvalidAttributeValueException,

                         MBeanException,

                         ReflectionException 

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

정의:

인터페이스 MBeanServerConnection 내의 setAttribute

파라미터:

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

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

예외:

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

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

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

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

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

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

관련 항목:

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

setAttributes

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

                                   ReflectionException 

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

정의:

인터페이스 MBeanServerConnection 내의 setAttributes

파라미터:

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

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

반환값:

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

예외:

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

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

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

관련 항목:

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

invoke

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

                     MBeanException,

                     ReflectionException 

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

정의:

인터페이스 MBeanServerConnection 내의 invoke

파라미터:

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

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

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

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

반환값:

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

예외:

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

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

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

getDefaultDomain

String  getDefaultDomain()

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

정의:

인터페이스 MBeanServerConnection 내의 getDefaultDomain

반환값:

디폴트의 도메인

getDomains

String [] getDomains()

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

정의:

인터페이스 MBeanServerConnection 내의 getDomains

반환값:

도메인의 리스트

addNotificationListener

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

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

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

정의:

인터페이스 MBeanServerConnection 내의 addNotificationListener

파라미터:

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

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

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

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

예외:

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

관련 항목:

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

addNotificationListener

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

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

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

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

정의:

인터페이스 MBeanServerConnection 내의 addNotificationListener

파라미터:

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

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

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

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

예외:

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

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

관련 항목:

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

removeNotificationListener

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

                                       ListenerNotFoundException 

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

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

정의:

인터페이스 MBeanServerConnection 내의 removeNotificationListener

파라미터:

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

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

예외:

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

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

관련 항목:

addNotificationListener(ObjectName, ObjectName, NotificationFilter, Object)

removeNotificationListener

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

                                       ListenerNotFoundException 

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

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

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

정의:

인터페이스 MBeanServerConnection 내의 removeNotificationListener

파라미터:

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

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

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

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

예외:

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

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

관련 항목:

addNotificationListener(ObjectName, ObjectName, NotificationFilter, Object)

removeNotificationListener

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

                                       ListenerNotFoundException 

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

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

정의:

인터페이스 MBeanServerConnection 내의 removeNotificationListener

파라미터:

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

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

예외:

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

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

관련 항목:

addNotificationListener(ObjectName, NotificationListener, NotificationFilter, Object)

removeNotificationListener

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

                                       ListenerNotFoundException 

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

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

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

정의:

인터페이스 MBeanServerConnection 내의 removeNotificationListener

파라미터:

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

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

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

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

예외:

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

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

관련 항목:

addNotificationListener(ObjectName, NotificationListener, NotificationFilter, Object)

getMBeanInfo

MBeanInfo  getMBeanInfo(ObjectName  name)
                       throws InstanceNotFoundException,

                              IntrospectionException,

                              ReflectionException 

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

정의:

인터페이스 MBeanServerConnection 내의 getMBeanInfo

파라미터:

name - 분석 대상의 MBean 이름

반환값:

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

예외:

IntrospectionException - 인트로스페크션중에 예외가 발생했을 경우

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

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

isInstanceOf

boolean isInstanceOf(ObjectName  name,
                     String  className)
                     throws InstanceNotFoundException 

지정된 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 입니다.

정의:

인터페이스 MBeanServerConnection 내의 isInstanceOf

파라미터:

name - MBean ObjectName

className - 클래스의 이름

반환값:

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

예외:

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

관련 항목:

Class.isAssignableFrom(Class)

instantiate

Object  instantiate(String  className)
                   throws ReflectionException,

                          MBeanException 

MBean 서버클래스 로더 리포지터리(repository) 내에 등록된 모든 클래스 로더의 리스트를 사용해, 객체를 인스턴스화합니다. 객체의 클래스는 public 생성자를 가지고 있지 않으면 안됩니다. 이 메서드는 새롭게 작성된 객체의 참조를 리턴합니다. 새롭게 작성된 객체는 MBean 서버에 등록되어 있지 않습니다.

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

파라미터:

className - 인스턴스화하는 객체의 클래스명

반환값:

새롭고 인스턴스화 된 객체

예외:

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

MBeanException - 객체의 생성자가 예외를 Throw 했을 경우

RuntimeOperationsException - java.lang.IllegalArgumentException를 감싸는 경우. 즉, 파라미터에게 건네지는 className가 null인 경우

instantiate

Object  instantiate(String  className,
                   ObjectName  loaderName)
                   throws ReflectionException,

                          MBeanException,

                          InstanceNotFoundException 

ObjectName 로 지정된 클래스 로더를 사용해, 객체를 인스턴스화합니다. 로더명이 null인 경우, MBean 서버의 로드에 사용된 ClassLoader가 사용됩니다. 객체의 클래스는 public 생성자를 가지고 있지 않으면 안됩니다. 이 메서드는 새롭게 작성된 객체의 참조를 리턴합니다. 새롭게 작성된 객체는 MBean 서버에 등록되어 있지 않습니다.

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

파라미터:

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

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

반환값:

새롭고 인스턴스화 된 객체

예외:

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

MBeanException - 객체의 생성자가 예외를 Throw 했을 경우

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

RuntimeOperationsException - java.lang.IllegalArgumentException를 감싸는 경우. 즉, 파라미터에게 건네지는 className가 null인 경우

instantiate

Object  instantiate(String  className,
                   Object [] params,
                   String [] signature)
                   throws ReflectionException,

                          MBeanException 

MBean 서버클래스 로더 리포지터리(repository) 내에 등록된 모든 클래스 로더의 리스트를 사용해, 객체를 인스턴스화합니다. 객체의 클래스는 public 생성자를 가지고 있지 않으면 안됩니다. 이 호출은 새롭게 작성된 객체의 참조를 리턴합니다. 새롭게 작성된 객체는 MBean 서버에 등록되어 있지 않습니다.

파라미터:

className - 인스턴스화하는 객체의 클래스명

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

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

반환값:

새롭고 인스턴스화 된 객체

예외:

ReflectionException - 객체의 생성자 호출시에 발행되는 java.lang.ClassNotFoundException 또는 java.lang.Exception을 감싸는 경우

MBeanException - 객체의 생성자가 예외를 Throw 했을 경우

RuntimeOperationsException - java.lang.IllegalArgumentException를 감싸는 경우. 즉, 파라미터에게 건네지는 className가 null인 경우

instantiate

Object  instantiate(String  className,
                   ObjectName  loaderName,
                   Object [] params,
                   String [] signature)
                   throws ReflectionException,

                          MBeanException,

                          InstanceNotFoundException 

객체를 인스턴스화합니다. 사용하는 클래스 로더는 그 객체명으로 식별됩니다. 로더의 객체명이 null인 경우, MBean 서버의 로드에 사용된 ClassLoader가 사용됩니다. 객체의 클래스는 public 생성자를 가지고 있지 않으면 안됩니다. 이 호출은 새롭게 작성된 객체의 참조를 리턴합니다. 새롭게 작성된 객체는 MBean 서버에 등록되어 있지 않습니다.

파라미터:

className - 인스턴스화하는 객체의 클래스명

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

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

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

반환값:

새롭고 인스턴스화 된 객체

예외:

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

MBeanException - 객체의 생성자가 예외를 Throw 했을 경우

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

RuntimeOperationsException - java.lang.IllegalArgumentException를 감싸는 경우. 즉, 파라미터에게 건네지는 className가 null인 경우

deserialize

@Deprecated 
ObjectInputStream  deserialize(ObjectName  name,
                                         byte[] data)
                              throws InstanceNotFoundException,

                                     OperationsException 

추천하지 않습니다. getClassLoaderFor를 사용해, 직렬화 복원에 사용하는 적절한 클래스 로더를 취득합니다.

MBean 클래스 로더의 컨텍스트 으로 바이트 배열을 직렬화 복원합니다.

파라미터:

name - MBean 이름. 이 MBean 클래스 로더를 사용해, 직렬화 복원을 하는

data - 직렬화 복원의 대상이 되는 바이트 배열

반환값:

직렬화 복원된 객체 스트림

예외:

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

OperationsException - 입출력에 관련한 예외의 어떤 것인가가 발생했을 경우

deserialize

@Deprecated 
ObjectInputStream  deserialize(String  className,
                                         byte[] data)
                              throws OperationsException,

                                     ReflectionException 

추천하지 않습니다. getClassLoaderRepository()를 사용해 클래스 로더 리포지터리(repository)를 취득해, 이것을 사용해 직렬화 복원을 실시합니다.

지정된 MBean 클래스 로더의 컨텍스트 으로 바이트 배열의 직렬화 복원을 실시합니다. 클래스 로더를 검색하려면, 클래스 로더 리포지터리(repository)를 사용해 className 클래스를 로드합니다. 이 클래스의 클래스 로더가 사용됩니다.

파라미터:

className - 클래스의 이름. 이 클래스의 클래스 로더를 사용해, 직렬화 복원을 하는

data - 직렬화 복원의 대상이 되는 바이트 배열

반환값:

직렬화 복원된 객체 스트림

예외:

OperationsException - 입출력에 관련한 예외의 어떤 것인가가 발생했을 경우

ReflectionException - 지정된 클래스가 클래스 로더 리포지터리(repository)에 로드 되지 않는 경우

deserialize

@Deprecated 
ObjectInputStream  deserialize(String  className,
                                         ObjectName  loaderName,
                                         byte[] data)
                              throws InstanceNotFoundException,

                                     OperationsException,

                                     ReflectionException 

추천하지 않습니다. getClassLoader를 사용해, 직렬화 복원에 사용하는 클래스 로더를 취득합니다.

지정된 MBean 클래스 로더의 컨텍스트 으로 바이트 배열의 직렬화 복원을 실시합니다. 이 클래스 로더는 className 라는 이름으로 클래스를 로드한 클래스 로더입니다. 지정된 클래스의 로드에 사용된 클래스 로더의 이름이 사용됩니다. null인 경우, MBean 서버의 클래스 로더가 사용됩니다.

파라미터:

className - 클래스의 이름. 이 클래스의 클래스 로더를 사용해, 직렬화 복원을 하는

data - 직렬화 복원의 대상이 되는 바이트 배열

loaderName - 지정된 클래스의 로드에 사용되는 클래스 로더의 이름. null인 경우, MBean 서버의 클래스 로더가 사용된다

반환값:

직렬화 복원된 객체 스트림

예외:

InstanceNotFoundException - 지정된 클래스 로더 MBean가 발견되지 않는 경우

OperationsException - 입출력에 관련한 예외의 어떤 것인가가 발생했을 경우

ReflectionException - 지정된 클래스가 지정된 클래스 로더에 로드 되지 않는 경우

getClassLoaderFor

ClassLoader  getClassLoaderFor(ObjectName  mbeanName)
                              throws InstanceNotFoundException 

지정된 MBean 클래스의 로드에 사용된 ClassLoader를 리턴합니다.

파라미터:

mbeanName - MBean ObjectName

반환값:

이 MBean용의 ClassLoader. MBean 실제의 ClassLoader가 l 로 반환값이 r인 경우, 다음의 몇개의 조건이 성립한다

• r가 l와 동일, 또는
• r. loadClass(s) 결과가 임의의 캐릭터 라인 s l. loadClass(s)에 일치

즉, ClassLoader는 시큐러티 또는 그 외의 이유로써 다른 ClassLoader에 랩 될 가능성이 있다고 하는 것입니다.

예외:

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

getClassLoader

ClassLoader  getClassLoader(ObjectName  loaderName)
                           throws InstanceNotFoundException 

지정된 ClassLoader를 리턴합니다.

파라미터:

loaderName - ClassLoader ObjectName. null인 경우, MBean 서버 고유의 ClassLoader가 리턴된다

반환값:

지정의 ClassLoader. 그 이름의 실제의 ClassLoader가 l 로 반환값이 r인 경우, 다음의 몇개의 조건이 성립한다

• r가 l와 동일, 또는
• r. loadClass(s) 결과가 임의의 캐릭터 라인 s l. loadClass(s)에 일치

즉, ClassLoader는 시큐러티 또는 그 외의 이유로써 다른 ClassLoader에 랩 될 가능성이 있다고 하는 것입니다.

예외:

InstanceNotFoundException - 지정된 ClassLoader가 발견되지 않는 경우

getClassLoaderRepository

ClassLoaderRepository  getClassLoaderRepository()

이 MBeanServer ClassLoaderRepository를 리턴합니다.

반환값:

이 MBeanServer ClassLoaderRepository