패키지 javax.management.remote

JMX MBean 서버에 원격 접근하기 위한 인터페이스입니다.

참조처:
설명

인터페이스 개요

JMXAuthenticator	리모트 인증서를 JAAS Subject 로 변환하는 방법을 정의하는 인터페이스입니다.
JMXConnector	JMX API 커넥터의 클라이언트측입니다.
JMXConnectorProvider	지정의 프로토콜을 사용해 JMX API 커넥터 클라이언트를 작성하기 위한 프로바이더입니다.
JMXConnectorServerMBean	커넥터 서버의 MBean 인터페이스입니다.
JMXConnectorServerProvider	지정의 프로토콜을 사용해 JMX API 커넥터 서버를 작성하기 위한 프로바이더입니다.
MBeanServerForwarder	이 클래스의 객체는 MBeanServer 인터페이스를 구현해, 이 인터페이스를 구현하는 객체를 1개 랩 합니다.

클래스 개요

JMXConnectionNotification	클라이언트 접속의 개시 및 종료시와 통지가 없어졌을 때에 발행되는 통지입니다.
JMXConnectorFactory	JMX API 커넥터 클라이언트를 작성하는 팩토리입니다.
JMXConnectorServer	모든 커넥터 서버의 슈퍼 클래스입니다.
JMXConnectorServerFactory	JMX API 커넥터 서버를 작성하는 팩토리입니다.
JMXPrincipal	JMX 리모트 API.
JMXServiceURL	JMX API 커넥터 서버의 주소입니다.
NotificationResult	버퍼 이용 통지의 쿼리의 결과입니다.
SubjectDelegationPermission	승인자식 덴티티에 대신해 오퍼레이션을 실행하는 인증자식 덴티티에 필요한 접근 권한입니다.
TargetedNotification	통지와 리스너 ID 페어 (Notification, Listener ID)입니다.

예외 개요

JMXProviderException	요구된 프로토콜의 프로바이더가 존재하지만, 어떠한 이유로써 사용할 수 없는 경우에 JMXConnectorFactory 에 의해 발생되는 예외입니다.
JMXServerErrorException	리모트 MBean 서버내에서 호출을 처리하고 있는 동안에 Error가 Throw 되었을 경우, MBeanServer 메서드의 리모트 호출의 결과로서 발생되는 예외입니다.

패키지 javax.management.remote 설명

JMX MBean 서버에 원격 접근하기 위한 인터페이스입니다. 이 패키지는 JMX MBean 서버를 remote administration 하기 위해서 필요한 인터페이스를 정의합니다. 이 인터페이스의 사양은 부속의 「JMX Remote API」에 기재되어 있습니다. 이 문서는 이 Javadoc 사양과 같은 장소에 PDF 문서로서 포함되어 있습니다.

커넥터의 개념에 대해 정의하는 JMX 사양입니다. 커넥터를 JMX API MBean 서버에 접속하는 것으로써, 이 서버를 리모트 Java 클라이언트로 이용할 수 있게 됩니다. 커넥터의 클라이언트측은 기본적으로 MBean 서버와 같은 인터페이스, 즉 MBeanServerConnection 를 export 합니다.

커넥터에의해 지정의 프로토콜 경유로 MBean 서버에 원격 접근 할 수 있게 됩니다.
예를 들어 JMX 리모트 API에 정의되고 있는 표준 커넥터, RMI 커넥터에서는 RMI 경유로 MBeanServer에 원격 접근 할 수 있습니다.
JMX 리모트 API 에는 옵션으로서JMXMP (JMX 메세지 프로토콜)도 정의되고 있습니다. JMXMP는 옵션 패키지 javax.management.remote.message에 정의된 직렬화 Java 객체와 TCP 접속을 이용합니다. 이 프로토콜을 구현하는 커넥터를 JMXMP 커넥터라고 부릅니다. JMXConnectorFactory 와 옵션의 범용 커넥터 (javax.management.remote.generic)를 사용해, 사용자 정의의 커넥터 프로토콜도 사용할 수 있습니다.

커넥터 주소

보통, 커넥터는 JMXServiceURL 클래스에 의해 나타내지는 주소를 가지고 있습니다. JMXMP 커넥터의 주소는 다음과 같은 형식을 취합니다.

 service:jmx:jmxmp://myhost:9876 

RMI 커넥터의 주소에는 몇개의 형식이 있습니다. 자세한 내용은 javax.management.remote.rmi 패키지에 관한 문서를 참조하십시오.

커넥터 서버의 작성

커넥터 서버는 JMXConnectorServer 서브 클래스의 인스턴스를 구축하는 것으로 작성됩니다. 보통, 이 인스턴스는 JMXConnectorServerFactory.newJMXConnectorServer 메서드에 의해 작성됩니다.

보통, 커넥터 서버와 MBean 서버가 관련짓고는 커넥터 서버를 MBean 서버에 등록하는지, 커넥터 서버의 작성시에 파라미터로서 MBean 서버를 지정하는 것에 의해 행해집니다.

커넥터 클라이언트의 작성

보통, 커넥터 클라이언트는 JMXConnectorFactory.connect 메서드에 JMXServiceURL를 지정하는 것으로써 작성됩니다.

보다 특수한 용도로 사용하는 경우는 RMIConnector 클래스 등, JMXConnector 인터페이스를 구현하는 클래스를 직접 인스턴스화해도, 클라이언트 커넥터를 작성할 수 있습니다.

클라이언트 또는 서버의 그 외의 파라미터

커넥터 클라이언트나 커넥터 서버의 작성시에는 추가 파라미터를 정의하는 Map 형의 객체를 지정할 수 있습니다 . 이 Map 내의 각 엔트리는 캐릭터 라인으로 나타내지는 키와 그 키에 적절한 형태의 관련값을 갖추고 있습니다. JMX 리모트 API에 의해 정의된 모든 표준 키의 선두 캐릭터 라인은, jmx.remote 입니다. 이러한 표준 키에 대해서는 「JMX Remote API」를 참조하십시오.

접속 식별자

커넥터 서버에 의해 유효화 된 모든 접속은, 접속 ID 로 불리는 캐릭터 라인의 식별자를 갖추고 있습니다. 이 식별자는 커넥터 서버에 의해 발행되는 JMXConnectionNotification 이벤트내, JMXConnectorServerMBean#getConnectionIds() 에 의해 리턴된 리스트내 및 클라이언트의 getConnectionId() 메서드에 의해 리턴된 값에 포함됩니다.

관례로서 접속 ID는 다음의 형식을 취합니다.

jmxmp://clienthost:6789 clientname xxxyyyzzz 

이 규칙에 따르는 접속 ID 정규 문법은 다음과 같습니다 ( 「The Java Language Specification, Second Edition」의 문법 개념을 사용).

ConnectionId: Protocol :
 ClientAddressopt Space ClientIdoptSpace ArbitraryText
ClientAddress: // HostAddress ClientPortopt
ClientPort : HostPort 

Protocol는 JMXConnectorFactory 에 의해 인식되는 프로토콜입니다.

ClientAddress는 접속 클라이언트의 주소 및 포트입니다 (판별 가능한 경우만). HostAddress는 클라이언트의 접속원호스트의 인터넷 주소를 수치 또는 DNS 형식에서 나타낸 것입니다. IPv6 수치 주소는 꺽쇄묶음 [] 으로 둘러싸인 형식에서 나타내집니다. HostPort는 클라이언트의 접속원의 10 진포트 번호입니다.

ClientId는 쿠라이안트엔티티의자식 덴티티입니다. 보통, JMXPrincipal.getName() 에 의해 리턴된 캐릭터 라인에 일치합니다. 이 캐릭터 라인에 공백 문자를 포함할 수 없습니다.

ArbitraryText는 클라이언트 ID 작성시에 커넥터 서버에 의해 추가되는 임의의 추가 텍스트입니다. 최소한, 현재 이 커넥터 서버에 의해 유효화 되고 있는 그 외의 접속의 ID와 구별할 수 있을 필요가 있습니다.