Класс 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

Краткое описание конструкторов

StandardMBean(Class<?> mbeanInterface)

StandardMBean(Class<?> mbeanInterface,
 boolean isMXBean)

StandardMBean(T implementation,
 Class<T> mbeanInterface)

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

Модификатор	Конструктор	Описание
`protected`	Создает DynamicMBean из `this`, используя указанный класс `mbeanInterface`.
`protected`	Создает DynamicMBean из `this`, используя указанный класс `mbeanInterface` и выбирая, будет ли результирующий MBean являться MXBean.
`<T>`	Создает DynamicMBean из объекта `implementation`, используя указанный класс `mbeanInterface`.
`<T>`	Создает 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)`	Точка расширения для настройки: получает className, который будет использоваться в 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)`	Точка расширения для настройки: получает описание, которое будет использоваться для MBeanParameterInfo с индексом `sequence` в 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)`	Точка расширения для настройки: получает описание, которое будет использоваться для MBeanParameterInfo с индексом `sequence` в MBeanOperationInfo, возвращаемом этим MBean.
`protected int`	`getImpact(MBeanOperationInfo info)`	Точка расширения для настройки: получает флаг `impact` операции, который будет использоваться в MBeanOperationInfo, возвращаемом этим MBean.
`Object`	`getImplementation()`	Получает реализацию этого стандартного MBean (или MXBean).
`Class<?>`	`getImplementationClass()`	Получает класс реализации этого стандартного MBean (или MXBean).
`MBeanInfo`	`getMBeanInfo()`	Получает `MBeanInfo` для этого MBean.
`final Class<?>`	`getMBeanInterface()`	Получает интерфейс управления этого стандартного MBean (или MXBean).
`protected String`	`getParameterName(MBeanConstructorInfo ctor, MBeanParameterInfo param, int sequence)`	Точка расширения для настройки: получает имя, которое будет использоваться для MBeanParameterInfo с индексом `sequence` в MBeanConstructorInfo, возвращаемом этим MBean.
`protected String`	`getParameterName(MBeanOperationInfo op, MBeanParameterInfo param, int sequence)`	Точка расширения для настройки: получает имя, которое будет использоваться для MBeanParameterInfo с индексом `sequence` в MBeanOperationInfo, возвращаемом этим 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)`	Заменяет объект реализации, обернутый в этот объект.

Методы, объявленные в классе Object

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

Модификатор и тип	Метод	Описание
`protected Object`	`clone()`	Создает и возвращает копию этого объекта.
`boolean`	`equals(Object obj)`	Показывает, равен ли этот объект другому объекту.
`protected void`	`finalize()`	Устарело, будет удалено: этот элемент API может быть удален в будущей версии. Финализация объявлена устаревшей и может быть удалена в одном из будущих выпусков.
`final Class<?>`	`getClass()`	Возвращает класс времени выполнения этого `Object`.
`int`	`hashCode()`	Возвращает хеш-код этого объекта.
`final void`	`notify()`	Пробуждает один поток, ожидающий на мониторе этого объекта.
`final void`	`notifyAll()`	Пробуждает все потоки, ожидающие на мониторе этого объекта.
`String`	`toString()`	Возвращает строковое представление объекта.
`final void`	`wait()`	Переводит текущий поток в состояние ожидания до его пробуждения, обычно в результате вызова метода notify или interrupt.
`final void`	`wait(long timeoutMillis)`	Переводит текущий поток в состояние ожидания до его пробуждения, обычно в результате вызова метода notify или interrupt, либо до истечения заданного промежутка реального времени.
`final void`	`wait(long timeoutMillis, int nanos)`	Переводит текущий поток в состояние ожидания до его пробуждения, обычно в результате вызова метода notify или interrupt, либо до истечения заданного промежутка реального времени.

Подробное описание конструкторов

StandardMBean

public <T> 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 <T> 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)

Создает DynamicMBean на основе this, используя указанный класс 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 — новая реализация этого Standard MBean (или MXBean). Объект implementation должен реализовывать интерфейс Standard MBean (или MXBean), переданный при создании этого StandardMBean.

Исключения:

IllegalArgumentException — если заданный implementation равен null.

NotCompliantMBeanException — если заданный implementation не реализует интерфейс Standard MBean (или MXBean), переданный при создании.

См. также:

getImplementation

public Object getImplementation()

Возвращает реализацию этого Standard MBean (или MXBean).

Возвращает:

Реализацию этого Standard MBean (или MXBean).

См. также:

getMBeanInterface

public final Class<?> getMBeanInterface()

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

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

getImplementationClass

public Class<?> getImplementationClass()

Возвращает класс реализации этого Standard MBean (или MXBean).

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

getAttribute

public Object getAttribute(String attribute) throws AttributeNotFoundException, MBeanException, ReflectionException

Описание скопировано из интерфейса: DynamicMBean

Получает значение указанного атрибута Dynamic MBean.

Определен в:

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

Параметры:

attribute — имя получаемого атрибута

Возвращает:

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

Исключения:

AttributeNotFoundException — если указанный атрибут не существует или его невозможно получить

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

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

См. также:

setAttribute

public void setAttribute(Attribute attribute) throws AttributeNotFoundException, InvalidAttributeValueException, MBeanException, ReflectionException

Описание скопировано из интерфейса: DynamicMBean

Задает значение указанного атрибута Dynamic MBean.

Определен в:

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

Параметры:

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

Исключения:

AttributeNotFoundException — если указанный атрибут не существует или его невозможно получить

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

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

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

См. также:

getAttributes

public AttributeList getAttributes(String[] attributes)

Описание скопировано из интерфейса: DynamicMBean

Получает значения нескольких атрибутов Dynamic MBean.

Определен в:

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

Параметры:

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

Возвращает:

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

См. также:

setAttributes

public AttributeList setAttributes(AttributeList attributes)

Описание скопировано из интерфейса: DynamicMBean

Задает значения нескольких атрибутов Dynamic MBean.

Определен в:

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

Параметры:

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

Возвращает:

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

См. также:

invoke

public Object invoke(String actionName, Object[] params, String[] signature) throws MBeanException, ReflectionException

Описание скопировано из интерфейса: DynamicMBean

Позволяет вызвать действие для Dynamic MBean.

Определен в:: invoke в интерфейсе DynamicMBean
Параметры:: actionName — имя вызываемого действия.; params — массив параметров, передаваемых при вызове действия.; signature — массив, содержащий сигнатуру действия. Объекты классов загружаются тем же загрузчиком классов, который использовался для загрузки MBean, для которого вызывается действие.
Возвращает:: Объект, возвращенный действием и представляющий результат вызова действия для указанного MBean.
Исключения:: MBeanException — оборачивает исключение java.lang.Exception, выброшенное вызванным методом MBean.; ReflectionException — оборачивает исключение java.lang.Exception, выброшенное при попытке вызвать метод.

getMBeanInfo

public MBeanInfo getMBeanInfo()

Возвращает MBeanInfo для этого MBean.

Этот метод реализует DynamicMBean.getMBeanInfo().

Сначала этот метод вызывает getCachedMBeanInfo(), чтобы получить кэшированный MBeanInfo для этого MBean, если он есть. Если MBeanInfo, возвращенный методом getCachedMBeanInfo(), не равен null, он возвращается.
В противном случае этот метод создает MBeanInfo по умолчанию для этого MBean, используя заданный для него интерфейс управления.

При создании MBeanInfo этот метод вызывает хуки настройки, позволяющие подклассам предоставлять собственные описания, имена параметров и т. д.
Наконец, он вызывает cacheMBeanInfo(), чтобы кэшировать новый MBeanInfo.

Определен в:: getMBeanInfo в интерфейсе DynamicMBean
Возвращает:: Кэшированный MBeanInfo для этого MBean, если он не равен null, или вновь созданный MBeanInfo, если кэшированного значения нет.

getClassName

protected String getClassName(MBeanInfo info)

Хук настройки: возвращает className, используемое в MBeanInfo, возвращаемом этим MBean.
Подклассы могут переопределить этот метод, чтобы предоставить собственное имя класса. Реализация по умолчанию возвращает info.getClassName().

Параметры:: info — MBeanInfo по умолчанию, полученный с помощью рефлексии.
Возвращает:: имя класса для нового MBeanInfo.

getDescription

protected String getDescription(MBeanInfo info)

Хук настройки: возвращает описание, используемое в MBeanInfo, возвращаемом этим MBean.
Подклассы могут переопределить этот метод, чтобы предоставить собственное описание MBean. Реализация по умолчанию возвращает info.getDescription().

Параметры:: info — MBeanInfo по умолчанию, полученный с помощью рефлексии.
Возвращает:: описание для нового MBeanInfo.

getDescription

protected String getDescription(MBeanFeatureInfo info)

Хук настройки: возвращает описание, используемое в MBeanFeatureInfo, возвращаемом этим MBean.

Подклассы могут переопределить этот метод, чтобы предоставить собственное описание. Реализация по умолчанию возвращает info.getDescription().

Этот метод вызывается методами getDescription(MBeanAttributeInfo), getDescription(MBeanOperationInfo), getDescription(MBeanConstructorInfo).

Параметры:: info — MBeanFeatureInfo по умолчанию, полученный с помощью рефлексии.
Возвращает:: описание для указанного MBeanFeatureInfo.

getDescription

protected String getDescription(MBeanAttributeInfo info)

Хук настройки: возвращает описание, используемое в MBeanAttributeInfo, возвращаемом этим MBean.

Подклассы могут переопределить этот метод, чтобы предоставить собственное описание. Реализация по умолчанию возвращает getDescription((MBeanFeatureInfo) info).

Параметры:: info — MBeanAttributeInfo по умолчанию, полученный с помощью рефлексии.
Возвращает:: описание для указанного MBeanAttributeInfo.

getDescription

protected String getDescription(MBeanConstructorInfo info)

Хук настройки: возвращает описание, используемое в MBeanConstructorInfo, возвращаемом этим MBean.
Подклассы могут переопределить этот метод, чтобы предоставить собственное описание. Реализация по умолчанию возвращает getDescription((MBeanFeatureInfo) info).

Параметры:: info — MBeanConstructorInfo по умолчанию, полученный с помощью рефлексии.
Возвращает:: описание для указанного MBeanConstructorInfo.

getDescription

protected String getDescription(MBeanConstructorInfo ctor, MBeanParameterInfo param, int sequence)

Хук настройки: возвращает описание для sequence MBeanParameterInfo объекта MBeanConstructorInfo, возвращаемого этим MBean.
Подклассы могут переопределить этот метод, чтобы предоставить собственное описание. Реализация по умолчанию возвращает param.getDescription().

Параметры:: ctor — MBeanConstructorInfo по умолчанию, полученный с помощью рефлексии.; param — MBeanParameterInfo по умолчанию, полученный с помощью рефлексии.; sequence — порядковый номер рассматриваемого параметра («0» для первого параметра, «1» для второго и т. д.).
Возвращает:: описание для указанного MBeanParameterInfo.

getParameterName

protected String getParameterName(MBeanConstructorInfo ctor, MBeanParameterInfo param, int sequence)

Хук настройки: возвращает имя для sequence MBeanParameterInfo объекта MBeanConstructorInfo, возвращаемого этим MBean.
Подклассы могут переопределить этот метод, чтобы указать собственное имя параметра. Реализация по умолчанию возвращает param.getName().

Параметры:: ctor — MBeanConstructorInfo по умолчанию, полученный с помощью рефлексии.; param — MBeanParameterInfo по умолчанию, полученный с помощью рефлексии.; sequence — порядковый номер рассматриваемого параметра («0» для первого параметра, «1» для второго и т. д.).
Возвращает:: имя для указанного MBeanParameterInfo.

getDescription

protected String getDescription(MBeanOperationInfo info)

Хук настройки: возвращает описание, используемое в MBeanOperationInfo, возвращаемом этим MBean.
Подклассы могут переопределить этот метод, чтобы предоставить собственное описание. Реализация по умолчанию возвращает getDescription((MBeanFeatureInfo) info).

Параметры:: info — MBeanOperationInfo по умолчанию, полученный с помощью рефлексии.
Возвращает:: описание для указанного MBeanOperationInfo.

getImpact

protected int getImpact(MBeanOperationInfo info)

Хук настройки: возвращает флаг impact операции, используемый в MBeanOperationInfo, возвращаемом этим MBean.
Подклассы могут переопределить этот метод, чтобы указать собственный флаг воздействия. Реализация по умолчанию возвращает info.getImpact().

Параметры:: info — MBeanOperationInfo по умолчанию, полученный с помощью рефлексии.
Возвращает:: флаг воздействия для указанного MBeanOperationInfo.

getParameterName

protected String getParameterName(MBeanOperationInfo op, MBeanParameterInfo param, int sequence)

Хук настройки: возвращает имя для sequence MBeanParameterInfo объекта MBeanOperationInfo, возвращаемого этим MBean.
Подклассы могут переопределить этот метод, чтобы указать собственное имя параметра. Реализация по умолчанию возвращает param.getName().

Параметры:: op — MBeanOperationInfo по умолчанию, полученный с помощью рефлексии.; param — MBeanParameterInfo по умолчанию, полученный с помощью рефлексии.; sequence — порядковый номер рассматриваемого параметра («0» для первого параметра, «1» для второго и т. д.).
Возвращает:: имя, используемое для указанного MBeanParameterInfo.

getDescription

protected String getDescription(MBeanOperationInfo op, MBeanParameterInfo param, int sequence)

Хук настройки: возвращает описание для sequence MBeanParameterInfo объекта MBeanOperationInfo, возвращаемого этим MBean.
Подклассы могут переопределить этот метод, чтобы предоставить собственное описание. Реализация по умолчанию возвращает param.getDescription().

Параметры:: op — MBeanOperationInfo по умолчанию, полученный с помощью рефлексии.; param — MBeanParameterInfo по умолчанию, полученный с помощью рефлексии.; sequence — порядковый номер рассматриваемого параметра («0» для первого параметра, «1» для второго и т. д.).
Возвращает:: описание для указанного MBeanParameterInfo.

getConstructors

protected MBeanConstructorInfo[] getConstructors(MBeanConstructorInfo[] ctors, Object impl)

Хук настройки: возвращает MBeanConstructorInfo[], используемый в MBeanInfo, возвращаемом этим MBean.
По умолчанию этот метод возвращает null, если обернутая реализация не является this. Действительно, если обернутая реализация — не сам этот объект, создать ее заново, вызывая конструкторы реализации через MBeanServer.createMBean(...), невозможно.
В противном случае, если обернутая реализация — это this, возвращается ctors.
При необходимости подклассы могут переопределить этот метод, чтобы изменить такое поведение.

Параметры:: ctors — MBeanConstructorInfo[] по умолчанию, полученный с помощью рефлексии.; impl — обернутая реализация. Если передано null, обернутая реализация игнорируется, а возвращается ctors.
Возвращает:: MBeanConstructorInfo[] для нового MBeanInfo.

getCachedMBeanInfo

protected MBeanInfo getCachedMBeanInfo()

Хук настройки: возвращает MBeanInfo, кэшированный для этого объекта.

Подклассы могут переопределить этот метод, чтобы реализовать собственную политику кэширования. Реализация по умолчанию хранит один объект MBeanInfo для каждого экземпляра.

Возвращает:

Кэшированный MBeanInfo или null, если MBeanInfo не кэширован.

См. также:

cacheMBeanInfo

protected void cacheMBeanInfo(MBeanInfo info)

Хук настройки: кэширует MBeanInfo, созданный для этого объекта.

Подклассы могут переопределить этот метод, чтобы реализовать собственную политику кэширования. Реализация по умолчанию сохраняет info в этом экземпляре. Подкласс может задать другую политику, например не сохранять info (чтобы он создавался заново при каждом вызове getMBeanInfo()) или использовать один общий объект MBeanInfo, если несколько экземпляров StandardMBean имеют одинаковые значения MBeanInfo.

Параметры:: info — новый MBeanInfo для кэширования. Все ранее кэшированные значения отбрасываются. Этот параметр может быть равен null, и в этом случае новое значение не кэшируется.

preRegister

public ObjectName preRegister(MBeanServer server, ObjectName name) throws Exception

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

Реализация этого метода по умолчанию возвращает параметр name. Для Standard MBean она больше ничего не делает. Для MXBean она сохраняет параметры MBeanServer и ObjectName, чтобы их можно было использовать для преобразования ссылок между MXBean.

Подклассу, переопределяющему этот метод, рекомендуется вызывать переопределенный метод через super.preRegister(...). Это необходимо, если на этот объект MXBean ссылаются атрибуты или операции других MXBean.

Определен в:: preRegister в интерфейсе MBeanRegistration
Параметры:: server — сервер MBean, на котором будет зарегистрирован MBean.; name — имя объекта MBean. Это имя равно null, если параметр имени в одном из методов createMBean или registerMBean интерфейса MBeanServer равен null. В таком случае этот метод должен вернуть ненулевой ObjectName для нового MBean.
Возвращает:: Имя, под которым регистрируется MBean. Это значение не должно быть null. Если параметр name не равен null, обычно, но не обязательно, возвращается именно он.
Исключения:: IllegalArgumentException — если это MXBean и name равен null.; InstanceAlreadyExistsException — если это MXBean и он уже зарегистрирован под другим именем (на этом или другом сервере MBean).; Exception — этот метод не выбрасывает других проверяемых исключений, однако Exception объявлен, чтобы подклассы могли переопределить метод и выбрасывать собственные исключения.
С версии:: 1.6

postRegister

public void postRegister(Boolean registrationDone)

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

Реализация этого метода по умолчанию ничего не делает для Standard MBean. Для MXBean она отменяет все действия, выполненные методом preRegister, если регистрация не удалась.

Подклассу, переопределяющему этот метод, рекомендуется вызывать переопределенный метод через super.postRegister(...). Это необходимо, если на этот объект MXBean ссылаются атрибуты или операции других MXBean.

Определен в:: postRegister в интерфейсе MBeanRegistration
Параметры:: registrationDone — указывает, был ли MBean успешно зарегистрирован на сервере MBean. Значение false означает, что этап регистрации завершился неудачей.
С версии:: 1.6

preDeregister

public void preDeregister() throws Exception

Позволяет MBean выполнить необходимые действия перед отменой его регистрации сервером MBean.

Реализация этого метода по умолчанию ничего не делает.

Подклассу, переопределяющему этот метод, рекомендуется вызывать переопределенный метод через super.preDeregister(...).

Определен в:: preDeregister в интерфейсе MBeanRegistration
Исключения:: Exception — этот метод не выбрасывает проверяемых исключений, однако Exception объявлен, чтобы подклассы могли переопределить метод и выбрасывать собственные исключения.
С версии:: 1.6

postDeregister

public void postDeregister()

Позволяет MBean выполнять любые операции, необходимые после его снятия с регистрации на сервере MBean.

Реализация этого метода по умолчанию ничего не делает для стандартных MBean. Для MXBean она удаляет все сведения, записанные методом preRegister.

При переопределении этого метода в подклассе рекомендуется вызывать переопределённый метод через super.postRegister(...). Это необходимо, если данный объект является MXBean, на который ссылаются атрибуты или операции других MXBean.

Указано в:: postDeregister в интерфейсе MBeanRegistration
С версии:: 1.6

© 1993, 2025, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.