Класс JMXConnectorServerFactory

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

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

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

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

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

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

pkg.protocol.ServerProvider

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

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

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

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

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

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

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

После того, как поставщик найден, результат метода newJMXConnectorServer — результат вызова newJMXConnectorServer на поставщике.

Параметр Map переданный методу JMXConnectorServerProvider является новым read-only Map, который содержит все записи, которые были в параметре environment метода JMXConnectorServerFactory.newJMXConnectorServer, если таковой был. Дополнительно, если ключ jmx.remote.protocol.provider.class.loader отсутствует в параметре environment, он добавляется в новый read-only Map. Соответствующим значением является контекстный загрузчик классов вызывающей нити.