javax.management.remote.rmi
클래스 RMIConnectorServer

java.lang.Object 
  javax.management.NotificationBroadcasterSupport 
      javax.management.remote.JMXConnectorServer 
          javax.management.remote.rmi.RMIConnectorServer

모든 구현된 인터페이스:

MBeanRegistration, NotificationBroadcaster, NotificationEmitter, JMXConnectorServerMBean

public class RMIConnectorServer
extends JMXConnectorServer 

리모트 클라이언트로부터의 RMI 베이스의 접속을 작성하는 JMX API 커넥터 서버입니다. 보통, 이러한 커넥터 서버의 작성에는 JMXConnectorServerFactory 가 사용됩니다. 그러나, RMIServerImpl 객체 등, 이 클래스를 사용할 수 있는 특수한 어플리케이션도 있습니다.

도입된 버전 :

1.5

필드 개요

static String	JNDI_REBIND_ATTRIBUTE RMI 커넥터 서버를 나타내는 RMIServer 스텁이 같은 주소의 기존의 스텁을 오버라이드(override) 할지 어떨지를 지정하는 속성의 이름입니다.
static String	RMI_CLIENT_SOCKET_FACTORY_ATTRIBUTE 작성된 RMI 객체 RMIClientSocketFactory를 이 커넥터로 지정하는 속성의 이름입니다.
static String	RMI_SERVER_SOCKET_FACTORY_ATTRIBUTE 작성된 RMI 객체 RMIServerSocketFactory를 이 커넥터로 지정하는 속성의 이름입니다.

클래스 javax.management.remote. JMXConnectorServer 로부터 상속된 필드

AUTHENTICATOR

생성자 개요

RMIConnectorServer (JMXServiceURL url, Map <String, ? > environment)
RMIConnectorServer를 작성합니다.

RMIConnectorServer (JMXServiceURL url, Map <String, ? > environment, MBeanServer mbeanServer)
지정된 MBean 서버의 RMIConnectorServer를 작성합니다.

RMIConnectorServer (JMXServiceURL url, Map <String, ? > environment, RMIServerImpl rmiServerImpl, MBeanServer mbeanServer)
지정된 MBean 서버의 RMIConnectorServer를 작성합니다.

메서드 개요

protected void	connectionClosed (String connectionId, String message, Object userData) 클라이언트 접속이 정상적으로 종료했을 때 서브 클래스에 의해 호출합니다.
protected void	connectionFailed (String connectionId, String message, Object userData) 클라이언트 접속에 실패했을 때 서브 클래스에 의해 호출합니다.
protected void	connectionOpened (String connectionId, String message, Object userData) 새로운 클라이언트 접속을 유효하게 했을 때 서브 클래스에 의해 호출합니다.
JMXServiceURL	getAddress () 이 커넥터 서버의 주소
Map <String, ? >	getAttributes () 이 커넥터 서버의 속성
boolean	isActive () 커넥터 서버가 활성화되었는가 어떤가를 판정합니다.
void	start () 커넥터 서버를 활성화 합니다.
void	stop () 커넥터 서버를 종료해, 클라이언트 접속의 대기를 정지합니다.
JMXConnector	toJMXConnector (Map <String, ? > env) 이 커넥터 서버의 클라이언트 스텁을 리턴합니다.

클래스 javax.management.remote. JMXConnectorServer 로부터 상속된 메서드

getConnectionIds, getMBeanServer, getNotificationInfo, postDeregister, postRegister, preDeregister, preRegister, setMBeanServerForwarder

클래스 javax.management. NotificationBroadcasterSupport 로부터 상속된 메서드

addNotificationListener, handleNotification, removeNotificationListener, removeNotificationListener, sendNotification

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

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

필드의 상세

JNDI_REBIND_ATTRIBUTE

public static final String  JNDI_REBIND_ATTRIBUTE

RMI 커넥터 서버를 나타내는 RMIServer 스텁이 같은 주소의 기존의 스텁을 오버라이드(override) 할지 어떨지를 지정하는 속성의 이름입니다. 이 속성에 값을 관련짓는 경우, "true" 또는 "false"와 동등의 캐릭터 라인 (영문자의 대문자와 소문자의 구별은 하지 않는다)을 지정할 필요가 있습니다. 기본값는 false 입니다.

관련 항목:

정수 필드값

RMI_CLIENT_SOCKET_FACTORY_ATTRIBUTE

public static final String  RMI_CLIENT_SOCKET_FACTORY_ATTRIBUTE

작성된 RMI 객체 RMIClientSocketFactory를 이 커넥터로 지정하는 속성의 이름입니다. 이 속성에는 RMIClientSocketFactory 형의 값을 관련지을 필요가 있습니다. 이 값은 커넥터 서버의 작성시로 지정된 Map인수내 밖에 지정할 수 없습니다.

관련 항목:

정수 필드값

RMI_SERVER_SOCKET_FACTORY_ATTRIBUTE

public static final String  RMI_SERVER_SOCKET_FACTORY_ATTRIBUTE

작성된 RMI 객체 RMIServerSocketFactory를 이 커넥터로 지정하는 속성의 이름입니다. 이 속성에는 RMIServerSocketFactory 형의 값을 관련지을 필요가 있습니다. 이 값은 커넥터 서버의 작성시로 지정된 Map인수내 밖에 지정할 수 없습니다.

관련 항목:

정수 필드값

생성자 상세

RMIConnectorServer

public RMIConnectorServer(JMXServiceURL  url,
                          Map <String,
? > environment)
                   throws IOException 

RMIConnectorServer를 작성합니다. 이 처리는 RMIConnectorServer(directoryURL, environment, null, null) 호출과 동등합니다.

파라미터:

url - 커넥터 서버의 작성 방법을 정의하는 URL. null은 불가

environment - RMI 객체의 작성과 포함을 관리하는 속성. null인 경우, 비어있는 Map와 동등

예외:

IllegalArgumentException - url가 null인 경우

MalformedURLException - url가 RMI 커넥터의 구문에 준거하고 있지 않는 경우, 또는 그 프로토콜이 이 구현으로 인식되지 않는 경우. 이 생성자 사용시에는 rmi와 jrmp 만이 유효

IOException - 어떠한 이유로써 커넥터 서버를 작성할 수 없는 경우, 또는 start 메서드의 실패를 피할 수 없는 경우

RMIConnectorServer

public RMIConnectorServer(JMXServiceURL  url,
                          Map <String,
? > environment,
                          MBeanServer  mbeanServer)
                   throws IOException 

지정된 MBean 서버의 RMIConnectorServer를 작성합니다. 이 처리는 RMIConnectorServer(directoryURL, environment, null, mbeanServer) 호출과 동등합니다.

파라미터:

url - 커넥터 서버의 작성 방법을 정의하는 URL. null은 불가

environment - RMI 객체의 작성과 포함을 관리하는 속성. null인 경우, 비어있는 Map와 동등

mbeanServer - 새로운 커넥터 서버의 접속처 MBean 서버. 이 커넥터 서버를 MBean 서버에 등록하는 것에 의해 MBean 서버에 접속하는 경우는 null

예외:

IllegalArgumentException - url가 null인 경우

MalformedURLException - url가 RMI 커넥터의 구문에 준거하고 있지 않는 경우, 또는 그 프로토콜이 이 구현으로 인식되지 않는 경우. 이 생성자 사용시에는 rmi와 jrmp 만이 유효

IOException - 어떠한 이유로써 커넥터 서버를 작성할 수 없는 경우, 또는 start 메서드의 실패를 피할 수 없는 경우

RMIConnectorServer

public RMIConnectorServer(JMXServiceURL  url,
                          Map <String,
? > environment,
                          RMIServerImpl  rmiServerImpl,
                          MBeanServer  mbeanServer)
                   throws IOException 

지정된 MBean 서버의 RMIConnectorServer를 작성합니다.

파라미터:

url - 커넥터 서버의 작성 방법을 정의하는 URL. null은 불가

environment - RMI 객체의 작성과 포함을 관리하는 속성. null인 경우, 비어있는 Map와 동등

rmiServerImpl - url 로 지정된 프로토콜형에 준거한, RMIServer 인터페이스의 구현. 이 파라미터의 값이 null 이외의 경우, url 로 지정된 프로토콜형은 강제당하지 않고, 유효라고 보여진다. 그 외의 경우, rmi와 iiop 만이 인식되는

mbeanServer - 새로운 커넥터 서버의 접속처 MBean 서버. 이 커넥터 서버를 MBean 서버에 등록하는 것에 의해 MBean 서버에 접속하는 경우는 null

예외:

IllegalArgumentException - url가 null인 경우

MalformedURLException - url가 RMI 커넥터의 구문에 준거하고 있지 않는 경우, 또는 그 프로토콜이 이 구현으로 인식되지 않는 경우. rmiServerImpl가 null 때는 rmi와 jrmp 만이 인식된다

IOException - 어떠한 이유로써 커넥터 서버를 작성할 수 없는 경우, 또는 start 메서드의 실패를 피할 수 없는 경우

관련 항목:

start()

메서드의 상세

toJMXConnector

public JMXConnector  toJMXConnector(Map <String,
? > env)
                            throws IOException 

이 커넥터 서버의 클라이언트 스텁을 리턴합니다. 클라이언트 스텁는 직렬화 가능한 객체입니다. 이 객체의 connect 메서드를 사용해, 이 커넥터 서버와의 새로운 접속을 1개 확립할 수 있습니다.

정의:

인터페이스 JMXConnectorServerMBean 내의 toJMXConnector

오버라이드(override):

클래스 JMXConnectorServer 내의 toJMXConnector

파라미터:

env - JMXConnector.connect(Map)에 제공 가능한 같은 종류의 클라이언트 접속 파라미터. null은 빈 맵과 동등

반환값:

이 커넥터 서버와의 새로운 접속을 확립하기 위해서 사용할 수 있는 클라이언트 스텁

예외:

UnsupportedOperationException - 이 커넥터 서버가 클라이언트 스텁 의 생성 기능을 지원 하지 않는 경우

IllegalStateException - JMXConnectorServer가 시작하고 있지 않는 경우 (isActive()를 참조)

IOException - 통신 장해에의해 스텁을 작성할 수 없는 경우

start

public void start()
           throws IOException 

커넥터 서버를 활성화 합니다. 활성화 된 커넥터 서버는 클라이언트 접속의 대기를 개시합니다. 커넥터 서버가 이미 활성화된 경우는 이 메서드를 호출해도 아무것도 일어나지 않습니다. 커넥터 서버가 정지하고 있는 상태로 이 메서드를 호출하면, IOException가 생성됩니다.

초기 호출시의 이 메서드의 동작은 아래와 같이, 구축시로 지정된 파라미터에 의존합니다.

우선, RMI 로부터 커넥터 서버를 export 하기 위한, RMIServerImpl 서브 클래스의 객체가 요구됩니다.

• 생성자 으로 지정된 RMIServerImpl가 있는 경우, 이것이 사용된다
• 생성자 으로 지정된 JMXServiceURL 프로토콜 부분이 iiop 이면, RMIIIOPServerImpl 형의 객체가 작성된다
• JMXServiceURL가 null 인지, 그 프로토콜 부분이 rmi 이면, RMIJRMPServerImpl 형의 객체가 작성된다
• 그 외의 경우, 구현은 구현 고유 RMIServerImpl를 작성할 수 있다. 또는 MalformedURLException를 Throw 할 수 있다

지정된 주소에 javax.management.remote.rmi 패키지 문서의 지정 대로의 JNDI 디렉토리 URL가 포함되는 경우, 이 RMIConnectorServer는 지정된 주소에 RMIServerImpl를 바인드 하는 것으로써, bootstrap 합니다.

JMXServiceURL URL 패스 부분이 공백 또는 단일의 slash (/)인 경우, RMI 객체는 디렉토리에 바인드 되지 않습니다. 대신에 그 참조가getAddress() 로부터 리턴된 RMIConnectorServer 주소의 URL 패스내에 encode 됩니다. rmi 및 iiop encode에 대해서는 javax.management.remote.rmi 패키지 문서에 기재되어 있습니다.

URL 패스가 하늘이 아니고, JNDI 디렉토리 URL도 아닌 경우, 또는 프로토콜이 rmi도 iiop도 아닌 경우의 동작은 구현 마다 정의되고 있습니다. 커넥터 서버의 작성시 또는 개시시에 MalformedURLException를 Throw 하는 동작이 정의되고 있는 경우도 있습니다.

예외:

IllegalStateException - 커넥터 서버가 MBean 서버에 접속되어 있지 않은 경우

IOException - 커넥터 서버를 시작할 수 없는 경우

stop

public void stop()
          throws IOException 

커넥터 서버를 종료해, 클라이언트 접속의 대기를 정지합니다. 이 메서드를 호출하면, 이 서버로 작성된 모든 클라이언트 접속이 종료합니다. 이 메서드가 정상적으로 종료했을 경우도, 예외를 생성해 종료했을 경우도, 커넥터 서버는 새로운 클라이언트 접속을 작성하지 않게 됩니다.

일단 정지한 커넥터 서버를 재차 시작할 수 없습니다.

커넥터 서버가 이미 정지하고 있는 경우는 이 메서드를 호출해도 아무것도 일어나지 않습니다. 커넥터 서버가 아직 시작하고 있지 않는 상태로 이 메서드를 호출하면, 커넥터 서버 객체가 영속적으로 무효화됩니다.

클라이언트 접속의 종료시에 생성된 예외는 이 메서드로부터는 Throw 되지 않습니다. 이 MBean 로부터는 JMXConnectionNotification 와 종료할 수 없었던 접속의 접속 ID가 발행됩니다.

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

이 메서드는 커넥터 서버의 RMIServerImpl 객체상에서 close 메서드를 호출합니다.

start 메서드로 RMIServerImpl가 JNDI 디렉토리에 바인드 되고 있는 경우, 이 메서드로 바인드가 해제됩니다.

예외:

IOException - 서버를 정상적으로 종료할 수 없는 경우, 또는 디렉토리로부터 RMIServerImpl 바인드를 해제할 수 없는 경우. 이 예외가 Throw 되었을 때, 서버는 이미 모든 클라이언트 접속의 종료 처리, RMIServerImpl.close() 호출해 및 RMIServerImpl 바인드 해제를 필요에 따라서 시행하고 있다. 서버가 모든 클라이언트 접속의 종료를 시행했을 때 예외가 생성되어 있지 않으면, 모든 클라이언트 접속은 종료하고 있다

isActive

public boolean isActive()

인터페이스 JMXConnectorServerMBean 기술:

커넥터 서버가 활성화되었는가 어떤가를 판정합니다. start 메서드가 정상적으로 종료하면, 커넥터 서버는 활성화 됩니다. 그 후, stop 메서드가 호출되는지, 장해가 발생할 때까지, 커넥터 서버는 활성화된 상태를 유지합니다.

반환값:

커넥터 서버가 활성화된 경우는 true

getAddress

public JMXServiceURL  getAddress()

인터페이스 JMXConnectorServerMBean 기술:

이 커넥터 서버의 주소

반환값:

이 커넥터 서버의 주소. 존재하지 않는 경우는 null

getAttributes

public Map <String,
? > getAttributes()

인터페이스 JMXConnectorServerMBean 기술:

이 커넥터 서버의 속성

반환값:

이 커넥터 서버의 속성을 포함한 읽기 전용 맵. 직렬화 가능한 값을 가지는 속성은 이 맵으로부터 제외된다. 직렬화 가능한 속성이 존재하지 않는 경우, 비어있는 맵이 리턴된다

connectionOpened

protected void connectionOpened(String  connectionId,
                                String  message,
                                Object  userData)

클래스 JMXConnectorServer 기술:

새로운 클라이언트 접속을 유효하게 했을 때 서브 클래스에 의해 호출합니다. JMXConnectorServer.getConnectionIds() 에 의해 리턴된 리스트에 connectionId를 추가해, JMXConnectionNotification.OPENED 형 JMXConnectionNotification를 발행합니다.

오버라이드(override):

클래스 JMXConnectorServer 내의 connectionOpened

파라미터:

connectionId - 새로운 접속의 ID. 이전에 이 커넥터 서버에 의해 유효하게 된 접속의 ID와는 다르지 않으면 안 되는

message - 발행된 JMXConnectionNotification 메세지. null도 가능. Notification.getMessage()를 참조

userData - 발행된 JMXConnectionNotification userData. null도 가능. Notification.getUserData()를 참조

connectionClosed

protected void connectionClosed(String  connectionId,
                                String  message,
                                Object  userData)

클래스 JMXConnectorServer 기술:

클라이언트 접속이 정상적으로 종료했을 때 서브 클래스에 의해 호출합니다. JMXConnectorServer.getConnectionIds() 에 의해 리턴된 리스트로부터 connectionId를 삭제해, JMXConnectionNotification.CLOSED 형 JMXConnectionNotification를 발행합니다.

오버라이드(override):

클래스 JMXConnectorServer 내의 connectionClosed

파라미터:

connectionId - 종료한 접속의 ID

message - 발행된 JMXConnectionNotification 메세지. null도 가능. Notification.getMessage()를 참조

userData - 발행된 JMXConnectionNotification userData. null도 가능. Notification.getUserData()를 참조

connectionFailed

protected void connectionFailed(String  connectionId,
                                String  message,
                                Object  userData)

클래스 JMXConnectorServer 기술:

클라이언트 접속에 실패했을 때 서브 클래스에 의해 호출합니다. JMXConnectorServer.getConnectionIds() 에 의해 리턴된 리스트로부터 connectionId를 삭제해, JMXConnectionNotification.FAILED 형 JMXConnectionNotification를 발행합니다.

오버라이드(override):

클래스 JMXConnectorServer 내의 connectionFailed

파라미터:

connectionId - 실패한 접속의 ID

message - 발행된 JMXConnectionNotification 메세지. null도 가능. Notification.getMessage()를 참조

userData - 발행된 JMXConnectionNotification userData. null도 가능. Notification.getUserData()를 참조