패키지 javax.management.remote.rmi

RMI 커넥터는 RMI를 사용해 클라이언트 요구를 리모트 MBean 서버에 전송 하는 JMX 리모트 API 용무의 커넥터입니다.

참조처:
설명

인터페이스 개요

RMIConnection	클라이언트로부터 서버측의 MBeanServer 구현에 MBeanServer 요구를 송신하기 위해서 사용되는 RMI 객체입니다.
RMIServer	RMI 커넥터와의 접속의 확립에 사용되는 RMI 객체입니다.

클래스 개요

RMIConnectionImpl	RMIConnection 인터페이스의 구현입니다.
RMIConnectionImpl_Stub
RMIConnector	리모트 RMI 커넥터에의 접속입니다.
RMIConnectorServer	리모트 클라이언트로부터의 RMI 베이스의 접속을 작성하는 JMX API 커넥터 서버입니다.
RMIIIOPServerImpl	IIOP 로부터 export 되어 IIOP 로부터 export 된 RMI 객체로서 클라이언트 접속을 작성하는 RMIServerImpl 입니다.
RMIJRMPServerImpl	JRMP 로부터 export 되어 JRMP 로부터 export 된 RMI 객체로서 클라이언트 접속을 작성하는 RMIServer 객체입니다.
RMIServerImpl	커넥터 서버를 나타내는 RMI 객체입니다.
RMIServerImpl_Stub

패키지 javax.management.remote.rmi 설명

RMI 커넥터는 RMI를 사용해 클라이언트 요구를 리모트 MBean 서버에 전송 하는 JMX 리모트 API 용무의 커넥터입니다. 이 패키지에서는 RMI 커넥터의 사용자가 클라이언트측 및 서버측에서 직접 참조할 필요가 있는 클래스를 정의합니다. 사용자가 직접 참조하지 않는 클래스도 정의합니다만, 이러한 클래스는 RMI 커넥터의 구현이 다른 경우도 상호 운용할 수 있도록 정의해야 합니다.

RMI 커넥터는 RMI JRMP 및 IIOP 트랜스폴트를 지원 합니다.

JMX 리모트 API 대부분의 커넥터와 같게, RMI도 주소로서 JMXServiceURL 를 가지고 있는 것이 보통입니다. 이 주소의 프로토콜 부분은 디폴트의 RMI 트랜스폴트 (JRMP)를 사용하는 커넥터의 경우 rmi, RMI/IIOP를 사용하는 커넥터의 경우 iiop가 됩니다.

RMI 커넥터 주소에는 다음의 2개의 형식이 있습니다.

• JNDI 형식. URL 디렉토리는 커넥터의 RMI 스텁 검색 위치를 나타낸다. 이 RMI 스텁는 커넥터 서버에의 액세스를 제공하는 RMIServer 형 Java 객체이다. 이 주소 형식을 사용해, URL 내의 외부 디렉토리 엔트리로부터 RMI 스텁이 취득된다. 외부 디렉토리는 JNDI 에 의해 인식되는 디렉토리의 어떤 것인가로 일반적으로 RMI 레지스트리, LDAP, 또는 COS

• encode 형식. URL 디렉토리에는 커넥터 서버와의 접속에 필요한 정보가 포함된다. RMI/JRMP를 사용하는 경우, 매입 개행 문자없이 BASE64 encode 처리된, 서버 객체의 직렬화가 끝난 RMI 스텁. RMI/IIOP를 사용하는 경우, 서버 객체의 CORBA IOR

주소의 자세한 것은 이하로 설명합니다.

RMI 커넥터 서버의 작성

보통, RMI 커넥터 서버를 작성하려면, JMXConnectorServerFactory.newJMXConnectorServer 메서드에 RMI 커넥터 주소를 지정합니다. 커넥터 서버의 접속처 MBean 서버도, 이 메서드의 파라미터로서 지정할 수 있습니다. 다른 방법으로서 커넥터 서버를 MBean 로서 MBean 서버에 등록하는 방법도 있습니다.

RMI 커넥터 서버는 RMIConnectorServer 인스턴스를 조회해도 작성할 수 있습니다. 이 조회는 명시적으로 행해도 MBean 서버의 createMBean 메서드를 개입시켜 행해도 괜찮습니다.

RMI 트랜스폴트의 선택

RMI 트랜스폴트 (JRMP 또는 IIOP)를 선택하려면, 커넥터 서버의 작성시에 serviceURL 의 protocol 부분에 rmi 또는 iiop를 지정합니다. RMIServerImpl 의 적절한 서브 클래스를 인스턴스화해, RMIConnectorServer 생성자 으로 지정하는 것에의해 특별한 커넥터 서버를 작성할 수도 있습니다.

서버에 의해 생성된 커넥터 주소

지정한 serviceURL URL 패스가 비어있는 경우 (옵션의 호스트와 포트에 계속되는 부분), 또는 serviceURL를 지정하지 않았던 경우, 커넥터 서버에의해 클라이언트가 접속을 위해서 사용할 수 있는 새로운 JMXServiceURL 하지만 작성됩니다.

• 다음과 같은 serviceURL인 경우:

          service:jmx:rmi://host:port      

  커넥터 서버는 RMIJRMPServerImpl를 생성한다. 다음과 같은 JMXServiceURL가 리턴된다:

          service:jmx:rmi://host:port/stub/XXXX   

  XXXX는 생성된 객체의 스텁 의 직렬화 형식. 개행 문자없이 BASE64 encode 처리되고 있다

• 다음과 같은 serviceURL인 경우:

          service:jmx:iiop://host:port     

  커넥터 서버는 RMIIIOPServerImpl를 생성한다. 다음과 같은 JMXServiceURL가 리턴된다:

          service:jmx:iiop://host:port/ior/IOR:XXXX       

  IOR:XXXX는 생성된 객체의 IOR (Interoperable Object Reference)의 표준 CORBA encode

• serviceURL가 존재하지 않는 경우, 사용자 지정의 RMIServerImpl 하지만 필요하게 된다. 이 객체상의 toStub 메서드가 Stub 인스턴스를 돌려주는 경우, 커넥터 서버는 상기의 iiop 형식을 사용해 JMXServiceURL를 생성한다. 그 외의 경우, rmi 형식을 사용해 JMXServiceURL를 생성한다

사용자 지정의 serviceURL 내의 host는 옵션입니다. 존재하는 경우, 생성된 JMXServiceURL에 복사됩니다 만, 존재하지 않는 경우는 무시됩니다. 존재하지 않는 경우, 생성된 JXMServiceURL는 로컬 호스트명을 가집니다.

사용자 지정의 serviceURL 내의 port 도 옵션입니다. 존재하는 경우, 생성된 JMXServiceURL에 복사됩니다. 존재하지 않는 경우, 생성된 JMXServiceURL는 포트를 가지지 않습니다. rmi 프로토콜을 사용하는 serviceURL에 서는 port 하지만 존재하는 경우, 생성된 리모트 객체가 export 되는 포트를 나타냅니다. 그 이외의 영향은 없습니다.

사용자가 JMXServiceURL는 아니고 RMIServerImpl를 지정했을 경우, 생성된 JMXServiceURL host 부분에 로컬 호스트명이 들어갑니다. port 부분은 없습니다.

디렉토리 엔트리에 근거하는 커넥터 주소

커넥터 서버의 작성시로 지정되는 serviceURL 주소에는 생성된 주소 (상기) 대신에 지정 또는 생성된 RMIServer 스텁 의 포함처가 되는 「디렉토리 주소」를 지정할 수도 있습니다. 이 경우 클라이언트에서도 서버에서도, 이 디렉토리 주소가 사용.

이 경우 serviceURL는 다음의 몇개의 형식을 취합니다.

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

jndi-name는 javax.naming.InitialContext.bind (으)로 지정 가능한 캐릭터 라인입니다.

여기에서도, host와 :port는 생략 가능합니다.

커넥터 서버는 프로토콜 (rmi 또는 iiop)에 근거해 RMIServerImpl를 생성합니다. rmi인 경우, port 하지만 지정되고 있으면 사용됩니다. 커넥터 서버는 시작시에 toStub 메서드를 사용해 이 객체로부터 스텁을 파생해, 지정된 jndi-name를 사용해 객체를 포함합니다. 예의 같게, JNDI API. 에 의해 정의된 프로퍼티가 조회됩니다.

예를 들어 다음과 같은 JMXServiceURL인 경우:

 service:jmx:rmi://ignoredhost/jndi/rmi://myhost/myname 

커넥터 서버는 RMIJRMPServerImpl를 생성해, 아래와 같이 JNDI이름을 사용해 그 스텁을 포함합니다.

 rmi://myhost/myname 

이것은 호스트 myhost 디폴트 포트로 실행되고 있는 RMI 레지스트리내의 엔트리 myname 입니다. RMI 레지스트리는 로컬 호스트로부터의 접속을 허가할 뿐입니다. 따라서, 이 경우 myhost는 커넥터 서버가 실행되고 있는 호스트의 이름이 됩니다.

이 JMXServiceURL에 서는 최초의 rmi:로 RMI 커넥터, 2번째의 rmi:로 RMI 레지스트리가 지정되고 있습니다.

이제(이미 ) 1개 예를 듭니다. 다음과 같은 JMXServiceURL인 경우:

 service:jmx:iiop://ignoredhost/jndi/ldap://dirhost:9999/cn=this, ou=that 

커넥터 서버는 RMIIIOPServerImpl를 생성해, 아래와 같이 JNDI이름을 사용해 그 스텁을 포함합니다.

 ldap://dirhost:9999/cn=this, ou=that 

이것은 호스트 dirhost 포트 9999 로 실행되고 있는 LDAP 디렉토리내의 엔트리 cn=this, ou=that 입니다.

다음과 같은 JMXServiceURL인 경우:

 service:jmx:iiop://ignoredhost/jndi/cn=this, ou=that 

커넥터 서버는 RMIIIOPServerImpl를 생성해, 아래와 같이 JNDI이름을 사용해 그 스텁을 포함합니다.

 cn=this, ou=that 

이 경우 JNDI API를 적절히 구성해, 사용하는 디렉토리의 정보를 지정할 필요가 있습니다.

이러한 예에서는 커넥터 서버, 커넥터 클라이언트 모두, 호스트명 ignoredhost를 사용하지 않습니다. 이 호스트명은 생략 가능합니다. 다음의 예를 참조하십시오.

 service:jmx:iiop:///jndi/cn=this, ou=that 

그런데도, 커넥터 서버가 실행되고 있는 호스트의 이름을 사용하는 것을 추천합니다. 보통, 이 호스트명은 디렉토리 호스트명과는 달라.

커넥터 서버 속성

디폴트의 JRMP 트랜스폴트의 사용시는 RMIConnectorServer 생성자 environment 의 jmx.remote.rmi.client.socket.factory 및 jmx.remote.rmi.server.socket.factory 속성을 사용해, RMI 소켓 팩토리를 지정할 수 있습니다. 이러한 속성의 값은 각각 RMIClientSocketFactory 형 또는 RMIServerSocketFactory 형태가 아니면 안됩니다. 이러한 팩토리는 커넥터에 관련된 RMI 객체를 작성할 때 사용됩니다.

RMI 커넥터 클라이언트의 작성

보통, RMI 커넥터 클라이언트의 구축에는 JMXConnectorFactory 와 프로토콜 rmi 또는 iiop를 가지는 JMXServiceURL를 사용합니다.

JMXServiceURL가 서버로 생성되었을 경우 (상기의 「서 바에 의해 생성된 커넥터 주소」를 참조), 클라이언트는 이 URL를 직접 또는 간접적으로 서버로부터 취득할 필요가 있습니다. 보통, 서버는 JMXServiceURL를 사용 가능하게 하기 위한, 이 URL를 파일 또는 검색 서비스에 포함합니다.

JMXServiceURL가 디렉토리 구문을 사용하는 경우 (상기의 「디렉토리 엔트리에 근거하는 커넥터 주소」를 참조), 이것은 클라이언트에 제공됩니다. 또는 클라이언트와 서버의 양쪽 모두가 어느 디렉토리 엔트리를 사용해야할 것인가를 인식하고 있습니다. 예를 들어 Whatsit에 이전트의 커넥터 서버는 호스트 myhost 상의 RMI 레지스트리에 포함되고 있는 엔트리 whatsit-agent-connector를 사용한다고 합니다. 이 경우 클라이언트와 서버의 양쪽 모두가 아래와 같은 적절한 JMXServiceURL를 인식할 수 있습니다.

 service:jmx:rmi:///jndi/rmi://myhost/whatsit-agent-connector 

RMI 스텁 의 형태가 RMIServer 인 경우는 RMIConnector 의 적절한 생성자를 사용해 직접 RMI 접속을 구축할 수 있습니다.

RMI/IIOP 커넥터의 ORB 지정

IIOP 트랜스폴트를 사용하는 경우, 클라이언트와 서버는 속성 java.naming.corba.orb를 사용해, 사용하는 ORB를 지정할 수 있습니다. ORB와 의 접속은 커넥터 서버의 경우는 start 실행시, 커넥터 클라이언트의 경우는 connect 실행시에 확립됩니다. java.naming.corba.orb 속성이 환경 Map에 포함되는 경우, IIOP 스텁 의 접속에는 이 속성값 (ORB ) 하지만 사용됩니다. 그 외의 경우, org.omg.CORBA.ORB.init((String[]) null, (Properties) null) 가 불려가 새롭다 org.omg.CORBA.ORB가 작성됩니다. 이 ORB는 같은 JVM 내의 후속의 RMI 커넥터 클라이언트 또는 서버로 재이용할 수 있습니다. 같은 순서로 새로운 ORB를 작성할 수도 있습니다.

지정된 java.naming.corba.orb 속성이 ORB를 포인트 하고 있지 않는 경우, IllegalArgumentException 가 발생 됩니다.

IIOP 리모트 객체 (스텁 또는 서버)가 수동으로 작성되어 ORB에 접속된 뒤 RMIConnector 및 RMIConnectorServer 에게 건네지는 경우, 여기서 설명한 도구는 적용되지 않습니다.

관련 항목:

Java^TM Remote Method Invocation (RMI)

@see Java Naming and Directory Interface^TM (JNDI)

@see RFC 2045, section 6.8, "Base64 Content-Transfer-Encoding"