javax.management.remote

Класс JMXConnectorServerFactory

java.lang. Объект

javax.management.remote.JMXConnectorServerFactory

public class JMXConnectorServerFactory
extends Object

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

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

pkg.protocol.ServerProvider

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

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

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

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

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

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

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

Как только провайдер находится, результат newJMXConnectorServer метод является результатом вызова newJMXConnectorServer на провайдере.

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

С тех пор:

1.5

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

Поля

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

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

Методы

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

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

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

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

DEFAULT_CLASS_LOADER

public static final String DEFAULT_CLASS_LOADER

Имя атрибута, который определяет загрузчик класса по умолчанию. Этот загрузчик класса используется, чтобы десериализовать объекты в запросах, полученных от клиента, возможно после консультации с MBean-специфичным загрузчиком класса. Значение, связанное с этим атрибутом, является экземпляром ClassLoader.

См. Также:

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

DEFAULT_CLASS_LOADER_NAME

public static final String DEFAULT_CLASS_LOADER_NAME

Имя атрибута, который определяет загрузчик класса по умолчанию имя MBean. Этот загрузчик класса используется, чтобы десериализовать объекты в запросах, полученных от клиента, возможно после консультации с MBean-специфичным загрузчиком класса. Значение, связанное с этим атрибутом, является экземпляром ObjectName.

См. Также:

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

PROTOCOL_PROVIDER_PACKAGES

public static final String PROTOCOL_PROVIDER_PACKAGES

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

См. Также:

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

PROTOCOL_PROVIDER_CLASS_LOADER

public static final String PROTOCOL_PROVIDER_CLASS_LOADER

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

См. Также:

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

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

newJMXConnectorServer

public static JMXConnectorServer newJMXConnectorServer(JMXServiceURL serviceURL,
                                       Map<String,?> environment,
                                       MBeanServer mbeanServer)
                                                throws IOException

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

Параметры:

serviceURL - адрес нового сервера соединителя. Фактический адрес нового сервера соединителя, как возвращено getAddress метод, не обязательно будет точно то же самое. Например, это могло бы включать номер порта, если бы исходный адрес не сделал.

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

mbeanServer - сервер MBean, к которому присоединен этот сервер соединителя. Нуль, если этот сервер соединителя будет присоединен к серверу MBean, будучи зарегистрированным в этом.

Возвраты:

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

Броски:

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

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

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

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