javax.management.remote.rmi
클래스 RMIConnector

java.lang.Object 
  javax.management.remote.rmi.RMIConnector

모든 구현된 인터페이스:

Serializable, JMXConnector

public class RMIConnector
extends Object 
implements JMXConnector,
 Serializable 

리모트 RMI 커넥터에의 접속입니다. 보통, 이러한 접속은, JMXConnectorFactory 로 작성됩니다. 그러나, JNDI를 사용하지 않고 취득되는 RMIServer 스텁 등에의해 이 클래스를 직접 사용하는 특수한 어플리케이션도 있습니다.

도입된 버전 :

1.5

관련 항목:

직렬화 된 형식

필드 개요

인터페이스 javax.management.remote. JMXConnector 로부터 상속된 필드

CREDENTIALS

생성자 개요

RMIConnector (JMXServiceURL url, Map <String, ? > environment)
지정된 주소의 RMI 커넥터 서버에 접속하는 RMIConnector를 구축합니다.

RMIConnector (RMIServer rmiServer, Map <String, ? > environment)
지정된 RMI 스텁을 사용해 RMIConnector를 구축합니다.

메서드 개요

void	addConnectionNotificationListener (NotificationListener listener, NotificationFilter filter, Object handback) 접속 상태의 변화가 통지되는 리스너를 추가합니다.
void	close () 클라이언트와 서버의 접속을 종료합니다.
void	connect () 커넥터 서버와의 접속을 확립합니다.
void	connect (Map <String, ? > environment) 커넥터 서버와의 접속을 확립합니다.
String	getConnectionId () 커넥터 서버로부터, 이 접속의 ID를 취득합니다.
MBeanServerConnection	getMBeanServerConnection () 리모트 MBean 서버를 나타내는 MBeanServerConnection 객체를 리턴합니다.
MBeanServerConnection	getMBeanServerConnection (Subject delegationSubject) 제공된 위양 대상 대신에 오퍼레이션을 실행하는 리모트 MBean 서버를 나타내는 MBeanServerConnection 객체를 리턴합니다.
void	removeConnectionNotificationListener (NotificationListener listener) 상태의 변경이 통지되는 리스너를 리스트로부터 삭제합니다.
void	removeConnectionNotificationListener (NotificationListener listener, NotificationFilter filter, Object handback) 상태의 변경이 통지되는 리스너를 리스트로부터 삭제합니다.
String	toString () 이 객체의 캐릭터 라인 표현을 리턴합니다.

클래스 java.lang. Object 로부터 상속된 메서드

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

생성자 상세

RMIConnector

public RMIConnector(JMXServiceURL  url,
                    Map <String,
? > environment)

지정된 주소의 RMI 커넥터 서버에 접속하는 RMIConnector를 구축합니다.

주소는 커넥터 서버를 직접 참조할 수 있습니다. 다음의 몇개의 구문을 사용합니다.

 service:jmx:rmi://[host[:port]]/stub/encoded-stub
 service:jmx:iiop://[host[:port]]/ior/encoded-IOR
 

꺽쇄묶음 [] 은 주소의 일부에서는 없고, 호스트와 포트가 옵션인 것을 나타냅니다.

주소를 사용해, JNDI 로부터 RMI 스텁을 검색하는 장소를 나타낼 수도 있습니다. 다음의 몇개의 구문을 사용합니다.

 service:jmx:rmi://[host[:port]]/jndi/jndi-name
 service:jmx:iiop://[host[:port]]/jndi/jndi-name
 

구현도 추가 주소 구문을 인식할 수 있습니다. 다음에 예를 나타냅니다.

 service:jmx:iiop://[host[:port]]/stub/encoded-stub
 

파라미터:

url - RMI 커넥터 서버의 주소

environment - 접속의 작성 방법을 지정하는 추가 속성. JNDI 베이스의 주소의 경우, 이러한 속성에 InitialContext 에 의해 인식되는 JNDI 속성이 포함된다. 이 파라미터가 null인 경우, 비어있는 Map를 지정했을 경우와 같게 된다

예외:

IllegalArgumentException - url가 null인 경우

RMIConnector

public RMIConnector(RMIServer  rmiServer,
                    Map <String,
? > environment)

지정된 RMI 스텁을 사용해 RMIConnector를 구축합니다.

파라미터:

rmiServer - RMI 커넥터 서버를 나타내는 RMI 스텁

environment - 접속의 작성 방법을 지정하는 추가 속성. 이 파라미터가 null인 경우, 비어있는 Map를 지정했을 경우와 같게 된다

예외:

IllegalArgumentException - rmiServer가 null인 경우

메서드의 상세

toString

public String  toString()

이 객체의 캐릭터 라인 표현을 리턴합니다. 보통, toString 메서드는 이 객체를 「텍스트로 표현한다」캐릭터 라인을 리턴합니다. 이 결과는 인간이 읽을 수 있는 간결하고 유익한 정보여야 합니다.

오버라이드(override):

클래스 Object 내의 toString

반환값:

이 객체의 String 표현

connect

public void connect()
             throws IOException 

인터페이스 JMXConnector 기술:

커넥터 서버와의 접속을 확립합니다. 이 메서드는 connect(null) 와 동등합니다.

정의:

인터페이스 JMXConnector 내의 connect

예외:

IOException - 통신 장해에 의해 접속을 확립할 수 없었던 경우

connect

public void connect(Map <String,
? > environment)
             throws IOException 

인터페이스 JMXConnector 기술:

커넥터 서버와의 접속을 확립합니다.

이 객체상에서 이미 connect이 불려가 고 있는 경우, 이제 1회 호출해도 아무것도 일어나지 않습니다. 한편, connect 나중에 JMXConnector.close() 가 불려가 고 있는 경우, 재차 connect를 호출하면 IOException가 발생 됩니다.

이 객체상에서 connect이 1회 도 불려가 지 않은 경우, 또는 호출에 대해서 예외가 생성되었을 경우, connect를 호출하면 커넥터 서버와의 접속이 시행됩니다.

정의:

인터페이스 JMXConnector 내의 connect

파라미터:

environment - 접속의 프로퍼티. 이 맵내의 프로퍼티는 JMXConnector 작성시로 지정된 맵내의 프로퍼티를 오버라이드(override) 한다. 이 파라미터가 null인 경우, 비어있는 맵을 지정했을 경우와 같은 것이 된다

예외:

IOException - 통신 장해에 의해 접속을 확립할 수 없었던 경우

getConnectionId

public String  getConnectionId()
                       throws IOException 

인터페이스 JMXConnector 기술:

커넥터 서버로부터, 이 접속의 ID를 취득합니다. 커넥터 서버내의 모든 접속은 일의의 ID를 가져, 이 ID는 접속의 수명이 다할 때까지 바뀌지 않습니다.

정의:

인터페이스 JMXConnector 내의 getConnectionId

반환값:

이 접속의 일의의 ID. 커넥터 서버가 JMXConnectionNotification에 포함하는 ID와 같다. package description 는 접속 ID 규약의 설명

예외:

IOException - 접속의 종료, 중단등이 원인으로 접속 ID를 취득할 수 없는 경우

getMBeanServerConnection

public MBeanServerConnection  getMBeanServerConnection()
                                               throws IOException 

인터페이스 JMXConnector 기술:

리모트 MBean 서버를 나타내는 MBeanServerConnection 객체를 리턴합니다. 보통, JMXConnector에 대해서 이 메서드를 2회 호출했을 경우, 각 호출로 같은 MBeanServerConnection 객체가 리턴됩니다 . 다만, 이것은 필수 조건이 아닙니다.

리턴된 MBeanServerConnection 내의 각 메서드에 대해서 이 메서드를 호출하면, 리모트 MBean 서버내의 대응하는 메서드가 호출됩니다. MBean 서버 메서드에 의해 리턴된 값이, 클라이언트에 리턴된 값이 됩니다. MBean 서버 메서드가 Exception을 Throw 했을 경우, 클라이언트에는 같은 Exception가 리턴됩니다 . MBean 서버 메서드 자체, 또는 그 호출의 시행으로 Error가 발생했을 경우, 클라이언트에는 발생한 Error를 감싸는 JMXServerErrorException이 리턴됩니다 .

이 메서드의 호출은, getMBeanServerConnection(null) 호출과 동등합니다. 위양 대상이 지정되지 않고, MBeanServerConnection 상에서 불려 간 모든 오퍼레이션은 인증 대상 (존재하는 경우)을 사용할 필요가 있습니다.

정의:

인터페이스 JMXConnector 내의 getMBeanServerConnection

반환값:

메서드를 리모트 MBean 서버에 전송 하는 것으로써 MBeanServerConnection인터페이스를 구현하는 객체

예외:

IOException - 유효한 MBeanServerConnection을 작성할 수 없는 경우. 예를 들어, connect 메서드에 한 리모트 MBean 서버와의 접속이 아직 확립되어 있지 않은 경우, MBean 서버와의 접속이 이미 종료하고 있는 경우, 접속이 중단되었을 경우 등

getMBeanServerConnection

public MBeanServerConnection  getMBeanServerConnection(Subject  delegationSubject)
                                               throws IOException 

인터페이스 JMXConnector 기술:

제공된 위양 대상 대신에 오퍼레이션을 실행하는 리모트 MBean 서버를 나타내는 MBeanServerConnection 객체를 리턴합니다. 보통, JMXConnector 및 Subject에 대해서 이 메서드를 2회 호출했을 경우, 각 호출로 같은 MBeanServerConnection 객체가 리턴됩니다 . 다만, 이것은 필수 조건이 아닙니다.

리턴된 MBeanServerConnection 내의 각 메서드에 대해서 이 메서드를 호출하면, 인증 대상은 아니고 위양 대상에 대신해, 리모트 MBean 서버내의 대응하는 메서드가 호출됩니다. MBean 서버 메서드에 의해 리턴된 값이, 클라이언트에 리턴된 값이 됩니다. MBean 서버 메서드가 Exception을 Throw 했을 경우, 클라이언트에는 같은 Exception가 리턴됩니다 . MBean 서버 메서드 자체, 또는 그 호출의 시행으로 Error가 발생했을 경우, 클라이언트에는 발생한 Error를 감싸는 JMXServerErrorException이 리턴됩니다 .

정의:

인터페이스 JMXConnector 내의 getMBeanServerConnection

파라미터:

delegationSubject - Subject. 이것 대신에 요구가 실행된다. null인 경우, 인증이 끝난 Subject 대신에 요구가 실행된다

반환값:

메서드를 리모트 MBean 서버에 전송 하는 것으로써, 위양 대상 대신에 MBeanServerConnection인터페이스를 구현하는 객체

예외:

IOException - 유효한 MBeanServerConnection을 작성할 수 없는 경우. 예를 들어, connect 메서드에 한 리모트 MBean 서버와의 접속이 아직 확립되어 있지 않은 경우, MBean 서버와의 접속이 이미 종료하고 있는 경우, 접속이 중단되었을 경우 등

addConnectionNotificationListener

public void addConnectionNotificationListener(NotificationListener  listener,
                                              NotificationFilter  filter,
                                              Object  handback)

인터페이스 JMXConnector 기술:

접속 상태의 변화가 통지되는 리스너를 추가합니다. 이 리스너는 JMXConnectionNotification 형의 통지를 수신합니다. 구현에의해 이외의 형태의 통지가 송신되는 경우도 있습니다.

이 메서드에 추가할 수 있는 리스너의 수에 제한은 없습니다. 필터와 핸드백에 동일한 값 또는 다른 값을 지정해, 동일한 리스너를 반복해 추가하는 일도 가능합니다. 복제 엔트리도 특별 취급 되지 않습니다. 예를 들어 리스너를 필터없이 2회 등록했을 경우, 각 통지로 이 리스너의 handleNotification 메서드가 2회 호출합니다.

정의:

인터페이스 JMXConnector 내의 addConnectionNotificationListener

파라미터:

listener - 접속 상태 통지를 받는 리스너

filter - 리스너에게 전달되는 통지를 선택하는 필터. 모든 통지를 전달하는 경우는 null

handback - 각 통지와 함께 리스너에게 건네지는 객체. null도 가능

관련 항목:

JMXConnector.removeConnectionNotificationListener(javax.management.NotificationListener), NotificationBroadcaster.addNotificationListener(javax.management.NotificationListener, javax.management.NotificationFilter, java.lang.Object)

removeConnectionNotificationListener

public void removeConnectionNotificationListener(NotificationListener  listener)
                                          throws ListenerNotFoundException 

인터페이스 JMXConnector 기술:

상태의 변경이 통지되는 리스너를 리스트로부터 삭제합니다. 삭제 대상으로의해 지정할 수 있는 것은 이전에 추가된 리스너만입니다. 조건에 해당하는 리스너가 복수 존재하는 경우, 모두 삭제됩니다.

정의:

인터페이스 JMXConnector 내의 removeConnectionNotificationListener

파라미터:

listener - 접속 상태 통지를 받는 리스너

예외:

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

관련 항목:

JMXConnector.removeConnectionNotificationListener(NotificationListener, NotificationFilter, Object), JMXConnector.addConnectionNotificationListener(javax.management.NotificationListener, javax.management.NotificationFilter, java.lang.Object), NotificationEmitter.removeNotificationListener(javax.management.NotificationListener, javax.management.NotificationFilter, java.lang.Object)

removeConnectionNotificationListener

public void removeConnectionNotificationListener(NotificationListener  listener,
                                                 NotificationFilter  filter,
                                                 Object  handback)
                                          throws ListenerNotFoundException 

인터페이스 JMXConnector 기술:

상태의 변경이 통지되는 리스너를 리스트로부터 삭제합니다. 삭제 대상으로의해 지정할 수 있는 것은 이전에 같은 3개의 파라미터로 추가된 리스너만입니다. 조건에 해당하는 리스너가 복수 존재하는 경우도, 삭제되는 것은 1개 뿐입니다.

정의:

인터페이스 JMXConnector 내의 removeConnectionNotificationListener

파라미터:

listener - 접속 상태 통지를 받는 리스너

filter - 리스너에게 전달되는 통지를 선택하는 필터. null도 가능

handback - 각 통지와 함께 리스너에게 건네지는 객체. null도 가능

예외:

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

관련 항목:

JMXConnector.removeConnectionNotificationListener(NotificationListener), JMXConnector.addConnectionNotificationListener(javax.management.NotificationListener, javax.management.NotificationFilter, java.lang.Object), NotificationEmitter.removeNotificationListener(javax.management.NotificationListener, javax.management.NotificationFilter, java.lang.Object)

close

public void close()
           throws IOException 

인터페이스 JMXConnector 기술:

클라이언트와 서버의 접속을 종료합니다. 현행의 요구 또는 새로운 요구가JMXConnector.getMBeanServerConnection() 로부터 리턴된 MBeanServerConnection를 사용하는 경우, IOException가 발생 됩니다.

이 객체상에서 이미 close가 불려가 고 있는 경우, 이제 1회 호출해도 아무것도 일어나지 않습니다. close가 1회 도 불려가 지 않은 경우, 또는 호출에 대해서 예외가 생성되었을 경우는 접속의 종료가 시행됩니다. 이 시행에 성공했을 경우, close는 보통 대로 종료합니다. 실패했을 경우는 예외가 생성되는 일이 있습니다.

접속의 종료는 시간이 걸리는 오퍼레이션입니다. 예를 들어 서버가 크래쉬 했을 경우, 종료 오퍼레이션은 네트워크 프로토콜의 타임 아웃까지 중단될 가능성이 있습니다. 종료 오퍼레이션의 도중에 기다리게 되고 싶지 않은 경우는 별thread로 실행해 주세요.

정의:

인터페이스 JMXConnector 내의 close

예외:

IOException - 접속을 정상적으로 종료할 수 없는 경우. 이 예외가 Throw 되었을 경우, 접속의 서버측이 정상적으로 종료했는지 어떠했는지는 불명