Класс StandardMBean

java.lang.Object
- javax.management.StandardMBean

Все реализованные интерфейсы:: DynamicMBean, MBeanRegistration

Прямые известные подклассы:: StandardEmitterMBean

public class StandardMBean
extends Object
implements DynamicMBean, MBeanRegistration

Объект MBean, чьи интерфейсы управления определяются отражением на интерфейсе Java.

Этот класс добавляет больше гибкости понятию интерфейса управления при использовании стандартных объектов MBean. Прямое использование шаблонов для стандартных объектов MBean, описанных в спецификации JMX, означает, что существует фиксированное соответствие между реализующим классом объекта MBean и его интерфейсом управления (т. е., если реализующий класс — Thing, интерфейс управления должен быть ThingMBean). Этот класс позволяет сохранить удобство указания интерфейса управления с помощью интерфейса Java, не требуя, чтобы между реализующими и интерфейсными классами существовало какое-либо соответствие имён.

Превращая объект MBean в DynamicMBean, этот класс позволяет выбрать любой интерфейс, реализованный объектом MBean, в качестве его интерфейса управления, при условии, что он соответствует шаблонам JMX (т. е., атрибуты определяются через геттеры/сеттеры и т. д.).

Этот класс также предоставляет средства, позволяющие указать пользовательские описания и имена для MBeanInfo, возвращаемые интерфейсом DynamicMBean.

С помощью этого класса объект MBean можно создать с любым именем реализующего класса Impl и с интерфейсом управления, определённым (как и для текущих стандартных объектов MBean) любым интерфейсом Intf, одним из двух способов:

Использование публичного конструктора StandardMBean(impl,interface):

MBeanServer mbs;
     ...
     Impl impl = new Impl(...);
     StandardMBean mbean = new StandardMBean(impl, Intf.class, false);
     mbs.registerMBean(mbean, objectName);

Наследование от StandardMBean:

public class Impl extends StandardMBean implements Intf {
        public Impl() {
          super(Intf.class, false);
       }
       // implement methods of Intf
     }

     [...]

     MBeanServer mbs;
     ....
     Impl impl = new Impl();
     mbs.registerMBean(impl, objectName);

В любом случае класс Impl должен реализовывать интерфейс Intf.

Стандартные объекты MBean, основанные на соответствии имён между реализующими и интерфейсными классами, по-прежнему доступны.

Этот класс также может быть использован для построения MXBean. Использование такое же, как и для стандартных объектов MBean, за исключением того, что в примерах выше параметр false конструктору или вызов super(...) заменяется на true.

С момента:: 1.5

Конструкторы

Модификатор	Конструктор и описание
`protected`	`StandardMBean(Class<?> mbeanInterface)` Создать DynamicMBean из `this`, используя указанный класс `mbeanInterface`.
`protected`	`StandardMBean(Class<?> mbeanInterface, boolean isMXBean)` Создать DynamicMBean из `this`, используя указанный класс `mbeanInterface`, и выбрать, является ли полученный MBean MXBean.
	`StandardMBean(T implementation, Class<T> mbeanInterface)` Создать DynamicMBean из объекта `implementation`, используя указанный класс `mbeanInterface`.
	`StandardMBean(T implementation, Class<T> mbeanInterface, boolean isMXBean)` Создать DynamicMBean из объекта `implementation`, используя указанный класс `mbeanInterface`, и выбрать, является ли полученный MBean MXBean.

Методы

Модификатор и тип	Метод и описание
`protected void`	`cacheMBeanInfo(MBeanInfo info)` Обработчик настройки: кэширование MBeanInfo, созданного для этого объекта.
`Object`	`getAttribute(String attribute)` Получение значения определенного атрибута Dynamic MBean.
`AttributeList`	`getAttributes(String[] attributes)` Получение значений нескольких атрибутов Dynamic MBean.
`protected MBeanInfo`	`getCachedMBeanInfo()` Обработчик настройки: возвращение кэшированного MBeanInfo для этого объекта.
`protected String`	`getClassName(MBeanInfo info)` Обработчик настройки: получение имени класса, которое будет использовано в MBeanInfo, возвращаемом этим MBean.
`protected MBeanConstructorInfo[]`	`getConstructors(MBeanConstructorInfo[] ctors, Object impl)` Обработчик настройки: получение MBeanConstructorInfo[], которое будет использовано в MBeanInfo, возвращаемом этим MBean.
`protected String`	`getDescription(MBeanAttributeInfo info)` Обработчик настройки: получение описания, которое будет использовано в MBeanAttributeInfo, возвращаемом этим MBean.
`protected String`	`getDescription(MBeanConstructorInfo info)` Обработчик настройки: получение описания, которое будет использовано в MBeanConstructorInfo, возвращаемом этим MBean.
`protected String`	`getDescription(MBeanConstructorInfo ctor, MBeanParameterInfo param, int sequence)` Обработчик настройки: получение описания, которое будет использовано для `sequence` MBeanParameterInfo MBeanConstructorInfo, возвращаемого этим MBean.
`protected String`	`getDescription(MBeanFeatureInfo info)` Обработчик настройки: получение описания, которое будет использовано в MBeanFeatureInfo, возвращаемом этим MBean.
`protected String`	`getDescription(MBeanInfo info)` Обработчик настройки: получение описания, которое будет использовано в MBeanInfo, возвращаемом этим MBean.
`protected String`	`getDescription(MBeanOperationInfo info)` Обработчик настройки: получение описания, которое будет использовано в MBeanOperationInfo, возвращаемом этим MBean.
`protected String`	`getDescription(MBeanOperationInfo op, MBeanParameterInfo param, int sequence)` Обработчик настройки: получение описания, которое будет использовано для `sequence` MBeanParameterInfo MBeanOperationInfo, возвращаемого этим MBean.
`protected int`	`getImpact(MBeanOperationInfo info)` Обработчик настройки: получение флага `impact` операции, который будет использован в MBeanOperationInfo, возвращаемом этим MBean.

`Object`	`getImplementation()` Получить реализацию этого Standard MBean (или MXBean).
`Class<?>`	`getImplementationClass()` Получить класс реализации этого Standard MBean (или MXBean).
`MBeanInfo`	`getMBeanInfo()` Получить `MBeanInfo` для этого MBean.
`Class<?>`	`getMBeanInterface()` Получить интерфейс управления для этого Standard MBean (или MXBean).
`protected String`	`getParameterName(MBeanConstructorInfo ctor, MBeanParameterInfo param, int sequence)` Дополнительный метод настройки: получить имя, которое будет использовано для `последовательности` MBeanParameterInfo конструктора MBean, возвращаемого этим MBean.
`protected String`	`getParameterName(MBeanOperationInfo op, MBeanParameterInfo param, int sequence)` Дополнительный метод настройки: получить имя, которое будет использовано для `последовательности` MBeanParameterInfo оператора MBean, возвращаемого этим MBean.
`Object`	`invoke(String actionName, Object[] params, String[] signature)` Позволяет вызвать действие на Dynamic MBean.
`void`	`postDeregister()` Позволяет MBean выполнить все необходимые операции после того, как он был дерегистрирован в сервере MBean.
`void`	`postRegister(Boolean registrationDone)` Позволяет MBean выполнить все необходимые операции после регистрации в сервере MBean или после того, как регистрация завершилась неудачей.
`void`	`preDeregister()` Позволяет MBean выполнить все необходимые операции перед дерегистрацией сервером MBean.
`ObjectName`	`preRegister(MBeanServer server, ObjectName name)` Позволяет MBean выполнить все необходимые операции перед регистрацией в сервере MBean.
`void`	`setAttribute(Attribute attribute)` Установить значение определенного атрибута Dynamic MBean.
`AttributeList`	`setAttributes(AttributeList attributes)` Устанавливает значения нескольких атрибутов Dynamic MBean.
`void`	`setImplementation(Object implementation)` Заменить объект реализации, обернутый в этом объекте.

Методы, унаследованные от класса java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Конструкторы

StandardMBean

public StandardMBean(T implementation,
                     Class<T> mbeanInterface)
              throws NotCompliantMBeanException

Создать DynamicMBean из объекта implementation, используя указанный класс mbeanInterface.

Параметры типа:: T - Позволяет компилятору проверить, что implementation действительно реализует класс, описанный в mbeanInterface. Компилятор может проверить это только если mbeanInterface является литералом класса, например, MyMBean.class.
Параметры:: implementation - Реализация данного MBean.; mbeanInterface - Интерфейс управления, экспортируемый реализацией данного MBean. Если null, этот объект будет использовать стандартную схему проектирования JMX для определения интерфейса управления, связанного с данной реализацией.
Исключения:: IllegalArgumentException - если заданный implementation равен null.; NotCompliantMBeanException - если mbeanInterface не соответствует паттернам проектирования JMX для интерфейсов управления, или если заданный implementation не реализует указанный интерфейс.

StandardMBean

protected StandardMBean(Class<?> mbeanInterface)
                 throws NotCompliantMBeanException

Создать DynamicMBean из this, используя указанный класс mbeanInterface.

Вызывает this(this,mbeanInterface). Этот конструктор предназначен для подклассов.

Параметры:: mbeanInterface - Интерфейс управления, экспортируемый данным MBean.
Исключения:: NotCompliantMBeanException - если mbeanInterface не соответствует паттернам проектирования JMX для интерфейсов управления, или если this не реализует указанный интерфейс.

StandardMBean

public StandardMBean(T implementation,
                     Class<T> mbeanInterface,
                     boolean isMXBean)

Создать DynamicMBean из объекта implementation, используя указанный класс mbeanInterface и выбор, является ли результирующий MBean MXBean. Этот конструктор может использоваться для создания как Standard MBean, так и MXBean. В отличие от конструктора StandardMBean(Object, Class), он не выбрасывает исключение NotCompliantMBeanException.

Параметры типа:: T - Позволяет компилятору проверить, что implementation действительно реализует класс, описанный в mbeanInterface. Компилятор может проверить это только если mbeanInterface является литералом класса, например, MyMBean.class.
Параметры:: implementation - Реализация данного MBean.; mbeanInterface - Управляющий интерфейс, экспортируемый реализацией этого MBean. Если null, этот объект будет использовать стандартную модель проектирования JMX для определения управляющего интерфейса, связанного с данной реализацией.; isMXBean - Если true, параметр mbeanInterface указывает на интерфейс MXBean, и полученный MBean является MXBean.
Исключения:: IllegalArgumentException - если заданная implementation равна null, или если mbeanInterface не соответствует паттернам проектирования JMX для управляющих интерфейсов, или если заданная implementation не реализует указанный интерфейс.
С:: 1.6

StandardMBean

protected StandardMBean(Class<?> mbeanInterface,
                        boolean isMXBean)

Преобразуйте this в DynamicMBean, используя указанный класс mbeanInterface и выбирая, будет ли полученный MBean MXBean. Этот конструктор может использоваться для создания как Standard MBean, так и MXBean. В отличие от конструктора StandardMBean(Object, Class), он не вызывает NotCompliantMBeanException.

Вызывает this(this, mbeanInterface, isMXBean). Этот конструктор предназначен для подклассов.

Параметры:: mbeanInterface - Управляющий интерфейс, экспортируемый этим MBean.; isMXBean - Если true, параметр mbeanInterface указывает на интерфейс MXBean, и полученный MBean является MXBean.
Исключения:: IllegalArgumentException - если mbeanInterface не соответствует паттернам проектирования JMX для управляющих интерфейсов, или если this не реализует указанный интерфейс.
С:: 1.6

Методы

setImplementation

public void setImplementation(Object implementation)
                       throws NotCompliantMBeanException

Заменить объект реализации, заключенный в этот объект.

Параметры:: implementation - Новая реализация этого стандартного MBean (или MXBean). Объект implementation должен реализовывать интерфейс стандартного MBean (или MXBean), который был предоставлен при создании этого StandardMBean.
Исключения:: IllegalArgumentException - если переданный implementation равен null.; NotCompliantMBeanException - если переданный implementation не реализует интерфейс стандартного MBean (или MXBean), предоставленный при создании.
См. также:: getImplementation()

getImplementation

public Object getImplementation()

Получить реализацию этого стандартного MBean (или MXBean).

Возвращает:: Реализация этого стандартного MBean (или MXBean).
См. также:: setImplementation(java.lang.Object)

getMBeanInterface

public final Class<?> getMBeanInterface()

Получить интерфейс управления этого стандартного MBean (или MXBean).

Возвращает:: Интерфейс управления этого стандартного MBean (или MXBean).

getImplementationClass

public Class<?> getImplementationClass()

Получить класс реализации этого стандартного MBean (или MXBean).

Возвращает:: Класс реализации этого стандартного MBean (или MXBean).