Spec-Zone .ru
спецификации, руководства, описания, API
 Платформа Java™
Стандарт Эд. 7

Пакет javax.management.remote

Интерфейсы для удаленного доступа к JMX MBean серверы.

См.: Описание

Пакет javax.management.remote Описание

Интерфейсы для удаленного доступа к JMX MBean серверы. Этот пакет определяет существенные интерфейсы для того, чтобы сделать JMX MBean сервером управляемый удаленно. Спецификация этой функциональности завершается Частью III Спецификации JMX, документа в формате PDF версии 1.4.

Спецификация JMX определяет понятие соединителей. Соединитель присоединен к API JMX сервер MBean и делает его доступным, чтобы отдалить клиенты Java. Клиентский конец соединителя экспортирует по существу тот же самый интерфейс как сервер MBean, определенно MBeanServerConnection интерфейс.

Соединитель делает сервер MBean удаленно доступным через данный протокол. JMX Удаленный API позволяет использование различного типа соединителей:

Отметьте: дополнительные пакеты, реализовывая дополнительную часть JMX Удаленный API не включается в Java Платформа SE, но доступен от JMX Удаленная Ссылочная Реализация API.

Адреса соединителя

Как правило, у сервера соединителя есть адрес, представленный классом JMXServiceURL. Адрес для Соединителя RMI может быть похожим на это:

      service:jmx:rmi:///jndi/rmi://myhost:1099/myname
      

В этом JMXServiceURL, первое rmi: определяет соединитель RMI, в то время как второе rmi: определяет реестр RMI, в который сервер соединителя RMI сохранил свой тупик.

Пример выше показывает только одну форму обращения. Адрес для Соединителя RMI может принять несколько форм, как детализировано в документации для пакета javax.management.remote.rmi.

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

Сервер соединителя создается, создавая экземпляр подкласса JMXConnectorServer. Обычно, этот экземпляр создается, используя метод JMXConnectorServerFactory.newJMXConnectorServer.

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

Создание клиента соединителя

Клиент соединителя обычно создается, предоставляя JMXServiceURL из сервера соединителя, чтобы соединиться с к JMXConnectorFactory.connect метод.

Для более специализированного использования клиент соединителя может быть создан, непосредственно инстанцируя класса, который реализует JMXConnector интерфейс, например класс RMIConnector.

Дополнительный клиент или параметры сервера

Создавая клиент соединителя или сервер, возможно предоставить объект типа Map это определяет дополнительные параметры. У каждой записи в этой Карте есть ключ, который является строкой и присваиваемым значением, тип которого является подходящим для того ключа. Стандартные ключи, определенные JMX Удаленный API, все начинают со строки"jmx.remote.". Документ JMX Удаленный API перечисляет эти стандартные ключи.

Идентификаторы соединения

У каждого соединения, открытого сервером соединителя, есть строковый идентификатор, названный его идентификатором соединения. Этот идентификатор появляется в JMXConnectionNotification события, испускаемые сервером соединителя, в списке, возвращенном getConnectionIds(), и в значении возвратился клиентом getConnectionId() метод.

Как пример, может выглядеть примерно так ID соединения:

rmi://192.18.1.9 username 1
      

Формальная грамматика для идентификаторов соединения, которые следуют за этим соглашением, следующим образом (использующий нотацию грамматики от раздела 2.4 из Спецификации языка Java™):

ConnectionId:
    Protocol : ClientAddressopt Space ClientIdopt Space ArbitraryText

ClientAddress:
    // HostAddress ClientPortopt

ClientPort
    : HostPort
      

Protocol протокол, который был бы распознан JMXConnectorFactory.

ClientAddress адрес и порт соединяющегося клиента, если они могут быть определены, иначе ничто. HostAddress Интернет-адрес узла, который клиент соединяет от в форме DNS или числовом. Числовые адреса IPv6 включаются в квадратные скобки []. HostPort десятичный номер порта, от которого соединяется клиент.

ClientId идентификационные данные клиентского объекта, обычно строки, возвращенной JMXPrincipal.getName(). Эта строка не должна содержать пробелы.

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

С тех пор:
1.5
См. Также:
Документация Платформы Java относительно технологии JMX, в особенности Спецификация JMX, версия 1.4
 Платформа Java™
Стандарт Эд. 7

Представьте ошибку или функцию
Для дальнейшей ссылки API и документации разработчика, см. Java Документация SE. Та документация содержит более подробные, предназначенные разработчиком описания, с концептуальными краткими обзорами, определениями сроков, обходных решений, и рабочих примеров кода.
Авторское право © 1993, 2011, Oracle и/или его филиалы. Все права защищены.