Класс RMIConnector

java.lang.Object
- javax.management.remote.rmi.RMIConnector

Все реализованные интерфейсы:: Closeable, Serializable, AutoCloseable, JMXAddressable, JMXConnector

public class RMIConnector
extends Object
implements JMXConnector, Serializable, JMXAddressable

Подключение к удалённому соединению RMI. Обычно такие подключения создаются с помощью JMXConnectorFactory. Однако специализированные приложения могут использовать этот класс напрямую, например, со RMIServer заглушкой, полученной без прохождения через JNDI.

С:: 1.5
См. также:: Сериализованная форма

Поля

Поля, объявленные в интерфейсе javax.management.remote.JMXConnector

CREDENTIALS

Краткое описание конструкторов

Конструктор	Описание
`RMIConnector(JMXServiceURL url, Map<String,?> environment)`	Создаёт `RMIConnector`, который подключится к серверу RMI-соединения по указанному адресу.
`RMIConnector(RMIServer rmiServer, Map<String,?> environment)`	Создаёт `RMIConnector` с помощью заданной заглушки RMI.

Краткое описание методов

Модификатор и тип	Метод	Описание
`void`	`connect()`	Устанавливает соединение с сервером подключения.
`void`	`connect(Map<String,?> environment)`	Устанавливает соединение с сервером подключения.
`JMXServiceURL`	`getAddress()`	Адрес этого подключения.
`String`	`toString()`	Возвращает строковое представление этого объекта.

Методы, объявленные в классе java.lang.Object

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

Методы, объявленные в интерфейсе javax.management.remote.JMXConnector

addConnectionNotificationListener, close, getConnectionId, getMBeanServerConnection, getMBeanServerConnection, removeConnectionNotificationListener, removeConnectionNotificationListener

Подробное описание конструкторов

RMIConnector

public RMIConnector(JMXServiceURL url,
                    Map<String,?> environment)

Создаёт RMIConnector, который подключится к серверу RMI-соединения по указанному адресу.

Адрес может указывать напрямую на сервер подключения, используя следующий синтаксис:

service:jmx:rmi://[host[:port]]/stub/encoded-stub

(Здесь квадратные скобки [] не являются частью адреса, но указывают на то, что хост и порт необязательны.)

Адрес может вместо этого указывать, где найти заглушку RMI через JNDI, используя следующий синтаксис:

service:jmx:rmi://[host[:port]]/jndi/jndi-name

Реализация также может распознавать дополнительные синтаксические конструкции адресов, например:

service:jmx:iiop://[host[:port]]/stub/encoded-stub

Параметры:: url — адрес сервера RMI-соединения.; environment — дополнительные атрибуты, определяющие, как выполнить подключение. Для адресов на основе JNDI эти атрибуты могут содержать полезные атрибуты JNDI, распознаваемые InitialContext. Этот параметр может быть null, что эквивалентно пустому Map.
Исключения:: IllegalArgumentException — если url равно null.

RMIConnector

public RMIConnector(RMIServer rmiServer,
                    Map<String,?> environment)

Создаёт RMIConnector с помощью заданной заглушки RMI.

Параметры:: rmiServer — заглушка RMI, представляющая сервер RMI-соединения.; environment — дополнительные атрибуты, определяющие, как выполнить подключение. Этот параметр может быть null, что эквивалентно пустому Map.
Исключения:: IllegalArgumentException — если rmiServer равно null.

Подробное описание методов

toString

public String toString()

Возвращает строковое представление этого объекта. В общем случае метод toString возвращает строку, «текстуально представляющую» этот объект. Результат должен быть лаконичным, но информативным представлением, удобным для чтения человеком.

Переопределяет:: toString в классе Object
Возвращает:: строковое представление этого объекта.

getAddress

public JMXServiceURL getAddress()

Адрес этого подключения.

Определено в:: getAddress в интерфейсе JMXAddressable
Возвращает:: адрес этого подключения или null, если он отсутствует.
С:: 1.6

connect

public void connect()
             throws IOException

Описание скопировано из интерфейса: JMXConnector

Устанавливает соединение с сервером подключения. Этот метод эквивалентен connect(null).

Определено в:: connect в интерфейсе JMXConnector
Исключения:: IOException — если подключение не удалось из-за проблемы с обменом данными

connect

public void connect(Map<String,?> environment)
             throws IOException

Описание скопировано из интерфейса: JMXConnector

Устанавливает соединение с сервером подключения.

Если connect уже успешно вызван для этого объекта, повторное вызов не имеет эффекта. Однако если JMXConnector.close() был вызван после connect, новое connect выбросит IOException.

В противном случае либо connect никогда не вызывался для этого объекта, либо был вызван, но произвёл исключение. Тогда вызов connect попытается установить соединение с сервером подключения.

Определено в:: connect в интерфейсе JMXConnector
Параметры:: environment — свойства подключения. Свойства в этом map переопределяют свойства в map, указанном при создании JMXConnector, если таковые имеются. Этот параметр может быть null, что эквивалентно пустому map.
Исключения:: IOException — если подключение не удалось из-за проблемы с обменом данными