javax.management.remote
클래스 JMXConnectorFactory

java.lang.Object 
  javax.management.remote.JMXConnectorFactory

public class JMXConnectorFactory
extends Object 

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

보통, 접속은 이 클래스의 connect 메서드에 의해 확립됩니다. 고도의 어플리케이션에서는 커넥터 클라이언트의 작성 처리와 접속 처리 자체가newJMXConnector 와 JMXConnector.connect(Map) 로 나눌 수 있고 있습니다.

각 클라이언트는 JMXConnectorProvider 인스턴스에 의해 작성됩니다. 지정된 JMXServiceURL 가 "service:jmx:protocol:remainder"와 같았다고 합시다. 팩토리는 그 protocol에 적절한 JMXConnectorProvider 검색을 실시합니다. protocol에 포함되는 문자 +와 -는 각각 . (와)과 _로 옮겨놓을 수 있습니다.

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

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

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

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

pkg. protocol. ClientProvider

newJMXConnector 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 합니다. 그 외의 방법으로 프로바이더를 검색할 수도 있습니다. 예를 들어 서비스 인터페이스로서 JMXConnectorProvider를 사용하는서비스 프로바이더의 JAR 규약이 지원 되고 있습니다.

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

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

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

도입된 버전 :

1.5

필드 개요

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

메서드 개요

static JMXConnector	connect (JMXServiceURL serviceURL) 지정된 주소의 커넥터 서버와의 접속을 작성합니다.
static JMXConnector	connect (JMXServiceURL serviceURL, Map <String, ? > environment) 지정된 주소의 커넥터 서버와의 접속을 작성합니다.
static JMXConnector	newJMXConnector (JMXServiceURL serviceURL, Map <String, ? > environment) 지정된 주소의 커넥터 서버의 커넥터 클라이언트를 작성합니다.

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

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

필드의 상세

DEFAULT_CLASS_LOADER

public static final String  DEFAULT_CLASS_LOADER

디폴트의 클래스 로더를 지정하는 속성의 이름입니다. 이 클래스 로더는 리모트 MBeanServerConnection 호출로부터의 반환값과 예외를 직렬화 복원하기 위해서 사용됩니다. 이 속성에는 값으로 해서 ClassLoader 인스턴스를 관련지을 수 있습니다.

관련 항목:

정수 필드값

PROTOCOL_PROVIDER_PACKAGES

public static final String  PROTOCOL_PROVIDER_PACKAGES

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

관련 항목:

정수 필드값

PROTOCOL_PROVIDER_CLASS_LOADER

public static final String  PROTOCOL_PROVIDER_CLASS_LOADER

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

관련 항목:

정수 필드값

메서드의 상세

connect

public static JMXConnector  connect(JMXServiceURL  serviceURL)
                            throws IOException 

지정된 주소의 커넥터 서버와의 접속을 작성합니다.

이 메서드는 connect(serviceURL, null) 와 동등합니다.

파라미터:

serviceURL - 접속처 커넥터 서버의 주소

반환값:

connect 메서드가 불려 간 JMXConnector

예외:

NullPointerException - serviceURL가 null인 경우

IOException - 통신 장해에 의해 커넥터 클라이언트를 작성할 수 없는 경우, 또는 접속을 확립할 수 없는 경우

SecurityException - 보안상의 이유에 의해 접속을 확립할 수 없는 경우

connect

public static JMXConnector  connect(JMXServiceURL  serviceURL,
                                   Map <String,
? > environment)
                            throws IOException 

지정된 주소의 커넥터 서버와의 접속을 작성합니다.

이 메서드는 다음과 동등합니다.

 JMXConnector conn = JMXConnectorFactory.newJMXConnector(serviceURL,
                                                         environment);
 conn.connect(environment);
 

파라미터:

serviceURL - 접속처 커넥터 서버의 주소

environment - 접속의 확립 방법을 결정짓는 속성세트. 이 파라미터는 null 이라도 좋다. 이 맵내의 키는 String가 아니면 안된다. 관련된 개개의 값에 적절한 형태는 이 속성에 의해 결정된다. 이 호출이 environment를 변경할 것은 없다

반환값:

새롭게 확립된 접속을 나타내는 JMXConnector. 이 메서드가 정상적으로 불려가 면, 그때마다 다른 객체가 생성된다

예외:

NullPointerException - serviceURL가 null인 경우

IOException - 통신 장해에 의해 커넥터 클라이언트를 작성할 수 없는 경우, 또는 접속을 확립할 수 없는 경우

SecurityException - 보안상의 이유에 의해 접속을 확립할 수 없는 경우

newJMXConnector

public static JMXConnector  newJMXConnector(JMXServiceURL  serviceURL,
                                           Map <String,
? > environment)
                                    throws IOException 

지정된 주소의 커넥터 서버의 커넥터 클라이언트를 작성합니다. 작성된 클라이언트는 connect 메서드가 불려 갈 때까지 접속되지 않습니다.

파라미터:

serviceURL - 접속처 커넥터 서버의 주소

environment - 접속의 확립 방법을 결정짓는 속성세트. 이 파라미터는 null 이라도 좋다. 이 맵내의 키는 String가 아니면 안된다. 관련된 개개의 값에 적절한 형태는 이 속성에 의해 결정된다. 이 호출이 environment를 변경할 것은 없다

반환값:

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

예외:

NullPointerException - serviceURL가 null인 경우

IOException - 통신 장해에 의해 커넥터 클라이언트를 작성할 수 없는 경우

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

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