Класс RMIConnectionImpl

public class RMIConnectionImpl
extends Object
implements RMIConnection, Unreferenced

Реализация интерфейса RMIConnection. Код пользователя обычно не ссылается на этот класс.

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

RMIConnectionImpl

public RMIConnectionImpl(RMIServerImpl rmiServer,
                         String connectionId,
                         ClassLoader defaultClassLoader,
                         Subject subject,
                         Map<String,?> env)

Конструирует новый RMIConnection. Это соединение может использоваться с транспортом JRMP или IIOP. Этот объект не экспортирует себя: обязанность вызывающего объекта — экспортировать его соответствующим образом (см. RMIJRMPServerImpl.makeClient(String,Subject) и RMIIIOPServerImpl.makeClient(String,Subject)).

Параметры:

rmiServer - Объект RMIServerImpl, для которого создается это соединение. Поведение не определено, если этот параметр равен null.

connectionId - Идентификатор для этого соединения. Поведение не определено, если этот параметр равен null.

defaultClassLoader - Класс загрузчик по умолчанию, который будет использоваться при десериализации маршалированных объектов. Может быть null, что означает загрузчик базовых классов.

subject - аутентифицированный субъект, который будет использоваться для авторизации. Может быть null, что означает, что ни один субъект не был аутентифицирован.

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

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

getConnectionId

public String getConnectionId()
                       throws IOException

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

Указано в:

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

Возвращает:

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

Исключения:

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

См. также:

RMIConnector.connect

close

public void close()
           throws IOException

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

Указано в:

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

Указано в:

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

Указано в:

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

Исключения:

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

unreferenced

public void unreferenced()

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

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

Указано в:

unreferenced в интерфейсе Unreferenced

createMBean

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

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

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

Указано в:

createMBean в интерфейсе RMIConnection

Параметры:

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

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

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

Возвращает:

ObjectInstance, содержащий ObjectName и имя Java-класса вновь созданного MBean. Если содержащийся ObjectName равен n, содержащееся имя Java-класса равно getMBeanInfo(n).getClassName().

Исключения:

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

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

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

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

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

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

createMBean

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

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

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

Указано в:

createMBean в интерфейсе RMIConnection

Параметры:

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

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

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

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

Возвращает:

ObjectInstance, содержащий ObjectName и имя Java-класса вновь созданного MBean. Если содержащийся ObjectName равен n, содержащееся имя Java-класса равно 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.

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

createMBean

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

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

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

Указано в:

createMBean в интерфейсе RMIConnection

Параметры:

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

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

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

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

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

Возвращает:

ObjectInstance, содержащий ObjectName и имя Java-класса вновь созданного MBean. Если содержащийся ObjectName равен n, содержащееся имя Java-класса равно getMBeanInfo(n).getClassName().

Исключения:

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

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

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

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

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

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

createMBean

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

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

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

Указано:

createMBean в интерфейсе RMIConnection

Параметры:

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

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

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

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

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

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

Возвращает:

Объект ObjectInstance, содержащий ObjectName и имя Java-класса только что проинициализированного MBean. Если содержащийся ObjectName имеет значение n, содержащееся имя Java-класса имеет значение 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.

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

unregisterMBean

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

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

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

Указано:

unregisterMBean в интерфейсе RMIConnection

Параметры:

name - Имя объекта MBean, который должен быть удалён из регистрации.

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

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

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

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

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

getObjectInstance

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

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

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

Указано:

getObjectInstance в интерфейсе RMIConnection

Параметры:

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

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

Возвращает:

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

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

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

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

queryMBeans

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

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

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

Указано:

queryMBeans в интерфейсе RMIConnection

Параметры:

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

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

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

Возвращает:

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

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

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

queryNames

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

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

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

Указано:

queryNames в интерфейсе RMIConnection

Параметры:

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

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

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

Возвращает:

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

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

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

isRegistered

public boolean isRegistered(ObjectName name,
                            Subject delegationSubject)
                     throws IOException

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

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

Указано:

isRegistered в интерфейсе RMIConnection

Параметры:

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

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

Возвращает:

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

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

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

getMBeanCount

public Integer getMBeanCount(Subject delegationSubject)
                      throws IOException

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

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

Указано:

getMBeanCount в интерфейсе RMIConnection

Параметры:

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

Возвращает:

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

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

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

getAttribute

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

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

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

Указано:

getAttribute в интерфейсе RMIConnection

Параметры:

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

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

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

Возвращает:

Значение извлечённого атрибута.

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

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

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

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

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

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

См. также:

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

getAttributes

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

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

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

Указано в:

getAttributes в интерфейсе RMIConnection

Параметры:

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

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

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

Возвращает:

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

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

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

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

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

См. также:

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

setAttribute

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

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

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

Указано в:

setAttribute в интерфейсе RMIConnection

Параметры:

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

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

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

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

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

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

InvalidAttributeValueException - Указанное значение атрибута недействительно.

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

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

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

См. также:

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

setAttributes

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

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

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

Указано в:

setAttributes в интерфейсе RMIConnection

Параметры:

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

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

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

Возвращает:

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

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

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

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

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

См. также:

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

invoke

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

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

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

Указано в:

invoke в интерфейсе RMIConnection

Параметры:

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

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

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

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

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

Возвращает:

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

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

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

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

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

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

getDefaultDomain

public String getDefaultDomain(Subject delegationSubject)
                        throws IOException

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

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

Указано в:

getDefaultDomain в интерфейсе RMIConnection

Параметры:

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

Возвращает:

Базовый домен.

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

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

getDomains

public String[] getDomains(Subject delegationSubject)
                    throws IOException

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

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

Указано в:

getDomains в интерфейсе RMIConnection

Параметры:

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

Возвращает:

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

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

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

getMBeanInfo

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

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

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

Указано в:

getMBeanInfo в интерфейсе RMIConnection

Параметры:

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

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

Возвращает:

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

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

InstanceNotFoundException - Указанный MBean не найден.

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

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

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

isInstanceOf

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

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

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

Указано в:

isInstanceOf в интерфейсе RMIConnection

Параметры:

name - ObjectName MBean.

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

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

Возвращает:

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

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

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

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

addNotificationListeners

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

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

Указано:

addNotificationListeners в интерфейсе RMIConnection

Параметры:

names - имя ObjectNames , идентифицирующее MBean, испускающий уведомления.

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

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

Возвращает:

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

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

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

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

addNotificationListener

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

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

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

Указано:

addNotificationListener в интерфейсе RMIConnection

Параметры:

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

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

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

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

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

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

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

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

См. также:

RMIConnection.removeNotificationListener(ObjectName, ObjectName, Subject), RMIConnection.removeNotificationListener(ObjectName, ObjectName, MarshalledObject, MarshalledObject, Subject)

removeNotificationListeners

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

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

Указано:

removeNotificationListeners в интерфейсе RMIConnection

Параметры:

name - имя ObjectName , идентифицирующее MBean, испускающий уведомления.

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

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

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

InstanceNotFoundException - если заданное name не соответствует ни одному зарегистрированному MBean.

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

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

removeNotificationListener

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

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

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

Указано:

removeNotificationListener в интерфейсе RMIConnection

Параметры:

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

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

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

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

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

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

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

См. также:

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

removeNotificationListener

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

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

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

Указано:

removeNotificationListener в интерфейсе RMIConnection

Параметры:

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

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

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

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

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

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

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

ListenerNotFoundException - Слушатель не зарегистрирован в MBean или не зарегистрирован с заданным фильтром и handback.

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

См. также:

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

fetchNotifications

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

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

Указано:

fetchNotifications в интерфейсе RMIConnection

Параметры:

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

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

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

Возвращает:

A NotificationResult.

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

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

toString

public String toString()

Переопределяет:

toString в классе Object

Возвращает:

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