Класс JMXConnectorFactory

Фабрика для создания клиентов соединений JMX API. Экземпляров этого класса нет.

Соединения обычно создаются с помощью метода connect этого класса. Более продвинутые приложения могут разделять создание клиента соединения, используя newJMXConnector, и установление самого соединения, используя JMXConnector.connect(Map).

Каждый клиент создаётся экземпляром JMXConnectorProvider. Этот экземпляр находится следующим образом. Предположим, заданный JMXServiceURL выглядит как "service:jmx:protocol:remainder". Тогда фабрика попытается найти соответствующий JMXConnectorProvider для protocol. Каждый символ + или - в protocol заменяется на . или _, соответственно.

Перечень пакетов поставщиков ищется следующим образом:

1. Если параметр environment метода newJMXConnector содержит ключ jmx.remote.protocol.provider.pkgs, то соответствующее значение является списком пакетов поставщиков.
2. В противном случае, если существует системная переменная jmx.remote.protocol.provider.pkgs, то её значение является списком пакетов поставщиков.
3. В противном случае, список пакетов поставщиков отсутствует.

Список пакетов поставщиков — это строка, которая интерпретируется как список непустых имён Java-пакетов, разделённых вертикальными чертами (|). Если строка пустая, то список пакетов поставщиков также пустой. Если список пакетов поставщиков не является строкой или содержит элемент, являющийся пустой строкой, выбрасывается исключение JMXProviderException.

Если список пакетов поставщиков существует и не пуст, то для каждого элемента pkg списка фабрика попытается загрузить класс

pkg.protocol.ClientProvider

Если параметр environment метода newJMXConnector содержит ключ jmx.remote.protocol.provider.class.loader, то соответствующее значение — класс загрузчик, который нужно использовать для загрузки поставщика. Если соответствующее значение не является экземпляром ClassLoader, выбрасывается исключение IllegalArgumentException.

Если ключ jmx.remote.protocol.provider.class.loader отсутствует в параметре environment, используется контекстный загрузчик класса текущей нити.

Если попытка загрузки этого класса приводит к ClassNotFoundException, поиск обработчика продолжается со следующим элементом списка.

В противном случае, проблема с найденным поставщиком сигнализируется исключением JMXProviderException, где cause указывает на базовое исключение следующим образом:

• если попытка загрузки класса приводит к исключению, отличного от ClassNotFoundException, то это причина;
• если вызов Class.newInstance() для класса приводит к исключению, то это причина.

Если ни один поставщик не найден по вышеуказанным шагам, включая случай по умолчанию, когда нет списка пакетов поставщиков, то реализация будет использовать собственного поставщика для protocol, или она выбросит исключение MalformedURLException, если его нет. Реализация может выбрать поиск поставщиков иными способами. Например, она может поддерживать JAR-конвенции для поставщиков сервисов, где интерфейс сервиса — JMXConnectorProvider.

Каждая реализация должна поддерживать протокол соединения RMI с транспортным средством RMI по умолчанию, заданным строкой rmi. Реализация может дополнительно поддерживать протокол соединения RMI с транспортным средством RMI/IIOP, заданным строкой iiop.

После нахождения поставщика результатом метода newJMXConnector является результат вызова newJMXConnector на поставщике.

Параметр Map , переданный в метод JMXConnectorProvider , является новым неизменяемым Map , содержащим все записи, которые были в параметре environment метода JMXConnectorFactory.newJMXConnector, если таковой был. Кроме того, если ключ jmx.remote.protocol.provider.class.loader отсутствует в параметре environment , он добавляется в новый неизменяемый Map. Соответствующим значением является контекстный загрузчик класса текущей нити.

Поля

DEFAULT_CLASS_LOADER

public static final String DEFAULT_CLASS_LOADER

См. также:

Значения константных полей

PROTOCOL_PROVIDER_PACKAGES

public static final String PROTOCOL_PROVIDER_PACKAGES

См. также:

Значения константных полей

PROTOCOL_PROVIDER_CLASS_LOADER

public static final String PROTOCOL_PROVIDER_CLASS_LOADER

См. также:

Значения константных полей

Методы

connect

public static JMXConnector connect(JMXServiceURL serviceURL)
                            throws IOException

Параметры:

serviceURL — адрес сервера-коннектора для подключения.

Возвращает:

объект JMXConnector, для которого был вызван метод connect.

Исключения:

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. Ключи в этом map должны быть строками. Соответствующий тип каждого связанного значения зависит от атрибута. Содержимое environment этим вызовом не изменяется.

Возвращает:

объект JMXConnector , представляющий вновь созданное соединение. Каждый успешный вызов этого метода создаёт другой объект.

Исключения:

NullPointerException — если serviceURL равно null.

IOException — если подключение к клиенту-коннектору или само соединение невозможно из-за проблемы с коммуникацией.

SecurityException — если подключение невозможно по соображениям безопасности.

newJMXConnector

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

Параметры:

serviceURL — адрес сервера-коннектора для подключения.

environment — набор атрибутов, определяющих способ создания соединения. Этот параметр может быть null. Ключи в этом map должны быть строками. Соответствующий тип каждого связанного значения зависит от атрибута. Содержимое environment этим вызовом не изменяется.

Возвращает:

объект JMXConnector , представляющий новый клиент-коннектор. Каждый успешный вызов этого метода создаёт другой объект.

Исключения:

NullPointerException — если serviceURL равно null.

IOException — если клиент-коннектор не может быть создан из-за проблемы с коммуникацией.

MalformedURLException — если нет поставщика для протокола в serviceURL.

JMXProviderException — если поставщик для протокола в serviceURL существует, но не может быть использован по какой-либо причине.