Класс ModelMBeanAttributeInfo

javax.management.modelmbean.ModelMBeanAttributeInfo

Все реализуемые интерфейсы:: Serializable, Cloneable, DescriptorAccess, DescriptorRead

public class ModelMBeanAttributeInfo extends MBeanAttributeInfo implements DescriptorAccess

Объект ModelMBeanAttributeInfo описывает атрибут ModelMBean. Он является подклассом MBeanAttributeInfo с добавлением связанного описателя (Descriptor) и реализацией интерфейса DescriptorAccess.

Поля в описателе определены, но не ограничиваются следующими. Обратите внимание, что когда Тип в этой таблице является Number, строка, которая является десятичным представлением Long, также может быть использована.

ModelMBeanAttributeInfo Fields
Имя	Тип	Значение
name	String	Имя атрибута.
descriptorType	String	Должно быть "attribute".
value	Object	Текущее (кешированное) значение атрибута.
default	Object	Значение по умолчанию для атрибута.
displayName	String	Имя атрибута, используемое в отображениях.
getMethod	String	Имя описателя операции для метода get.
setMethod	String	Имя описателя операции для метода set.
protocolMap	Descriptor	См. раздел "Поддержка карты протоколов" в документе спецификации JMX. Сопоставления должны быть подходящими для атрибута, и записи могут быть обновлены или дополнены во время выполнения.
persistPolicy	String	Один из: OnUpdate\|OnTimer\|NoMoreOftenThan\|OnUnregister\|Always\|Never. См. раздел "Поля описателя MBean" в документе спецификации JMX.
persistPeriod	Number	Частота цикла сохранения в секундах. Используется, когда persistPolicy равно "OnTimer" или "NoMoreOftenThan".
currencyTimeLimit	Number	Время, в течение которого значение value является действительным: <0 никогда, =0 всегда, >0 секунд.
lastUpdatedTimeStamp	Number	Время, когда значение value было установлено.
visibility	Number	1-4, где 1: всегда видимый, 4: редко видимый.
presentationString	String	XML-форматированная строка для отображения данных.

По умолчанию описатель содержит поля name, descriptorType и displayName. Значение по умолчанию для полей name и displayName — это имя атрибута.

Примечание: из-за несоответствий в предыдущих версиях этой спецификации рекомендуется не использовать отрицательные или нулевые значения для currencyTimeLimit. Чтобы указать, что кэшированное значение никогда не является действительным, опустите поле currencyTimeLimit. Чтобы указать, что оно всегда действительное, используйте очень большое число для этого поля.

serialVersionUID этого класса — 6181543027787327345L.

С:

1.5

См. также:

Краткое описание полей

Поля, объявленные в классе javax.management.MBeanFeatureInfo

description, name

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

Конструктор	Описание
`ModelMBeanAttributeInfo(String name, String description, Method getter, Method setter)`	Создает объект ModelMBeanAttributeInfo с описателем по умолчанию.
`ModelMBeanAttributeInfo(String name, String description, Method getter, Method setter, Descriptor descriptor)`	Создает объект ModelMBeanAttributeInfo.
`ModelMBeanAttributeInfo(String name, String type, String description, boolean isReadable, boolean isWritable, boolean isIs)`	Создает объект ModelMBeanAttributeInfo с описателем по умолчанию.
`ModelMBeanAttributeInfo(String name, String type, String description, boolean isReadable, boolean isWritable, boolean isIs, Descriptor descriptor)`	Создает объект ModelMBeanAttributeInfo.
`ModelMBeanAttributeInfo(ModelMBeanAttributeInfo inInfo)`	Создает новый объект ModelMBeanAttributeInfo из этого объекта ModelMBeanAttributeInfo.

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

Модификатор и тип	Метод	Описание
`Object`	`clone()`	Создаёт и возвращает новый ModelMBeanAttributeInfo, который является дубликатом данного ModelMBeanAttributeInfo.
`Descriptor`	`getDescriptor()`	Получает копию связанного описателя (Descriptor) для ModelMBeanAttributeInfo.
`void`	`setDescriptor(Descriptor inDescriptor)`	Устанавливает связанный описатель (Descriptor) (полная замена) для ModelMBeanAttributeDescriptor.
`String`	`toString()`	Возвращает удобочитаемую версию экземпляра ModelMBeanAttributeInfo.

Методы, объявленные в классе javax.management.MBeanAttributeInfo

equals, getType, isIs, isReadable, isWritable

Методы, объявленные в классе javax.management.MBeanFeatureInfo

getDescription, getName

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

finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

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

ModelMBeanAttributeInfo

public ModelMBeanAttributeInfo(String name, String description, Method getter, Method setter) throws IntrospectionException

Создаёт объект ModelMBeanAttributeInfo с дескриптором по умолчанию. Descriptor созданного объекта будет включать поля, вносимые любыми аннотациями на объектах Method, содержащих мета-аннотацию DescriptorKey.

Параметры:: name - Имя атрибута.; description - Читабельное описание атрибута. Необязательно.; getter - Метод для чтения значения атрибута. Может быть null, если свойство только для записи.; setter - Метод для записи значения атрибута. Может быть null, если атрибут только для чтения.
Исключения:: IntrospectionException - Проблема согласованности в определении этого атрибута.

ModelMBeanAttributeInfo

public ModelMBeanAttributeInfo(String name, String description, Method getter, Method setter, Descriptor descriptor) throws IntrospectionException

Создаёт объект ModelMBeanAttributeInfo. Descriptor созданного объекта будет включать поля, вносимые любыми аннотациями на объектах Method, содержащих мета-аннотацию DescriptorKey.

Параметры:: name - Имя атрибута.; description - Читабельное описание атрибута. Необязательно.; getter - Метод для чтения значения атрибута. Может быть null, если свойство только для записи.; setter - Метод для записи значения атрибута. Может быть null, если атрибут только для чтения.; descriptor - Экземпляр Descriptor, содержащий соответствующие метаданные для этого экземпляра атрибута. Если null, то будет создан дескриптор по умолчанию. Если дескриптор не содержит поля "displayName", это поле добавляется в дескриптор со значением по умолчанию.
Исключения:: IntrospectionException - Проблема согласованности в определении этого атрибута.; RuntimeOperationsException - Обёртка IllegalArgumentException. Дескриптор некорректен, или поле дескриптора "name" не равно параметру name, или поле дескриптора "descriptorType" не равно "attribute".

ModelMBeanAttributeInfo

public ModelMBeanAttributeInfo(String name, String type, String description, boolean isReadable, boolean isWritable, boolean isIs)

Создаёт объект ModelMBeanAttributeInfo с дескриптором по умолчанию.

Параметры:: name - Имя атрибута; type - Тип или имя класса атрибута; description - Читабельное описание атрибута.; isReadable - True, если атрибут имеет метод getter, иначе false.; isWritable - True, если атрибут имеет метод setter, иначе false.; isIs - True, если атрибут имеет метод getter "is", иначе false.

ModelMBeanAttributeInfo

public ModelMBeanAttributeInfo(String name, String type, String description, boolean isReadable, boolean isWritable, boolean isIs, Descriptor descriptor)

Создаёт объект ModelMBeanAttributeInfo.

Параметры:: name - Имя атрибута; type - Тип или имя класса атрибута; description - Читабельное описание атрибута.; isReadable - True, если атрибут имеет метод getter, иначе false.; isWritable - True, если атрибут имеет метод setter, иначе false.; isIs - True, если атрибут имеет метод getter "is", иначе false.; descriptor - Экземпляр Descriptor, содержащий соответствующие метаданные для этого экземпляра атрибута. Если null, то будет создан дескриптор по умолчанию. Если дескриптор не содержит поля "displayName", это поле добавляется в дескриптор со значением по умолчанию.
Исключения:: RuntimeOperationsException - Обёртка IllegalArgumentException для некорректного дескриптора.

ModelMBeanAttributeInfo

public ModelMBeanAttributeInfo(ModelMBeanAttributeInfo inInfo)

Создаёт новый объект ModelMBeanAttributeInfo из этого объекта ModelMBeanAttributeInfo. Будет создан дескриптор по умолчанию.

Параметры:: inInfo - дублируемый ModelMBeanAttributeInfo

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

getDescriptor

public Descriptor getDescriptor()

Возвращает копию связанного дескриптора для ModelMBeanAttributeInfo.

Задано:

getDescriptor в интерфейсе DescriptorRead

Переопределяет:

getDescriptor в классе MBeanFeatureInfo

Возвращает:

Дескриптор, связанный с объектом ModelMBeanAttributeInfo.

См. также:

setDescriptor

public void setDescriptor(Descriptor inDescriptor)

Устанавливает связанный дескриптор (полная замена) для ModelMBeanAttributeDescriptor. Если новый дескриптор null, то связанный дескриптор возвращается к дескриптору по умолчанию. Дескриптор проверяется на валидность перед назначением. Если новый дескриптор невалиден, вызывается RuntimeOperationsException, обёрнутая в IllegalArgumentException.

Задано:

setDescriptor в интерфейсе DescriptorAccess

Параметры:

inDescriptor - заменяет дескриптор, связанный с ModelMBeanAttributeInfo

Исключения:

RuntimeOperationsException - Обёртка IllegalArgumentException для некорректного дескриптора

См. также:

clone

public Object clone()

Создаёт и возвращает новый ModelMBeanAttributeInfo, являющийся дубликатом этого ModelMBeanAttributeInfo.

Переопределяет:

clone в классе MBeanAttributeInfo

Возвращает:

клонированный экземпляр.

Исключения:

RuntimeOperationsException - для некорректного значения для поля Имена или поля Значения. Если создание дескриптора завершается ошибкой по какой-либо причине, это исключение будет вызвано.

См. также:

toString

public String toString()

Возвращает читабельное представление экземпляра ModelMBeanAttributeInfo.

Переопределяет:: toString в классе Object
Возвращает:: строковое представление объекта

© 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.
https://download.java.net/java/early_access/jdk24/docs/api/java.management/javax/management/modelmbean/ModelMBeanAttributeInfo.html