Интерфейс RMIConnection

public interface RMIConnection
extends Closeable, Remote

Объект RMI, используемый для перенаправления запроса MBeanServer от клиента к его реализации MBeanServer на стороне сервера. Для каждого удаленного клиента, подключенного к соединителю RMI, существует один объект Remote, реализующий этот интерфейс.

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

Для обеспечения того, чтобы параметры клиента были десериализованы на стороне сервера с правильным загрузчиком классов, параметры клиента, такие как параметры, используемые для вызова метода, упаковываются в MarshalledObject. Реализация этого интерфейса должна сначала получить соответствующий загрузчик классов для операции и её целевого объекта, а затем десериализовать передаваемые параметры с этим загрузчиком классов. За исключением указанных случаев, параметр, являющийся MarshalledObject или MarshalledObject[], не должен быть null; поведение не определено, если он им является.

Аспекты загрузки классов подробно описаны в документе PDF Спецификации JMX, версия 1.4.

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

Методы

getConnectionId

String getConnectionId()
                throws IOException

Возвращает:

идентификатор соединения

Исключения:

IOException - если произошла общая ошибка связи.

См. также:

RMIConnector.connect

close

void close()
    throws IOException

Указано в:

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

Указано в:

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

Исключения:

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

createMBean

ObjectInstance createMBean(String className,
                           ObjectName name,
                           Subject delegationSubject)
                    throws ReflectionException,
                           InstanceAlreadyExistsException,
                           MBeanRegistrationException,
                           MBeanException,
                           NotCompliantMBeanException,
                           IOException

Обрабатывает метод MBeanServerConnection.createMBean(String, ObjectName).

Параметры:

className - Имя класса MBean, который должен быть создан.

name - Имя объекта MBean. Может быть null.

delegationSubject - Subject содержащий принципалы делегирования или null если вместо этого используется принцип аутентификации.

Возвращает:

An ObjectInstance, containing the ObjectName and the Java class name of the newly instantiated MBean. If the contained ObjectName is n, the contained Java class name is getMBeanInfo(n).getClassName().

Исключения:

ReflectionException - Оборачивает java.lang.ClassNotFoundException или java.lang.Exception, которые произошли при попытке вызвать конструктор MBean.

InstanceAlreadyExistsException - MBean уже находится под управлением сервера MBean.

MBeanRegistrationException - Метод preRegister (интерфейс MBeanRegistration) MBean вызвал исключение. MBean не будет зарегистрирован.

MBeanException - Конструктор MBean вызвал исключение.

NotCompliantMBeanException - Этот класс не является совместимым с JMX MBean.

RuntimeOperationsException - Оборачивает java.lang.IllegalArgumentException: Переданное в параметре имя класса равно null, переданный в параметре ObjectName содержит шаблон или не указан ObjectName для MBean.

SecurityException - если клиент или делегированный Subject (если есть) не имеет разрешения на выполнение этой операции.

IOException - если произошла общая ошибка связи.

createMBean

ObjectInstance createMBean(String className,
                           ObjectName name,
                           ObjectName loaderName,
                           Subject delegationSubject)
                    throws ReflectionException,
                           InstanceAlreadyExistsException,
                           MBeanRegistrationException,
                           MBeanException,
                           NotCompliantMBeanException,
                           InstanceNotFoundException,
                           IOException

Обрабатывает метод MBeanServerConnection.createMBean(String, ObjectName, ObjectName).

Параметры:

className - Имя класса MBean, который должен быть создан.

name - Имя объекта MBean. Может быть null.

loaderName - Имя объекта загрузчика классов, который будет использоваться.

delegationSubject - Subject содержащий принципалы делегирования или null если вместо этого используется принцип аутентификации.

Возвращает:

An ObjectInstance, containing the ObjectName and the Java class name of the newly instantiated MBean. If the contained ObjectName is n, the contained Java class name is getMBeanInfo(n).getClassName().

Исключения:

ReflectionException - Оборачивает java.lang.ClassNotFoundException или java.lang.Exception, которые произошли при попытке вызвать конструктор MBean.

InstanceAlreadyExistsException - MBean уже находится под управлением сервера MBean.

MBeanRegistrationException - Метод preRegister (интерфейс MBeanRegistration) MBean вызвал исключение. MBean не будет зарегистрирован.

MBeanException - Конструктор MBean вызвал исключение.

NotCompliantMBeanException - Этот класс не является совместимым с JMX MBean.

InstanceNotFoundException - Указанный загрузчик классов не зарегистрирован на сервере MBean.

RuntimeOperationsException - Оборачивает java.lang.IllegalArgumentException: Переданное в параметре имя класса равно null, переданный в параметре ObjectName содержит шаблон или не указан ObjectName для MBean.

SecurityException - если клиент или делегированный Subject (если есть) не имеет разрешения на выполнение этой операции.

IOException - если произошла общая ошибка связи.

createMBean

ObjectInstance createMBean(String className,
                           ObjectName name,
                           MarshalledObject params,
                           String[] signature,
                           Subject delegationSubject)
                    throws ReflectionException,
                           InstanceAlreadyExistsException,
                           MBeanRegistrationException,
                           MBeanException,
                           NotCompliantMBeanException,
                           IOException

Обрабатывает метод MBeanServerConnection.createMBean(String, ObjectName, Object[], String[]). Параметр Object[] обернут в MarshalledObject.

Параметры:

className - Имя класса MBean, который должен быть создан.

name - Имя объекта MBean. Может быть null.

params - Массив, содержащий параметры конструктора, который должен быть вызван, инкапсулированный в MarshalledObject. Инкапсулированный массив может быть null, что эквивалентно пустому массиву.

signature - Массив, содержащий сигнатуру конструктора, который должен быть вызван. Может быть null, что эквивалентно пустому массиву.

delegationSubject - Subject содержащий принципалы делегирования или null если вместо этого используется принцип аутентификации.

Возвращает:

An ObjectInstance, containing the ObjectName and the Java class name of the newly instantiated MBean. If the contained ObjectName is n, the contained Java class name is getMBeanInfo(n).getClassName().

Исключения:

ReflectionException - Оборачивает java.lang.ClassNotFoundException или java.lang.Exception, которые произошли при попытке вызвать конструктор MBean.

InstanceAlreadyExistsException - MBean уже находится под управлением сервера MBean.

MBeanRegistrationException - Метод preRegister (интерфейс MBeanRegistration) MBean вызвал исключение. MBean не будет зарегистрирован.

MBeanException - Конструктор MBean вызвал исключение.

NotCompliantMBeanException - Этот класс не является совместимым с JMX MBean.

RuntimeOperationsException - Оборачивает java.lang.IllegalArgumentException: Переданное в параметре имя класса равно null, переданный в параметре ObjectName содержит шаблон или не указан ObjectName для MBean.

SecurityException - если клиент или делегированный Subject (если есть) не имеет разрешения на выполнение этой операции.

IOException - если произошла общая ошибка связи.

createMBean

ObjectInstance createMBean(String className,
                           ObjectName name,
                           ObjectName loaderName,
                           MarshalledObject params,
                           String[] signature,
                           Subject delegationSubject)
                    throws ReflectionException,
                           InstanceAlreadyExistsException,
                           MBeanRegistrationException,
                           MBeanException,
                           NotCompliantMBeanException,
                           InstanceNotFoundException,
                           IOException

Обрабатывает метод MBeanServerConnection.createMBean(String, ObjectName, ObjectName, Object[], String[]). Параметр Object[] обернут в MarshalledObject.

Параметры:

className - Имя класса MBean, который должен быть создан.

name - Имя объекта MBean. Может быть null.

loaderName - Имя объекта загрузчика классов, который будет использоваться.

params - Массив, содержащий параметры конструктора, который должен быть вызван, инкапсулированный в MarshalledObject. Инкапсулированный массив может быть null, что эквивалентно пустому массиву.

signature - Массив, содержащий сигнатуру конструктора, который должен быть вызван. Может быть null, что эквивалентно пустому массиву.

delegationSubject - Subject содержащий принципалы делегирования или null если вместо этого используется принцип аутентификации.

Возвращает:

An ObjectInstance, containing the ObjectName and the Java class name of the newly instantiated MBean. If the contained ObjectName is n, the contained Java class name is getMBeanInfo(n).getClassName().

Исключения:

ReflectionException - Оборачивает java.lang.ClassNotFoundException или java.lang.Exception, которые произошли при попытке вызвать конструктор MBean.

InstanceAlreadyExistsException - MBean уже находится под управлением сервера MBean.

MBeanRegistrationException - Метод preRegister (интерфейс MBeanRegistration) MBean вызвал исключение. MBean не будет зарегистрирован.

MBeanException - Конструктор MBean вызвал исключение.

NotCompliantMBeanException - Этот класс не является совместимым с JMX MBean.

InstanceNotFoundException - Указанный загрузчик классов не зарегистрирован на сервере MBean.

RuntimeOperationsException - Оборачивает java.lang.IllegalArgumentException: Переданное в параметре имя класса равно null, переданный в параметре ObjectName содержит шаблон или не указан ObjectName для MBean.

SecurityException - если клиент или делегированный Subject (если есть) не имеет разрешения на выполнение этой операции.

IOException - если произошла общая ошибка связи.

unregisterMBean

void unregisterMBean(ObjectName name,
                     Subject delegationSubject)
              throws InstanceNotFoundException,
                     MBeanRegistrationException,
                     IOException

Обрабатывает метод MBeanServerConnection.unregisterMBean(ObjectName).

Параметры:

name - Имя объекта MBean, который нужно аннулировать.

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

Исключения:

InstanceNotFoundException - Указанный MBean не зарегистрирован в сервере MBean.

MBeanRegistrationException - Метод preDeregister ((MBeanRegistration интерфейс)) MBean выбросил исключение.

RuntimeOperationsException - Оборачивает java.lang.IllegalArgumentException: имя объекта в параметре равно null или MBean, который вы пытаетесь аннулировать, является MBeanServerDelegate MBean.

SecurityException - если клиенту или делегированному субъекту (если таковой имеется) нет разрешения на выполнение этой операции.

IOException - если произошла общая ошибка связи.

getObjectInstance

ObjectInstance getObjectInstance(ObjectName name,
                                 Subject delegationSubject)
                          throws InstanceNotFoundException,
                                 IOException

Обрабатывает метод MBeanServerConnection.getObjectInstance(ObjectName).

Параметры:

name - Имя объекта MBean.

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

Возвращает:

ObjectInstance , связанный с MBean, указанным в name. Содержащийся ObjectName - name, а содержащееся имя класса - getMBeanInfo(name).getClassName().

Исключения:

InstanceNotFoundException - Указанный MBean не зарегистрирован в сервере MBean.

RuntimeOperationsException - Оборачивает java.lang.IllegalArgumentException: имя объекта в параметре равно null.

SecurityException - если клиенту или делегированному субъекту (если таковой имеется) нет разрешения на выполнение этой операции.

IOException - если произошла общая ошибка связи.

queryMBeans

Set<ObjectInstance> queryMBeans(ObjectName name,
                                MarshalledObject query,
                                Subject delegationSubject)
                         throws IOException

Обрабатывает метод MBeanServerConnection.queryMBeans(ObjectName, QueryExp). QueryExp упакован в MarshalledObject.

Параметры:

name - Шаблон имени объекта, определяющий MBeans, которые нужно получить. Если null или не указаны свойства домена и ключа, будут получены все зарегистрированные MBeans.

query - Выражение запроса, которое применяется для выбора MBeans, упакованное в MarshalledObject. Если MarshalledObject содержит значение null, выражение запроса не будет применено для выбора MBeans.

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

Возвращает:

Множество, содержащее ObjectInstance объекты для выбранных MBeans. Если ни один MBean не удовлетворяет запросу, возвращается пустой список.

Исключения:

SecurityException - если клиенту или делегированному субъекту (если таковой имеется) нет разрешения на выполнение этой операции.

IOException - если произошла общая ошибка связи.

queryNames

Set<ObjectName> queryNames(ObjectName name,
                           MarshalledObject query,
                           Subject delegationSubject)
                    throws IOException

Обрабатывает метод MBeanServerConnection.queryNames(ObjectName, QueryExp). QueryExp упакован в MarshalledObject.

Параметры:

name - Шаблон имени объекта, определяющий имена MBean, которые нужно получить. Если null или не указаны свойства домена и ключа, будут получены имена всех зарегистрированных MBeans.

query - Выражение запроса, которое применяется для выбора MBeans, упакованное в MarshalledObject. Если MarshalledObject содержит значение null, выражение запроса не будет применено для выбора MBeans.

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

Возвращает:

Множество, содержащее ObjectNames для выбранных MBeans. Если ни один MBean не удовлетворяет запросу, возвращается пустой список.

Исключения:

SecurityException - если клиенту или делегированному субъекту (если таковой имеется) нет разрешения на выполнение этой операции.

IOException - если произошла общая ошибка связи.

isRegistered

boolean isRegistered(ObjectName name,
                     Subject delegationSubject)
              throws IOException

Обрабатывает метод MBeanServerConnection.isRegistered(ObjectName).

Параметры:

name - Имя объекта MBean, который нужно проверить.

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

Возвращает:

True, если MBean уже зарегистрирован в сервере MBean, иначе false.

Исключения:

RuntimeOperationsException - Оборачивает java.lang.IllegalArgumentException: имя объекта в параметре равно null.

SecurityException - если клиенту или делегированному субъекту (если таковой имеется) нет разрешения на выполнение этой операции.

IOException - если произошла общая ошибка связи.

getMBeanCount

Integer getMBeanCount(Subject delegationSubject)
               throws IOException

Обрабатывает метод MBeanServerConnection.getMBeanCount().

Параметры:

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

Возвращает:

количество зарегистрированных MBeans.

Исключения:

SecurityException - если клиенту или делегированному субъекту (если таковой имеется) нет разрешения на выполнение этой операции.

IOException - если произошла общая ошибка связи.

getAttribute

Object getAttribute(ObjectName name,
                    String attribute,
                    Subject delegationSubject)
             throws MBeanException,
                    AttributeNotFoundException,
                    InstanceNotFoundException,
                    ReflectionException,
                    IOException

Обрабатывает метод MBeanServerConnection.getAttribute(ObjectName, String).

Параметры:

name - Имя объекта MBean, из которого нужно получить атрибут.

attribute - Строка, определяющая имя атрибута, который нужно получить.

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

Возвращает:

Значение полученного атрибута.

Исключения:

AttributeNotFoundException - Указанный атрибут недоступен в MBean.

MBeanException - Исключение, выброшенное getter MBean.

InstanceNotFoundException - Указанный MBean не зарегистрирован в сервере MBean.

ReflectionException - Оборачивает java.lang.Exception выброшенное при попытке вызова getter.

RuntimeOperationsException - Оборачивает java.lang.IllegalArgumentException: имя объекта в параметре равно null или атрибут в параметре равен null.

RuntimeMBeanException - Оборачивает исключение времени выполнения, выброшенное getter MBean.

SecurityException - если клиенту или делегированному субъекту (если таковой имеется) нет разрешения на выполнение этой операции.

IOException - если произошла общая ошибка связи.

См. также:

setAttribute(javax.management.ObjectName, java.rmi.MarshalledObject, javax.security.auth.Subject)

getAttributes

AttributeList getAttributes(ObjectName name,
                            String[] attributes,
                            Subject delegationSubject)
                     throws InstanceNotFoundException,
                            ReflectionException,
                            IOException

Обрабатывает метод MBeanServerConnection.getAttributes(ObjectName, String[]).

Параметры:

name - Имя объекта MBean, из которого извлекаются атрибуты.

attributes - Список атрибутов, которые нужно получить.

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

Возвращает:

Список полученных атрибутов.

Исключения:

InstanceNotFoundException - Указанный MBean не зарегистрирован в сервере MBean.

ReflectionException - Произошла ошибка при попытке вызова метода getAttributes динамического MBean.

RuntimeOperationsException - Оборачивает java.lang.IllegalArgumentException: имя объекта в параметре равно null или атрибуты в параметре равны null.

SecurityException - если клиенту или делегированному субъекту (если таковой имеется) нет разрешения на выполнение этой операции.

IOException - если произошла общая ошибка связи.

См. также:

setAttributes(javax.management.ObjectName, java.rmi.MarshalledObject, javax.security.auth.Subject)

setAttribute

void setAttribute(ObjectName name,
                  MarshalledObject attribute,
                  Subject delegationSubject)
           throws InstanceNotFoundException,
                  AttributeNotFoundException,
                  InvalidAttributeValueException,
                  MBeanException,
                  ReflectionException,
                  IOException

Обрабатывает метод MBeanServerConnection.setAttribute(ObjectName, Attribute). Параметр Attribute упакован в MarshalledObject.

Параметры:

name - Имя MBean, в котором нужно установить атрибут.

attribute - Идентификатор атрибута, который нужно установить, и значение, на которое нужно его установить, упакованный в MarshalledObject.

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

Исключения:

InstanceNotFoundException - Указанный MBean не зарегистрирован в сервере MBean.

AttributeNotFoundException - Указанный атрибут недоступен в MBean.

InvalidAttributeValueException - Указанное значение для атрибута некорректно.

MBeanException - Обёртка исключения, сгенерированного установщиком атрибута MBean.

ReflectionException - Обёртка исключения java.lang.Exception при попытке вызова установщика.

RuntimeOperationsException - Обёртка исключения java.lang.IllegalArgumentException: Имя объекта в параметре null или атрибут в параметре null.

SecurityException - Если у клиента или делегированного субъекта нет разрешения на выполнение этой операции.

IOException - Если произошла общая ошибка связи.

См. также:

getAttribute(javax.management.ObjectName, java.lang.String, javax.security.auth.Subject)

setAttributes

AttributeList setAttributes(ObjectName name,
                            MarshalledObject attributes,
                            Subject delegationSubject)
                     throws InstanceNotFoundException,
                            ReflectionException,
                            IOException

Обрабатывает метод MBeanServerConnection.setAttributes(ObjectName, AttributeList). Параметр AttributeList упакован в MarshalledObject.

Параметры:

name - Имя объекта MBean, в котором нужно установить атрибуты.

attributes - Список атрибутов: Идентификаторы атрибутов, которые нужно установить, и значения, на которые нужно их установить, упакованные в MarshalledObject.

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

Возвращает:

Список атрибутов, которые были установлены, со своими новыми значениями.

Исключения:

InstanceNotFoundException - Указанный MBean не зарегистрирован в сервере MBean.

ReflectionException - Произошла ошибка при попытке вызвать метод getAttributes у динамического MBean.

RuntimeOperationsException - Обёртка исключения java.lang.IllegalArgumentException: Имя объекта в параметре null или список атрибутов в параметре null.

SecurityException - Если у клиента или делегированного субъекта нет разрешения на выполнение этой операции.

IOException - Если произошла общая ошибка связи.

См. также:

getAttributes(javax.management.ObjectName, java.lang.String[], javax.security.auth.Subject)

invoke

Object invoke(ObjectName name,
              String operationName,
              MarshalledObject params,
              String[] signature,
              Subject delegationSubject)
       throws InstanceNotFoundException,
              MBeanException,
              ReflectionException,
              IOException

Обрабатывает метод MBeanServerConnection.invoke(ObjectName, String, Object[], String[]). Параметр Object[] упакован в MarshalledObject.

Параметры:

name - Имя объекта MBean, на котором нужно вызвать метод.

operationName - Имя операции, которую нужно вызвать.

params - Массив параметров, которые нужно установить при вызове операции, упакованный в MarshalledObject. Упакованный массив может быть null, что эквивалентно пустому массиву.

signature - Массив сигнатур операции. Классы будут загружены с помощью того же загрузчика классов, что и MBean, на котором вызывается операция. Может быть null, что эквивалентно пустому массиву.

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

Возвращает:

Объект, возвращённый операцией, представляющий результат вызова операции на указанном MBean.

Исключения:

InstanceNotFoundException - Указанный MBean не зарегистрирован в сервере MBean.

MBeanException - Обёртка исключения, сгенерированного вызываемым методом MBean.

ReflectionException - Обёртка исключения java.lang.Exception при попытке вызова метода.

SecurityException - Если у клиента или делегированного субъекта нет разрешения на выполнение этой операции.

IOException - Если произошла общая ошибка связи.

RuntimeOperationsException - Обёртка исключения IllegalArgumentException, если name или operationName равно null.

getDefaultDomain

String getDefaultDomain(Subject delegationSubject)
                 throws IOException

Обрабатывает метод MBeanServerConnection.getDefaultDomain().

Параметры:

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

Возвращает:

Значение домена по умолчанию.

Исключения:

SecurityException - Если у клиента или делегированного субъекта нет разрешения на выполнение этой операции.

IOException - Если произошла общая ошибка связи.

getDomains

String[] getDomains(Subject delegationSubject)
             throws IOException

Обрабатывает метод MBeanServerConnection.getDomains().

Параметры:

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

Возвращает:

Список доменов.

Исключения:

SecurityException - Если у клиента или делегированного субъекта нет разрешения на выполнение этой операции.

IOException - Если произошла общая ошибка связи.

getMBeanInfo

MBeanInfo getMBeanInfo(ObjectName name,
                       Subject delegationSubject)
                throws InstanceNotFoundException,
                       IntrospectionException,
                       ReflectionException,
                       IOException

Обрабатывает метод MBeanServerConnection.getMBeanInfo(ObjectName).

Параметры:

name - Имя анализируемого MBean

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

Возвращает:

Экземпляр MBeanInfo, позволяющий получить все атрибуты и операции этого MBean.

Исключения:

IntrospectionException - Ошибка во время интроспекции.

InstanceNotFoundException - MBean не найден.

ReflectionException - Ошибка при попытке вызвать getMBeanInfo динамического MBean.

SecurityException - Если у клиента или делегированного субъекта нет разрешения на выполнение этой операции.

IOException - Если произошла общая ошибка связи.

RuntimeOperationsException - Обёртка исключения java.lang.IllegalArgumentException: Имя объекта в параметре null.

isInstanceOf

boolean isInstanceOf(ObjectName name,
                     String className,
                     Subject delegationSubject)
              throws InstanceNotFoundException,
                     IOException

Обрабатывает метод MBeanServerConnection.isInstanceOf(ObjectName, String).

Параметры:

name - Имя MBean.

className - Имя класса.

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

Возвращает:

true, если указанный MBean является экземпляром указанного класса согласно правилам выше, иначе false.

Исключения:

InstanceNotFoundException - Указанный MBean не зарегистрирован в сервере MBean.

SecurityException - Если у клиента или делегированного субъекта нет разрешения на выполнение этой операции.

IOException - Если произошла общая ошибка связи.

RuntimeOperationsException - Обёртка исключения java.lang.IllegalArgumentException: Имя объекта в параметре null.

addNotificationListener

void addNotificationListener(ObjectName name,
                             ObjectName listener,
                             MarshalledObject filter,
                             MarshalledObject handback,
                             Subject delegationSubject)
                      throws InstanceNotFoundException,
                             IOException

Обрабатывает метод MBeanServerConnection.addNotificationListener(ObjectName, ObjectName, NotificationFilter, Object). Параметр NotificationFilter упакован в MarshalledObject. Параметр Object (handback) также упакован в MarshalledObject.

Параметры:

name — Имя MBean, к которому должен быть добавлен слушатель.

listener — Имя объекта слушателя, который будет обрабатывать уведомления, исходящие от зарегистрированного MBean.

filter — Объект фильтра, инкапсулированный в MarshalledObject. Если фильтр, инкапсулированный в MarshalledObject, имеет значение null, фильтрация не будет выполняться перед обработкой уведомлений.

handback — Контекст, который будет отправлен слушателю при возникновении уведомления, инкапсулированный в MarshalledObject.

delegationSubject — Subject, содержащий делегированные принципы или null, если вместо этого используется принцип аутентификации.

Исключения:

InstanceNotFoundException — Имя MBean слушателя уведомлений или объекта-распространителя уведомлений не соответствует ни одному из зарегистрированных MBeans.

RuntimeOperationsException — Оборачивает IllegalArgumentException. MBean, имя которого listener, существует, но не реализует интерфейс NotificationListener, или name или listener имеет значение null.

SecurityException — если у клиента или делегированного субъекта нет разрешения на выполнение этой операции.

IOException — если произошла общая ошибка связи.

См. также:

removeNotificationListener(ObjectName, ObjectName, Subject), removeNotificationListener(ObjectName, ObjectName, MarshalledObject, MarshalledObject, Subject)

removeNotificationListener

void removeNotificationListener(ObjectName name,
                                ObjectName listener,
                                Subject delegationSubject)
                         throws InstanceNotFoundException,
                                ListenerNotFoundException,
                                IOException

Обрабатывает метод MBeanServerConnection.removeNotificationListener(ObjectName, ObjectName).

Параметры:

name — Имя MBean, из которого должен быть удален слушатель.

listener — Имя объекта слушателя, который нужно удалить.

delegationSubject — Subject, содержащий делегированные принципы, или null, если вместо этого используется принцип аутентификации.

Исключения:

InstanceNotFoundException — Указанное имя MBean не соответствует ни одному из зарегистрированных MBeans.

ListenerNotFoundException — Слушатель не зарегистрирован в MBean.

SecurityException — если у клиента или делегированного субъекта нет разрешения на выполнение этой операции.

IOException — если произошла общая ошибка связи.

RuntimeOperationsException — Оборачивает IllegalArgumentException, когда name или listener имеют значение null.

См. также:

addNotificationListener(javax.management.ObjectName, javax.management.ObjectName, java.rmi.MarshalledObject, java.rmi.MarshalledObject, javax.security.auth.Subject)

removeNotificationListener

void removeNotificationListener(ObjectName name,
                                ObjectName listener,
                                MarshalledObject filter,
                                MarshalledObject handback,
                                Subject delegationSubject)
                         throws InstanceNotFoundException,
                                ListenerNotFoundException,
                                IOException

Обрабатывает метод MBeanServerConnection.removeNotificationListener(ObjectName, ObjectName, NotificationFilter, Object). Параметр NotificationFilter упакован в MarshalledObject. Параметр Object также упакован в MarshalledObject.

Параметры:

name — Имя MBean, из которого должен быть удален слушатель.

listener — Слушатель, который ранее был добавлен к этому MBean.

filter — Фильтр, указанный при добавлении слушателя, инкапсулированный в MarshalledObject.

handback — Обратная связь, указанная при добавлении слушателя, инкапсулированная в MarshalledObject.

delegationSubject — Subject, содержащий делегированные принципы, или null если используется принцип аутентификации.

Исключения:

InstanceNotFoundException — Предоставленное имя MBean не соответствует ни одному из зарегистрированных MBeans.

ListenerNotFoundException — Слушатель не зарегистрирован в MBean или он не зарегистрирован с заданным фильтром и обратной связью.

SecurityException — если у клиента или делегированного субъекта нет разрешения на выполнение этой операции.

IOException — если произошла общая ошибка связи.

RuntimeOperationsException — Оборачивает IllegalArgumentException, когда name или listener имеют значение null.

См. также:

addNotificationListener(javax.management.ObjectName, javax.management.ObjectName, java.rmi.MarshalledObject, java.rmi.MarshalledObject, javax.security.auth.Subject)

addNotificationListeners

Integer[] addNotificationListeners(ObjectName[] names,
                                   MarshalledObject[] filters,
                                   Subject[] delegationSubjects)
                            throws InstanceNotFoundException,
                                   IOException

Параметры:

names — ObjectNames, идентифицирующие MBeans, генерирующие уведомления.

filters — Массив сериализованных представлений NotificationFilters. Элементы этого массива могут быть null.

delegationSubjects — Subjects от имени которого добавляются слушатели. Элементы этого массива могут быть null. Также, сам параметр delegationSubjects может быть null, что эквивалентно массиву нулевых значений с таким же размером, как массивы names и filters.

Возвращаемое значение:

массив listenerIDs, идентифицирующих локальных слушателей. Этот массив имеет такое же количество элементов, что и параметры.

Исключения:

IllegalArgumentException — если names или filters равно null, или если names содержит нулевой элемент, или если три массива не имеют одинакового размера.

ClassCastException — если один из элементов filters при размаршаливании является не нулевым объектом, который не является NotificationFilter.

InstanceNotFoundException — если ни одному из names не соответствует зарегистрированный MBean.

SecurityException — если для одного из MBeans у клиента или делегированного субъекта нет разрешения на добавление слушателя.

IOException — если произошла общая ошибка связи.

removeNotificationListeners

void removeNotificationListeners(ObjectName name,
                                 Integer[] listenerIDs,
                                 Subject delegationSubject)
                          throws InstanceNotFoundException,
                                 ListenerNotFoundException,
                                 IOException

Параметры:

name — ObjectName, идентифицирующие MBean, генерирующий уведомления.

listenerIDs — Список идентификаторов, соответствующих слушателям для удаления.

delegationSubject — Subject, содержащий делегированные принципы, или null если вместо этого используется принцип аутентификации.

Исключения:

InstanceNotFoundException — Предоставленное name не соответствует ни одному из зарегистрированных MBeans.

ListenerNotFoundException — Один из слушателей не найден на стороне сервера. Это исключение может произойти, если MBean отбросил слушателя по какой-либо причине, отличной от вызова MBeanServer.removeNotificationListener.

SecurityException — У клиента или делегированного субъекта нет разрешения на удаление слушателей.

IOException — Произошла общая ошибка связи.

IllegalArgumentException — если ObjectName или listenerIds равно null, или если listenerIds содержит нулевой элемент.

fetchNotifications

NotificationResult fetchNotifications(long clientSequenceNumber,
                                      int maxNotifications,
                                      long timeout)
                               throws IOException

Параметры:

clientSequenceNumber - первый порядковый номер, который интересует клиента. Если отрицательный, он интерпретируется как порядковый номер, который будет иметь следующее уведомление.

maxNotifications - максимальное количество различных уведомлений для возврата. Массив TargetedNotification в возвращаемом NotificationResult может иметь больше элементов, чем это, если одно и то же уведомление появляется более одного раза. Поведение не определено, если этот параметр отрицательный.

timeout - максимальное время в миллисекундах ожидания прибытия уведомления. Может быть 0, чтобы указать, что метод не должен ждать, если уведомлений нет, а должен сразу вернуться. Может быть Long.MAX_VALUE, чтобы указать, что таймаут отсутствует. Поведение не определено, если этот параметр отрицательный.

Возвращает:

A NotificationResult.

Выбрасывает:

IOException - если произошла общая ошибка связи.