Класс 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, если такового нет. Реализация может выбрать поиск поставщиков другими способами. Например, она может поддерживать поставщиков сервисов, где интерфейс сервиса — JMXConnectorProvider.

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

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

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