Пакет javax.management.remote

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

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

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

• JMX Remote API определяет стандартный коннектор, RMI коннектор, который обеспечивает удаленный доступ к MBeanServer через RMI.
• JMX Remote API также определяет необязательный коннектор под названием JMXMP коннектор, реализующий протокол JMX Message Protocol (JMXMP). Так как он является необязательным, он не входит в этот пакет (см. примечание ниже).
• Пользовательские протоколы коннекторов также возможны, используя JMXConnectorFactory и, необязательно, общий коннектор (не входит в этот пакет, см. примечание ниже).

Примечание: необязательные пакеты, реализующие необязательную часть JMX Remote API, не включены в Java SE Platform, но доступны в реализации JMX Remote API Reference Implementation.

Адреса коннекторов

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

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

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

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

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

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

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

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

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

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

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

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

Идентификаторы подключений

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

В качестве примера, идентификатор подключения может выглядеть так:

rmi://192.18.1.9 username 1

Формальная грамматика для идентификаторов подключений, которые следуют этой схеме (используя обозначение грамматики из раздела 2.4 The Java™ Language Specification):

ConnectionId:
    Protocol : ClientAddressopt Space ClientIdopt Space ArbitraryText

ClientAddress:
    // HostAddress ClientPortopt

ClientPort
    : HostPort

Protocol — это протокол, который распознается JMXConnectorFactory.

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

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

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