Класс 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 — этот класс не является MBean, совместимым с JMX.

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 — этот класс не является MBean, совместимым с JMX.

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 — этот класс не является MBean, совместимым с JMX.

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 — этот класс не является MBean, совместимым с JMX.

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

Возвращает:

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