Пакет javax.management.remote.rmi

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

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

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

Интерфейс	Описание
RMIConnection	Объект RMI, используемый, чтобы передать запрос MBeanServer от клиента к его реализации MBeanServer на серверной стороне.
RMIServer	Объект RMI, используемый, чтобы установить соединения с соединителем RMI.

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

Класс	Описание
RMIConnectionImpl	Реализация RMIConnection интерфейс.
RMIConnectionImpl_Stub
RMIConnector	Соединение с удаленным соединителем RMI.
RMIConnectorServer	Сервер соединителя API JMX, который создает основанные на RMI соединения от удаленных клиентов.
RMIIIOPServerImpl	RMIServerImpl это экспортируется через IIOP, и это создает клиентские соединения как объекты RMI, экспортируемые через IIOP.
RMIJRMPServerImpl	RMIServer объект, который экспортируется через JRMP и это создает клиентские соединения как объекты RMI, экспортируемые через JRMP.
RMIServerImpl	Объект RMI представление сервера соединителя.
RMIServerImpl_Stub

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

Соединитель RMI является соединителем для JMX Удаленный API, который использует RMI, чтобы передать клиентские запросы к удаленному серверу MBean. Этот пакет определяет классы, на которые пользователь соединителя RMI должен сослаться непосредственно для обоих стороны клиента и сервера. Это также определяет определенные классы, на которые пользователь не будет обычно ссылаться непосредственно, но это должно быть определено так, чтобы могли взаимодействовать различные реализации соединителя RMI.

Соединитель RMI поддерживает и JRMP и транспорты IIOP для RMI.

Как большинство соединителей в JMX Удаленный API, у соединителя RMI обычно есть адрес, который является a JMXServiceURL. Часть протокола этого адреса rmi для соединителя, который использует транспорт RMI по умолчанию (JRMP), или iiop для соединителя, который использует RMI/IIOP.

Есть две формы для адресов соединителя RMI:

• В форме JNDI URL указывает, где найти тупик RMI для соединителя. Этот тупик RMI является объектом Java типа RMIServer это дает удаленный доступ к серверу соединителя. С этой формой адреса тупик RMI получается из внешней записи каталога, включенной в URL. Внешний каталог является любым каталогом, распознанным JNDI, обычно реестр RMI, LDAP, или Именование COS.
• В закодированной форме URL непосредственно включает информацию, должен был соединиться с сервером соединителя. При использовании RMI/JRMP закодированная форма является сериализированным тупиком RMI для серверный объекта, закодированное использование BASE64 без встроенных новых строк. При использовании RMI/IIOP закодированная форма является CORBA IOR для серверный объекта.

Адреса покрываются более подробно ниже.

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

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

Сервер соединителя RMI может также быть создан, создавая экземпляр RMIConnectorServer, явно или через сервер MBean createMBean метод.

Выбор транспорта RMI

Можно выбрать транспорт RMI (JRMP или IIOP), определяя rmi или iiop в protocol часть serviceURL создавая сервер соединителя. Можно также создать специализированные серверы соединителя, инстанцируя соответствующего подкласса RMIServerImpl и предоставление этого к RMIConnectorServer конструктор.

Адреса соединителя сгенерированы сервером

Если serviceURL Вы определяете, имеет пустой путь URL (после того, как дополнительный узел и порт), или если Вы не определяете a serviceURL, тогда сервер соединителя произведет новое JMXServiceURL то, что клиенты могут использовать для подключения:

• Если serviceURL похож:

          service:jmx:rmi://host:port
          

  тогда сервер соединителя генерирует RMIJRMPServerImpl и возвращенный JMXServiceURL похож:

          service:jmx:rmi://host:port/stub/XXXX
          

  где XXXX сериализированная форма тупика для сгенерированного объекта, закодированного в BASE64 без новых строк.

• Если serviceURL похож:

          service:jmx:iiop://host:port
          

  тогда сервер соединителя генерирует RMIIIOPServerImpl и возвращенный JMXServiceURL похож:

          service:jmx:iiop://host:port/ior/IOR:XXXX
          

  где IOR:XXXX стандартное кодирование CORBA Взаимодействующей Ссылки на объект для сгенерированного объекта.

• Если есть нет serviceURL, должен быть предоставленный пользователем RMIServerImpl. Если toStub метод на этом объекте возвращает экземпляр Stub, тогда сервер соединителя генерирует a JMXServiceURL использование iiop форма выше. Иначе, это генерирует a JMXServiceURL использование rmi форма.

host в предоставленном пользователем serviceURL является дополнительным. Если существующий, это копируется в сгенерированный JMXServiceURL но иначе проигнорированный. Если отсутствующий, сгенерированный JXMServiceURL будет иметь локальное имя хоста.

port в предоставленном пользователем serviceURL является также дополнительным. Если существующий, это также копируется в сгенерированный JMXServiceURL; иначе, сгенерированный JMXServiceURL не имеет никакого порта. Для serviceURL использование rmi протокол, portЕсли есть указывает на то, на каком порте сгенерированный удаленный объект должен быть экспортирован. Это не имеет никакого другого эффекта.

Если пользователь обеспечивает RMIServerImpl вместо a JMXServiceURL, тогда сгенерированный JMXServiceURL будет иметь локальное имя хоста в host часть и нет port.

Адреса соединителя, основанные на записях каталога

Как альтернатива сгенерированным адресам, только описанным, serviceURL адрес, предоставленный, создавая сервер соединителя, может определить адрес каталога, в котором можно сохранить обеспеченный или сгенерированный RMIServer тупик. Этот адрес каталога тогда используется обоими клиентами и серверами.

В этом случае, serviceURL имеет одну из этих двух форм:

    service:jmx:rmi://host:port/jndi/jndi-name
    service:jmx:iiop://host:port/jndi/jndi-name
    

Здесь, jndi-name строка, которая может быть предоставлена javax.naming.InitialContext.bind.

Как обычно, host и :port может быть опущен.

Сервер соединителя генерирует RMIServerImpl основанный на протоколе (rmi или iiop) и, для rmi, port если любой. Когда сервер соединителя будет запущен, он получит тупик из этого объекта, используя toStub метод и хранилище объект, используя данный jndi-name. Со свойствами, определенными API JNDI, консультируются как обычно.

Например, если JMXServiceURL :

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

тогда сервер соединителя генерирует RMIJRMPServerImpl и сохраните его тупик, используя имя JNDI

      rmi://myhost/myname
      

что означает запись myname в реестре RMI, работающем на порту по умолчанию узла myhost. Отметьте, что реестр RMI только позволяет регистрацию от локального узла. Так, в этом случае, myhost должно быть имя (или имя) узла, на котором работает сервер соединителя.

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

Как другой пример, если JMXServiceURL :

      service:jmx:iiop://ignoredhost/jndi/ldap://dirhost:9999/cn=this,ou=that
      

тогда сервер соединителя генерирует RMIIIOPServerImpl и сохраните его тупик, используя имя JNDI

      ldap://dirhost:9999/cn=this,ou=that
      

что означает запись cn=this,ou=that в каталоге LDAP, работающем на порту 9999 из узла dirhost.

Если JMXServiceURL :

      service:jmx:iiop://ignoredhost/jndi/cn=this,ou=that
      

тогда сервер соединителя генерирует RMIIIOPServerImpl и сохраните его тупик, используя имя JNDI

      cn=this,ou=that
      

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

В этих примерах, имени хоста ignoredhost не используется сервером соединителя или его клиентами. Это может быть опущено, например:

      service:jmx:iiop:///jndi/cn=this,ou=that
      

Однако, это - хорошая практика, чтобы использовать имя узла, куда сервер соединителя работает. Это часто отличается от имени узла каталога.

Атрибуты сервера соединителя

При использовании транспорта JRMP по умолчанию фабрики сокета RMI могут быть определены, используя атрибуты jmx.remote.rmi.client.socket.factory и jmx.remote.rmi.server.socket.factory в environment данный RMIConnectorServer конструктор. Значения этих атрибутов должны иметь тип RMIClientSocketFactory и RMIServerSocketFactory, соответственно. Эти фабрики используются, создавая объекты RMI, связанные с соединителем.

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

Клиент соединителя RMI обычно создается, используя JMXConnectorFactory, с a JMXServiceURL это имеет rmi или iiop как его протокол.

Если JMXServiceURL был сгенерирован сервером, как описано выше под "адресами соединителя, сгенерированными сервером", тогда клиент должен будет получить это прямо или косвенно из сервера. Как правило, сервер делает JMXServiceURL доступный, храня это в файле или службе поиска.

Если JMXServiceURL использует синтаксис каталога, как описано выше под "адресами соединителя, основанными на записях каталога", тогда клиент может получить его как только объяснено, или клиент и сервер может оба знать, что соответствующая запись каталога использует. Например, если сервер соединителя для агента Whatsit использует запись whatsit-agent-connector в реестре RMI на узле myhost, тогда клиент и сервер может оба знать что соответствующее JMXServiceURL :

    service:jmx:rmi:///jndi/rmi://myhost/whatsit-agent-connector
    

Если у Вас есть тупик RMI типа RMIServer, можно создать соединение RMI непосредственно при использовании соответствующего конструктора RMIConnector.

Определение ШАРА для соединителя RMI/IIOP

При использовании транспорта IIOP клиент и сервер может определить что ШАР использовать с атрибутом java.naming.corba.orb. Соединение с ШАРОМ происходит в start время для сервера соединителя, и в connect время для клиента соединителя. Если java.naming.corba.orb атрибут содержится в Карте среды, тогда ее значение ( ORB), используется, чтобы соединить Тупики IIOP. Иначе, новый org.omg. CORBA.ORB создается, вызывая org.omg.CORBA.ORB.init((String[])null,(Properties)null). Более поздний клиент соединителя RMI или сервер в той же самой JVM могут снова использовать этот ШАР, или это может создать другой таким же образом.

Если java.naming.corba.orb атрибут определяется и не указывает на ORB, тогда IllegalArgumentException будет брошен.

Механизм, описанный здесь, не применяется, когда Удаленные объекты IIOP (Тупики или Серверы) создаются и соединяются с ШАРОМ вручную прежде, чем быть переданным к RMIConnector и RMIConnectorServer.

Динамическая загрузка кода

Если клиент соединителя RMI или сервер получают от его коллеги экземпляр класса, который он не знает, и если динамическая загрузка кода является активной для соединения RMI, то класс может быть загружен с кодовой базы, определенной коллегой. Статья Динамическая загрузка кода, используя Java RMI объясняет это более подробно.

С тех пор:

1.5

См. Также:

^JavaTM Удаленный Вызов метода (RMI), Именование Java и Каталог ^InterfaceTM (JNDI), RFC 2045, разделяют 6.8, "Кодирование передачи контента Base64"