compact3

javax.management.remote.rmi

Интерфейс RMIConnection

Все Суперинтерфейсы:

AutoCloseable, Closeable, Удаленный

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

RMIConnectionImpl, RMIConnectionImpl_Stub

public interface RMIConnection
extends Closeable, Remote

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

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

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

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

Большинство методов в этом интерфейсе параллельно методам в MBeanServerConnection интерфейс. Где аспект поведения метода не определяется здесь, это - то же самое как в соответствии MBeanServerConnection метод.

С тех пор:

1.5

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

Модификатор и Тип	Метод и Описание
void	addNotificationListener(ObjectName name, ObjectName listener, MarshalledObject filter, MarshalledObject handback, Subject delegationSubject) Обрабатывает метод MBeanServerConnection.addNotificationListener(ObjectName, ObjectName, NotificationFilter, Object).
Целое число[]	addNotificationListeners(ObjectName[] names, MarshalledObject[] filters, Subject[] delegationSubjects) Обрабатывает метод MBeanServerConnection.addNotificationListener(ObjectName, NotificationListener, NotificationFilter, Object).
void	close() Завершения это соединение.
ObjectInstance	createMBean(String className, ObjectName name, MarshalledObject params, String[] signature, Subject delegationSubject) Обрабатывает метод MBeanServerConnection.createMBean(String, ObjectName, Object[], String[]).
ObjectInstance	createMBean(String className, ObjectName name, ObjectName loaderName, MarshalledObject params, String[] signature, Subject delegationSubject) Обрабатывает метод MBeanServerConnection.createMBean(String, ObjectName, ObjectName, Object[], String[]).
ObjectInstance	createMBean(String className, ObjectName name, ObjectName loaderName, Subject delegationSubject) Обрабатывает метод MBeanServerConnection.createMBean(String, ObjectName, ObjectName).
ObjectInstance	createMBean(String className, ObjectName name, Subject delegationSubject) Обрабатывает метод MBeanServerConnection.createMBean(String, ObjectName).
NotificationResult	fetchNotifications(long clientSequenceNumber, int maxNotifications, long timeout) Получает уведомления от сервера соединителя.
Объект	getAttribute(ObjectName name, String attribute, Subject delegationSubject) Обрабатывает метод MBeanServerConnection.getAttribute(ObjectName, String).
AttributeList	getAttributes(ObjectName name, String[] attributes, Subject delegationSubject) Обрабатывает метод MBeanServerConnection.getAttributes(ObjectName, String[]).
Строка	getConnectionId() Возвращает ID соединения.
Строка	getDefaultDomain(Subject delegationSubject) Обрабатывает метод MBeanServerConnection.getDefaultDomain().
Строка[]	getDomains(Subject delegationSubject) Обрабатывает метод MBeanServerConnection.getDomains().
Целое число	getMBeanCount(Subject delegationSubject) Обрабатывает метод MBeanServerConnection.getMBeanCount().
MBeanInfo	getMBeanInfo(ObjectName name, Subject delegationSubject) Обрабатывает метод MBeanServerConnection.getMBeanInfo(ObjectName).
ObjectInstance	getObjectInstance(ObjectName name, Subject delegationSubject) Обрабатывает метод MBeanServerConnection.getObjectInstance(ObjectName).
Объект	invoke(ObjectName name, String operationName, MarshalledObject params, String[] signature, Subject delegationSubject) Обрабатывает метод MBeanServerConnection.invoke(ObjectName, String, Object[], String[]).
boolean	isInstanceOf(ObjectName name, String className, Subject delegationSubject) Обрабатывает метод MBeanServerConnection.isInstanceOf(ObjectName, String).
boolean	isRegistered(ObjectName name, Subject delegationSubject) Обрабатывает метод MBeanServerConnection.isRegistered(ObjectName).
Set<ObjectInstance>	queryMBeans(ObjectName name, MarshalledObject query, Subject delegationSubject) Обрабатывает метод MBeanServerConnection.queryMBeans(ObjectName, QueryExp).
Set<ObjectName>	queryNames(ObjectName name, MarshalledObject query, Subject delegationSubject) Обрабатывает метод MBeanServerConnection.queryNames(ObjectName, QueryExp).
void	removeNotificationListener(ObjectName name, ObjectName listener, MarshalledObject filter, MarshalledObject handback, Subject delegationSubject) Обрабатывает метод MBeanServerConnection.removeNotificationListener(ObjectName, ObjectName, NotificationFilter, Object).
void	removeNotificationListener(ObjectName name, ObjectName listener, Subject delegationSubject) Обрабатывает метод MBeanServerConnection.removeNotificationListener(ObjectName, ObjectName).
void	removeNotificationListeners(ObjectName name, Integer[] listenerIDs, Subject delegationSubject) Дескрипторы removeNotificationListener(ObjectName, NotificationListener) и removeNotificationListener(ObjectName, NotificationListener, NotificationFilter, Object) методы.
void	setAttribute(ObjectName name, MarshalledObject attribute, Subject delegationSubject) Обрабатывает метод MBeanServerConnection.setAttribute(ObjectName, Attribute).
AttributeList	setAttributes(ObjectName name, MarshalledObject attributes, Subject delegationSubject) Обрабатывает метод MBeanServerConnection.setAttributes(ObjectName, AttributeList).
void	unregisterMBean(ObjectName name, Subject delegationSubject) Обрабатывает метод MBeanServerConnection.unregisterMBean(ObjectName).

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

getConnectionId

String getConnectionId()
                throws IOException

Возвращает ID соединения. Эта строка отличается для каждого открытого соединения с данным сервером соединителя RMI.

Возвраты:

ID соединения

Броски:

IOException - если общее коммуникационное исключение произошло.

См. Также:

RMIConnector.connect

близко

void close()
    throws IOException

Завершения это соединение. По возврату из этого метода неэкспортируется объект RMI, реализующий этот интерфейс, таким образом, далее удаленные звонки в это перестанут работать.

Определенный:

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 - Имя class MBean, который инстанцируют.

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

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

Возвраты:

ObjectInstance, содержа ObjectName и Java имя class недавно инстанцированного MBean. Если содержавший ObjectName n, содержавший Java имя class getMBeanInfo(n).getClassName().

Броски:

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

InstanceAlreadyExistsException - MBean уже является объектом управления сервера MBean.

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

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

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

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

SecurityException - если у клиента, или делегированного Предмета если таковые вообще имеются, нет разрешения, чтобы выполнить эту работу.

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 - Имя class MBean, который инстанцируют.

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

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

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

Возвраты:

ObjectInstance, содержа ObjectName и Java имя class недавно инстанцированного MBean. Если содержавший ObjectName n, содержавший Java имя class getMBeanInfo(n).getClassName().

Броски:

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

InstanceAlreadyExistsException - MBean уже является объектом управления сервера MBean.

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

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

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

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

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

SecurityException - если у клиента, или делегированного Предмета если таковые вообще имеются, нет разрешения, чтобы выполнить эту работу.

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[] параметр обертывается в a MarshalledObject.

Параметры:

className - Имя class MBean, который инстанцируют.

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

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

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

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

Возвраты:

ObjectInstance, содержа ObjectName и Java имя class недавно инстанцированного MBean. Если содержавший ObjectName n, содержавший Java имя class getMBeanInfo(n).getClassName().

Броски:

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

InstanceAlreadyExistsException - MBean уже является объектом управления сервера MBean.

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

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

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

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

SecurityException - если у клиента, или делегированного Предмета если таковые вообще имеются, нет разрешения, чтобы выполнить эту работу.

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[] параметр обертывается в a MarshalledObject.

Параметры:

className - Имя class MBean, который инстанцируют.

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

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

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

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

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

Возвраты:

ObjectInstance, содержа ObjectName и Java имя class недавно инстанцированного MBean. Если содержавший ObjectName n, содержавший Java имя class getMBeanInfo(n).getClassName().

Броски:

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

InstanceAlreadyExistsException - MBean уже является объектом управления сервера MBean.

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

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

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

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

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

SecurityException - если у клиента, или делегированного Предмета если таковые вообще имеются, нет разрешения, чтобы выполнить эту работу.

IOException - если общее коммуникационное исключение произошло.

unregisterMBean

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

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

Параметры:

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

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

Броски:

InstanceNotFoundException - Определенный MBean не регистрируется в сервере MBean.

MBeanRegistrationException - Предварительно вычеркивание из списка ((MBeanRegistration интерфейс), метод MBean выдал исключение.

RuntimeOperationsException - Обертки a java.lang.IllegalArgumentException: Имя объекта в параметре является нулем или 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 и содержавшее имя class getMBeanInfo(name).getClassName().

Броски:

InstanceNotFoundException - Определенный MBean не регистрируется в сервере MBean.

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

SecurityException - если у клиента, или делегированного Предмета если таковые вообще имеются, нет разрешения, чтобы выполнить эту работу.

IOException - если общее коммуникационное исключение произошло.

queryMBeans

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

Обрабатывает метод MBeanServerConnection.queryMBeans(ObjectName, QueryExp). QueryExp обертывается в a MarshalledObject.

Параметры:

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

query - Выражение запроса, которое будет применено для того, чтобы выбрать MBeans, инкапсулировавший в a MarshalledObject. Если MarshalledObject инкапсулирует нулевое значение, никакое выражение запроса не будет применено для того, чтобы выбрать 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 обертывается в a MarshalledObject.

Параметры:

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

query - Выражение запроса, которое будет применено для того, чтобы выбрать MBeans, инкапсулировавший в a MarshalledObject. Если MarshalledObject инкапсулирует нулевое значение, никакое выражение запроса не будет применено для того, чтобы выбрать 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 если принципал аутентификации используется вместо этого.

Возвраты:

Истина, если MBean уже регистрируется в сервере MBean, ложь иначе.

Броски:

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

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 - Обертывает исключение, выданное методом get MBEAN.

InstanceNotFoundException - Определенный MBean не регистрируется в сервере MBean.

ReflectionException - Обертки a java.lang.Exception брошенный, пытаясь вызвать метода get.

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

RuntimeMBeanException - Обертывает исключение на этапе выполнения, брошенное методом get 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 - Обертка a java.lang.IllegalArgumentException: Имя объекта в параметре является нулем, или атрибуты в параметре нуль.

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 параметр обертывается в a MarshalledObject.

Параметры:

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

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

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

Броски:

InstanceNotFoundException - Определенный MBean не регистрируется в сервере MBean.

AttributeNotFoundException - Определенный атрибут не доступен в MBean.

InvalidAttributeValueException - Значение, определенное для атрибута, не допустимо.

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

ReflectionException - Обертки a java.lang.Exception брошенный, пытаясь вызвать метод set.

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

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 параметр обертывается в a MarshalledObject.

Параметры:

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

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

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

Возвраты:

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

Броски:

InstanceNotFoundException - Определенный MBean не регистрируется в сервере MBean.

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

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

SecurityException - если у клиента, или делегированного Предмета если таковые вообще имеются, нет разрешения, чтобы выполнить эту работу.

IOException - если общее коммуникационное исключение произошло.

См. Также:

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

вызвать

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

Обрабатывает метод MBeanServerConnection.invoke(ObjectName, String, Object[], String[]). Object[] параметр обертывается в a MarshalledObject.

Параметры:

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

operationName - Имя работы, которая будет вызвана.

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

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

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

Возвраты:

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

Броски:

InstanceNotFoundException - Определенный MBean не регистрируется в сервере MBean.

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

ReflectionException - Обертки a java.lang.Exception брошенный, пытаясь вызвать метод.

SecurityException - если у клиента, или делегированного Предмета если таковые вообще имеются, нет разрешения, чтобы выполнить эту работу.

IOException - если общее коммуникационное исключение произошло.

RuntimeOperationsException - Обертки IllegalArgumentException когда name или operationName нуль.

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 - Обертки a java.lang.IllegalArgumentException: Имя объекта в параметре является нулем.

isInstanceOf

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

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

Параметры:

name - ObjectName из MBean.

className - Имя class.

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

Возвраты:

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

Броски:

InstanceNotFoundException - Определенный MBean не регистрируется в сервере MBean.

SecurityException - если у клиента, или делегированного Предмета если таковые вообще имеются, нет разрешения, чтобы выполнить эту работу.

IOException - если общее коммуникационное исключение произошло.

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

addNotificationListener

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

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

Параметры:

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

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

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

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

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

Броски:

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

RuntimeOperationsException - Обертки IllegalArgumentException. MBean, названный listener существует, но не реализует NotificationListener интерфейс, или name или listener нуль.

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 нуль.

См. Также:

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 параметр обертывается в a MarshalledObject. Object параметр также обертывается в a MarshalledObject.

Параметры:

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

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

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

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

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

Броски:

InstanceNotFoundException - Обеспеченное имя MBean не соответствует ни одного из зарегистрированных MBeans.

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

SecurityException - если у клиента, или делегированного Предмета если таковые вообще имеются, нет разрешения, чтобы выполнить эту работу.

IOException - если общее коммуникационное исключение произошло.

RuntimeOperationsException - Обертки IllegalArgumentException когда name или listener нуль.

См. Также:

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

Обрабатывает метод MBeanServerConnection.addNotificationListener(ObjectName, NotificationListener, NotificationFilter, Object).

Регистр для уведомлений от данных MBeans, которые соответствуют данные фильтры. Удаленный клиент может впоследствии получить уведомления, используя fetchNotifications метод.

Для каждого слушателя, оригинала NotificationListener и handback сохраняются на стороне клиента; для клиента, чтобы быть в состоянии идентифицировать их, сервер генерирует и возвращает уникальное listenerID. Это listenerID передается с Notifications удаленному клиенту.

Если кто-либо из данных (имя, фильтр) пары не могут быть зарегистрированы, то сбои работы с исключением, и никакие имена или фильтры регистрируются.

Параметры:

names - ObjectNames идентификация MBeans испускание Уведомлений.

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

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

Возвраты:

массив listenerIDs идентификация локальных слушателей. У этого массива есть то же самое число элементов как параметры.

Броски:

IllegalArgumentException - если names или filters нуль, или если names содержит нулевой элемент, или если у трех массивов все нет того же самого размера.

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

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

SecurityException - если для одного из MBeans у клиента, или делегированного Предмета если таковые вообще имеются, нет разрешения, чтобы добавить слушателя.

IOException - если общее коммуникационное исключение произошло.

removeNotificationListeners

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

Дескрипторы removeNotificationListener(ObjectName, NotificationListener) и removeNotificationListener(ObjectName, NotificationListener, NotificationFilter, Object) методы.

Этот метод удаляет один или больше NotificationListeners от данного MBean в сервере MBean.

NotificationListeners идентифицируются ID, которые были возвращены addNotificationListeners(ObjectName[], MarshalledObject[], Subject[]) метод.

Параметры:

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

listenerIDs - список ID, соответствующих слушателям, чтобы удалить.

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

Броски:

InstanceNotFoundException - если данный name не соответствует любой зарегистрировал MBean.

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

SecurityException - если у клиента, или делегированного Предмета если таковые вообще имеются, нет разрешения, чтобы удалить слушателей.

IOException - если общее коммуникационное исключение произошло.

IllegalArgumentException - если ObjectName или listenerIds нуль или если listenerIds содержит нулевой элемент.

fetchNotifications

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

Получает уведомления от сервера соединителя. Этот метод может блокировать, пока нет по крайней мере одно уведомление или пока указанный тайм-аут достигается. Метод может также возвратиться в любое время с нулевыми уведомлениями.

Уведомление может быть включено в результат, если его порядковый номер не меньше, чем clientSequenceNumber и этот клиент зарегистрировал по крайней мере одного слушателя для MBean генерирование уведомления с фильтром, который принимает уведомление. Каждый слушатель, который интересуется уведомлением, идентифицируется Целочисленным ID, который был возвращен addNotificationListeners(ObjectName[], MarshalledObject[], Subject[]).

Параметры:

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

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

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

Возвраты:

A NotificationResult.

Броски:

IOException - если общее коммуникационное исключение произошло.