|
JavaTM Platform Standard Ed. 6 |
|||||||||
전의 클래스 다음의 클래스 | 프레임 있어 프레임 없음 | |||||||||
개요: 상자 | 필드 | 생성자 | 메소드 | 상세: 필드 | 생성자 | 메소드 |
public interface RMIConnection
클라이언트로부터 서버측의 MBeanServer 구현에 MBeanServer 요구를 송신하기 위해서 사용되는 RMI 객체입니다. RMI 연결기에 접속된 원격 클라이언트 마다, 이 인터페이스를 구현하는 Remote 객체가 1 개씩 제공됩니다.
사용자 코드는, 반드시 이 인터페이스를 참조하지 않습니다. 이 인터페이스는, API 의 구현이 다른 경우도 상호 운용할 수 있도록(듯이), 공개 API 의 일부로서 지정되고 있습니다.
클라이언트 파라미터를, 서버측의 올바른 클래스 로더로 직렬화 복원하기 (위해)때문에, 메소드 호출에 사용되는 것 같은 클라이언트 파라미터는 MarshalledObject
에 랩 됩니다. 이 인터페이스의 구현은, 우선 오퍼레이션과 그 타겟의 적절한 클래스 로더를 취득하고 나서, 이 클래스 로더를 사용해 정렬화 파라미터를 직렬화 복원합니다. 특별히 기재되지 않은 한, 파라미터 MarshalledObject
또는 MarshalledObject[]
는 null 의외로 합니다. null 의 경우, 파라미터의 동작은 부정이 됩니다.
클래스의 로드에 관한 자세한 것은,JMX 스펙, Version 1.4 의 PDF 문서를 참조해 주세요.
이 인터페이스의 대부분의 메소드는,MBeanServerConnection
인터페이스의 병행 메소드입니다. 여기에서는 설명합니다만, 메소드의 동작은 대응하는 MBeanServerConnection
메소드와 같습니다.
메소드의 상세 |
---|
String getConnectionId() throws IOException
접속 ID 를 돌려줍니다. 이 캐릭터 라인은, 지정의 RMI 연결기 서버에의 유효한 접속 마다 다릅니다.
IOException
- 일반적인 통신 예외가 발생했을 경우RMIConnector.connect
void close() throws IOException
이 접속을 종료합니다. 이 메소드의 종료시에는, 더 이상 원격 호출의 실패가 일어나지 않게, 이 인터페이스를 구현하는 RMI 객체가 안 export 됩니다.
Closeable
내의 close
IOException
- 접속을 종료할 수 없었던 경우, Remote 객체를 안 export 할 수 없었던 경우, 또는 원격 종료 요구의 전송시에 통신 장해가 발생했을 경우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
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
- 일반적인 통신 예외가 발생했을 경우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
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
- 일반적인 통신 예외가 발생했을 경우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 의 경우, 빈 상태(empty) 배열과 같은 의미가 되는signature
- 생성자 의 시그니챠를 포함한 배열. 이 배열이 불려 가는 null 의 경우, 빈 상태(empty) 배열과 같은 의미가 되는delegationSubject
- 위양 주체를 포함한 Subject
. 인증 주체가 사용되고 있는 경우는 null
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
- 일반적인 통신 예외가 발생했을 경우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 의 경우, 빈 상태(empty) 배열과 같은 의미가 되는signature
- 생성자 의 시그니챠를 포함한 배열. 이 배열이 불려 간다. null 의 경우, 빈 상태(empty) 배열과 같은 의미가 되는delegationSubject
- 위양 주체를 포함한 Subject
. 인증 주체가 사용되고 있는 경우는 null
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
- 일반적인 통신 예외가 발생했을 경우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
- 일반적인 통신 예외가 발생했을 경우ObjectInstance getObjectInstance(ObjectName name, Subject delegationSubject) throws InstanceNotFoundException , IOException
MBeanServerConnection.getObjectInstance(ObjectName)
메소드를 처리합니다.
name
- MBean 의 객체명delegationSubject
- 위양 주체를 포함한 Subject
. 인증 주체가 사용되고 있는 경우는 null
ObjectInstance
. ObjectName
는 name
로, 포함되는 클래스명은 getMBeanInfo(name)
. getClassName()
InstanceNotFoundException
- 지정된 MBean 가 MBean 서버에 등록되지 않은 경우
RuntimeOperationsException
- java.lang.IllegalArgumentException
를 랩 하는 경우. 즉, 파라미터내의 객체명이 null 의 경우
SecurityException
- 클라이언트 또는 위양 된 Subject 가, 이 오퍼레이션의 실행 권한을 가지지 않는 경우
IOException
- 일반적인 통신 예외가 발생했을 경우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
ObjectInstance
객체를 포함한 세트. 쿼리의 조건을 채우는 MBean 가 존재하지 않는 경우, 빈 상태(empty)의 리스트가 반환된다
SecurityException
- 클라이언트 또는 위양 된 Subject 가, 이 오퍼레이션의 실행 권한을 가지지 않는 경우
IOException
- 일반적인 통신 예외가 발생했을 경우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
SecurityException
- 클라이언트 또는 위양 된 Subject 가, 이 오퍼레이션의 실행 권한을 가지지 않는 경우
IOException
- 일반적인 통신 예외가 발생했을 경우boolean isRegistered(ObjectName name, Subject delegationSubject) throws IOException
MBeanServerConnection.isRegistered(ObjectName)
메소드를 처리합니다.
name
- 체크 대상의 MBean 의 객체명delegationSubject
- 위양 주체를 포함한 Subject
. 인증 주체가 사용되고 있는 경우는 null
RuntimeOperationsException
- java.lang.IllegalArgumentException
를 랩 하는 경우. 즉, 파라미터내의 객체명이 null 의 경우
SecurityException
- 클라이언트 또는 위양 된 Subject 가, 이 오퍼레이션의 실행 권한을 가지지 않는 경우
IOException
- 일반적인 통신 예외가 발생했을 경우Integer getMBeanCount(Subject delegationSubject) throws IOException
MBeanServerConnection.getMBeanCount()
메소드를 처리합니다.
delegationSubject
- 위양 주체를 포함한 Subject
. 인증 주체가 사용되고 있는 경우는 null
SecurityException
- 클라이언트 또는 위양 된 Subject 가, 이 오퍼레이션의 실행 권한을 가지지 않는 경우
IOException
- 일반적인 통신 예외가 발생했을 경우Object getAttribute(ObjectName name, String attribute, Subject delegationSubject) throws MBeanException , AttributeNotFoundException , InstanceNotFoundException , ReflectionException , IOException
MBeanServerConnection.getAttribute(ObjectName, String)
메소드를 처리합니다.
name
- MBean 의 객체명. 이 MBean 의 속성이 취득되는attribute
- 취득되는 속성의 이름을 지정하는 StringdelegationSubject
- 위양 주체를 포함한 Subject
. 인증 주체가 사용되고 있는 경우는 null
AttributeNotFoundException
- MBean 의 지정된 속성이 액세스 불능인 경우
MBeanException
- MBean 의 취득 메소드에 의해 throw 되는 예외를 랩 하는 경우
InstanceNotFoundException
- 지정된 MBean 가 MBean 서버에 등록되지 않은 경우
ReflectionException
- 취득 메소드의 호출시에 throw 되는 java.lang.Exception
를 랩 하는 경우
RuntimeOperationsException
- java.lang.IllegalArgumentException
를 랩 하는 경우. 즉, 파라미터내의 객체명이 null 인지, 파라미터내의 속성이 null 인 경우
RuntimeMBeanException
- MBean 의 취득 메소드에 의해 throw 되는 실행시 예외를 랩 하는 경우
SecurityException
- 클라이언트 또는 위양 된 Subject 가, 이 오퍼레이션의 실행 권한을 가지지 않는 경우
IOException
- 일반적인 통신 예외가 발생했을 경우setAttribute(javax.management.ObjectName, java.rmi.MarshalledObject, javax.security.auth.Subject)
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)
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
에 캡슐화되는 값의 IDdelegationSubject
- 위양 주체를 포함한 Subject
. 인증 주체가 사용되고 있는 경우는 null
InstanceNotFoundException
- 지정된 MBean 가 MBean 서버에 등록되지 않은 경우
AttributeNotFoundException
- MBean 의 지정된 속성이 액세스 불능인 경우
InvalidAttributeValueException
- 지정된 값이, 속성에 대한 유효한 값이 아닌 경우
MBeanException
- MBean 의 설정 메소드에 의해 throw 되는 예외를 랩 하는 경우
ReflectionException
- 설정 메소드의 호출시에 throw 되는 java.lang.Exception
를 랩 하는 경우
RuntimeOperationsException
- java.lang.IllegalArgumentException
를 랩 하는 경우. 즉, 파라미터내의 객체명이 null 인지, 파라미터내의 속성이 null 인 경우
SecurityException
- 클라이언트 또는 위양 된 Subject 가, 이 오퍼레이션의 실행 권한을 가지지 않는 경우
IOException
- 일반적인 통신 예외가 발생했을 경우getAttribute(javax.management.ObjectName, java.lang.String, javax.security.auth.Subject)
AttributeList setAttributes(ObjectName name, MarshalledObject attributes, Subject delegationSubject) throws InstanceNotFoundException , ReflectionException , IOException
MBeanServerConnection.setAttributes(ObjectName, AttributeList)
메소드를 처리합니다. AttributeList
파라미터는,MarshalledObject
에 랩 되고 있습니다.
name
- MBean 의 객체명. 이 MBean 의 속성이 설정되는attributes
- 속성의 리스트. 설정되는 속성과 설정 후 MarshalledObject
에 캡슐화되는 값의 IDdelegationSubject
- 위양 주체를 포함한 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)
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 의 경우, 빈 상태(empty) 배열과 같은 의미가 되는signature
- 오퍼레이션의 시그니챠를 포함한 배열. 클래스 객체의 로드에는, 오퍼레이션을 호출한 MBean 를 로드할 때와 같은 클래스 로더가 사용된다. null 의 경우, 빈 상태(empty) 배열과 같은 의미가 되는delegationSubject
- 위양 주체를 포함한 Subject
. 인증 주체가 사용되고 있는 경우는 null
InstanceNotFoundException
- 지정된 MBean 가 MBean 서버에 등록되지 않은 경우
MBeanException
- MBean 의 호출 메소드에 의해 throw 되는 예외를 랩 하는 경우
ReflectionException
- 메소드의 호출시에 throw 되는 java.lang.Exception
를 랩 하는 경우
SecurityException
- 클라이언트 또는 위양 된 Subject 가, 이 오퍼레이션의 실행 권한을 가지지 않는 경우
IOException
- 일반적인 통신 예외가 발생했을 경우
RuntimeOperationsException
- name
또는 operationName
이 null 의 경우,IllegalArgumentException
를 랩 하는 경우String getDefaultDomain(Subject delegationSubject) throws IOException
MBeanServerConnection.getDefaultDomain()
메소드를 처리합니다.
delegationSubject
- 위양 주체를 포함한 Subject
. 인증 주체가 사용되고 있는 경우는 null
SecurityException
- 클라이언트 또는 위양 된 Subject 가, 이 오퍼레이션의 실행 권한을 가지지 않는 경우
IOException
- 일반적인 통신 예외가 발생했을 경우String [] getDomains(Subject delegationSubject) throws IOException
MBeanServerConnection.getDomains()
메소드를 처리합니다.
delegationSubject
- 위양 주체를 포함한 Subject
. 인증 주체가 사용되고 있는 경우는 null
SecurityException
- 클라이언트 또는 위양 된 Subject 가, 이 오퍼레이션의 실행 권한을 가지지 않는 경우
IOException
- 일반적인 통신 예외가 발생했을 경우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 의 경우boolean isInstanceOf(ObjectName name, String className, Subject delegationSubject) throws InstanceNotFoundException , IOException
MBeanServerConnection.isInstanceOf(ObjectName, String)
메소드를 처리합니다.
name
- MBean 의 ObjectName
className
- 클래스의 이름delegationSubject
- 위양 주체를 포함한 Subject
. 인증 주체가 사용되고 있는 경우는 null
InstanceNotFoundException
- 지정된 MBean 가 MBean 서버에 등록되지 않은 경우
SecurityException
- 클라이언트 또는 위양 된 Subject 가, 이 오퍼레이션의 실행 권한을 가지지 않는 경우
IOException
- 일반적인 통신 예외가 발생했을 경우
RuntimeOperationsException
- java.lang.IllegalArgumentException
를 랩 하는 경우. 즉, 파라미터내의 객체명이 null 의 경우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)
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)
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)
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
- 일반적인 통신 예외가 발생했을 경우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 요소가 포함되는 경우NotificationResult fetchNotifications(long clientSequenceNumber, int maxNotifications, long timeout) throws IOException
연결기 서버로부터 통지를 수신합니다. 이 메소드는, 1 개(살) 이상 통지가 발행되는지, 지정된 타임 아웃에 이를 때까지 블록 할 수 있습니다. 또, 통지가 0 이면 언제라도 종료할 수 있습니다.
순서 번호가 clientSequenceNumber
이상으로, 이 클라이언트가 통지를 받아들이는 필터를 사용해 통지의 발행원 MBean 의 청취자를 1 개 이상 등록하고 있는 경우, 이 통지를 결과에 포함할 수가 있습니다. 이 통지를 대기하는 각 청취자는,addNotificationListeners(ObjectName[], MarshalledObject[], Subject[])
에 의해 반환된 정수치의 ID 에 의해 식별됩니다.
clientSequenceNumber
- 클라이언트가 대기하는 최초의 순서 번호. 0 보다 작은 값의 경우, 다음의 통지의 순서 번호라고 해석되는maxNotifications
- 반환되는 다른 통지의 최대수. 같은 통지가 반복해 발행되는 경우, 반환되는 NotificationResult
에 포함되는 TargetedNotification
배열은, 이 값보다 많은 요소를 가질 수가 있다. 이 파라미터의 값이 부의 경우의 동작은 부정timeout
- 통지의 착신을 기다리는 최대 시간 (밀리 세컨드 단위). 0 의 경우, 통지가 없으면 메소드는 대기하지 않고, 즉시 종료한다. Long.MAX_VALUE
의 경우, 타임 아웃은 설정되지 않는다. 이 파라미터의 값이 부의 경우의 동작은 부정
NotificationResult
IOException
- 일반적인 통신 예외가 발생했을 경우
|
JavaTM Platform Standard Ed. 6 |
|||||||||
전의 클래스 다음의 클래스 | 프레임 있어 프레임 없음 | |||||||||
개요: 상자 | 필드 | 생성자 | 메소드 | 상세: 필드 | 생성자 | 메소드 |
Copyright 2006 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms . Documentation Redistribution Policy 도 참조해 주세요.