javax.management.remote
클래스 JMXConnectorServerFactory

java.lang.Object 
  javax.management.remote.JMXConnectorServerFactory

public class JMXConnectorServerFactory
extends Object 

JMX API 커넥터 서버를 작성하는 팩토리입니다. 이 클래스의 인스턴스는 존재하지 않습니다.

각 커넥터 서버는 JMXConnectorServerProvider 인스턴스에 의해 작성됩니다. 이 인스턴스의 검출 처리에서는 "service:jmx:protocol:remainder"를 닮은 JMXServiceURL 가 지정되고 있으면 가정해, 팩토리에의해 protocol 적절한 JMXConnectorServerProvider 검색을 합니다. protocol에 포함되는 문자 +와 -는 각각 . (와)과 _로 옮겨놓을 수 있습니다.

「프로바이더 패키지 리스트」의 검색 순서는 다음과 같습니다.

1. newJMXConnectorServer environment 파라미터에 키 jmx.remote.protocol.provider.pkgs가 포함되는 경우, 관련된 값이 프로바이더 패키지 리스트가 된다
2. 그 외의 경우로 시스템 프로퍼티 jmx.remote.protocol.provider.pkgs가 존재하는 경우, 그 값이 프로바이더 패키지 리스트가 된다
3. 그 외의 경우, 프로바이더 패키지 리스트는 존재하지 않는다

프로바이더 패키지 리스트는 세로의 곧은 선 (|)으로 단락지어진 비어있지 않은 Java 패키지명의 리스트라고 해석되는 캐릭터 라인입니다. 이 캐릭터 라인이 비어있는 경우, 프로바이더 패키지 리스트도 비웁니다. 프로바이더 패키지 리스트가 String가 아닌 경우, 또는 공문자열을 요소로서 포함한 경우, JMXProviderException을 발생시킵니다.

비어있지 않은 프로바이더 패키지 리스트가 존재하는 경우, 팩토리에의해 리스트의 각 pkg 요소에 대해서 클래스의 로드가 시행됩니다.

pkg. protocol. ServerProvider

newJMXConnectorServer environment 파라미터에 키 jmx.remote.protocol.provider.class.loader가 포함되는 경우, 관련된 값이 프로바이더를 로드하기 위한 클래스 로더가 됩니다. 관련된 값이 ClassLoader 인스턴스가 아닌 경우는 IllegalArgumentException을 발생시킵니다.

environment 파라미터내에 jmx.remote.protocol.provider.class.loader 키가 포함되지 않는 경우, 호출 thread의 컨텐츠 클래스 로더가 사용됩니다.

이 클래스의 로드시에 ClassNotFoundException이 Throw 되었을 경우, 핸들러의 검색은 리스트내의 다음의 요소에 인계됩니다.

그 외의 경우, JMXProviderException 에의해 검출된 프로바이더에 관한 문제가 보고됩니다. 이 예외의 cause 는 다음과 같이 잠재적인 예외를 나타냅니다.

• 클래스의 로드시에 ClassNotFoundException 이외의 예외가 Throw 되었을 경우, 이것이 cause가 된다
• 클래스의 Class.newInstance() 에 의해 예외가 Throw 되었을 경우, 이것이 cause가 된다

프로바이더 패키지 리스트가 존재하지 않는 디폴트 상태를 포함해, 상기의 순서로 프로바이더가 검출되지 않았던 경우, 구현은 protocol에 대해서 고유의 프로바이더를 사용합니다. 고유의 프로바이더가 없는 경우는 MalformedURLException을 Throw 합니다. 그 외의 방법으로 프로바이더를 검색할 수도 있습니다. 예를 들어 서비스 인터페이스로서 JMXConnectorServerProvider를 사용하는서비스 프로바이더의 JAR 규약이 지원 되고 있습니다.

모든 구현은 캐릭터 라인 rmi 또는 iiop로 지정되는 RMI 커넥터 프로토콜을 지원 하고 있지 않으면 안됩니다.

프로바이더가 발견되었을 경우, newJMXConnectorServer 메서드의 결과가 그 프로바이더상에서 newJMXConnectorServer를 호출한 결과에 일치합니다.

JMXConnectorServerProvider에 게 건네진 Map 파라미터는 JMXConnectorServerFactory.newJMXConnectorServer environment 파라미터내에 있던 모든 엔트리를 포함한, 새로운 읽기 전용 Map가 됩니다. 게다가environment 파라미터내에 jmx.remote.protocol.provider.class.loader 키가 존재하지 않는 경우, 새로운 읽기 전용 Map에 추가됩니다. 호출 thread의 컨텍스트 클래스 로더를 값으로 해서 관련지을 수 있습니다.

도입된 버전 :

1.5

필드 개요

static String	DEFAULT_CLASS_LOADER 디폴트의 클래스 로더를 지정하는 속성의 이름입니다.
static String	DEFAULT_CLASS_LOADER_NAME 디폴트의 클래스 로더 MBean 명을 지정하는 속성의 이름입니다.
static String	PROTOCOL_PROVIDER_CLASS_LOADER 프로토콜 프로바이더를 로드하는 클래스 로더를 지정하는 속성의 이름입니다.
static String	PROTOCOL_PROVIDER_PACKAGES 프로토콜 핸들러의 검색시에 조회되는 프로바이더 패키지를 지정하는 속성의 이름입니다.

메서드 개요

static JMXConnectorServer

newJMXConnectorServer (JMXServiceURL serviceURL, Map <String, ? > environment, MBeanServer mbeanServer) 지정된 주소의 커넥터 서버를 작성합니다.

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

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

필드의 상세

DEFAULT_CLASS_LOADER

public static final String  DEFAULT_CLASS_LOADER

디폴트의 클래스 로더를 지정하는 속성의 이름입니다. 이 클래스 로더는 MBean 고유의 클래스 로더의 조회 후 (임의), 클라이언트로부터 수신한 요구에 포함되는 객체를 직렬화 복원하기 위해서 사용됩니다. 이 속성에는 값으로 해서 ClassLoader 인스턴스를 관련지을 수 있습니다.

관련 항목:

정수 필드값

DEFAULT_CLASS_LOADER_NAME

public static final String  DEFAULT_CLASS_LOADER_NAME

디폴트의 클래스 로더 MBean 명을 지정하는 속성의 이름입니다. 이 클래스 로더는 MBean 고유의 클래스 로더의 조회 후 (임의), 클라이언트로부터 수신한 요구에 포함되는 객체를 직렬화 복원하기 위해서 사용됩니다. 이 속성에는 값으로 해서 ObjectName 인스턴스를 관련지을 수 있습니다.

관련 항목:

정수 필드값

PROTOCOL_PROVIDER_PACKAGES

public static final String  PROTOCOL_PROVIDER_PACKAGES

프로토콜 핸들러의 검색시에 조회되는 프로바이더 패키지를 지정하는 속성의 이름입니다. 이 속성에는 값으로서 세로의 곧은 선 (|)으로 단락지어진 패키지명으로부터 완성되는 캐릭터 라인을 관련지을 수 있습니다.

관련 항목:

정수 필드값

PROTOCOL_PROVIDER_CLASS_LOADER

public static final String  PROTOCOL_PROVIDER_CLASS_LOADER

프로토콜 프로바이더를 로드하는 클래스 로더를 지정하는 속성의 이름입니다. 이 속성에는 값으로서ClassLoader 인스턴스를 관련지을 수 있습니다.

관련 항목:

정수 필드값

메서드의 상세

newJMXConnectorServer

public static JMXConnectorServer  newJMXConnectorServer(JMXServiceURL  serviceURL,
                                                       Map <String,
? > environment,
                                                       MBeanServer  mbeanServer)
                                                throws IOException 

지정된 주소의 커넥터 서버를 작성합니다. 작성된 서버는 start 메서드가 불려 갈 때까지 시작하지 않습니다.

파라미터:

serviceURL - 새로운 커넥터 서버의 주소. getAddress 메서드에 의해 리턴된 새로운 커넥터 서버의 실제의 주소는 엄밀하게 같다라고는 한정되지 않는다. 예를 들어 원의 주소에 포함되지 않은 포트 번호가 포함되어 있는 경우가 있는

environment - 새로운 커넥터 서버의 동작을 제어하는 속성세트. 이 파라미터는 null 이라도 좋다. 이 맵내의 키는 String가 아니면 안된다. 관련된 개개의 값에 적절한 형태는 이 속성에 의해 결정된다. 이 호출이 environment를 변경할 것은 없는

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

반환값:

새로운 커넥터 서버를 나타내는 JMXConnectorServer. 이 메서드가 정상적으로 불려가 면, 그때마다 다른 객체가 생성된다

예외:

NullPointerException - serviceURL가 null인 경우

IOException - 통신 장해에 의해 커넥터 서버를 작성할 수 없는 경우

MalformedURLException - serviceURL 내에 프로토콜의 프로바이더가 존재하지 않는 경우

JMXProviderException - serviceURL 내에 프로토콜의 프로바이더가 존재하지만, 어떠한 이유로써 사용할 수 없는 경우