JMXConnectorServerMBean (Java 2 Platform SE 5.0)

메서드 개요
`JMXServiceURL`	`getAddress ()` 이 커넥터 서버의 주소
`Map <String, ? >`	`getAttributes ()` 이 커넥터 서버의 속성
`String []`	`getConnectionIds ()` 현재 유효하게 되어 있는 이 커넥터 서버와의 접속의 ID 리스트입니다.
`boolean`	`isActive ()` 커넥터 서버가 활성화되었는가 어떤가를 판정합니다.
`void`	`setMBeanServerForwarder (MBeanServerForwarder mbsf)` 이 커넥터 서버 경유로 착신한 MBean 서버에의 요구를 차단하는 객체를 추가합니다.
`void`	`start ()` 커넥터 서버를 활성화 해, 클라이언트 접속의 대기를 개시합니다.
`void`	`stop ()` 커넥터 서버를 종료해, 클라이언트 접속의 대기를 정지합니다.
`JMXConnector`	`toJMXConnector (Map <String, ? > env)` 이 커넥터 서버의 클라이언트 스텁을 리턴합니다.

메서드의 상세

start

void start()
           throws IOException

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

예외:: IOException - 대기를 개시할 수 없는 경우, 또는 커넥터 서버가 정지하고 있는 경우; IllegalStateException - 커넥터 서버가 MBean 서버에 접속되어 있지 않은 경우

stop

void stop()
          throws IOException

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

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

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

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

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

예외:: IOException - 서버를 정상적으로 종료할 수 없는 경우. 이 예외가 Throw 되었을 때, 서버는 이미 모든 클라이언트 접속의 종료를 시행이 끝난 상태. 서버가 종료를 시행했을 때 예외를 생성한 것을 제외해, 모든 클라이언트 접속은 종료가 끝난 상태

isActive

boolean isActive()

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

반환값:: 커넥터 서버가 활성화된 경우는 true

setMBeanServerForwarder

void setMBeanServerForwarder(MBeanServerForwarder  mbsf)

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

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

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

파라미터:: mbsf - 새로운 MBeanServerForwarder
예외:: IllegalArgumentException - mbsf.setMBeanServer 호출이 IllegalArgumentException을 생성해 실패했을 경우. mbsf가 null인 경우도 포함된다

getConnectionIds

String [] getConnectionIds()

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

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

getAddress

JMXServiceURL  getAddress()

이 커넥터 서버의 주소

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

getAttributes

Map <String,
? > getAttributes()

이 커넥터 서버의 속성

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

toJMXConnector

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

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

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

파라미터:: env - JMXConnector.connect(Map)에 제공 가능한 같은 종류의 클라이언트 접속 파라미터. null은 빈 맵과 동등
반환값:: 이 커넥터 서버와의 새로운 접속을 확립하기 위해서 사용할 수 있는 클라이언트 스텁
예외:: UnsupportedOperationException - 이 커넥터 서버가 클라이언트 스텁 의 생성 기능을 지원 하지 않는 경우; IllegalStateException - JMXConnectorServer가 시작하고 있지 않는 경우 (isActive()를 참조); IOException - 통신 장해에의해 스텁을 작성할 수 없는 경우