JavaTM Platform
Standard Ed. 6

javax.management.remote.rmi
클래스 RMIConnectionImpl

java.lang.Object 
  상위를 확장 javax.management.remote.rmi.RMIConnectionImpl
모든 구현된 인터페이스:
Closeable , Remote , Unreferenced , RMIConnection


public class RMIConnectionImpl
extends Object
implements RMIConnection , Unreferenced

RMIConnection 인터페이스의 구현입니다. 일반적으로, 사용자 코드는 이 클래스를 참조하지 않습니다.

도입된 버젼:
1.5

생성자 의 개요
RMIConnectionImpl (RMIServerImpl  rmiServer, String  connectionId, ClassLoader  defaultClassLoader, Subject  subject, Map <String ,? > env)
          새로운 RMIConnection 를 구축합니다.
 
메소드의 개요
 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) 메소드를 처리합니다.
 String toString ()
          이 객체의 캐릭터 라인 표현을 돌려줍니다.
 void unreferenced ()
          RMI 런타임에 의해, 참조 리스트 (원격 객체를 참조하는 클라이언트의 리스트)가 비웠다고 판단되었고 장미구 나중에 불려 갑니다.
 void unregisterMBean (ObjectName  name, Subject  delegationSubject)
          MBeanServerConnection.unregisterMBean(ObjectName) 메소드를 처리합니다.
 
클래스 java.lang. Object 로부터 상속된 메소드
clone , equals , finalize , getClass , hashCode , notify , notifyAll , wait , wait , wait
 

생성자 의 상세

RMIConnectionImpl

public RMIConnectionImpl(RMIServerImpl  rmiServer,
                         String  connectionId,
                         ClassLoader  defaultClassLoader,
                         Subject  subject,
                         Map <String ,? > env)
새로운 RMIConnection 를 구축합니다. 이 접속은, JRMP 또는 IIOP 트랜스폴트로 사용할 수 있습니다. 이 객체는 자신을 export 하지 않습니다. 이 객체는, 호출 측에야는 적절히 export 됩니다 (RMIJRMPServerImpl.makeClient(String, Subject)RMIIIOPServerImpl.makeClient(String, Subject) 를 참조).

파라미터:
rmiServer - RMIServerImpl 객체. 이 접속은, 이 객체용으로 작성된다. 이 파라미터가 null 의 경우의 동작은 부정
connectionId - 이 접속의 ID. 이 파라미터가 null 의 경우의 동작은 부정
defaultClassLoader - 정렬화 객체의 직렬화 복원시에 사용된다 디폴트의 ClassLoader. bootstrap 클래스 로더를 지정하는 경우는 null 도 가능
subject - 승인에 사용한다 인증 끝난 피인증자. 인증 끝난 피인증자가 존재하지 않는 것을 지정하는 경우는 null 도 가능
env - 새로운 RMIServerImpl 의 속성을 포함한다 환경. null 의 경우, 빈 상태(empty) 맵과 동등
메소드의 상세

getConnectionId

public String  getConnectionId()
                       throws IOException 
인터페이스 RMIConnection 의 기술:

접속 ID 를 돌려줍니다. 이 캐릭터 라인은, 지정의 RMI 연결기 서버에의 유효한 접속 마다 다릅니다.

정의:
인터페이스 RMIConnection 내의 getConnectionId
반환값:
접속 ID
예외:
IOException - 일반적인 통신 예외가 발생했을 경우
관련 항목:
RMIConnector.connect

close

public void close()
           throws IOException 
인터페이스 RMIConnection 의 기술:

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

정의:
인터페이스 Closeable 내의 close
정의:
인터페이스 RMIConnection 내의 close
예외:
IOException - 접속을 종료할 수 없었던 경우, Remote 객체를 안 export 할 수 없었던 경우, 또는 원격 종료 요구의 전송시에 통신 장해가 발생했을 경우

unreferenced

public void unreferenced()
인터페이스 Unreferenced 의 기술:
RMI 런타임에 의해, 참조 리스트 (원격 객체를 참조하는 클라이언트의 리스트)가 비웠다고 판단되었고 장미구 나중에 불려 갑니다.

정의:
인터페이스 Unreferenced 내의 unreferenced

createMBean

public ObjectInstance  createMBean(String  className,
                                  ObjectName  name,
                                  Subject  delegationSubject)
                           throws ReflectionException ,
                                  InstanceAlreadyExistsException ,
                                  MBeanRegistrationException ,
                                  MBeanException ,
                                  NotCompliantMBeanException ,
                                  IOException 
인터페이스 RMIConnection 의 기술:
MBeanServerConnection.createMBean(String, ObjectName) 메소드를 처리합니다.

정의:
인터페이스 RMIConnection 내의 createMBean
파라미터:
className - 인스턴스화하는 MBean 의 클래스명
name - MBean 의 객체명. null 의 경우 있어
delegationSubject - 위양 주체를 포함한 Subject. 인증 주체가 사용되고 있는 경우는 null
반환값:
새롭고 인스턴스화 된 MBean 의 ObjectName 와 Java 클래스명을 포함한 ObjectInstance. ObjectNamen 의 경우, 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 가 아닌 경우
IOException - 일반적인 통신 예외가 발생했을 경우

createMBean

public ObjectInstance  createMBean(String  className,
                                  ObjectName  name,
                                  ObjectName  loaderName,
                                  Subject  delegationSubject)
                           throws ReflectionException ,
                                  InstanceAlreadyExistsException ,
                                  MBeanRegistrationException ,
                                  MBeanException ,
                                  NotCompliantMBeanException ,
                                  InstanceNotFoundException ,
                                  IOException 
인터페이스 RMIConnection 의 기술:
MBeanServerConnection.createMBean(String, ObjectName, ObjectName) 메소드를 처리합니다.

정의:
인터페이스 RMIConnection 내의 createMBean
파라미터:
className - 인스턴스화하는 MBean 의 클래스명
name - MBean 의 객체명. null 의 경우 있어
loaderName - 사용하는 클래스 로더의 객체명
delegationSubject - 위양 주체를 포함한 Subject. 인증 주체가 사용되고 있는 경우는 null
반환값:
새롭고 인스턴스화 된 MBean 의 ObjectName 와 Java 클래스명을 포함한 ObjectInstance. ObjectNamen 의 경우, 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 서버에 등록되지 않은 경우
IOException - 일반적인 통신 예외가 발생했을 경우

createMBean

public ObjectInstance  createMBean(String  className,
                                  ObjectName  name,
                                  MarshalledObject  params,
                                  String [] signature,
                                  Subject  delegationSubject)
                           throws ReflectionException ,
                                  InstanceAlreadyExistsException ,
                                  MBeanRegistrationException ,
                                  MBeanException ,
                                  NotCompliantMBeanException ,
                                  IOException 
인터페이스 RMIConnection 의 기술:
MBeanServerConnection.createMBean(String, ObjectName, Object[], String[]) 메소드를 처리합니다. Object[] 파라미터는,MarshalledObject 에 랩 되고 있습니다.

정의:
인터페이스 RMIConnection 내의 createMBean
파라미터:
className - 인스턴스화하는 MBean 의 클래스명
name - MBean 의 객체명. null 의 경우 있어
params - 생성자 의 파라미터를 포함한 배열. 이 배열은, 불려 간 뒤,MarshalledObject 에 캡슐화된다. 캡슐화된 배열이 null 의 경우, 빈 상태(empty) 배열과 같은 의미가 되는
signature - 생성자 의 시그니챠를 포함한 배열. 이 배열이 불려 가는 null 의 경우, 빈 상태(empty) 배열과 같은 의미가 되는
delegationSubject - 위양 주체를 포함한 Subject. 인증 주체가 사용되고 있는 경우는 null
반환값:
새롭고 인스턴스화 된 MBean 의 ObjectName 와 Java 클래스명을 포함한 ObjectInstance. ObjectNamen 의 경우, 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 가 아닌 경우
IOException - 일반적인 통신 예외가 발생했을 경우

createMBean

public ObjectInstance  createMBean(String  className,
                                  ObjectName  name,
                                  ObjectName  loaderName,
                                  MarshalledObject  params,
                                  String [] signature,
                                  Subject  delegationSubject)
                           throws ReflectionException ,
                                  InstanceAlreadyExistsException ,
                                  MBeanRegistrationException ,
                                  MBeanException ,
                                  NotCompliantMBeanException ,
                                  InstanceNotFoundException ,
                                  IOException 
인터페이스 RMIConnection 의 기술:
MBeanServerConnection.createMBean(String, ObjectName, ObjectName, Object[], String[]) 메소드를 처리합니다. Object[] 파라미터는,MarshalledObject 에 랩 되고 있습니다.

정의:
인터페이스 RMIConnection 내의 createMBean
파라미터:
className - 인스턴스화하는 MBean 의 클래스명
name - MBean 의 객체명. null 의 경우 있어
loaderName - 사용하는 클래스 로더의 객체명
params - 생성자 의 파라미터를 포함한 배열. 이 배열은, 불려 간 뒤,MarshalledObject 에 캡슐화된다. 캡슐화된 배열이 null 의 경우, 빈 상태(empty) 배열과 같은 의미가 되는
signature - 생성자 의 시그니챠를 포함한 배열. 이 배열이 불려 간다. null 의 경우, 빈 상태(empty) 배열과 같은 의미가 되는
delegationSubject - 위양 주체를 포함한 Subject. 인증 주체가 사용되고 있는 경우는 null
반환값:
새롭고 인스턴스화 된 MBean 의 ObjectName 와 Java 클래스명을 포함한 ObjectInstance. ObjectNamen 의 경우, 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 서버에 등록되지 않은 경우
IOException - 일반적인 통신 예외가 발생했을 경우

unregisterMBean

public void unregisterMBean(ObjectName  name,
                            Subject  delegationSubject)
                     throws InstanceNotFoundException ,
                            MBeanRegistrationException ,
                            IOException 
인터페이스 RMIConnection 의 기술:
MBeanServerConnection.unregisterMBean(ObjectName) 메소드를 처리합니다.

정의:
인터페이스 RMIConnection 내의 unregisterMBean
파라미터:
name - 등록 해제하는 MBean 의 객체명
delegationSubject - 위양 주체를 포함한 Subject. 인증 주체가 사용되고 있는 경우는 null
예외:
InstanceNotFoundException - 지정된 MBean 가 MBean 서버에 등록되지 않은 경우
MBeanRegistrationException - MBean 의 preDeregister (MBeanRegistration interface) 메소드가 예외를 throw 했을 경우
IOException - 일반적인 통신 예외가 발생했을 경우

getObjectInstance

public ObjectInstance  getObjectInstance(ObjectName  name,
                                        Subject  delegationSubject)
                                 throws InstanceNotFoundException ,
                                        IOException 
인터페이스 RMIConnection 의 기술:
MBeanServerConnection.getObjectInstance(ObjectName) 메소드를 처리합니다.

정의:
인터페이스 RMIConnection 내의 getObjectInstance
파라미터:
name - MBean 의 객체명
delegationSubject - 위양 주체를 포함한 Subject. 인증 주체가 사용되고 있는 경우는 null
반환값:
name 로 지정된 MBean 에 관련지을 수 있었던 ObjectInstance. ObjectNamename 로, 포함되는 클래스명은 getMBeanInfo(name) . getClassName()
예외:
InstanceNotFoundException - 지정된 MBean 가 MBean 서버에 등록되지 않은 경우
IOException - 일반적인 통신 예외가 발생했을 경우

queryMBeans

public Set <ObjectInstance > queryMBeans(ObjectName  name,
                                       MarshalledObject  query,
                                       Subject  delegationSubject)
                                throws IOException 
인터페이스 RMIConnection 의 기술:
MBeanServerConnection.queryMBeans(ObjectName, QueryExp) 메소드를 처리합니다. QueryExp 는,MarshalledObject 에 랩 되고 있습니다.

정의:
인터페이스 RMIConnection 내의 queryMBeans
파라미터:
name - 취득하는 MBean 를 식별하는 객체명 패턴. null 의 경우, 또는 도메인이나 키의 프로퍼티이 지정되어 있지 않은 경우는, 등록되어 모든 MBean 가 취득되는
query - MBean 의 선택에 적용되는 쿼리식. MarshalledObject 에 캡슐화되고 있다. MarshalledObject 에 null 치가 캡슐화되고 있는 경우, MBean 의 선택에 쿼리식은 적용되지 않는
delegationSubject - 위양 주체를 포함한 Subject. 인증 주체가 사용되고 있는 경우는 null
반환값:
선택된 MBean 의 ObjectInstance 객체를 포함한 세트. 쿼리의 조건을 채우는 MBean 가 존재하지 않는 경우, 빈 상태(empty)의 리스트가 반환된다
예외:
IOException - 일반적인 통신 예외가 발생했을 경우

queryNames

public Set <ObjectName > queryNames(ObjectName  name,
                                  MarshalledObject  query,
                                  Subject  delegationSubject)
                           throws IOException 
인터페이스 RMIConnection 의 기술:
MBeanServerConnection.queryNames(ObjectName, QueryExp) 메소드를 처리합니다. QueryExp 는,MarshalledObject 에 랩 되고 있습니다.

정의:
인터페이스 RMIConnection 내의 queryNames
파라미터:
name - 취득하는 MBean 명을 식별하는 객체명 패턴. null 의 경우, 또는 도메인이나 키의 프로퍼티이 지정되어 있지 않은 경우는, 등록되어 모든 MBean 의 이름이 취득되는
query - MBean 의 선택에 적용되는 쿼리식. MarshalledObject 에 캡슐화되고 있다. MarshalledObject 에 null 치가 캡슐화되고 있는 경우, MBean 의 선택에 쿼리식은 적용되지 않는
delegationSubject - 위양 주체를 포함한 Subject. 인증 주체가 사용되고 있는 경우는 null
반환값:
선택된 MBean 의 ObjectName 를 포함한 세트. 쿼리의 조건을 채우는 MBean 가 존재하지 않는 경우, 빈 상태(empty)의 리스트가 반환된다
예외:
IOException - 일반적인 통신 예외가 발생했을 경우

isRegistered

public boolean isRegistered(ObjectName  name,
                            Subject  delegationSubject)
                     throws IOException 
인터페이스 RMIConnection 의 기술:
MBeanServerConnection.isRegistered(ObjectName) 메소드를 처리합니다.

정의:
인터페이스 RMIConnection 내의 isRegistered
파라미터:
name - 체크 대상의 MBean 의 객체명
delegationSubject - 위양 주체를 포함한 Subject. 인증 주체가 사용되고 있는 경우는 null
반환값:
MBean 가 벌써 MBean 서버에 등록되어 있는 경우는 true, 그렇지 않은 경우는 false
예외:
IOException - 일반적인 통신 예외가 발생했을 경우

getMBeanCount

public Integer  getMBeanCount(Subject  delegationSubject)
                      throws IOException 
인터페이스 RMIConnection 의 기술:
MBeanServerConnection.getMBeanCount() 메소드를 처리합니다.

정의:
인터페이스 RMIConnection 내의 getMBeanCount
파라미터:
delegationSubject - 위양 주체를 포함한 Subject. 인증 주체가 사용되고 있는 경우는 null
반환값:
등록을 마친 MBean 의 수
예외:
IOException - 일반적인 통신 예외가 발생했을 경우

getAttribute

public Object  getAttribute(ObjectName  name,
                           String  attribute,
                           Subject  delegationSubject)
                    throws MBeanException ,
                           AttributeNotFoundException ,
                           InstanceNotFoundException ,
                           ReflectionException ,
                           IOException 
인터페이스 RMIConnection 의 기술:
MBeanServerConnection.getAttribute(ObjectName, String) 메소드를 처리합니다.

정의:
인터페이스 RMIConnection 내의 getAttribute
파라미터:
name - MBean 의 객체명. 이 MBean 의 속성이 취득되는
attribute - 취득되는 속성의 이름을 지정하는 String
delegationSubject - 위양 주체를 포함한 Subject. 인증 주체가 사용되고 있는 경우는 null
반환값:
취득되는 속성의 값
예외:
MBeanException - MBean 의 취득 메소드에 의해 throw 되는 예외를 랩 하는 경우
AttributeNotFoundException - MBean 의 지정된 속성이 액세스 불능인 경우
InstanceNotFoundException - 지정된 MBean 가 MBean 서버에 등록되지 않은 경우
ReflectionException - 취득 메소드의 호출시에 throw 되는 java.lang.Exception 를 랩 하는 경우
IOException - 일반적인 통신 예외가 발생했을 경우
관련 항목:
RMIConnection.setAttribute(javax.management.ObjectName, java.rmi.MarshalledObject, javax.security.auth.Subject)

getAttributes

public AttributeList  getAttributes(ObjectName  name,
                                   String [] attributes,
                                   Subject  delegationSubject)
                            throws InstanceNotFoundException ,
                                   ReflectionException ,
                                   IOException 
인터페이스 RMIConnection 의 기술:
MBeanServerConnection.getAttributes(ObjectName, String[]) 메소드를 처리합니다.

정의:
인터페이스 RMIConnection 내의 getAttributes
파라미터:
name - MBean 의 객체명. 이 MBean 의 속성이 취득되는
attributes - 취득되는 속성의 리스트
delegationSubject - 위양 주체를 포함한 Subject. 인증 주체가 사용되고 있는 경우는 null
반환값:
취득되는 속성의 리스트
예외:
InstanceNotFoundException - 지정된 MBean 가 MBean 서버에 등록되지 않은 경우
ReflectionException - Dynamic MBean 의 getAttributes 메소드의 호출시에 예외가 발생했을 경우
IOException - 일반적인 통신 예외가 발생했을 경우
관련 항목:
RMIConnection.setAttributes(javax.management.ObjectName, java.rmi.MarshalledObject, javax.security.auth.Subject)

setAttribute

public void setAttribute(ObjectName  name,
                         MarshalledObject  attribute,
                         Subject  delegationSubject)
                  throws InstanceNotFoundException ,
                         AttributeNotFoundException ,
                         InvalidAttributeValueException ,
                         MBeanException ,
                         ReflectionException ,
                         IOException 
인터페이스 RMIConnection 의 기술:
MBeanServerConnection.setAttribute(ObjectName, Attribute) 메소드를 처리합니다. Attribute 파라미터는,MarshalledObject 에 랩 되고 있습니다.

정의:
인터페이스 RMIConnection 내의 setAttribute
파라미터:
name - MBean 명. 이 MBean 의 속성이 설정되는
attribute - 설정되는 속성과 설정 후 MarshalledObject 에 캡슐화되는 값의 ID
delegationSubject - 위양 주체를 포함한 Subject. 인증 주체가 사용되고 있는 경우는 null
예외:
InstanceNotFoundException - 지정된 MBean 가 MBean 서버에 등록되지 않은 경우
AttributeNotFoundException - MBean 의 지정된 속성이 액세스 불능인 경우
InvalidAttributeValueException - 지정된 값이, 속성에 대한 유효한 값이 아닌 경우
MBeanException - MBean 의 설정 메소드에 의해 throw 되는 예외를 랩 하는 경우
ReflectionException - 설정 메소드의 호출시에 throw 되는 java.lang.Exception 를 랩 하는 경우
IOException - 일반적인 통신 예외가 발생했을 경우
관련 항목:
RMIConnection.getAttribute(javax.management.ObjectName, java.lang.String, javax.security.auth.Subject)

setAttributes

public AttributeList  setAttributes(ObjectName  name,
                                   MarshalledObject  attributes,
                                   Subject  delegationSubject)
                            throws InstanceNotFoundException ,
                                   ReflectionException ,
                                   IOException 
인터페이스 RMIConnection 의 기술:
MBeanServerConnection.setAttributes(ObjectName, AttributeList) 메소드를 처리합니다. AttributeList 파라미터는,MarshalledObject 에 랩 되고 있습니다.

정의:
인터페이스 RMIConnection 내의 setAttributes
파라미터:
name - MBean 의 객체명. 이 MBean 의 속성이 설정되는
attributes - 속성의 리스트. 설정되는 속성과 설정 후 MarshalledObject 에 캡슐화되는 값의 ID
delegationSubject - 위양 주체를 포함한 Subject. 인증 주체가 사용되고 있는 경우는 null
반환값:
설정된 속성과 새로운 값의 리스트
예외:
InstanceNotFoundException - 지정된 MBean 가 MBean 서버에 등록되지 않은 경우
ReflectionException - Dynamic MBean 의 getAttributes 메소드의 호출시에 예외가 발생했을 경우
IOException - 일반적인 통신 예외가 발생했을 경우
관련 항목:
RMIConnection.getAttributes(javax.management.ObjectName, java.lang.String[], javax.security.auth.Subject)

invoke

public Object  invoke(ObjectName  name,
                     String  operationName,
                     MarshalledObject  params,
                     String [] signature,
                     Subject  delegationSubject)
              throws InstanceNotFoundException ,
                     MBeanException ,
                     ReflectionException ,
                     IOException 
인터페이스 RMIConnection 의 기술:
MBeanServerConnection.invoke(ObjectName, String, Object[], String[]) 메소드를 처리합니다. Object[] 파라미터는,MarshalledObject 에 랩 되고 있습니다.

정의:
인터페이스 RMIConnection 내의 invoke
파라미터:
name - 메소드의 호출을 하는 MBean 의 객체명
operationName - 불려 가는 오퍼레이션의 이름
params - 오퍼레이션이 불려 가MarshalledObject 에 캡슐화되었을 때 설정되는 파라미터를 포함한 배열. 캡슐화된 배열이 null 의 경우, 빈 상태(empty) 배열과 같은 의미가 되는
signature - 오퍼레이션의 시그니챠를 포함한 배열. 클래스 객체의 로드에는, 오퍼레이션을 호출한 MBean 를 로드할 때와 같은 클래스 로더가 사용된다. null 의 경우, 빈 상태(empty) 배열과 같은 의미가 되는
delegationSubject - 위양 주체를 포함한 Subject. 인증 주체가 사용되고 있는 경우는 null
반환값:
오퍼레이션에 의해 반환되는 객체. 지정된 MBean 상에서 오퍼레이션을 호출한 결과를 나타낸다
예외:
InstanceNotFoundException - 지정된 MBean 가 MBean 서버에 등록되지 않은 경우
MBeanException - MBean 의 호출 메소드에 의해 throw 되는 예외를 랩 하는 경우
ReflectionException - 메소드의 호출시에 throw 되는 java.lang.Exception 를 랩 하는 경우
IOException - 일반적인 통신 예외가 발생했을 경우

getDefaultDomain

public String  getDefaultDomain(Subject  delegationSubject)
                        throws IOException 
인터페이스 RMIConnection 의 기술:
MBeanServerConnection.getDefaultDomain() 메소드를 처리합니다.

정의:
인터페이스 RMIConnection 내의 getDefaultDomain
파라미터:
delegationSubject - 위양 주체를 포함한 Subject. 인증 주체가 사용되고 있는 경우는 null
반환값:
디폴트의 도메인
예외:
IOException - 일반적인 통신 예외가 발생했을 경우

getDomains

public String [] getDomains(Subject  delegationSubject)
                    throws IOException 
인터페이스 RMIConnection 의 기술:
MBeanServerConnection.getDomains() 메소드를 처리합니다.

정의:
인터페이스 RMIConnection 내의 getDomains
파라미터:
delegationSubject - 위양 주체를 포함한 Subject. 인증 주체가 사용되고 있는 경우는 null
반환값:
도메인의 리스트
예외:
IOException - 일반적인 통신 예외가 발생했을 경우

getMBeanInfo

public MBeanInfo  getMBeanInfo(ObjectName  name,
                              Subject  delegationSubject)
                       throws InstanceNotFoundException ,
                              IntrospectionException ,
                              ReflectionException ,
                              IOException 
인터페이스 RMIConnection 의 기술:
MBeanServerConnection.getMBeanInfo(ObjectName) 메소드를 처리합니다.

정의:
인터페이스 RMIConnection 내의 getMBeanInfo
파라미터:
name - 분석 대상의 MBean 의 이름
delegationSubject - 위양 주체를 포함한 Subject. 인증 주체가 사용되고 있는 경우는 null
반환값:
MBeanInfo 의 인스턴스. 이 MBean 의 모든 속성과 오퍼레이션의 취득을 허가한다
예외:
InstanceNotFoundException - 지정된 MBean 가 발견되지 않았던 경우
IntrospectionException - 인트로스페크션중에 예외가 발생했을 경우
ReflectionException - Dynamic MBean 의 getMBeanInfo 메소드의 호출시에 예외가 발생했을 경우
IOException - 일반적인 통신 예외가 발생했을 경우

isInstanceOf

public boolean isInstanceOf(ObjectName  name,
                            String  className,
                            Subject  delegationSubject)
                     throws InstanceNotFoundException ,
                            IOException 
인터페이스 RMIConnection 의 기술:
MBeanServerConnection.isInstanceOf(ObjectName, String) 메소드를 처리합니다.

정의:
인터페이스 RMIConnection 내의 isInstanceOf
파라미터:
name - MBean 의 ObjectName
className - 클래스의 이름
delegationSubject - 위양 주체를 포함한 Subject. 인증 주체가 사용되고 있는 경우는 null
반환값:
상기의 규칙에 따라, 지정된 MBean 가 지정된 클래스의 인스턴스인 경우는 true, 그렇지 않은 경우는 false
예외:
InstanceNotFoundException - 지정된 MBean 가 MBean 서버에 등록되지 않은 경우
IOException - 일반적인 통신 예외가 발생했을 경우

addNotificationListeners

public Integer [] addNotificationListeners(ObjectName [] names,
                                          MarshalledObject [] filters,
                                          Subject [] delegationSubjects)
                                   throws InstanceNotFoundException ,
                                          IOException 
인터페이스 RMIConnection 의 기술:

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

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

클라이언트 측에는, 청취자 마다 원의 NotificationListenerhandback 가 보관 유지됩니다. 클라이언트가 이것들을 식별할 수 있도록(듯이), 서버는 일의의 listenerID 를 생성해, 돌려줍니다. 이 listenerIDNotification 와 함께 원격 클라이언트에 전송 됩니다.

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

정의:
인터페이스 RMIConnection 내의 addNotificationListeners
파라미터:
names - Notification 의 발행원 MBean 를 식별하는 ObjectName
filters - NotificationFilter 의 정렬화 된 표현으로부터 완성되는 배열. 이 배열의 요소는 null 이라도 좋다.
delegationSubjects - Subject. 이 Subject (복수가능) 대신에 청취자가 추가된다. 이 배열의 요소는 null 이라도 좋다. 또,delegationSubjects 파라미터 자체가 null 여도 괜찮다. 이 경우, 이 배열은,name 배열이나 filter 배열과 같은 사이즈의 null 치로부터 완성되는 배열과 동등하게 된다
반환값:
로컬 청취자를 식별하는 listenerID 로부터 완성되는 배열. 이 배열은 파라미터와 같은 수의 요소를 가진다
예외:
InstanceNotFoundException - name 중 한쪽이 등록이 끝난 MBean 에 대응하고 있지 않는 경우
IOException - 일반적인 통신 예외가 발생했을 경우

addNotificationListener

public void addNotificationListener(ObjectName  name,
                                    ObjectName  listener,
                                    MarshalledObject  filter,
                                    MarshalledObject  handback,
                                    Subject  delegationSubject)
                             throws InstanceNotFoundException ,
                                    IOException 
인터페이스 RMIConnection 의 기술:
MBeanServerConnection.addNotificationListener(ObjectName, ObjectName, NotificationFilter, Object) 메소드를 처리합니다. NotificationFilter 파라미터는,MarshalledObject 에 랩 되고 있습니다. Object (핸드백) 파라미터도,MarshalledObject 에 랩 되고 있습니다.

정의:
인터페이스 RMIConnection 내의 addNotificationListener
파라미터:
name - 청취자가 추가되는 MBean 의 이름
listener - 등록이 끝난 MBean 가 발행한 통지를 처리하는 청취자의 객체명
filter - MarshalledObject 에 캡슐화된 필터 객체. MarshalledObject 에 캡슐화된 필터가 null 치를 가지는 경우, 통지의 처리전에 필터링은 행해지지 않는
handback - 통지가 발행되었을 때 청취자에게 송신되는 문맥. MarshalledObject 에 캡슐화되고 있는
delegationSubject - 위양 주체를 포함한 Subject. 인증 주체가 사용되고 있는 경우는 null
예외:
InstanceNotFoundException - 등록이 끝난 MBean 안에, 통지 청취자 또는 통지 브로드 캐스터의 MBean 명이 없는 경우
IOException - 일반적인 통신 예외가 발생했을 경우
관련 항목:
RMIConnection.removeNotificationListener(ObjectName, ObjectName, Subject) , RMIConnection.removeNotificationListener(ObjectName, ObjectName, MarshalledObject, MarshalledObject, Subject)

removeNotificationListeners

public void removeNotificationListeners(ObjectName  name,
                                        Integer [] listenerIDs,
                                        Subject  delegationSubject)
                                 throws InstanceNotFoundException ,
                                        ListenerNotFoundException ,
                                        IOException 
인터페이스 RMIConnection 의 기술:

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

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

NotificationListener 는,RMIConnection.addNotificationListeners(ObjectName[], MarshalledObject[], Subject[]) 메소드로부터 반환된 ID 에 의해 식별됩니다.

정의:
인터페이스 RMIConnection 내의 removeNotificationListeners
파라미터:
name - Notification 의 발행원 MBean 를 식별하는 ObjectName
listenerIDs - 삭제하는 청취자에게 대응하는 ID 의 리스트
delegationSubject - 위양 주체를 포함한 Subject. 인증 주체가 사용되고 있는 경우는 null
예외:
InstanceNotFoundException - 지정된 name 가 등록이 끝난 MBean 에 대응하고 있지 않는 경우
ListenerNotFoundException - 서버 측에 발견되지 않는 청취자가 있는 경우. 이 예외는, MBean 가,MBeanServer.removeNotificationListener 의 호출해 이외의 하등의 이유로써 청취자를 파기했을 때 발행된다
IOException - 일반적인 통신 예외가 발생했을 경우

removeNotificationListener

public void removeNotificationListener(ObjectName  name,
                                       ObjectName  listener,
                                       Subject  delegationSubject)
                                throws InstanceNotFoundException ,
                                       ListenerNotFoundException ,
                                       IOException 
인터페이스 RMIConnection 의 기술:
MBeanServerConnection.removeNotificationListener(ObjectName, ObjectName) 메소드를 처리합니다.

정의:
인터페이스 RMIConnection 내의 removeNotificationListener
파라미터:
name - 청취자가 삭제되는 MBean 의 이름
listener - 삭제되는 청취자의 객체명
delegationSubject - 위양 주체를 포함한 Subject. 인증 주체가 사용되고 있는 경우는 null
예외:
InstanceNotFoundException - 등록이 끝난 MBean 안에, 지정된 MBean 명이 없는 경우
ListenerNotFoundException - 청취자가 MBean 에 등록되지 않은 경우
IOException - 일반적인 통신 예외가 발생했을 경우
관련 항목:
RMIConnection.addNotificationListener(javax.management.ObjectName, javax.management.ObjectName, java.rmi.MarshalledObject, java.rmi.MarshalledObject, javax.security.auth.Subject)

removeNotificationListener

public void removeNotificationListener(ObjectName  name,
                                       ObjectName  listener,
                                       MarshalledObject  filter,
                                       MarshalledObject  handback,
                                       Subject  delegationSubject)
                                throws InstanceNotFoundException ,
                                       ListenerNotFoundException ,
                                       IOException 
인터페이스 RMIConnection 의 기술:
MBeanServerConnection.removeNotificationListener(ObjectName, ObjectName, NotificationFilter, Object) 메소드를 처리합니다. NotificationFilter 파라미터는,MarshalledObject 에 랩 되고 있습니다. Object 파라미터도,MarshalledObject 에 랩 되고 있습니다.

정의:
인터페이스 RMIConnection 내의 removeNotificationListener
파라미터:
name - 청취자가 삭제되는 MBean 의 이름
listener - 이전에 이 MBean 에 추가된 청취자
filter - 청취자의 추가시로 지정된 필터. MarshalledObject 에 캡슐화되고 있는
handback - 청취자의 추가시로 지정된 핸드백. MarshalledObject 에 캡슐화되고 있는
delegationSubject - 위양 주체를 포함한 Subject. 인증 주체가 사용되고 있는 경우는 null
예외:
InstanceNotFoundException - 등록이 끝난 MBean 안에, 지정된 MBean 명이 없는 경우
ListenerNotFoundException - 청취자가 MBean 에 등록되지 않은 경우, 또는 지정된 필터 및 핸드백으로 등록되지 않은 경우
IOException - 일반적인 통신 예외가 발생했을 경우
관련 항목:
RMIConnection.addNotificationListener(javax.management.ObjectName, javax.management.ObjectName, java.rmi.MarshalledObject, java.rmi.MarshalledObject, javax.security.auth.Subject)

fetchNotifications

public NotificationResult  fetchNotifications(long clientSequenceNumber,
                                             int maxNotifications,
                                             long timeout)
                                      throws IOException 
인터페이스 RMIConnection 의 기술:

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

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

정의:
인터페이스 RMIConnection 내의 fetchNotifications
파라미터:
clientSequenceNumber - 클라이언트가 대기하는 최초의 순서 번호. 0 보다 작은 값의 경우, 다음의 통지의 순서 번호라고 해석되는
maxNotifications - 반환되는 다른 통지의 최대수. 같은 통지가 반복해 발행되는 경우, 반환되는 NotificationResult 에 포함되는 TargetedNotification 배열은, 이 값보다 많은 요소를 가질 수가 있다. 이 파라미터의 값이 부의 경우의 동작은 부정
timeout - 통지의 착신을 기다리는 최대 시간 (밀리 세컨드 단위). 0 의 경우, 통지가 없으면 메소드는 대기하지 않고, 즉시 종료한다. Long.MAX_VALUE 의 경우, 타임 아웃은 설정되지 않는다. 이 파라미터의 값이 부의 경우의 동작은 부정
반환값:
NotificationResult
예외:
IOException - 일반적인 통신 예외가 발생했을 경우

toString

public String  toString()

이 객체의 캐릭터 라인 표현을 돌려줍니다. 일반적으로,toString 메소드는 이 객체를 「텍스트로 표현한다」캐릭터 라인을 돌려줍니다. 이 결과는, 인간이 읽을 수 있는 간결하고 유익한 정보여야 합니다.

오버라이드(override):
클래스 Object 내의 toString
반환값:
이 객체의 String 표현

JavaTM Platform
Standard Ed. 6

버그의 보고와 기능의 요청
한층 더 자세한 API 레퍼런스 및 개발자 문서에 대해서는,Java SE 개발자용 문서를 참조해 주세요. 개발자전용의 상세한 해설, 개념의 개요, 용어의 정의, 버그의 회피책, 및 코드 실례가 포함되어 있습니다.

Copyright 2006 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms . Documentation Redistribution Policy 도 참조해 주세요.