compact3

javax.management.remote

Класс JMXConnectorFactory

java.lang. Объект

javax.management.remote.JMXConnectorFactory

public class JMXConnectorFactory
extends Object

Фабрика, чтобы создать клиенты соединителя API JMX. Нет никаких экземпляров этого class.

Соединения обычно делаются, используя connect метод этого class. Больше усовершенствованных приложений может разделить создание клиента соединителя, используя 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, разделенных вертикальными панелями (|). Если строка пуста, то так список пакета провайдера. Если списком пакета провайдера не является Строка, или если он содержит элемент, который является пустой строкой, a JMXProviderException бросается.

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

pkg.protocol.ClientProvider

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

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

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

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

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

Если никакой провайдер не будет найден вышеупомянутыми шагами, включая случай значения по умолчанию, где нет никакого списка пакета провайдера, то реализация будет использовать своего собственного провайдера для protocol, или это бросит a 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. Присваиваемое значение является контекстом вызывающего потока загрузчик class.

С тех пор:

1.5

Полевая Сводка

Поля

Модификатор и Тип	Поле и Описание
static String	DEFAULT_CLASS_LOADER Имя атрибута, который определяет значение по умолчанию загрузчик class.
static String	PROTOCOL_PROVIDER_CLASS_LOADER Имя атрибута, который определяет загрузчик class для того, чтобы загрузить провайдеров протокола.
static String	PROTOCOL_PROVIDER_PACKAGES Имя атрибута, который определяет пакеты провайдера, с которыми консультируются, ища обработчик для протокола.

Сводка метода

Модификатор и Тип	Метод и Описание
static JMXConnector	connect(JMXServiceURL serviceURL) Создает соединение с сервером соединителя в данном адресе.
static JMXConnector	connect(JMXServiceURL serviceURL, Map<String,?> environment) Создает соединение с сервером соединителя в данном адресе.
static JMXConnector	newJMXConnector(JMXServiceURL serviceURL, Map<String,?> environment) Создает клиент соединителя для сервера соединителя в данном адресе.

Методы, наследованные от class java.lang. Объект

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Полевая Деталь

DEFAULT_CLASS_LOADER

public static final String DEFAULT_CLASS_LOADER

Имя атрибута, который определяет значение по умолчанию загрузчик class. Этот загрузчик class используется, чтобы десериализовать возвращаемые значения и исключения из удаленного MBeanServerConnection вызовы. Значение, связанное с этим атрибутом, является экземпляром ClassLoader.

См. Также:

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

PROTOCOL_PROVIDER_PACKAGES

public static final String PROTOCOL_PROVIDER_PACKAGES

Имя атрибута, который определяет пакеты провайдера, с которыми консультируются, ища обработчик для протокола. Значение, связанное с этим атрибутом, является строкой с именами пакета, разделенными вертикальными панелями (|).

См. Также:

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

PROTOCOL_PROVIDER_CLASS_LOADER

public static final String PROTOCOL_PROVIDER_CLASS_LOADER

Имя атрибута, который определяет загрузчик class для того, чтобы загрузить провайдеров протокола. Значение, связанное с этим атрибутом, является экземпляром ClassLoader.

См. Также:

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

Деталь метода

соединиться

public static JMXConnector connect(JMXServiceURL serviceURL)
                            throws IOException

Создает соединение с сервером соединителя в данном адресе.

Этот метод эквивалентен connect(serviceURL, null).

Параметры:

serviceURL - адрес сервера соединителя, чтобы соединиться с.

Возвраты:

a JMXConnector чей connect метод вызвали.

Броски:

NullPointerException - если serviceURL нуль.

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

SecurityException - если соединение не может быть сделано для соображений безопасности.

соединиться

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

Создает соединение с сервером соединителя в данном адресе.

Этот метод эквивалентен:

 JMXConnector conn = JMXConnectorFactory.newJMXConnector(serviceURL,
                                                         environment);
 conn.connect(environment);
 

Параметры:

serviceURL - адрес сервера соединителя, чтобы соединиться с.

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

Возвраты:

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

Броски:

NullPointerException - если serviceURL нуль.

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

SecurityException - если соединение не может быть сделано для соображений безопасности.

newJMXConnector

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

Создает клиент соединителя для сервера соединителя в данном адресе. Результирующий клиент не соединяется до connect метод вызывают.

Параметры:

serviceURL - адрес сервера соединителя, чтобы соединиться с.

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

Возвраты:

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

Броски:

NullPointerException - если serviceURL нуль.

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

MalformedURLException - если нет никакого провайдера для протокола в serviceURL.

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