Пакет javax.management.remote

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

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

Интерфейсная Сводка

Интерфейс	Описание
JMXAddressable	Реализованный объектами, у которых может быть a JMXServiceURL адрес.
JMXAuthenticator	Интерфейс, чтобы определить, как удаленные учетные данные преобразовываются в Предмет JAAS.
JMXConnector	Клиентский конец соединителя API JMX.
JMXConnectorProvider	Провайдер для того, чтобы создать клиенты соединителя API JMX, использующие данный протокол.
JMXConnectorServerMBean	MBean взаимодействуют через интерфейс для серверов соединителя.
JMXConnectorServerProvider	Провайдер для того, чтобы создать серверы соединителя API JMX, используя данный протокол.
MBeanServerForwarder	Объект этого класса реализует интерфейс MBeanServer и обертывает другой объект, который также реализует тот интерфейс.

Сводка класса

Класс	Описание
JMXConnectionNotification	Уведомление, испускаемое, когда клиентское соединение открывается или закрывается или когда уведомления теряются.
JMXConnectorFactory	Фабрика, чтобы создать клиенты соединителя API JMX.
JMXConnectorServer	Суперкласс каждого сервера соединителя.
JMXConnectorServerFactory	Фабрика, чтобы создать серверы соединителя API JMX.
JMXPrincipal	Идентификационные данные удаленного клиента JMX Удаленный API.
JMXServiceURL	Адрес сервера соединителя API JMX.
NotificationResult	Результат запроса для буферизованных уведомлений.
SubjectDelegationPermission	Разрешение, требуемое идентификационными данными аутентификации выполнять операции от имени идентификационных данных авторизации.
TargetedNotification	(Уведомление, ID Слушателя) пара.

Сводка исключения

Исключение	Описание
JMXProviderException	Исключение, выданное JMXConnectorFactory и JMXConnectorServerFactory когда провайдер существует для необходимого протокола, но не может использоваться по некоторым причинам.
JMXServerErrorException	Исключение, выданное как результат удаленного MBeanServer вызов метода, когда Error бросается, обрабатывая вызов в удаленном сервере MBean.

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

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

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

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

• Удаленный API JMX определяет стандартный соединитель, Соединитель RMI, который обеспечивает удаленный доступ к MBeanServer через RMI.
• JMX Удаленный API также определяет дополнительный соединитель под названием Соединитель JMXMP, реализовывая JMX, передают Протокол (JMXMP). Поскольку это является дополнительным, это не часть этого пакета (см. примечание ниже).
• Определяемые пользователем протоколы соединителя являются также возможным использованием JMXConnectorFactory и, дополнительно, Универсальный Соединитель (не часть этого пакета, см. примечание ниже).

Отметьте: дополнительные пакеты, реализовывая дополнительную часть 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