javax.management.remote
클래스 JMXConnectorServer

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

모든 구현된 인터페이스:

MBeanRegistration, NotificationBroadcaster, NotificationEmitter, JMXConnectorServerMBean

알려진 직계 서브 클래스:

RMIConnectorServer

public abstract class JMXConnectorServer
extends NotificationBroadcasterSupport 
implements JMXConnectorServerMBean,
 MBeanRegistration 

모든 커넥터 서버의 슈퍼 클래스입니다. 커넥터 서버는 MBean 서버에 접속됩니다. 커넥터 서버는 클라이언트 접속 요구를 대기해, 요구 마다 1개 씩 접속을 작성합니다.

커넥터 서버와 MBean 서버가 관련짓고는 커넥터 서버를 MBean 서버에 등록하는지, MBean 서버를 커넥터 서버의 생성자에 건네주는 것에 의해 행해집니다.

커넥터 서버는 작성된 시점에서는 정지하고 있어, start 메서드가 불려 간 시점에서 클라이언트 접속의 대기를 개시합니다. 그 후, stop 메서드가 호출되는지, MBean 서버에의 등록이 해제되면, 클라이언트 접속의 대기를 정지합니다.

커넥터 서버를 정지해도, MBean 서버에의 등록은 해제되지 않습니다. 일단 정지한 커넥터 서버를 재시작할 수 없습니다.

클라이언트 접속이 작성되는지, 종료할 때마다, JMXConnectionNotification 클래스의 통지가 발행됩니다.

도입된 버전 :

1.5

필드 개요

static String

AUTHENTICATOR 커넥터 서버의 Authenticator를 지정하는 속성의 이름입니다.

생성자 개요

JMXConnectorServer ()
접속처의 MBean 서버에 MBean 로서 등록되는 커넥터 서버를 구축합니다.

JMXConnectorServer (MBeanServer mbeanServer)
지정된 MBean 서버에 접속하는 커넥터 서버를 구축합니다.

메서드 개요

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) 새로운 클라이언트 접속을 유효하게 했을 때 서브 클래스에 의해 호출합니다.
String []	getConnectionIds () 현재 유효하게 되어 있는 이 커넥터 서버와의 접속의 ID 리스트입니다.
MBeanServer	getMBeanServer () 이 커넥터 서버의 접속처 MBean 서버를 리턴합니다.
MBeanNotificationInfo []	getNotificationInfo () 이 MBean 로부터 송신되는 통지를 나타내는 배열을 리턴합니다.
void	postDeregister () MBean 서버로부터 등록 해제한뒤 MBean가 필요한 오퍼레이션을 실행할 수 있도록 합니다.
void	postRegister (Boolean registrationDone) MBean 서버에의 등록이 성공 또는 실패한뒤 MBean가 필요한 오퍼레이션을 실행할 수 있도록 합니다.
void	preDeregister () 이 커넥터 서버의 MBean 서버에의 등록이 해제되었을 때, 원등록처 MBean 서버에 의해 호출합니다.
ObjectName	preRegister (MBeanServer mbs, ObjectName name) 이 커넥터 서버가 MBean 서버에 등록되었을 때, 등록처의 MBean 서버에 의해 호출합니다.
void	setMBeanServerForwarder (MBeanServerForwarder mbsf) 이 커넥터 서버 경유로 착신한 MBean 서버에의 요구를 차단하는 객체를 추가합니다.
JMXConnector	toJMXConnector (Map <String, ? > env) 이 커넥터 서버의 클라이언트 스텁을 리턴합니다.

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

addNotificationListener, handleNotification, removeNotificationListener, removeNotificationListener, sendNotification

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

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

인터페이스 javax.management.remote. JMXConnectorServerMBean 로부터 상속된 메서드

getAddress, getAttributes, isActive, start, stop

필드의 상세

AUTHENTICATOR

public static final String  AUTHENTICATOR

커넥터 서버의 Authenticator를 지정하는 속성의 이름입니다. 이 속성에 값을 관련된 인 경우, 그 값은, JMXAuthenticator 인터페이스를 구현하는 객체일 필요가 있습니다.

관련 항목:

정수 필드값

생성자 상세

JMXConnectorServer

public JMXConnectorServer()

접속처의 MBean 서버에 MBean 로서 등록되는 커넥터 서버를 구축합니다. 이 생성자는 보통, 리모트로 이용할 수 있는 커넥터 서버가 MBean 서버내에서 작성될 때, 임의의 createMBean 메서드에 의해 호출합니다.

JMXConnectorServer

public JMXConnectorServer(MBeanServer  mbeanServer)

지정된 MBean 서버에 접속하는 커넥터 서버를 구축합니다. 이 방법으로 작성된 커넥터 서버를 다른 MBean 서버에 등록할 수도 있습니다.

파라미터:

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

메서드의 상세

getMBeanServer

public MBeanServer  getMBeanServer()

이 커넥터 서버의 접속처 MBean 서버를 리턴합니다.

반환값:

이 커넥터 서버의 접속처 MBean 서버. 아직 MBean 서버에 접속되어 있지 않은 경우는 null

setMBeanServerForwarder

public void setMBeanServerForwarder(MBeanServerForwarder  mbsf)

인터페이스 JMXConnectorServerMBean 기술:

이 커넥터 서버 경유로 착신한 MBean 서버에의 요구를 차단하는 객체를 추가합니다. 이 객체는 이 커넥터 서버에 의해 작성된 새로운 접속의 MBeanServer로 서 지정됩니다. 기존의 접속에 영향은 없습니다.

이 커넥터 서버가 이미 MBeanServer 객체에 관련된 인 경우는 mbsf.setMBeanServer에 이 객체가 건네받습니다. 이 처리로 예외가 생성되었을 경우, 이 메서드는 그 예외를 Throw 합니다. 발생되는 예외는 어떤 영향도 가지지 않습니다.

이 커넥터가 아직 MBeanServer 객체에 관련지을 수 있지 않은 경우, 또는 mbsf.setMBeanServer 호출이 성공했을 경우, mbsf가 이 커넥터 서버의 MBeanServer가 됩니다.

정의:

인터페이스 JMXConnectorServerMBean 내의 setMBeanServerForwarder

파라미터:

mbsf - 새로운 MBeanServerForwarder

getConnectionIds

public String [] getConnectionIds()

인터페이스 JMXConnectorServerMBean 기술:

현재 유효하게 되어 있는 이 커넥터 서버와의 접속의 ID 리스트입니다.

정의:

인터페이스 JMXConnectorServerMBean 내의 getConnectionIds

반환값:

ID 리스트를 포함한 새로운 문자 배열. 현재 유효하게 되어 있는 접속이 없는 경우, 이 배열은 비운다

toJMXConnector

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

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

지정된 커넥터가 클라이언트 스텁 의 생성 기능을 지원 하지 않는 경우도 있습니다. 다만, JMX 리모트 API에 의해 지정된 커넥터 (JMXMP 커넥터와 RMI 커넥터)는 이 기능을 지원 합니다.

이 메서드의 디폴트 구현은, JMXConnectorServerMBean.getAddress() 와 JMXConnectorFactory를 사용해, 다음과 같은 코드의 스텁을 생성합니다.

 JMXServiceURL addr = getAddress() ;
 return JMXConnectorFactory.newJMXConnector(addr, env) ;
 

이것이 적절하지 않은 커넥터 서버는 적절한 논리를 구현하는지, UnsupportedOperationException를 Throw 하기 위한, 이 메서드를 오버라이드(override) 할 필요가 있습니다.

정의:

인터페이스 JMXConnectorServerMBean 내의 toJMXConnector

파라미터:

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

반환값:

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

예외:

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

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

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

getNotificationInfo

public MBeanNotificationInfo [] getNotificationInfo()

이 MBean 로부터 송신되는 통지를 나타내는 배열을 리턴합니다. JMXConnectorServer 내의 구현은 요소 1개의 배열을 리턴합니다. 이것은 형태 정의된 JMXConnectionNotification 클래스의 통지를 발행할 수 있는 것을 나타냅니다. 그 외의 통지를 발행할 수 있는 서브 클래스는 이 요소와 그 외의 통지의 설명을 포함한 배열을 리턴합니다.

정의:

인터페이스 NotificationBroadcaster 내의 getNotificationInfo

오버라이드(override):

클래스 NotificationBroadcasterSupport 내의 getNotificationInfo

반환값:

통지의 배열

connectionOpened

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

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

파라미터:

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

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

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

예외:

NullPointerException - connectionId가 null인 경우

connectionClosed

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

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

파라미터:

connectionId - 종료한 접속의 ID

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

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

예외:

NullPointerException - connectionId가 null인 경우

connectionFailed

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

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

파라미터:

connectionId - 실패한 접속의 ID

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

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

예외:

NullPointerException - connectionId가 null인 경우

preRegister

public ObjectName  preRegister(MBeanServer  mbs,
                              ObjectName  name)

이 커넥터 서버가 MBean 서버에 등록되었을 때, 등록처의 MBean 서버에 의해 호출합니다. 이 커넥터 서버가 MBean 서버에 접속되어 그 getMBeanServer() 메서드는 mbs를 리턴합니다.

이 커넥터 서버가 이미 MBean 서버에 접속되고 있는 경우, 이 메서드는 아무것도 실행하지 않습니다. 접속처의 MBean 서버가 등록처의 MBean 서버에 일치하고 있을 필요는 없습니다.

정의:

인터페이스 MBeanRegistration 내의 preRegister

파라미터:

mbs - 이 커넥터 서버의 등록처 MBean 서버

name - MBean 객체명

반환값:

MBean 등록명

예외:

NullPointerException - mbs 또는 name가 null인 경우

postRegister

public void postRegister(Boolean  registrationDone)

인터페이스 MBeanRegistration 기술:

MBean 서버에의 등록이 성공 또는 실패한뒤 MBean가 필요한 오퍼레이션을 실행할 수 있도록 합니다.

정의:

인터페이스 MBeanRegistration 내의 postRegister

파라미터:

registrationDone - MBean가 MBean 서버에 정상적으로 등록되었는지 어떠했는지를 나타낸다. 등록에 실패했을 경우의 값은 false

preDeregister

public void preDeregister()
                   throws Exception 

이 커넥터 서버의 MBean 서버에의 등록이 해제되었을 때, 원등록처 MBean 서버에 의해 호출합니다. 등록에 의해 MBean 서버에 접속하고 있던 커넥터 서버가 아직 활성화된 경우, 등록을 해제하면 stop 메서드가 호출됩니다. stop 메서드가 예외를 Throw 했을 경우, 등록 해제는 실패합니다. stop 메서드는 MBean 등록 해제전에 명시적으로 호출하는 것을 추천합니다.

정의:

인터페이스 MBeanRegistration 내의 preDeregister

예외:

IOException - stop 메서드에 의해 Throw 되었을 경우

Exception - 이 예외는 MBean 서버에 캐치 되어MBeanRegistrationException 로서 재Throw 된다

postDeregister

public void postDeregister()

인터페이스 MBeanRegistration 기술:

MBean 서버로부터 등록 해제한뒤 MBean가 필요한 오퍼레이션을 실행할 수 있도록 합니다.

정의:

인터페이스 MBeanRegistration 내의 postDeregister