Класс JMXConnectorFactory

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

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