Класс RMIConnectionImpl

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

Параметры:

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

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

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

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

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

public String getConnectionId() throws IOException

Определено в:

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

Возвращает:

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

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

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

См. также:

• RMIConnector.connect

public void close() throws IOException

Определено в:

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

Определено в:

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

Определено в:

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

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

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

public void unreferenced()

Определено в:

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

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

Определено в:

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

Параметры:

className — имя класса создаваемого экземпляра MBean.

name — имя объекта MBean. Может быть равно null.

delegationSubject — должен быть null.

Возвращает:

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

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

UnsupportedOperationException — если delegationSubject не равен null.

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

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

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

MBeanException — конструктор MBean выбросил исключение.

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

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

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

Определено в:

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

Параметры:

className — имя класса создаваемого экземпляра MBean.

name — имя объекта MBean. Может быть равно null.

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

delegationSubject — должен быть null.

Возвращает:

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

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

UnsupportedOperationException — если delegationSubject не равен null.

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

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

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

MBeanException — конструктор MBean выбросил исключение.

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

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

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

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

Определено в:

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

Параметры:

className — имя класса создаваемого экземпляра MBean.

name — имя объекта MBean. Может быть равно null.

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

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

delegationSubject — должен быть null.

Возвращает:

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

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

UnsupportedOperationException — если delegationSubject не равен null.

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

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

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

MBeanException — конструктор MBean выбросил исключение.

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

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

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

Определено в:

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

Параметры:

className — имя класса создаваемого экземпляра MBean.

name — имя объекта MBean. Может быть равно null.

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

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

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

delegationSubject — должен быть null.

Возвращает:

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

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

UnsupportedOperationException — если delegationSubject не равен null.

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

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

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

MBeanException — конструктор MBean выбросил исключение.

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

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

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

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

Определено в:

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

Параметры:

name — имя объекта MBean, который необходимо отменить регистрацию.

delegationSubject — должен быть null.

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

UnsupportedOperationException — если delegationSubject не равен null.

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

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

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

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

Определено в:

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

Параметры:

name — имя объекта MBean.

delegationSubject — должен быть null.

Возвращает:

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

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

UnsupportedOperationException — если delegationSubject не равен null.

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

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

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

Определено в:

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

Параметры:

name — шаблон имени объекта, идентифицирующий извлекаемые MBean. Если значение равно null или домен и ключевые свойства не указаны, будут извлечены все зарегистрированные MBean.

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

delegationSubject — должен быть null.

Возвращает:

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

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

UnsupportedOperationException — если delegationSubject не равен null.

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

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

Определено в:

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

Параметры:

name — шаблон имени объекта, идентифицирующий извлекаемые имена MBean. Если значение равно null или домен и ключевые свойства не указаны, будут извлечены имена всех зарегистрированных MBean.

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

delegationSubject — должен быть null.

Возвращает:

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

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

UnsupportedOperationException — если delegationSubject не равен null.

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

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

Определено в:

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

Параметры:

name — имя объекта MBean, регистрацию которого нужно проверить.

delegationSubject — должен быть null.

Возвращает:

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

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

UnsupportedOperationException — если delegationSubject не равен null.

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

public Integer getMBeanCount(Subject delegationSubject) throws IOException

Определено в:

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

Параметры:

delegationSubject — должен быть null.

Возвращает:

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

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

UnsupportedOperationException — если delegationSubject не равен null.

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

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

Определено в:

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

Параметры:

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

attribute — строка с именем извлекаемого атрибута.

delegationSubject — должен быть null.

Возвращает:

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

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

UnsupportedOperationException — если delegationSubject не равен null.

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

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

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

ReflectionException — оборачивает java.lang.Exception, выброшенное при попытке вызвать метод чтения.

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

См. также:

• RMIConnection.setAttribute(ObjectName, MarshalledObject, Subject)

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

Определено в:

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

Параметры:

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

attributes — список извлекаемых атрибутов.

delegationSubject — должен быть null.

Возвращает:

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

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

UnsupportedOperationException — если delegationSubject не равен null.

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

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

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

См. также:

• RMIConnection.setAttributes(ObjectName, MarshalledObject, Subject)

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

Определено в:

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

Параметры:

name — имя MBean, атрибут которого необходимо задать.

attribute — идентификатор задаваемого атрибута и значение, которое ему присваивается, инкапсулированные в MarshalledObject.

delegationSubject — должен быть null.

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

UnsupportedOperationException — если delegationSubject не равен null.

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

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

InvalidAttributeValueException — указанное значение атрибута недопустимо.

MBeanException — оборачивает исключение, выброшенное методом записи MBean.

ReflectionException — оборачивает java.lang.Exception, выброшенное при попытке вызвать метод записи.

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

См. также:

• RMIConnection.getAttribute(ObjectName, String, Subject)

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

Определено в:

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

Параметры:

name — имя объекта MBean, атрибуты которого необходимо задать.

attributes — список атрибутов: идентификаторы задаваемых атрибутов и присваиваемые им значения, инкапсулированные в MarshalledObject.

delegationSubject — должен быть null.

Возвращает:

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

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

UnsupportedOperationException — если delegationSubject не равен null.

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

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

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

См. также:

• RMIConnection.getAttributes(ObjectName, String[], Subject)

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

Определено в:

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

Параметры:

name — имя объекта MBean, для которого вызывается метод.

operationName — имя вызываемой операции.

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

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

delegationSubject — должен быть null.

Возвращает:

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

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

UnsupportedOperationException — если delegationSubject не равен null.

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

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

ReflectionException — оборачивает java.lang.Exception, выброшенное при попытке вызвать метод.

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

public String getDefaultDomain(Subject delegationSubject) throws IOException

Указан в:

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

Параметры:

delegationSubject — должен быть null.

Возвращает:

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

Исключения:

UnsupportedOperationException — если delegationSubject не равен null.

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

public String[] getDomains(Subject delegationSubject) throws IOException

Указан в:

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

Параметры:

delegationSubject — должен быть null.

Возвращает:

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

Исключения:

UnsupportedOperationException — если delegationSubject не равен null.

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

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

Указан в:

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

Параметры:

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

delegationSubject — должен быть null.

Возвращает:

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

Исключения:

UnsupportedOperationException — если delegationSubject не равен null.

InstanceNotFoundException — указанный MBean не найден.

IntrospectionException — при интроспекции произошло исключение.

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

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

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

Указан в:

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

Параметры:

name — ObjectName MBean.

className — имя класса.

delegationSubject — должен быть null.

Возвращает:

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

Исключения:

UnsupportedOperationException — если delegationSubject не равен null.

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

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

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

Указан в:

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

Параметры:

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

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

delegationSubjects — должен быть null либо массивом, не содержащим ненулевых элементов.

Возвращает:

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

Исключения:

UnsupportedOperationException — если delegationSubjects не равен null и содержит ненулевые элементы.

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

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

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

Указан в:

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

Параметры:

name — имя MBean, к которому следует добавить прослушиватель.

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

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

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

delegationSubject — должен быть null.

Исключения:

UnsupportedOperationException — если delegationSubject не равен null.

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

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

См. также:

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

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

Указан в:

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

Параметры:

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

listenerIDs — список идентификаторов прослушивателей, которые нужно удалить.

delegationSubject — должен быть null.

Исключения:

UnsupportedOperationException — если delegationSubject не равен null.

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

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

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

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

Указан в:

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

Параметры:

name — имя MBean, из которого следует удалить прослушиватель.

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

delegationSubject — должен быть null.

Исключения:

UnsupportedOperationException — если delegationSubject не равен null.

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

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

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

См. также:

• RMIConnection.addNotificationListener(ObjectName, ObjectName, MarshalledObject, MarshalledObject, Subject)

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

Указан в:

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

Параметры:

name — имя MBean, из которого следует удалить прослушиватель.

listener — прослушиватель, ранее добавленный в этот MBean.

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

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

delegationSubject — должен быть null.

Исключения:

UnsupportedOperationException — если delegationSubject не равен null.

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

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

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

См. также:

• RMIConnection.addNotificationListener(ObjectName, ObjectName, MarshalledObject, MarshalledObject, Subject)

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

Указан в:

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

Параметры:

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

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

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

Возвращает:

NotificationResult.

Исключения:

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

public String toString()

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

toString в классе Object

Возвращает:

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