Spec-Zone.ru › OpenJDK 21

Класс StandardMBean

java.lang.Object
javax.management.StandardMBean
Все реализованные интерфейсы:
DynamicMBean, MBeanRegistration
Прямые известные подклассы:
StandardEmitterMBean
public class StandardMBean extends Object implements DynamicMBean, MBeanRegistration

МBean, интерфейс управления которого определяется отражением по Java-интерфейсу.

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

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

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

Используя этот класс, МBean можно создать с любым именем реализующего класса Impl и с интерфейсом управления, определённым (как и в текущих стандартных МBean) любым интерфейсом 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.

Стандартные МBean, основанные на связи по именам между реализующим и интерфейсным классами, по-прежнему доступны.

Этот класс также может использоваться для построения MXBean. Использование точно такое же, как и для стандартных МBean, за исключением того, что в примерах выше параметр 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 и выбирая, является ли полученный МBean MXBean.
Создать DynamicMBean из объекта implementation, используя указанный класс mbeanInterface.
Создать DynamicMBean из объекта implementation, используя указанный класс mbeanInterface и выбирая, является ли полученный МBean 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, возвращаемом этим МBean.
protected MBeanConstructorInfo[] getConstructors(MBeanConstructorInfo[] ctors, Object impl)
Крючок для кастомизации: получить MBeanConstructorInfo[], которое будет использовано в MBeanInfo, возвращаемом этим МBean.
protected String getDescription(MBeanAttributeInfo info)
Крючок для кастомизации: получить описание, которое будет использовано в MBeanAttributeInfo, возвращаемом этим МBean.
protected String getDescription(MBeanConstructorInfo info)
Крючок для кастомизации: получить описание, которое будет использовано в MBeanConstructorInfo, возвращаемом этим МBean.
protected String getDescription(MBeanConstructorInfo ctor, MBeanParameterInfo param, int sequence)
Крючок для кастомизации: получить описание, которое будет использовано для параметра sequence MBeanParameterInfo MBeanConstructorInfo, возвращаемого этим МBean.
protected String getDescription(MBeanFeatureInfo info)
Крючок для кастомизации: получить описание, которое будет использовано в MBeanFeatureInfo, возвращаемом этим МBean.
protected String getDescription(MBeanInfo info)
Крючок для кастомизации: получить описание, которое будет использовано в MBeanInfo, возвращаемом этим МBean.
protected String getDescription(MBeanOperationInfo info)
Крючок для кастомизации: получить описание, которое будет использовано в MBeanOperationInfo, возвращаемом этим МBean.
protected String getDescription(MBeanOperationInfo op, MBeanParameterInfo param, int sequence)
Крючок для кастомизации: получить описание, которое будет использовано для параметра sequence MBeanParameterInfo MBeanOperationInfo, возвращаемого этим МBean.
protected int getImpact(MBeanOperationInfo info)
Крючок для кастомизации: получить флаг impact операции, который будет использован в MBeanOperationInfo, возвращаемом этим МBean.
Object getImplementation()
Получить реализацию этого стандартного МBean (или MXBean).
Class<?> getImplementationClass()
Получить класс реализации этого стандартного МBean (или MXBean).
MBeanInfo getMBeanInfo()
Получить MBeanInfo для этого МBean.
final Class<?> getMBeanInterface()
Получить интерфейс управления этого стандартного МBean (или MXBean).
protected String getParameterName(MBeanConstructorInfo ctor, MBeanParameterInfo param, int sequence)
Крючок для кастомизации: получить имя, которое будет использовано для параметра sequence MBeanParameterInfo MBeanConstructorInfo, возвращаемого этим МBean.
protected String getParameterName(MBeanOperationInfo op, MBeanParameterInfo param, int sequence)
Крючок для кастомизации: получить имя, которое будет использовано для параметра sequence MBeanParameterInfo MBeanOperationInfo, возвращаемого этим МBean.
Object invoke(String actionName, Object[] params, String[] signature)
Позволяет вызвать действие на Dynamic MBean.
void postDeregister()
Позволяет МBean выполнить необходимые операции после того, как он был дерегистрирован в сервере МBean.
void postRegister(Boolean registrationDone)
Позволяет МBean выполнить необходимые операции после того, как он был зарегистрирован в сервере МBean или после того, как регистрация завершилась ошибкой.
void preDeregister()
Позволяет МBean выполнить необходимые операции перед дерегистрацией сервером МBean.
ObjectName preRegister(MBeanServer server, ObjectName name)
Позволяет МBean выполнить необходимые операции перед регистрацией в сервере МBean.
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. Этот конструктор может использоваться для создания как стандартных 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. Этот конструктор может использоваться для создания как стандартных 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()

getImplementation

public Object getImplementation()
Получить реализацию этого Standard MBean (или MXBean).
Возвращает:
Реализация этого Standard MBean (или MXBean).
См. также:
  • setImplementation(java.lang.Object)

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, брошенное во время попытки вызвать метод получения.
См. также:
  • DynamicMBean.setAttribute(javax.management.Attribute)

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, брошенное во время попытки вызвать метод установки.
См. также:
  • DynamicMBean.getAttribute(java.lang.String)

getAttributes

public AttributeList getAttributes(String[] attributes)
Описание скопировано из интерфейса: DynamicMBean
Получить значения нескольких атрибутов Dynamic MBean.
Определено в:
getAttributes в интерфейсе DynamicMBean
Параметры:
attributes - Список атрибутов для извлечения.
Возвращает:
Список извлечённых атрибутов.
См. также:
  • DynamicMBean.setAttributes(javax.management.AttributeList)

setAttributes

public AttributeList setAttributes(AttributeList attributes)
Описание скопировано из интерфейса: DynamicMBean
Установить значения нескольких атрибутов Dynamic MBean.
Определено в:
setAttributes в интерфейсе DynamicMBean
Параметры:
attributes - Список атрибутов: идентификаторы атрибутов для установки и значения, на которые они должны быть установлены.
Возвращает:
Список атрибутов, которые были установлены с их новыми значениями.
См. также:
  • DynamicMBean.getAttributes(java.lang.String[])

invoke

public Object invoke(String actionName, Object[] params, String[] signature) throws MBeanException, ReflectionException
Описание, скопированное из интерфейса: DynamicMBean
Позволяет вызвать действие на динамическом 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, используя интерфейс управления, указанный для этого MBean.

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

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

getClassName

protected String getClassName(MBeanInfo info)
Метод настройки: Получить имя класса, которое будет использоваться в 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.
END_OF_DOCUMENT_MARKER

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(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. Для стандартных MBean она ничего больше не делает. Для MXBean она записывает параметры MBeanServer и ObjectName для использования при переводе ссылок между MXBean.

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

Определено в:
preRegister в интерфейсе MBeanRegistration
Параметры:
server - Сервер MBean, в котором будет зарегистрирован MBean.
name - Имя объекта MBean. Это имя равно null, если параметр name для одного из методов createMBean или registerMBean в интерфейсе MBeanServer равен null. В этом случае этот метод должен вернуть не-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 или после того, как регистрация завершилась неудачно.

Реализация по умолчанию этого метода ничего не делает для стандартных 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, 2023, 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.
https://docs.oracle.com/en/java/javase/21/docs/api/java.management/javax/management/StandardMBean.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API