javax.management.remote
인터페이스 JMXConnector

알려진 구현 클래스 목록:

RMIConnector

public interface JMXConnector

JMX API 커넥터의 클라이언트측입니다. 이 형태의 객체는 커넥터 서버에 접속하기 위해서 사용할 수 있습니다.

이 형태의 새롭게 작성된 객체는 접속되지 않습니다. 이 객체를 사용하기 위해서는 connect 메서드를 호출할 필요가 있습니다. 다만, JMXConnectorFactory.connect 로 작성된 객체는 이미 접속되고 있습니다.

도입된 버전 :

1.5

필드 개요

static String

CREDENTIALS 접속중에 커넥터 서버에 송신하는 인증서를 지정하는 속성의 이름입니다.

메서드 개요

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

필드의 상세

CREDENTIALS

static final String  CREDENTIALS

접속중에 커넥터 서버에 송신하는 인증서를 지정하는 속성의 이름입니다. 이 속성에 관련된 값은 서버 JMXAuthenticator 적절한 형태의 직렬화 가능한 객체입니다.

관련 항목:

정수 필드값

메서드의 상세

connect

void connect()
             throws IOException 

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

예외:

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

SecurityException - 보안상의 이유에 의해 접속을 확립할 수 없었던 경우

connect

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

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

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

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

파라미터:

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

예외:

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

SecurityException - 보안상의 이유에 의해 접속을 확립할 수 없었던 경우

getMBeanServerConnection

MBeanServerConnection  getMBeanServerConnection()
                                               throws IOException 

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

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

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

반환값:

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

예외:

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

getMBeanServerConnection

MBeanServerConnection  getMBeanServerConnection(Subject  delegationSubject)
                                               throws IOException 

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

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

파라미터:

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

반환값:

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

예외:

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

close

void close()
           throws IOException 

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

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

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

예외:

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

addConnectionNotificationListener

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

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

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

파라미터:

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

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

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

예외:

NullPointerException - listener가 null인 경우

관련 항목:

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

removeConnectionNotificationListener

void removeConnectionNotificationListener(NotificationListener  listener)
                                          throws ListenerNotFoundException 

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

파라미터:

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

예외:

NullPointerException - listener가 null인 경우

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

관련 항목:

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

removeConnectionNotificationListener

void removeConnectionNotificationListener(NotificationListener  l,
                                          NotificationFilter  f,
                                          Object  handback)
                                          throws ListenerNotFoundException 

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

파라미터:

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

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

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

예외:

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

관련 항목:

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

getConnectionId

String  getConnectionId()
                       throws IOException 

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

반환값:

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

예외:

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