javax.management.remote.rmi

Класс RMIConnector

java.lang. Объект

javax.management.remote.rmi. RMIConnector

Все Реализованные Интерфейсы:

Closeable, Сериализуемый, AutoCloseable, JMXAddressable, JMXConnector

public class RMIConnector
extends Object
implements JMXConnector, Serializable, JMXAddressable

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

С тех пор:

1.5

См. Также:

Сериализированная Форма

Полевая Сводка

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

УЧЕТНЫЕ ДАННЫЕ

Сводка конструктора

Конструкторы

Конструктор и Описание
RMIConnector(JMXServiceURL url, Map<String,?> environment) Конструкции RMIConnector это соединит сервер соединителя RMI с данным адресом.
RMIConnector(RMIServer rmiServer, Map<String,?> environment) Конструкции RMIConnector использование данного тупика RMI.

Сводка метода

Методы

Модификатор и Тип	Метод и Описание
void	addConnectionNotificationListener(NotificationListener listener, NotificationFilter filter, Object handback) Добавляет слушатель, чтобы быть информированным об изменениях в состоянии соединения.
void	close() Закрывает клиентское соединение с его сервером.
void	connect() Устанавливает соединение с сервером соединителя.
void	connect(Map<String,?> environment) Устанавливает соединение с сервером соединителя.
JMXServiceURL	getAddress() Адрес этого соединителя.
Строка	getConnectionId() Получает ID этого соединения от сервера соединителя.
MBeanServerConnection	getMBeanServerConnection() Возвраты MBeanServerConnection объект, представляющий удаленный сервер MBean.
MBeanServerConnection	getMBeanServerConnection(Subject delegationSubject) Возвраты MBeanServerConnection объект, представляющий удаленный сервер MBean, на котором операции выполняются от имени предоставленного предмета делегации.
void	removeConnectionNotificationListener(NotificationListener listener) Удаляет слушателя из списка, который будет информирован об изменениях в состоянии.
void	removeConnectionNotificationListener(NotificationListener listener, NotificationFilter filter, Object handback) Удаляет слушателя из списка, который будет информирован об изменениях в состоянии.
Строка	toString() Возвращает строковое представление этого объекта.

Методы java.lang унаследованный от класса. Объект

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

Деталь конструктора

RMIConnector

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

Конструкции RMIConnector это соединит сервер соединителя RMI с данным адресом.

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

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

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

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

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

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

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

Параметры:

url - адрес сервера соединителя RMI.

environment - дополнительные атрибуты, определяющие, как сделать соединение. Для JNDI-на-основе адресов эти атрибуты могут полезно включать атрибуты JNDI, распознанные InitialContext. Этот параметр может быть нулем, который эквивалентен пустой Карте.

Броски:

IllegalArgumentException - если url нуль.

RMIConnector

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

Конструкции RMIConnector использование данного тупика RMI.

Параметры:

rmiServer - тупик RMI представление сервера соединителя RMI.

environment - дополнительные атрибуты, определяющие, как сделать соединение. Этот параметр может быть нулем, который эквивалентен пустой Карте.

Броски:

IllegalArgumentException - если rmiServer нуль.

Деталь метода

toString

public String toString()

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

Переопределения:

toString в классе Object

Возвраты:

Строковое представление этого объекта.

getAddress

public JMXServiceURL getAddress()

Адрес этого соединителя.

Определенный:

getAddress в интерфейсе JMXAddressable

Возвраты:

адрес этого соединителя, или нуль, если у этого нет того.

С тех пор:

1.6

подключение

public void connect()
             throws IOException

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

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

Определенный:

connect в интерфейсе JMXConnector

Броски:

IOException - если соединение не могло бы быть сделано из-за проблемы коммуникации.

подключение

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

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

Устанавливает соединение с сервером соединителя.

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

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

Определенный:

connect в интерфейсе JMXConnector

Параметры:

environment - свойства соединения. Свойства в этой карте переопределяют свойства в карте, определенной когда JMXConnector создавался, если любой. Этот параметр может быть нулем, который эквивалентен пустой карте.

Броски:

IOException - если соединение не могло бы быть сделано из-за проблемы коммуникации.

getConnectionId

public String getConnectionId()
                       throws IOException

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

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

Определенный:

getConnectionId в интерфейсе JMXConnector

Возвраты:

уникальный ID этого соединения. Это - то же самое как ID, который сервер соединителя включает в JMXConnectionNotifications. package description описывает соглашения для ID соединения.

Броски:

IOException - если ID соединения не может быть получен, например потому что соединение закрывается или повреждается.

getMBeanServerConnection

public MBeanServerConnection getMBeanServerConnection()
                                               throws IOException

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

Возвраты MBeanServerConnection объект, представляющий удаленный сервер MBean. Для данного JMXConnector, два успешных вызова к этому методу будут обычно возвращать то же самое MBeanServerConnection объект, хотя это не требуется.

Для каждого метода в возвращенном MBeanServerConnection, вызов метода заставляет соответствующий метод быть призванным удаленный сервер MBean. Значение, возвращенное методом сервера MBean, является значением, возвращенным клиенту. Если метод сервера MBean производит Exception, то же самое Exception замечается клиентом. Если метод сервера MBean, или попытка вызвать это, производит Error, Error обертывается в a JMXServerErrorException, который замечается клиентом.

Вызов этого метода эквивалентен вызову getMBeanServerConnection(null) означать, что никакой предмет делегации не определяется и что все операции, к которым обращаются MBeanServerConnection должен использовать аутентифицируемый предмет, если любой.

Определенный:

getMBeanServerConnection в интерфейсе JMXConnector

Возвраты:

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

Броски:

IOException - если допустимое MBeanServerConnection не может быть создан, например потому что соединение с удаленным сервером MBean еще не было установлено (с connect метод), или это было закрыто, или это повредилось.

getMBeanServerConnection

public MBeanServerConnection getMBeanServerConnection(Subject delegationSubject)
                                               throws IOException

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

Возвраты MBeanServerConnection объект, представляющий удаленный сервер MBean, на котором операции выполняются от имени предоставленного предмета делегации. Для данного JMXConnector и Subject, два успешных вызова к этому методу будут обычно возвращать то же самое MBeanServerConnection объект, хотя это не требуется.

Для каждого метода в возвращенном MBeanServerConnection, вызов метода заставляет соответствующий метод быть призванным удаленный сервер MBean от имени данного предмета делегации вместо аутентифицируемого предмета. Значение, возвращенное методом сервера MBean, является значением, возвращенным клиенту. Если метод сервера MBean производит Exception, то же самое Exception замечается клиентом. Если метод сервера MBean, или попытка вызвать это, производит Error, Error обертывается в a JMXServerErrorException, который замечается клиентом.

Определенный:

getMBeanServerConnection в интерфейсе JMXConnector

Параметры:

delegationSubject - Subject от имени которого будут выполняться запросы. Может быть нуль, когда запросы будут выполняться от имени аутентифицируемого Предмета, если любой.

Возвраты:

объект, который реализует MBeanServerConnection интерфейс, передавая его методы удаленному серверу MBean от имени данного предмета делегации.

Броски:

IOException - если допустимое MBeanServerConnection не может быть создан, например потому что соединение с удаленным сервером MBean еще не было установлено (с connect метод), или это было закрыто, или это повредилось.

addConnectionNotificationListener

public void addConnectionNotificationListener(NotificationListener listener,
                                     NotificationFilter filter,
                                     Object handback)

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

Добавляет слушатель, чтобы быть информированным об изменениях в состоянии соединения. Слушатель получит уведомления о типе JMXConnectionNotification. Реализация может отправить другие типы уведомлений также.

Любое число слушателей может быть добавлено с этим методом. Тот же самый слушатель может быть добавлен не раз с теми же самыми или различными значениями для фильтра и handback. Нет никакого специального режима двойной записи. Например, если слушатель регистрируется дважды без фильтра, то handleNotification метод вызовут дважды для каждого уведомления.

Определенный:

addConnectionNotificationListener в интерфейсе JMXConnector

Параметры:

listener - слушатель, чтобы получить уведомления о состоянии соединения.

filter - фильтр, чтобы выбрать, какие уведомления должны быть поставлены слушателю, или нулю, если все уведомления должны быть поставлены.

handback - объект, который будет дан слушателю наряду с каждым уведомлением. Может быть нуль.

См. Также:

JMXConnector.removeConnectionNotificationListener(javax.management.NotificationListener), NotificationBroadcaster.addNotificationListener(javax.management.NotificationListener, javax.management.NotificationFilter, java.lang.Object)

removeConnectionNotificationListener

public void removeConnectionNotificationListener(NotificationListener listener)
                                          throws ListenerNotFoundException

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

Удаляет слушателя из списка, который будет информирован об изменениях в состоянии. Слушатель, должно быть, ранее был добавлен. Если есть больше чем один соответствующий слушатель, все удаляются.

Определенный:

removeConnectionNotificationListener в интерфейсе JMXConnector

Параметры:

listener - слушатель, чтобы получить уведомления о состоянии соединения.

Броски:

ListenerNotFoundException - если слушатель не регистрируется в этом JMXConnector.

См. Также:

JMXConnector.removeConnectionNotificationListener(NotificationListener, NotificationFilter, Object), JMXConnector.addConnectionNotificationListener(javax.management.NotificationListener, javax.management.NotificationFilter, java.lang.Object), NotificationEmitter.removeNotificationListener(javax.management.NotificationListener, javax.management.NotificationFilter, java.lang.Object)

removeConnectionNotificationListener

public void removeConnectionNotificationListener(NotificationListener listener,
                                        NotificationFilter filter,
                                        Object handback)
                                          throws ListenerNotFoundException

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

Удаляет слушателя из списка, который будет информирован об изменениях в состоянии. Слушатель, должно быть, ранее был добавлен с теми же самыми тремя параметрами. Если есть больше чем один соответствующий слушатель, только один удаляется.

Определенный:

removeConnectionNotificationListener в интерфейсе JMXConnector

Параметры:

listener - слушатель, чтобы получить уведомления о состоянии соединения.

filter - фильтр, чтобы выбрать, какие уведомления должны быть поставлены слушателю. Может быть нуль.

handback - объект, который будет дан слушателю наряду с каждым уведомлением. Может быть нуль.

Броски:

ListenerNotFoundException - если слушатель не регистрируется в этом JMXConnector, или не регистрируется в данном фильтре и handback.

См. Также:

JMXConnector.removeConnectionNotificationListener(NotificationListener), JMXConnector.addConnectionNotificationListener(javax.management.NotificationListener, javax.management.NotificationFilter, java.lang.Object), NotificationEmitter.removeNotificationListener(javax.management.NotificationListener, javax.management.NotificationFilter, java.lang.Object)

близко

public void close()
           throws IOException

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

Закрывает клиентское соединение с его сервером. Любой продолжающийся или новый запрос, используя MBeanServerConnection, возвращенный JMXConnector.getMBeanServerConnection() доберется IOException.

Если close был уже вызван успешно на этом объекте, вызывая его снова не имеет никакого эффекта. Если close никогда не вызывался, или если это вызвали, но произвело исключение, попытка будет предпринята, чтобы закрыть соединение. Эта попытка может успешно выполниться, когда close будет обычно возвращаться, или это может генерировать исключение.

Закрытие соединения является потенциально медленной работой. Например, если сервер отказал, операции закрытия, возможно, придется ожидать сетевого тайм-аута протокола. Вызывающие стороны, которые не хотят блокировать в операции закрытия, должны сделать это в отдельном потоке.

Определенный:

close в интерфейсе Closeable

Определенный:

close в интерфейсе AutoCloseable

Определенный:

close в интерфейсе JMXConnector

Броски:

IOException - если соединение не может быть закрыто чисто. Если это исключение выдается, не известно, был ли конец сервера соединения чисто закрыт.