javax.management.remote.rmi
인터페이스 RMIConnection

모든 슈퍼 인터페이스:

Remote

알려진 구현 클래스 목록:

RMIConnectionImpl, RMIConnectionImpl_Stub

public interface RMIConnection
extends Remote 

클라이언트로부터 서버측의 MBeanServer 구현에 MBeanServer 요구를 송신하기 위해서 사용되는 RMI 객체입니다. RMI 커넥터에 접속된 리모트 클라이언트 마다, 이 인터페이스를 구현하는 Remote 객체가 1개 씩 제공됩니다.

사용자 코드는 반드시 이 인터페이스를 참조하지 않습니다. 이 인터페이스는 API 구현이 다른 경우도 상호 운용할 수 있도록, 공개 API 일부로서 지정되고 있습니다.

클라이언트 파라미터를, 서버측의 올바른 클래스 로더로 직렬화 복원하기 때문에 메서드 호출에 사용되는 것 같은 클라이언트 파라미터는 MarshalledObject에 랩 됩니다. 이 인터페이스의 구현은 우선 오퍼레이션과 그 타겟의 적절한 클래스 로더를 취득하고 나서, 이 클래스 로더를 사용해 정렬화 파라미터를 직렬화 복원합니다. 특별히 기재되지 않은 한, 파라미터 MarshalledObject 또는 MarshalledObject[]는 null 외로 합니다. null인 경우, 파라미터의 동작은 부정이 됩니다.

클래스의 로드에 관한자세한 내용은 이 문서를 보충하는 부속의 「JMX Remote API」를 참조하십시오. 이 문서는 이 Javadoc 사양과 같은 장소에 PDF 문서로서 포함되어 있습니다.

도입된 버전 :

1.5

메서드 개요

void	addNotificationListener (ObjectName name, ObjectName listener, MarshalledObject filter, MarshalledObject handback, Subject delegationSubject) MBeanServerConnection.addNotificationListener(ObjectName, ObjectName, NotificationFilter, Object) 메서드를 처리합니다.
Integer []	addNotificationListeners (ObjectName [] names, MarshalledObject [] filters, Subject [] delegationSubjects) MBeanServerConnection.addNotificationListener(ObjectName, NotificationListener, NotificationFilter, Object) 메서드를 처리합니다.
void	close () 이 접속을 종료합니다.
ObjectInstance	createMBean (String className, ObjectName name, MarshalledObject params, String [] signature, Subject delegationSubject) MBeanServerConnection.createMBean(String, ObjectName, Object[], String[]) 메서드를 처리합니다.
ObjectInstance	createMBean (String className, ObjectName name, ObjectName loaderName, MarshalledObject params, String [] signature, Subject delegationSubject) MBeanServerConnection.createMBean(String, ObjectName, ObjectName, Object[], String[]) 메서드를 처리합니다.
ObjectInstance	createMBean (String className, ObjectName name, ObjectName loaderName, Subject delegationSubject) MBeanServerConnection.createMBean(String, ObjectName, ObjectName) 메서드를 처리합니다.
ObjectInstance	createMBean (String className, ObjectName name, Subject delegationSubject) MBeanServerConnection.createMBean(String, ObjectName) 메서드를 처리합니다.
NotificationResult	fetchNotifications (long clientSequenceNumber, int maxNotifications, long timeout) 커넥터 서버로부터 통지를 수신합니다.
Object	getAttribute (ObjectName name, String attribute, Subject delegationSubject) MBeanServerConnection.getAttribute(ObjectName, String) 메서드를 처리합니다.
AttributeList	getAttributes (ObjectName name, String [] attributes, Subject delegationSubject) MBeanServerConnection.getAttributes(ObjectName, String[]) 메서드를 처리합니다.
String	getConnectionId () 접속 ID를 리턴합니다.
String	getDefaultDomain (Subject delegationSubject) MBeanServerConnection.getDefaultDomain() 메서드를 처리합니다.
String []	getDomains (Subject delegationSubject) MBeanServerConnection.getDomains() 메서드를 처리합니다.
Integer	getMBeanCount (Subject delegationSubject) MBeanServerConnection.getMBeanCount() 메서드를 처리합니다.
MBeanInfo	getMBeanInfo (ObjectName name, Subject delegationSubject) MBeanServerConnection.getMBeanInfo(ObjectName) 메서드를 처리합니다.
ObjectInstance	getObjectInstance (ObjectName name, Subject delegationSubject) MBeanServerConnection.getObjectInstance(ObjectName) 메서드를 처리합니다.
Object	invoke (ObjectName name, String operationName, MarshalledObject params, String [] signature, Subject delegationSubject) MBeanServerConnection.invoke(ObjectName, String, Object[], String[]) 메서드를 처리합니다.
boolean	isInstanceOf (ObjectName name, String className, Subject delegationSubject) MBeanServerConnection.isInstanceOf(ObjectName, String) 메서드를 처리합니다.
boolean	isRegistered (ObjectName name, Subject delegationSubject) MBeanServerConnection.isRegistered(ObjectName) 메서드를 처리합니다.
Set <ObjectInstance >	queryMBeans (ObjectName name, MarshalledObject query, Subject delegationSubject) MBeanServerConnection.queryMBeans(ObjectName, QueryExp) 메서드를 처리합니다.
Set <ObjectName >	queryNames (ObjectName name, MarshalledObject query, Subject delegationSubject) MBeanServerConnection.queryNames(ObjectName, QueryExp) 메서드를 처리합니다.
void	removeNotificationListener (ObjectName name, ObjectName listener, MarshalledObject filter, MarshalledObject handback, Subject delegationSubject) MBeanServerConnection.removeNotificationListener(ObjectName, ObjectName, NotificationFilter, Object) 메서드를 처리합니다.
void	removeNotificationListener (ObjectName name, ObjectName listener, Subject delegationSubject) MBeanServerConnection.removeNotificationListener(ObjectName, ObjectName) 메서드를 처리합니다.
void	removeNotificationListeners (ObjectName name, Integer [] listenerIDs, Subject delegationSubject) removeNotificationListener(ObjectName, NotificationListener) 및 removeNotificationListener(ObjectName, NotificationListener, NotificationFilter, Object) 메서드를 처리합니다.
void	setAttribute (ObjectName name, MarshalledObject attribute, Subject delegationSubject) MBeanServerConnection.setAttribute(ObjectName, Attribute) 메서드를 처리합니다.
AttributeList	setAttributes (ObjectName name, MarshalledObject attributes, Subject delegationSubject) MBeanServerConnection.setAttributes(ObjectName, AttributeList) 메서드를 처리합니다.
void	unregisterMBean (ObjectName name, Subject delegationSubject) MBeanServerConnection.unregisterMBean(ObjectName) 메서드를 처리합니다.

메서드의 상세

getConnectionId

String  getConnectionId()
                       throws IOException 

접속 ID를 리턴합니다. 이 캐릭터 라인은 지정의 RMI 커넥터 서버에의 유효한 접속 마다 다릅니다.

반환값:

접속 ID

예외:

IOException - 일반적인 통신 예외가 발생했을 경우

관련 항목:

RMIConnector.connect

close

void close()
           throws IOException 

이 접속을 종료합니다. 이 메서드의 종료시에는 더 이상 리모트 호출의 실패가 일어나지 않게, 이 인터페이스를 구현하는 RMI 객체가 안 export 됩니다.

예외:

IOException - 접속을 종료할 수 없었던 경우, Remote 객체를 안 export 할 수 없었던 경우, 또는 리모트 종료 요구의 전송시에 통신 장해가 발생했을 경우

createMBean

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

                                  InstanceAlreadyExistsException,

                                  MBeanRegistrationException,

                                  MBeanException,

                                  NotCompliantMBeanException,

                                  IOException 

MBeanServerConnection.createMBean(String, ObjectName) 메서드를 처리합니다.

파라미터:

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

name - MBean 객체명. null도 가능

delegationSubject - 위양 주체를 포함한 Subject. 인증 주체가 사용되고 있는 경우는 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가 지정되어 있지 않다

SecurityException - 클라이언트 또는 위양 된 Subject 가 이 오퍼레이션의 실행권을 가지지 않는 경우

IOException - 일반적인 통신 예외가 발생했을 경우

createMBean

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

                                  InstanceAlreadyExistsException,

                                  MBeanRegistrationException,

                                  MBeanException,

                                  NotCompliantMBeanException,

                                  InstanceNotFoundException,

                                  IOException 

MBeanServerConnection.createMBean(String, ObjectName, ObjectName) 메서드를 처리합니다.

파라미터:

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

name - MBean 객체명. null도 가능

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

delegationSubject - 위양 주체를 포함한 Subject. 인증 주체가 사용되고 있는 경우는 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가 아니다

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

RuntimeOperationsException - java.lang.IllegalArgumentException을 랩 한다. 즉, 파라미터에게 건네지는 className가 null 인지, 파라미터에게 건네지는 ObjectName 이 패턴인지, MBean에 ObjectName가 지정되어 있지 않다

SecurityException - 클라이언트 또는 위양 된 Subject 가 이 오퍼레이션의 실행권을 가지지 않는 경우

IOException - 일반적인 통신 예외가 발생했을 경우

createMBean

ObjectInstance  createMBean(String  className,
                           ObjectName  name,
                           MarshalledObject  params,
                           String [] signature,
                           Subject  delegationSubject)
                           throws ReflectionException,

                                  InstanceAlreadyExistsException,

                                  MBeanRegistrationException,

                                  MBeanException,

                                  NotCompliantMBeanException,

                                  IOException 

MBeanServerConnection.createMBean(String, ObjectName, Object[], String[]) 메서드를 처리합니다. Object[] 파라미터는 MarshalledObject에 랩 되고 있습니다.

파라미터:

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

name - MBean 객체명. null도 가능

params - 생성자 파라미터를 포함한 배열. 이 배열은 불려 간 뒤, MarshalledObject에 캡슐화된다. 캡슐화된 배열이 null인 경우, 빈 배열과 같은 의미가 되는

signature - 생성자 시그니쳐를 포함한 배열. 이 배열이 불려 간다. null인 경우, 빈 배열과 같은 의미가 되는

delegationSubject - 위양 주체를 포함한 Subject. 인증 주체가 사용되고 있는 경우는 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가 지정되어 있지 않다

SecurityException - 클라이언트 또는 위양 된 Subject 가 이 오퍼레이션의 실행권을 가지지 않는 경우

IOException - 일반적인 통신 예외가 발생했을 경우

createMBean

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

                                  InstanceAlreadyExistsException,

                                  MBeanRegistrationException,

                                  MBeanException,

                                  NotCompliantMBeanException,

                                  InstanceNotFoundException,

                                  IOException 

MBeanServerConnection.createMBean(String, ObjectName, ObjectName, Object[], String[]) 메서드를 처리합니다. Object[] 파라미터는 MarshalledObject에 랩 되고 있습니다.

파라미터:

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

name - MBean 객체명. null도 가능

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

params - 생성자 파라미터를 포함한 배열. 이 배열은 불려 간 뒤, MarshalledObject에 캡슐화된다. 캡슐화된 배열이 null인 경우, 빈 배열과 같은 의미가 되는

signature - 생성자 시그니쳐를 포함한 배열. 이 배열이 불려 간다. null인 경우, 빈 배열과 같은 의미가 되는

delegationSubject - 위양 주체를 포함한 Subject. 인증 주체가 사용되고 있는 경우는 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가 아니다

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

RuntimeOperationsException - java.lang.IllegalArgumentException을 랩 한다. 즉, 파라미터에게 건네지는 className가 null 인지, 파라미터에게 건네지는 ObjectName에 패턴이 포함되어 있는지, MBean에 ObjectName가 지정되어 있지 않다

SecurityException - 클라이언트 또는 위양 된 Subject 가 이 오퍼레이션의 실행권을 가지지 않는 경우

IOException - 일반적인 통신 예외가 발생했을 경우

unregisterMBean

void unregisterMBean(ObjectName  name,
                     Subject  delegationSubject)
                     throws InstanceNotFoundException,

                            MBeanRegistrationException,

                            IOException 

MBeanServerConnection.unregisterMBean(ObjectName) 메서드를 처리합니다.

파라미터:

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

delegationSubject - 위양 주체를 포함한 Subject. 인증 주체가 사용되고 있는 경우는 null

예외:

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

MBeanRegistrationException - MBean preDeregister (MBeanRegistration interface) 메서드가 예외를 Throw 했다

RuntimeOperationsException - java.lang.IllegalArgumentException을 랩 한다. 즉, 파라미터내의 객체명이 null 인지, 등록 해제하려고 하고 있는 MBean가 MBeanServerDelegate 이다

SecurityException - 클라이언트 또는 위양 된 Subject 가 이 오퍼레이션의 실행권을 가지지 않는 경우

IOException - 일반적인 통신 예외가 발생했을 경우

getObjectInstance

ObjectInstance  getObjectInstance(ObjectName  name,
                                 Subject  delegationSubject)
                                 throws InstanceNotFoundException,

                                        IOException 

MBeanServerConnection.getObjectInstance(ObjectName) 메서드를 처리합니다.

파라미터:

name - MBean 객체명

delegationSubject - 위양 주체를 포함한 Subject. 인증 주체가 사용되고 있는 경우는 null

반환값:

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

예외:

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

RuntimeOperationsException - java.lang.IllegalArgumentException을 랩 한다. 즉, 파라미터내의 객체명이 null

SecurityException - 클라이언트 또는 위양 된 Subject 가 이 오퍼레이션의 실행권을 가지지 않는 경우

IOException - 일반적인 통신 예외가 발생했을 경우

queryMBeans

Set <ObjectInstance > queryMBeans(ObjectName  name,
                                MarshalledObject  query,
                                Subject  delegationSubject)
                                throws IOException 

MBeanServerConnection.queryMBeans(ObjectName, QueryExp) 메서드를 처리합니다. QueryExp는 MarshalledObject에 랩 되고 있습니다.

파라미터:

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

query - MBean 선택에 적용되는 쿼리식. MarshalledObject에 캡슐화되고 있다. MarshalledObject에 null 값이 캡슐화되고 있는 경우, MBean 선택에 쿼리식은 적용되지 않는

delegationSubject - 위양 주체를 포함한 Subject. 인증 주체가 사용되고 있는 경우는 null

반환값:

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

예외:

SecurityException - 클라이언트 또는 위양 된 Subject 가 이 오퍼레이션의 실행권을 가지지 않는 경우

IOException - 일반적인 통신 예외가 발생했을 경우

queryNames

Set <ObjectName > queryNames(ObjectName  name,
                           MarshalledObject  query,
                           Subject  delegationSubject)
                           throws IOException 

MBeanServerConnection.queryNames(ObjectName, QueryExp) 메서드를 처리합니다. QueryExp는 MarshalledObject에 랩 되고 있습니다.

파라미터:

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

query - MBean 선택에 적용되는 쿼리식. MarshalledObject에 캡슐화되고 있다. MarshalledObject에 null 값이 캡슐화되고 있는 경우, MBean 선택에 쿼리식은 적용되지 않는

delegationSubject - 위양 주체를 포함한 Subject. 인증 주체가 사용되고 있는 경우는 null

반환값:

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

예외:

SecurityException - 클라이언트 또는 위양 된 Subject 가 이 오퍼레이션의 실행권을 가지지 않는 경우

IOException - 일반적인 통신 예외가 발생했을 경우

isRegistered

boolean isRegistered(ObjectName  name,
                     Subject  delegationSubject)
                     throws IOException 

MBeanServerConnection.isRegistered(ObjectName) 메서드를 처리합니다.

파라미터:

name - 체크 대상의 MBean 객체명

delegationSubject - 위양 주체를 포함한 Subject. 인증 주체가 사용되고 있는 경우는 null

반환값:

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

예외:

RuntimeOperationsException - java.lang.IllegalArgumentException을 랩 한다. 즉, 파라미터내의 객체명이 null

SecurityException - 클라이언트 또는 위양 된 Subject 가 이 오퍼레이션의 실행권을 가지지 않는 경우

IOException - 일반적인 통신 예외가 발생했을 경우

getMBeanCount

Integer  getMBeanCount(Subject  delegationSubject)
                      throws IOException 

MBeanServerConnection.getMBeanCount() 메서드를 처리합니다.

파라미터:

delegationSubject - 위양 주체를 포함한 Subject. 인증 주체가 사용되고 있는 경우는 null

반환값:

등록을 마친 MBean 수

예외:

SecurityException - 클라이언트 또는 위양 된 Subject 가 이 오퍼레이션의 실행권을 가지지 않는 경우

IOException - 일반적인 통신 예외가 발생했을 경우

getAttribute

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

                           AttributeNotFoundException,

                           InstanceNotFoundException,

                           ReflectionException,

                           IOException 

MBeanServerConnection.getAttribute(ObjectName, String) 메서드를 처리합니다.

파라미터:

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

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

delegationSubject - 위양 주체를 포함한 Subject. 인증 주체가 사용되고 있는 경우는 null

반환값:

취득되는 속성의 값

예외:

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

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

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

ReflectionException - 취득 메서드의 호출시에 발생되는 java.lang.Exception을 랩 한다

RuntimeOperationsException - java.lang.IllegalArgumentException을 랩 한다. 즉, 파라미터내의 객체명이 null 인지, 파라미터내의 속성이 null

RuntimeMBeanException - MBean 취득 메서드에 의해 발생되는 실행시 예외를 랩 한다

SecurityException - 클라이언트 또는 위양 된 Subject 가 이 오퍼레이션의 실행권을 가지지 않는 경우

IOException - 일반적인 통신 예외가 발생했을 경우

관련 항목:

setAttribute(javax.management.ObjectName, java.rmi.MarshalledObject, javax.security.auth.Subject)

getAttributes

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

                                   ReflectionException,

                                   IOException 

MBeanServerConnection.getAttributes(ObjectName, String[]) 메서드를 처리합니다.

파라미터:

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

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

delegationSubject - 위양 주체를 포함한 Subject. 인증 주체가 사용되고 있는 경우는 null

반환값:

취득되는 속성의 리스트

예외:

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

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

RuntimeOperationsException - java.lang.IllegalArgumentException을 랩 한다. 즉, 파라미터내의 객체명이 null 인지, 파라미터내의 속성이 null

SecurityException - 클라이언트 또는 위양 된 Subject 가 이 오퍼레이션의 실행권을 가지지 않는 경우

IOException - 일반적인 통신 예외가 발생했을 경우

관련 항목:

setAttributes(javax.management.ObjectName, java.rmi.MarshalledObject, javax.security.auth.Subject)

setAttribute

void setAttribute(ObjectName  name,
                  MarshalledObject  attribute,
                  Subject  delegationSubject)
                  throws InstanceNotFoundException,

                         AttributeNotFoundException,

                         InvalidAttributeValueException,

                         MBeanException,

                         ReflectionException,

                         IOException 

MBeanServerConnection.setAttribute(ObjectName, Attribute) 메서드를 처리합니다. Attribute 파라미터는 MarshalledObject에 랩 되고 있습니다.

파라미터:

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

attribute - 설정되는 속성과 설정 후 MarshalledObject에 캡슐화되는 값의 ID

delegationSubject - 위양 주체를 포함한 Subject. 인증 주체가 사용되고 있는 경우는 null

예외:

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

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

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

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

ReflectionException - 설정 메서드의 호출시에 발생되는 java.lang.Exception을 랩 한다

RuntimeOperationsException - java.lang.IllegalArgumentException을 랩 한다. 즉, 파라미터내의 객체명이 null 인지, 파라미터내의 속성이 null

SecurityException - 클라이언트 또는 위양 된 Subject 가 이 오퍼레이션의 실행권을 가지지 않는 경우

IOException - 일반적인 통신 예외가 발생했을 경우

관련 항목:

getAttribute(javax.management.ObjectName, java.lang.String, javax.security.auth.Subject)

setAttributes

AttributeList  setAttributes(ObjectName  name,
                            MarshalledObject  attributes,
                            Subject  delegationSubject)
                            throws InstanceNotFoundException,

                                   ReflectionException,

                                   IOException 

MBeanServerConnection.setAttributes(ObjectName, AttributeList) 메서드를 처리합니다. AttributeList 파라미터는 MarshalledObject에 랩 되고 있습니다.

파라미터:

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

attributes - 속성의 리스트. 설정되는 속성과 설정 후 MarshalledObject에 캡슐화되는 값의 ID

delegationSubject - 위양 주체를 포함한 Subject. 인증 주체가 사용되고 있는 경우는 null

반환값:

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

예외:

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

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

RuntimeOperationsException - java.lang.IllegalArgumentException을 랩 한다. 즉, 파라미터내의 객체명이 null 인지, 파라미터내의 속성이 null

SecurityException - 클라이언트 또는 위양 된 Subject 가 이 오퍼레이션의 실행권을 가지지 않는 경우

IOException - 일반적인 통신 예외가 발생했을 경우

관련 항목:

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

invoke

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

                     MBeanException,

                     ReflectionException,

                     IOException 

MBeanServerConnection.invoke(ObjectName, String, Object[], String[]) 메서드를 처리합니다. Object[] 파라미터는 MarshalledObject에 랩 되고 있습니다.

파라미터:

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

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

params - 오퍼레이션이 불려가 MarshalledObject에 캡슐화되었을 때 설정되는 파라미터를 포함한 배열. 캡슐화된 배열이 null인 경우, 빈 배열과 같은 의미가 되는

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

delegationSubject - 위양 주체를 포함한 Subject. 인증 주체가 사용되고 있는 경우는 null

반환값:

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

예외:

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

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

ReflectionException - 메서드의 호출시에 발생되는 java.lang.Exception을 랩 한다

SecurityException - 클라이언트 또는 위양 된 Subject 가 이 오퍼레이션의 실행권을 가지지 않는 경우

IOException - 일반적인 통신 예외가 발생했을 경우

RuntimeOperationsException - name 또는 operationName 이 null인 경우, IllegalArgumentException를 랩 한다

getDefaultDomain

String  getDefaultDomain(Subject  delegationSubject)
                        throws IOException 

MBeanServerConnection.getDefaultDomain() 메서드를 처리합니다.

파라미터:

delegationSubject - 위양 주체를 포함한 Subject. 인증 주체가 사용되고 있는 경우는 null

반환값:

디폴트의 도메인

예외:

SecurityException - 클라이언트 또는 위양 된 Subject 가 이 오퍼레이션의 실행권을 가지지 않는 경우

IOException - 일반적인 통신 예외가 발생했을 경우

getDomains

String [] getDomains(Subject  delegationSubject)
                    throws IOException 

MBeanServerConnection.getDomains() 메서드를 처리합니다.

파라미터:

delegationSubject - 위양 주체를 포함한 Subject. 인증 주체가 사용되고 있는 경우는 null

반환값:

도메인의 리스트

예외:

SecurityException - 클라이언트 또는 위양 된 Subject 가 이 오퍼레이션의 실행권을 가지지 않는 경우

IOException - 일반적인 통신 예외가 발생했을 경우

getMBeanInfo

MBeanInfo  getMBeanInfo(ObjectName  name,
                       Subject  delegationSubject)
                       throws InstanceNotFoundException,

                              IntrospectionException,

                              ReflectionException,

                              IOException 

MBeanServerConnection.getMBeanInfo(ObjectName) 메서드를 처리합니다.

파라미터:

name - 분석 대상의 MBean 이름

delegationSubject - 위양 주체를 포함한 Subject. 인증 주체가 사용되고 있는 경우는 null

반환값:

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

예외:

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

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

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

SecurityException - 클라이언트 또는 위양 된 Subject 가 이 오퍼레이션의 실행권을 가지지 않는 경우

IOException - 일반적인 통신 예외가 발생했을 경우

RuntimeOperationsException - java.lang.IllegalArgumentException을 랩 한다. 즉, 파라미터내의 객체명이 null

isInstanceOf

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

                            IOException 

MBeanServerConnection.isInstanceOf(ObjectName, String) 메서드를 처리합니다.

파라미터:

name - MBean ObjectName

className - 클래스의 이름

delegationSubject - 위양 주체를 포함한 Subject. 인증 주체가 사용되고 있는 경우는 null

반환값:

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

예외:

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

SecurityException - 클라이언트 또는 위양 된 Subject 가 이 오퍼레이션의 실행권을 가지지 않는 경우

IOException - 일반적인 통신 예외가 발생했을 경우

RuntimeOperationsException - java.lang.IllegalArgumentException을 랩 한다. 즉, 파라미터내의 객체명이 null

addNotificationListener

void addNotificationListener(ObjectName  name,
                             ObjectName  listener,
                             MarshalledObject  filter,
                             MarshalledObject  handback,
                             Subject  delegationSubject)
                             throws InstanceNotFoundException,

                                    IOException 

MBeanServerConnection.addNotificationListener(ObjectName, ObjectName, NotificationFilter, Object) 메서드를 처리합니다. NotificationFilter 파라미터는 MarshalledObject에 랩 되고 있습니다. Object (핸드백) 파라미터도 MarshalledObject에 랩 되고 있습니다.

파라미터:

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

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

filter - MarshalledObject에 캡슐화된 필터 객체. MarshalledObject에 캡슐화된 필터가 null 치를 가지는 경우, 통지의 처리전에 필터링은 행해지지 않는

handback - 통지가 발행되었을 때 리스너에게 송신되는 컨텍스트. MarshalledObject에 캡슐화되고 있는

delegationSubject - 위양 주체를 포함한 Subject. 인증 주체가 사용되고 있는 경우는 null

예외:

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

RuntimeOperationsException - IllegalArgumentException를 랩 한다. listener에 의해 지정된 MBean가 존재하고 있어도, NotificationListener 인터페이스를 구현하고 있지 않는지, name 또는 listener가 null

SecurityException - 클라이언트 또는 위양 된 Subject 가 이 오퍼레이션의 실행권을 가지지 않는 경우

IOException - 일반적인 통신 예외가 발생했을 경우

관련 항목:

removeNotificationListener(ObjectName, ObjectName, Subject), removeNotificationListener(ObjectName, ObjectName, MarshalledObject, MarshalledObject, Subject)

removeNotificationListener

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

                                       ListenerNotFoundException,

                                       IOException 

MBeanServerConnection.removeNotificationListener(ObjectName, ObjectName) 메서드를 처리합니다.

파라미터:

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

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

delegationSubject - 위양 주체를 포함한 Subject. 인증 주체가 사용되고 있는 경우는 null

예외:

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

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

SecurityException - 클라이언트 또는 위양 된 Subject 가 이 오퍼레이션의 실행권을 가지지 않는 경우

IOException - 일반적인 통신 예외가 발생했을 경우

RuntimeOperationsException - name 또는 listener가 null인 경우, IllegalArgumentException를 감싸는

관련 항목:

addNotificationListener(javax.management.ObjectName, javax.management.ObjectName, java.rmi.MarshalledObject, java.rmi.MarshalledObject, javax.security.auth.Subject)

removeNotificationListener

void removeNotificationListener(ObjectName  name,
                                ObjectName  listener,
                                MarshalledObject  filter,
                                MarshalledObject  handback,
                                Subject  delegationSubject)
                                throws InstanceNotFoundException,

                                       ListenerNotFoundException,

                                       IOException 

MBeanServerConnection.removeNotificationListener(ObjectName, ObjectName, NotificationFilter, Object) 메서드를 처리합니다. NotificationFilter 파라미터는 MarshalledObject에 랩 되고 있습니다. Object 파라미터도 MarshalledObject에 랩 되고 있습니다.

파라미터:

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

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

filter - 리스너의 추가시로 지정된 필터. MarshalledObject에 캡슐화되고 있는

handback - 리스너의 추가시로 지정된 핸드백. MarshalledObject에 캡슐화되고 있는

delegationSubject - 위양 주체를 포함한 Subject. 인증 주체가 사용되고 있는 경우는 null

예외:

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

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

SecurityException - 클라이언트 또는 위양 된 Subject 가 이 오퍼레이션의 실행권을 가지지 않는 경우

IOException - 일반적인 통신 예외가 발생했을 경우

RuntimeOperationsException - name 또는 listener가 null인 경우, IllegalArgumentException를 감싸는

관련 항목:

addNotificationListener(javax.management.ObjectName, javax.management.ObjectName, java.rmi.MarshalledObject, java.rmi.MarshalledObject, javax.security.auth.Subject)

addNotificationListeners

Integer [] addNotificationListeners(ObjectName [] names,
                                   MarshalledObject [] filters,
                                   Subject [] delegationSubjects)
                                   throws InstanceNotFoundException,

                                          IOException 

MBeanServerConnection.addNotificationListener(ObjectName, NotificationListener, NotificationFilter, Object) 메서드를 처리합니다.

지정된 필터에 일치하는 MBean 로부터의 통지를 등록합니다. 리모트 클라이언트는 그 후, fetchNotifications 메서드를 사용해 이러한 통지를 취득할 수 있습니다.

클라이언트 측에는 리스너 마다 원의 NotificationListener와 handback가 보관 유지됩니다. 클라이언트가 이것들을 식별할 수 있도록, 서버는 일의의 listenerID를 생성해, 리턴합니다. 이 listenerID는 Notification와 함께 리모트 클라이언트에 전송 됩니다.

지정된 페어 (name, filter)의 어느쪽이든을 등록할 수 없는 경우, 오퍼레이션은 예외를 발행해 종료합니다. 이 경우 이름도 필터도 등록되지 않습니다.

파라미터:

names - Notification 발행원 MBean를 식별하는 ObjectName

filters - NotificationFilter 정렬화 된 표현으로부터 완성되는 배열. 이 배열의 요소는 null 이라도 좋은

delegationSubjects - Subject. 이 Subject (복수가능) 대신에 리스너가 추가된다. 이 배열의 요소는 null 이라도 좋다. 또, delegationSubjects 파라미터 자체가 null 여도 괜찮다. 이 경우 이 배열은, name 배열이나 filter 배열과 같은 사이즈의 null 치로부터 완성되는 배열과 동등하게 된다

반환값:

로컬 리스너를 식별하는 listenerID로 부터 완성되는 배열. 이 배열은 파라미터와 같은 수의 요소를 가진다

예외:

IllegalArgumentException - name 또는 filter가 null인 경우, name에 null 요소가 포함되는 경우, 또는 3개의 배열의 사이즈가 다른 경우

ClassCastException - filter 몇개의 요소가 NotificationFilter 이외의 비 null 객체로서 비정렬화하는 경우

InstanceNotFoundException - name 중 한쪽이 등록이 끝난 MBean에 대응하고 있지 않는 경우

SecurityException - 몇개의 MBean 로 클라이언트 또는 위양 된 Subject 가 리스너를 추가하는 접근 권한을 가지지 않는 경우

IOException - 일반적인 통신 예외가 발생했을 경우

removeNotificationListeners

void removeNotificationListeners(ObjectName  name,
                                 Integer [] listenerIDs,
                                 Subject  delegationSubject)
                                 throws InstanceNotFoundException,

                                        ListenerNotFoundException,

                                        IOException 

removeNotificationListener(ObjectName, NotificationListener) 및 removeNotificationListener(ObjectName, NotificationListener, NotificationFilter, Object) 메서드를 처리합니다.

이 메서드는 MBean 서버내의 지정된 MBean 로부터, 1개 이상의 NotificationListener를 삭제합니다.

NotificationListener는 addNotificationListeners(ObjectName[], MarshalledObject[], Subject[]) 메서드로부터 리턴된 ID에 의해 식별됩니다.

파라미터:

name - Notification 발행원 MBean를 식별하는 ObjectName

listenerIDs - 삭제하는 리스너에게 대응하는 ID 리스트

delegationSubject - 위양 주체를 포함한 Subject. 인증 주체가 사용되고 있는 경우는 null

예외:

InstanceNotFoundException - 지정된 name가 등록이 끝난 MBean에 대응하고 있지 않는 경우

ListenerNotFoundException - 서버 측에 발견되지 않는 리스너가 있는 경우. 이 예외는 MBean 가MBeanServer.removeNotificationListener 호출해 이외의 어떠한 이유로써 리스너를 파기했을 때 발행된다

SecurityException - 클라이언트 또는 위양 된 Subject 가 리스너를 삭제하는 접근 권한을 가지지 않는 경우

IOException - 일반적인 통신 예외가 발생했을 경우

IllegalArgumentException - ObjectName 또는 listenerId가 null인 경우, 또는 listenerId에 null 요소가 포함되는 경우

fetchNotifications

NotificationResult  fetchNotifications(long clientSequenceNumber,
                                      int maxNotifications,
                                      long timeout)
                                      throws IOException 

커넥터 서버로부터 통지를 수신합니다. 이 메서드는 1개 이상 통지가 발행되는지, 지정된 타임 아웃에 이를 때까지 블록 할 수 있습니다. 또, 통지가 0 이면 언제라도 종료할 수 있습니다.

순서 번호가 clientSequenceNumber 이상으로 이 클라이언트가 통지를 받아들이는 필터를 사용해 통지의 발행원 MBean 리스너를 1개 이상 등록하고 있는 경우, 이 통지를 결과에 포함할 수 있습니다 . 이 통지를 대기하는 각 리스너는 addNotificationListeners(ObjectName[], MarshalledObject[], Subject[]) 에 의해 리턴된 정수값 의 ID에 의해 식별됩니다.

파라미터:

clientSequenceNumber - 클라이언트가 대기하는 최초의 순서 번호. 잘못된 값 의 경우, 다음의 통지의 순서 번호라고 해석되는

maxNotifications - 리턴된 다른 통지의 최대수. 같은 통지가 반복해 발행되는 경우, 리턴된 NotificationResult에 포함되는 TargetedNotification 배열은 이 값보다 많은 요소를 가질 수가 있다. 이 파라미터의 값이 부의 경우의 동작은 부정

timeout - 통지의 착신을 기다리는 최대 시간 (밀리 세컨드 단위). 0인 경우, 통지가 없으면 메서드는 대기하지 않고, 즉시 종료한다. Long.MAX_VALUE인 경우, 타임 아웃은 설정되지 않는다. 이 파라미터의 값이 부의 경우의 동작은 부정

반환값:

NotificationResult

예외:

IOException - 일반적인 통신 예외가 발생했을 경우