javax.management.remote.rmi

Класс RMIConnectorServer

java.lang. Объект

javax.management.NotificationBroadcasterSupport

javax.management.remote.JMXConnectorServer

javax.management.remote.rmi.RMIConnectorServer

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

MBeanRegistration, NotificationBroadcaster, NotificationEmitter, JMXAddressable, JMXConnectorServerMBean

public class RMIConnectorServer
extends JMXConnectorServer

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

С тех пор:

1.5

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

Поля

Модификатор и Тип	Поле и Описание
static String	JNDI_REBIND_ATTRIBUTE Имя атрибута, который определяет ли RMIServer тупик, который представляет сервер соединителя RMI, должен переопределить существующий тупик в том же самом адресе.
static String	RMI_CLIENT_SOCKET_FACTORY_ATTRIBUTE Имя атрибута, который определяет RMIClientSocketFactory для объектов RMI, создаваемых в соединении с этим соединителем.
static String	RMI_SERVER_SOCKET_FACTORY_ATTRIBUTE Имя атрибута, который определяет RMIServerSocketFactory для объектов RMI, создаваемых в соединении с этим соединителем.

Поля, унаследованные от класса javax.management.remote.JMXConnectorServer

АУТЕНТИФИКАТОР

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

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

Конструктор и Описание
RMIConnectorServer(JMXServiceURL url, Map<String,?> environment) Делает RMIConnectorServer.
RMIConnectorServer(JMXServiceURL url, Map<String,?> environment, MBeanServer mbeanServer) Делает RMIConnectorServer для данного сервера MBean.
RMIConnectorServer(JMXServiceURL url, Map<String,?> environment, RMIServerImpl rmiServerImpl, MBeanServer mbeanServer) Делает RMIConnectorServer для данного сервера MBean.

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

Методы

Модификатор и Тип	Метод и Описание
protected void	connectionClosed(String connectionId, String message, Object userData) Вызванный подклассом, когда клиентское соединение обычно закрывается.
protected void	connectionFailed(String connectionId, String message, Object userData) Вызванный подклассом, когда клиентская связь прерывается.
protected void	connectionOpened(String connectionId, String message, Object userData) Вызванный подклассом, когда новое клиентское соединение открывается.
JMXServiceURL	getAddress() Адрес этого сервера соединителя.
Map<String,?>	getAttributes() Атрибуты для этого сервера соединителя.
boolean	isActive() Определяет, является ли сервер соединителя активным.
void	setMBeanServerForwarder(MBeanServerForwarder mbsf) Вставляет объект, который прерывает запросы на сервер MBean, которые прибывают через этот сервер соединителя.
void	start() Активирует сервер соединителя, который является запусками, прислушивающимися к клиентским соединениям.
void	stop() Деактивировал сервер соединителя, то есть, остановки прислушаться к клиентским соединениям.
JMXConnector	toJMXConnector(Map<String,?> env) Возвращает клиентский тупик для этого сервера соединителя.

Методы, унаследованные от класса javax.management.remote.JMXConnectorServer

getConnectionIds, getMBeanServer, getNotificationInfo, postDeregister, postRegister, preDeregister, preRegister

Методы, унаследованные от класса javax.management.NotificationBroadcasterSupport

addNotificationListener, handleNotification, removeNotificationListener, removeNotificationListener, sendNotification

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

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

Полевая Деталь

JNDI_REBIND_ATTRIBUTE

public static final String JNDI_REBIND_ATTRIBUTE

Имя атрибута, который определяет ли RMIServer тупик, который представляет сервер соединителя RMI, должен переопределить существующий тупик в том же самом адресе. Значение, связанное с этим атрибутом, если таковые вообще имеются, должно быть строкой, которая равна, игнорируя регистр, к "true" или "false". Значение по умолчанию является ложью.

См. Также:

Постоянные Значения полей

RMI_CLIENT_SOCKET_FACTORY_ATTRIBUTE

public static final String RMI_CLIENT_SOCKET_FACTORY_ATTRIBUTE

Имя атрибута, который определяет RMIClientSocketFactory для объектов RMI, создаваемых в соединении с этим соединителем. Значение, связанное с этим атрибутом, должно иметь тип RMIClientSocketFactory и может только быть определен в Map параметр, предоставленный, создавая сервер соединителя.

См. Также:

Постоянные Значения полей

RMI_SERVER_SOCKET_FACTORY_ATTRIBUTE

public static final String RMI_SERVER_SOCKET_FACTORY_ATTRIBUTE

Имя атрибута, который определяет RMIServerSocketFactory для объектов RMI, создаваемых в соединении с этим соединителем. Значение, связанное с этим атрибутом, должно иметь тип RMIServerSocketFactory и может только быть определен в Map параметр, предоставленный, создавая сервер соединителя.

См. Также:

Постоянные Значения полей

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

RMIConnectorServer

public RMIConnectorServer(JMXServiceURL url,
                  Map<String,?> environment)
                   throws IOException

Делает RMIConnectorServer. Это эквивалентно вызову RMIConnectorServer(directoryURL,environment,null,null)

Параметры:

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

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

Броски:

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

MalformedURLException - если url не соответствует синтаксису для соединителя RMI, или если его протокол не распознается этой реализацией. Только "rmi" и "iiop" допустимы, когда этот конструктор используется.

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

RMIConnectorServer

public RMIConnectorServer(JMXServiceURL url,
                  Map<String,?> environment,
                  MBeanServer mbeanServer)
                   throws IOException

Делает RMIConnectorServer для данного сервера MBean. Это эквивалентно вызову RMIConnectorServer(directoryURL,environment,null,mbeanServer)

Параметры:

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

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

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

Броски:

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

MalformedURLException - если url не соответствует синтаксису для соединителя RMI, или если его протокол не распознается этой реализацией. Только "rmi" и "iiop" допустимы, когда этот конструктор используется.

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

RMIConnectorServer

public RMIConnectorServer(JMXServiceURL url,
                  Map<String,?> environment,
                  RMIServerImpl rmiServerImpl,
                  MBeanServer mbeanServer)
                   throws IOException

Делает RMIConnectorServer для данного сервера MBean.

Параметры:

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

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

rmiServerImpl - Реализация интерфейса RMIServer, непротиворечивого с типом протокола, определенным в url. Если этот параметр не является нулем, тип протокола, определенный url, не ограничивается, и, как предполагается, допустим. Иначе, только "rmi" и "iiop" будет распознан.

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

Броски:

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

MalformedURLException - если url не соответствует синтаксису для соединителя RMI, или если его протокол не распознается этой реализацией. Только "rmi" и "iiop" распознаются, когда rmiServerImpl является нулем.

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

См. Также:

start()

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

toJMXConnector

public JMXConnector toJMXConnector(Map<String,?> env)
                            throws IOException

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

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

toJMXConnector в интерфейсе JMXConnectorServerMBean

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

toJMXConnector в классе JMXConnectorServer

Параметры:

env - клиентские параметры соединения того же самого вида, для которого можно было обеспечить JMXConnector.connect(Map). Может быть нуль, который эквивалентен пустой карте.

Возвраты:

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

Броски:

UnsupportedOperationException - если этот сервер соединителя не поддерживает генерацию клиентских тупиков.

IllegalStateException - если JMXConnectorServer не запускается (см. isActive()).

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

запустить

public void start()
           throws IOException

Активирует сервер соединителя, который является запусками, прислушивающимися к клиентским соединениям. Вызов этого метода, когда сервер соединителя является уже активным, не имеет никакого эффекта. Вызов этого метода, когда сервер соединителя был остановлен, генерирует IOException.

Поведение этого метода когда вызвано впервые зависит от параметров, которые были предоставлены в конструкции, как описано ниже.

Во-первых, объект подкласса RMIServerImpl требуется, чтобы экспортировать сервер соединителя через RMI:

• Если RMIServerImpl был предоставлен конструктору, это используется.
• Иначе, если часть протокола JMXServiceURL предоставленный конструктору был iiop, объект типа RMIIIOPServerImpl создается.
• Иначе, если JMXServiceURL был нуль, или его часть протокола была rmi, объект типа RMIJRMPServerImpl создается.
• Иначе, реализация может создать специфичное для реализации RMIServerImpl или это может бросить MalformedURLException.

Если данный адрес включает каталог JNDI URL как определено в документации пакета для javax.management.remote.rmi, тогда это RMIConnectorServer загрузится, связывая RMIServerImpl к данному адресу.

Если часть пути URL JMXServiceURL было пусто или единственная наклонная черта (/), тогда объект RMI не будет связан с каталогом. Вместо этого ссылка на это будет закодирована в пути URL адреса RMIConnectorServer (возвращенный getAddress()). Кодировки для rmi и iiop описываются в документации пакета для javax.management.remote.rmi.

Поведение, когда путь URL не ни пуст, ни каталог JNDI URL, или когда протокол ни один не rmi ни iiop, реализация, определенная, и может включать бросок MalformedURLException когда сервер соединителя создается или когда он запускается.

Броски:

IllegalStateException - если сервер соединителя не был присоединен к серверу MBean.

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

остановиться

public void stop()
          throws IOException

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

Как только сервер соединителя был остановлен, он не может быть запущен снова.

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

Если закрытие клиентского соединения производит исключение, то исключение не выдается от этого метода. A JMXConnectionNotification испускается от этого MBean с ID соединения соединения, которое не могло быть закрыто.

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

Это вызовы метода метод close на сервере соединителя RMIServerImpl объект.

Если RMIServerImpl был связан с каталогом JNDI start метод, это является несвязанным из каталога этим методом.

Броски:

IOException - если сервер не может быть закрыт чисто, или если RMIServerImpl не может быть несвязанным из каталога. Когда это исключение выдается, сервер уже попытался закрыть все клиентские соединения, если соответствующий; вызывать RMIServerImpl.close(); и развязывать RMIServerImpl из его каталога, если приспособлено. Все клиентские соединения закрываются кроме возможно тех, которые генерировали исключения когда сервер, предпринятый, чтобы закрыть их.

isActive

public boolean isActive()

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

Определяет, является ли сервер соединителя активным. Сервер соединителя начинает быть активным когда start метод возвращается успешно и остается активным до любого stop метод вызывают или сбои сервера соединителя.

Возвраты:

истина, если сервер соединителя является активным.

getAddress

public JMXServiceURL getAddress()

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

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

Возвращенный адрес, возможно, не точный оригинал JMXServiceURL это было предоставлено, создавая сервер соединителя, так как исходный адрес, возможно, всегда не полон. Например номер порта может быть динамически выделен, запуская сервер соединителя. Вместо этого возвращенный адрес является фактическим JMXServiceURL из JMXConnectorServer. Это - адрес тот, клиенты предоставляют к JMXConnectorFactory.connect(JMXServiceURL).

Отметьте, что возвращенный адрес может быть null если JMXConnectorServer еще не active.

Возвраты:

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

getAttributes

public Map<String,?> getAttributes()

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

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

Возвраты:

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

setMBeanServerForwarder

public void setMBeanServerForwarder(MBeanServerForwarder mbsf)

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

Вставляет объект, который прерывает запросы на сервер MBean, которые прибывают через этот сервер соединителя. Этот объект будет предоставлен как MBeanServer для любого нового соединения, создаваемого этим сервером соединителя. Существующие соединения незатронуты.

Этот метод можно вызвать не раз с различным MBeanServerForwarder объекты. Результатом является цепочка средств передачи. Последнее добавленное средство передачи является первым в цепочке. Более подробно:

• Если этот сервер соединителя уже связывается с MBeanServer объект, тогда тому объекту дают mbsf.setMBeanServer. Если выполнение так производит исключение, этот метод выдает то же самое исключение без любого другого эффекта.

• Если этот соединитель уже не связывается с MBeanServer объект, или если mbsf.setMBeanServer вызов, только упомянутый, успешно выполняется, тогда mbsf становится этим сервером соединителя MBeanServer.

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

setMBeanServerForwarder в интерфейсе JMXConnectorServerMBean

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

setMBeanServerForwarder в классе JMXConnectorServer

Параметры:

mbsf - новое MBeanServerForwarder.

connectionOpened

protected void connectionOpened(String connectionId,
                    String message,
                    Object userData)

Описание скопировало с класса: JMXConnectorServer

Вызванный подклассом, когда новое клиентское соединение открывается. Добавляет connectionId к списку, возвращенному JMXConnectorServer.getConnectionIds(), тогда испускает a JMXConnectionNotification с типом JMXConnectionNotification.OPENED.

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

connectionOpened в классе JMXConnectorServer

Параметры:

connectionId - ID нового соединения. Это должно отличаться от ID любого соединения, ранее открытого этим сервером соединителя.

message - сообщение для испускаемого JMXConnectionNotification. Может быть нуль. См. Notification.getMessage().

userData - userData для испускаемого JMXConnectionNotification. Может быть нуль. См. Notification.getUserData().

connectionClosed

protected void connectionClosed(String connectionId,
                    String message,
                    Object userData)

Описание скопировало с класса: JMXConnectorServer

Вызванный подклассом, когда клиентское соединение обычно закрывается. Удаляет connectionId от списка, возвращенного JMXConnectorServer.getConnectionIds(), тогда испускает a JMXConnectionNotification с типом JMXConnectionNotification.CLOSED.

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

connectionClosed в классе JMXConnectorServer

Параметры:

connectionId - ID закрытого соединения.

message - сообщение для испускаемого JMXConnectionNotification. Может быть нуль. См. Notification.getMessage().

userData - userData для испускаемого JMXConnectionNotification. Может быть нуль. См. Notification.getUserData().

connectionFailed

protected void connectionFailed(String connectionId,
                    String message,
                    Object userData)

Описание скопировало с класса: JMXConnectorServer

Вызванный подклассом, когда клиентская связь прерывается. Удаляет connectionId от списка, возвращенного JMXConnectorServer.getConnectionIds(), тогда испускает a JMXConnectionNotification с типом JMXConnectionNotification.FAILED.

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

connectionFailed в классе JMXConnectorServer

Параметры:

connectionId - ID отказавшего соединения.

message - сообщение для испускаемого JMXConnectionNotification. Может быть нуль. См. Notification.getMessage().

userData - userData для испускаемого JMXConnectionNotification. Может быть нуль. См. Notification.getUserData().