javax.management

Интерфейсный MBeanServerConnection

Все Известные Подынтерфейсы:

MBeanServer, MBeanServerForwarder

public interface MBeanServerConnection

Этот интерфейс представляет способ говорить с сервером MBean, или локальный или удаленный. MBeanServer интерфейс, представляя локальный сервер MBean, расширяет этот интерфейс.

С тех пор:

1.5

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

Методы

Модификатор и Тип	Метод и Описание
void	addNotificationListener(ObjectName name, NotificationListener listener, NotificationFilter filter, Object handback) Добавляет слушатель зарегистрированного MBean.
void	addNotificationListener(ObjectName name, ObjectName listener, NotificationFilter filter, Object handback) Добавляет слушатель зарегистрированного MBean.
ObjectInstance	createMBean(String className, ObjectName name) Инстанцирует и регистрирует MBean в сервере MBean.
ObjectInstance	createMBean(String className, ObjectName name, Object[] params, String[] signature) Инстанцирует и регистрирует MBean в сервере MBean.
ObjectInstance	createMBean(String className, ObjectName name, ObjectName loaderName) Инстанцирует и регистрирует MBean в сервере MBean.
ObjectInstance	createMBean(String className, ObjectName name, ObjectName loaderName, Object[] params, String[] signature) Инстанцирует и регистрирует MBean в сервере MBean.
Объект	getAttribute(ObjectName name, String attribute) Получает значение определенного атрибута именованного MBean.
AttributeList	getAttributes(ObjectName name, String[] attributes) Получает значения нескольких атрибутов именованного MBean.
Строка	getDefaultDomain() Возвращает домен по умолчанию, используемый для того, чтобы назвать MBean.
Строка[]	getDomains() Возвращает список доменов, в которых в настоящий момент регистрируется любой MBean.
Целое число	getMBeanCount() Возвращает число MBeans, зарегистрированного в сервере MBean.
MBeanInfo	getMBeanInfo(ObjectName name) Этот метод обнаруживает атрибуты и операции, которые MBean представляет для управления.
ObjectInstance	getObjectInstance(ObjectName name) Добирается ObjectInstance для данного MBean, зарегистрированного в сервере MBean.
Объект	invoke(ObjectName name, String operationName, Object[] params, String[] signature) Вызывает работу на MBean.
boolean	isInstanceOf(ObjectName name, String className) Возвращает true, если определенный MBean является экземпляром указанного класса, ложь иначе.
boolean	isRegistered(ObjectName name) Проверки, регистрируется ли MBean, идентифицированный его именем объекта, уже, в сервере MBean.
Set<ObjectInstance>	queryMBeans(ObjectName name, QueryExp query) Получает MBeans, которым управляет сервер MBean.
Set<ObjectName>	queryNames(ObjectName name, QueryExp query) Получает имена MBeans, которым управляет сервер MBean.
void	removeNotificationListener(ObjectName name, NotificationListener listener) Удаляет слушателя из зарегистрированного MBean.
void	removeNotificationListener(ObjectName name, NotificationListener listener, NotificationFilter filter, Object handback) Удаляет слушателя из зарегистрированного MBean.
void	removeNotificationListener(ObjectName name, ObjectName listener) Удаляет слушателя из зарегистрированного MBean.
void	removeNotificationListener(ObjectName name, ObjectName listener, NotificationFilter filter, Object handback) Удаляет слушателя из зарегистрированного MBean.
void	setAttribute(ObjectName name, Attribute attribute) Устанавливает значение определенного атрибута именованного MBean.
AttributeList	setAttributes(ObjectName name, AttributeList attributes) Устанавливает значения нескольких атрибутов именованного MBean.
void	unregisterMBean(ObjectName name) Нерегистрирует MBean от сервера MBean.

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

createMBean

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

Инстанцирует и регистрирует MBean в сервере MBean. Сервер MBean будет использовать Default Loader Repository загрузить класс MBean. Имя объекта связывается с MBean. Если данное имя объекта является нулем, MBean должен обеспечить свое собственное имя, реализовывая MBeanRegistration взаимодействуйте через интерфейс и возврат имени от preRegister метод.

Этот метод эквивалентен createMBean(className, name, (Object[]) null, (String[]) null).

Параметры:

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

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

Возвраты:

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

Броски:

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

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

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

RuntimeMBeanException - Если конструктор MBEAN или preRegister или postRegister метод бросил a RuntimeException. Если postRegister (MBeanRegistration интерфейс), метод MBean бросает a RuntimeException, createMBean метод бросит a RuntimeMBeanException, хотя создание MBean и регистрация успешно выполнялись. В таком случае MBean будет фактически зарегистрирован даже при том, что createMBean метод выдавал исключение. Отметьте это RuntimeMBeanException может также быть брошен preRegister, когда MBean не будет зарегистрирован.

RuntimeErrorException - Если postRegister (MBeanRegistration интерфейс), метод MBean бросает Error, createMBean метод бросит a RuntimeErrorException, хотя создание MBean и регистрация успешно выполнялись. В таком случае MBean будет фактически зарегистрирован даже при том, что createMBean метод выдавал исключение. Отметьте это RuntimeErrorException может также быть брошен preRegister, когда MBean не будет зарегистрирован.

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

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

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

IOException - Проблема коммуникации произошла когда говорящий с сервером MBean.

См. Также:

MBeanRegistration

createMBean

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

Инстанцирует и регистрирует MBean в сервере MBean. Загрузчик класса, который будет использоваться, идентифицируется его именем объекта. Имя объекта связывается с MBean. Если имя объекта загрузчика будет нулем, то ClassLoder, который загрузил сервер MBean, будет использоваться. Если данное имя объекта MBEAN является нулем, MBean должен обеспечить свое собственное имя, реализовывая MBeanRegistration взаимодействуйте через интерфейс и возврат имени от preRegister метод.

Этот метод эквивалентен createMBean(className, name, loaderName, (Object[]) null, (String[]) null).

Параметры:

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

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

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

Возвраты:

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

Броски:

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

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

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

RuntimeMBeanException - Если конструктор MBEAN или preRegister или postRegister метод бросил a RuntimeException. Если postRegister (MBeanRegistration интерфейс), метод MBean бросает a RuntimeException, createMBean метод бросит a RuntimeMBeanException, хотя создание MBean и регистрация успешно выполнялись. В таком случае MBean будет фактически зарегистрирован даже при том, что createMBean метод выдавал исключение. Отметьте это RuntimeMBeanException может также быть брошен preRegister, когда MBean не будет зарегистрирован.

RuntimeErrorException - Если postRegister (MBeanRegistration интерфейс), метод MBean бросает Error, createMBean метод бросит a RuntimeErrorException, хотя создание MBean и регистрация успешно выполнялись. В таком случае MBean будет фактически зарегистрирован даже при том, что createMBean метод выдавал исключение. Отметьте это RuntimeErrorException может также быть брошен preRegister, когда MBean не будет зарегистрирован.

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

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

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

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

IOException - Проблема коммуникации произошла когда говорящий с сервером MBean.

См. Также:

MBeanRegistration

createMBean

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

Инстанцирует и регистрирует MBean в сервере MBean. Сервер MBean будет использовать Default Loader Repository загрузить класс MBean. Имя объекта связывается с MBean. Если данное имя объекта является нулем, MBean должен обеспечить свое собственное имя, реализовывая MBeanRegistration взаимодействуйте через интерфейс и возврат имени от preRegister метод.

Параметры:

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

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

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

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

Возвраты:

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

Броски:

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

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

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

RuntimeMBeanException - Если конструктор MBEAN или preRegister или postRegister метод бросил a RuntimeException. Если postRegister (MBeanRegistration интерфейс), метод MBean бросает a RuntimeException, createMBean метод бросит a RuntimeMBeanException, хотя создание MBean и регистрация успешно выполнялись. В таком случае MBean будет фактически зарегистрирован даже при том, что createMBean метод выдавал исключение. Отметьте это RuntimeMBeanException может также быть брошен preRegister, когда MBean не будет зарегистрирован.

RuntimeErrorException - Если postRegister (MBeanRegistration интерфейс), метод MBean бросает Error, createMBean метод бросит a RuntimeErrorException, хотя создание MBean и регистрация успешно выполнялись. В таком случае MBean будет фактически зарегистрирован даже при том, что createMBean метод выдавал исключение. Отметьте это RuntimeErrorException может также быть брошен preRegister, когда MBean не будет зарегистрирован.

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

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

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

IOException - Проблема коммуникации произошла когда говорящий с сервером MBean.

См. Также:

MBeanRegistration

createMBean

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

Инстанцирует и регистрирует MBean в сервере MBean. Загрузчик класса, который будет использоваться, идентифицируется его именем объекта. Имя объекта связывается с MBean. Если имя объекта загрузчика не будет определено, то ClassLoder, который загрузил сервер MBean, будет использоваться. Если данное имя объекта MBean является нулем, MBean должен обеспечить свое собственное имя, реализовывая MBeanRegistration взаимодействуйте через интерфейс и возврат имени от preRegister метод.

Параметры:

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

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

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

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

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

Возвраты:

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

Броски:

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

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

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

RuntimeMBeanException - Конструктор MBEAN или preRegister или postRegister метод бросил a RuntimeException. Если postRegister (MBeanRegistration интерфейс), метод MBean бросает a RuntimeException, createMBean метод бросит a RuntimeMBeanException, хотя создание MBean и регистрация успешно выполнялись. В таком случае MBean будет фактически зарегистрирован даже при том, что createMBean метод выдавал исключение. Отметьте это RuntimeMBeanException может также быть брошен preRegister, когда MBean не будет зарегистрирован.

RuntimeErrorException - Если postRegister метод (MBeanRegistration интерфейс), метод MBean бросает Error, createMBean метод бросит a RuntimeErrorException, хотя создание MBean и регистрация успешно выполнялись. В таком случае MBean будет фактически зарегистрирован даже при том, что createMBean метод выдавал исключение. Отметьте это RuntimeErrorException может также быть брошен preRegister, когда MBean не будет зарегистрирован.

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

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

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

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

IOException - Проблема коммуникации произошла когда говорящий с сервером MBean.

См. Также:

MBeanRegistration

unregisterMBean

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

Нерегистрирует MBean от сервера MBean. MBean идентифицируется его именем объекта. Как только метод был вызван, к MBean больше не может получить доступ его имя объекта.

Параметры:

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

Броски:

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

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

RuntimeMBeanException - Если postDeregister (MBeanRegistration интерфейс), метод MBean бросает a RuntimeException, unregisterMBean метод бросит a RuntimeMBeanException, хотя нерегистрация MBean успешно выполнялась. В таком случае MBean будет фактически незарегистрирован даже при том, что unregisterMBean метод выдавал исключение. Отметьте это RuntimeMBeanException может также быть брошен preDeregister, когда MBean останется зарегистрированным.

RuntimeErrorException - Если postDeregister (MBeanRegistration интерфейс), метод MBean бросает Error, unregisterMBean метод бросит a RuntimeErrorException, хотя нерегистрация MBean успешно выполнялась. В таком случае MBean будет фактически незарегистрирован даже при том, что unregisterMBean метод выдавал исключение. Отметьте это RuntimeMBeanException может также быть брошен preDeregister, когда MBean останется зарегистрированным.

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

IOException - Проблема коммуникации произошла когда говорящий с сервером MBean.

См. Также:

MBeanRegistration

getObjectInstance

ObjectInstance getObjectInstance(ObjectName name)
                                 throws InstanceNotFoundException,
                                        IOException

Добирается ObjectInstance для данного MBean, зарегистрированного в сервере MBean.

Параметры:

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

Возвраты:

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

Броски:

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

IOException - Проблема коммуникации произошла когда говорящий с сервером MBean.

queryMBeans

Set<ObjectInstance> queryMBeans(ObjectName name,
                              QueryExp query)
                                throws IOException

Получает MBeans, которым управляет сервер MBean. Этот метод позволяет любому из следующих быть полученным: Весь MBeans, ряд MBeans, определенного сопоставлением с образцом на ObjectName и/или выражение Запроса, определенный MBean. Когда имя объекта является нулем, или никакие доменные и ключевые свойства не определяются, все объекты состоят в том, чтобы быть выбраны (и фильтроваться, если запрос определяется). Это возвращает набор ObjectInstance объекты (содержащий ObjectName и Имя класса Java) для выбранного MBeans.

Параметры:

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

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

Возвраты:

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

Броски:

IOException - Проблема коммуникации произошла когда говорящий с сервером MBean.

queryNames

Set<ObjectName> queryNames(ObjectName name,
                         QueryExp query)
                           throws IOException

Получает имена MBeans, которым управляет сервер MBean. Этот метод позволяет любому из следующих быть полученным: имена всего MBeans, имена ряда MBeans, определенного сопоставлением с образцом на ObjectName и/или выражение Запроса, определенное имя MBean (эквивалентный тестированию, регистрируется ли MBean). Когда имя объекта является нулем, или никакие доменные и ключевые свойства не определяются, все объекты выбираются (и фильтруются, если запрос определяется). Это возвращает набор ObjectNames для выбранного MBeans.

Параметры:

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

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

Возвраты:

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

Броски:

IOException - Проблема коммуникации произошла когда говорящий с сервером MBean.

isRegistered

boolean isRegistered(ObjectName name)
                     throws IOException

Проверки, регистрируется ли MBean, идентифицированный его именем объекта, уже, в сервере MBean.

Параметры:

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

Возвраты:

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

Броски:

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

IOException - Проблема коммуникации произошла когда говорящий с сервером MBean.

getMBeanCount

Integer getMBeanCount()
                      throws IOException

Возвращает число MBeans, зарегистрированного в сервере MBean.

Возвраты:

число MBeans зарегистрировалось.

Броски:

IOException - Проблема коммуникации произошла когда говорящий с сервером MBean.

getAttribute

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

Получает значение определенного атрибута именованного MBean. MBean идентифицируется его именем объекта.

Параметры:

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

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

Возвраты:

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

Броски:

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

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

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

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

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

IOException - Проблема коммуникации произошла когда говорящий с сервером MBean.

См. Также:

setAttribute(javax.management.ObjectName, javax.management.Attribute)

getAttributes

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

Получает значения нескольких атрибутов именованного MBean. MBean идентифицируется его именем объекта.

Если один или более атрибутов не могут быть получены по некоторым причинам, они будут опущены от возвращенного AttributeList. Вызывающая сторона должна проверить, что список является тем же самым размером как attributes массив. Чтобы обнаружить что проблема, которой препятствуют данный атрибут быть полученным, вызвать getAttribute для того атрибута.

Вот пример вызова этого метода и проверяя, что это преуспело в том, чтобы получить все требуемые атрибуты:

 String[] attrNames = ...;
 AttributeList list = mbeanServerConnection.getAttributes(objectName, attrNames);
 if (list.size() == attrNames.length)
     System.out.println("All attributes were retrieved successfully");
 else {
     List<String> missing = new ArrayList<String>(Arrays.asList(attrNames));
     for (Attribute a : list.asList())
         missing.remove(a.getName());
     System.out.println("Did not retrieve: " + missing);
 }
 

Параметры:

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

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

Возвраты:

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

Броски:

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

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

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

IOException - Проблема коммуникации произошла когда говорящий с сервером MBean.

См. Также:

setAttributes(javax.management.ObjectName, javax.management.AttributeList)

setAttribute

void setAttribute(ObjectName name,
                Attribute attribute)
                  throws InstanceNotFoundException,
                         AttributeNotFoundException,
                         InvalidAttributeValueException,
                         MBeanException,
                         ReflectionException,
                         IOException

Устанавливает значение определенного атрибута именованного MBean. MBean идентифицируется его именем объекта.

Параметры:

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

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

Броски:

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

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

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

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

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

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

IOException - Проблема коммуникации произошла когда говорящий с сервером MBean.

См. Также:

getAttribute(javax.management.ObjectName, java.lang.String)

setAttributes

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

Устанавливает значения нескольких атрибутов именованного MBean. MBean идентифицируется его именем объекта.

Если один или более атрибутов не могут быть установлены по некоторым причинам, они будут опущены от возвращенного AttributeList. Вызывающая сторона должна проверить что ввод AttributeList тот же самый размер как вывод один. Обнаружить, какую проблему, которой препятствуют данный атрибут быть полученным, обычно будет возможно вызвать setAttribute для того атрибута, хотя это, как гарантируют, не будет работать. (Например, значения двух атрибутов, возможно, были отклонены, потому что они были непоследовательны друг с другом. Установка одного из них один могла бы быть позволена.)

Вот пример вызова этого метода и проверяя, что это преуспело в том, чтобы установить все требуемые атрибуты:

 AttributeList inputAttrs = ...;
 AttributeList outputAttrs = mbeanServerConnection.setAttributes(objectName, inputAttrs);
 if (inputAttrs.size() == outputAttrs.size())
     System.out.println("All attributes were set successfully");
 else {
     List<String> missing = new ArrayList<String>();
     for (Attribute a : inputAttrs.asList())
         missing.add(a.getName());
     for (Attribute a : outputAttrs.asList())
         missing.remove(a.getName());
     System.out.println("Did not set: " + missing);
 }
 

Параметры:

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

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

Возвраты:

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

Броски:

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

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

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

IOException - Проблема коммуникации произошла когда говорящий с сервером MBean.

См. Также:

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

вызвать

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

Вызывает работу на MBean.

Из-за потребности в a signature чтобы дифференцировать возможно перегруженные операции, намного более просто вызвать операции через прокси MBean где только возможно. Например, предположите, что у Вас есть Стандартный интерфейс MBean как это:

 public interface FooMBean {
     public int countMatches(String[] patterns, boolean ignoreCase);
 }
 

countMatches работа может быть вызвана следующим образом:

 String[] myPatterns = ...;
 int count = (Integer) mbeanServerConnection.invoke(
         objectName,
         "countMatches",
         new Object[] {myPatterns, true},
         new String[] {String[].class.getName(), boolean.class.getName()});
 

Альтернативно, это может быть вызвано через прокси следующим образом:

 String[] myPatterns = ...;
 FooMBean fooProxy = JMX.newMBeanProxy(
         mbeanServerConnection, objectName, FooMBean.class);
 int count = fooProxy.countMatches(myPatterns, true);
 

Параметры:

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

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

params - Массив, содержащий параметры, которые будут установлены, когда работа вызывается

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

Возвраты:

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

Броски:

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

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

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

IOException - Проблема коммуникации произошла когда говорящий с сервером MBean.

getDefaultDomain

String getDefaultDomain()
                        throws IOException

Возвращает домен по умолчанию, используемый для того, чтобы назвать MBean. Доменное имя по умолчанию используется в качестве доменной части в ObjectName MBeans, если никакой домен не определяется пользователем.

Возвраты:

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

Броски:

IOException - Проблема коммуникации произошла когда говорящий с сервером MBean.

getDomains

String[] getDomains()
                    throws IOException

Возвращает список доменов, в которых в настоящий момент регистрируется любой MBean. Строка находится в возвращенном массиве, если и только если есть по крайней мере один MBean, зарегистрированный в ObjectName чей getDomain() равно той строке. Порядок строк в пределах возвращенного массива не определяется.

Возвраты:

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

Броски:

IOException - Проблема коммуникации произошла когда говорящий с сервером MBean.

addNotificationListener

void addNotificationListener(ObjectName name,
                           NotificationListener listener,
                           NotificationFilter filter,
                           Object handback)
                             throws InstanceNotFoundException,
                                    IOException

Добавляет слушатель зарегистрированного MBean. Уведомления, испускаемые MBean, будут пересланы слушателю.

Параметры:

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

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

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

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

Броски:

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

IOException - Проблема коммуникации произошла когда говорящий с сервером MBean.

См. Также:

removeNotificationListener(ObjectName, NotificationListener), removeNotificationListener(ObjectName, NotificationListener, NotificationFilter, Object)

addNotificationListener

void addNotificationListener(ObjectName name,
                           ObjectName listener,
                           NotificationFilter filter,
                           Object handback)
                             throws InstanceNotFoundException,
                                    IOException

Добавляет слушатель зарегистрированного MBean.

Уведомление, испускаемое MBean, будет переслано MBeanServer слушателю. Если источник уведомления будет ссылкой на объект MBean, то сервер MBean заменит это ObjectName того MBEAN. Иначе источник неизменен.

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

Параметры:

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

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

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

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

Броски:

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

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

IOException - Проблема коммуникации произошла когда говорящий с сервером MBean.

См. Также:

removeNotificationListener(ObjectName, ObjectName), removeNotificationListener(ObjectName, ObjectName, NotificationFilter, Object)

removeNotificationListener

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

Удаляет слушателя из зарегистрированного MBean.

Если слушатель будет зарегистрирован не раз, возможно с различными фильтрами или обратными вызовами, то этот метод удалит всю ту регистрацию.

Параметры:

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

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

Броски:

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

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

IOException - Проблема коммуникации произошла когда говорящий с сервером MBean.

См. Также:

addNotificationListener(ObjectName, ObjectName, NotificationFilter, Object)

removeNotificationListener

void removeNotificationListener(ObjectName name,
                              ObjectName listener,
                              NotificationFilter filter,
                              Object handback)
                                throws InstanceNotFoundException,
                                       ListenerNotFoundException,
                                       IOException

Удаляет слушателя из зарегистрированного MBean.

У MBean должен быть слушатель, который точно соответствует данный listener, filter, и handback параметры. Если есть больше чем один такой слушатель, только один удаляется.

filter и handback параметры могут быть нулем, если и только если они - нуль в слушателе, чтобы быть удаленными.

Параметры:

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

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

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

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

Броски:

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

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

IOException - Проблема коммуникации произошла когда говорящий с сервером MBean.

См. Также:

addNotificationListener(ObjectName, ObjectName, NotificationFilter, Object)

removeNotificationListener

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

Удаляет слушателя из зарегистрированного MBean.

Если слушатель будет зарегистрирован не раз, возможно с различными фильтрами или обратными вызовами, то этот метод удалит всю ту регистрацию.

Параметры:

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

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

Броски:

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

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

IOException - Проблема коммуникации произошла когда говорящий с сервером MBean.

См. Также:

addNotificationListener(ObjectName, NotificationListener, NotificationFilter, Object)

removeNotificationListener

void removeNotificationListener(ObjectName name,
                              NotificationListener listener,
                              NotificationFilter filter,
                              Object handback)
                                throws InstanceNotFoundException,
                                       ListenerNotFoundException,
                                       IOException

Удаляет слушателя из зарегистрированного MBean.

У MBean должен быть слушатель, который точно соответствует данный listener, filter, и handback параметры. Если есть больше чем один такой слушатель, только один удаляется.

filter и handback параметры могут быть нулем, если и только если они - нуль в слушателе, чтобы быть удаленными.

Параметры:

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

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

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

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

Броски:

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

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

IOException - Проблема коммуникации произошла когда говорящий с сервером MBean.

См. Также:

addNotificationListener(ObjectName, NotificationListener, NotificationFilter, Object)

getMBeanInfo

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

Этот метод обнаруживает атрибуты и операции, которые MBean представляет для управления.

Параметры:

name - Имя MBean, чтобы проанализировать

Возвраты:

Экземпляр MBeanInfo разрешение извлечения всех атрибутов и операций этого MBean.

Броски:

IntrospectionException - Исключение произошло во время самоанализа.

InstanceNotFoundException - Определенный MBean не был найден.

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

IOException - Проблема коммуникации произошла когда говорящий с сервером MBean.

isInstanceOf

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

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

Если name не называет MBean, этот метод броски InstanceNotFoundException.

Иначе, позволить
X быть MBean, названным name,
L быть ClassLoder X,
N быть именем класса в X MBeanInfo.

Если N равняется className, результатом является истина.

Иначе, если L успешно загружается className и X экземпляр этого класса, результатом является истина.

Иначе, если L успешно загружает и N и className, и второй класс присваиваем сначала, результатом является истина.

Иначе, результатом является ложь.

Параметры:

name - ObjectName из MBean.

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

Возвраты:

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

Броски:

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

IOException - Проблема коммуникации произошла когда говорящий с сервером MBean.

См. Также:

Class.isInstance(java.lang.Object)