Класс JMXConnectorServerFactory

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

Каждый сервер соединителей создается экземпляром 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, представляет собой новую доступную только для чтения Map, содержащую все записи, которые находились в параметре environment метода JMXConnectorServerFactory.newJMXConnectorServer, если он был указан. Кроме того, если ключ jmx.remote.protocol.provider.class.loader отсутствует в параметре environment, он добавляется в новую доступную только для чтения Map. Связанным с ним значением является загрузчик классов контекста вызывающего потока.