javax.management.remote

Интерфейсный JMXConnectorServerMBean

Все Известные Классы с реализацией:

JMXConnectorServer, RMIConnectorServer

public interface JMXConnectorServerMBean

MBean взаимодействуют через интерфейс для серверов соединителя. Сервер соединителя API JMX присоединен к серверу MBean, и устанавливает соединения с этим сервер MBean для удаленных клиентов.

Недавно создаваемый сервер соединителя неактивен, и еще не прислушивается к соединениям. Только, когда start метод вызвали, делает он начинает прислушиваться к соединениям.

С тех пор:

1.5

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

Методы

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

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

запустить

void start()
           throws IOException

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

Броски:

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

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

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

void stop()
          throws IOException

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

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

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

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

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

Броски:

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

isActive

boolean isActive()

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

Возвраты:

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

setMBeanServerForwarder

void setMBeanServerForwarder(MBeanServerForwarder mbsf)

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

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

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

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

Параметры:

mbsf - новое MBeanServerForwarder.

Броски:

IllegalArgumentException - если звонок mbsf.setMBeanServer сбои с IllegalArgumentException. Это включает случай где mbsf нуль.

getConnectionIds

String[] getConnectionIds()

Список ID для в настоящий момент открытых соединений с этим сервером соединителя.

Возвраты:

новый строковый массив, содержащий список ID. Если не будет никаких в настоящий момент открытых соединений, то этот массив будет пуст.

getAddress

JMXServiceURL getAddress()

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

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

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

Возвраты:

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

getAttributes

Map<String,?> getAttributes()

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

Возвраты:

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

toJMXConnector

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

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

Данный соединитель не должен поддерживать генерацию клиентских тупиков. Однако, соединители, определенные JMX Удаленный API, делают (Соединитель JMXMP и Соединитель RMI).

Параметры:

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

Возвраты:

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

Броски:

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

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

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