Класс ModelMBeanAttributeInfo
- java.lang.Object
-
- javax.management.MBeanFeatureInfo
-
- javax.management.MBeanAttributeInfo
-
- javax.management.modelmbean.ModelMBeanAttributeInfo
- Все реализованные интерфейсы:
-
Serializable,Cloneable,DescriptorAccess,DescriptorRead
public class ModelMBeanAttributeInfo extends MBeanAttributeInfo implements DescriptorAccess
Объект ModelMBeanAttributeInfo описывает атрибут ModelMBean. Он является подклассом MBeanAttributeInfo с добавлением связанного описателя (Descriptor) и реализации интерфейса DescriptorAccess.
Поля в описателе определены, но не ограничиваются следующими. Обратите внимание, что когда Тип в этой таблице — Число, можно также использовать строку, являющуюся десятичным представлением Long.
| Имя | Тип | Значение |
|---|---|---|
| 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 | Сколько времени значение является действительным: <0 никогда, =0 всегда, >0 секунд. |
| lastUpdatedTimeStamp | Number | Когда было установлено значение. |
| visibility | Number | 1-4, где 1: всегда отображается, 4: редко отображается. |
| presentationString | String | Строка в формате XML для отображения данных. |
По умолчанию описатель содержит поля name, descriptorType и displayName. Значение по умолчанию для полей name и displayName — имя атрибута.
Примечание: из-за несоответствий в предыдущих версиях этой спецификации рекомендуется не использовать отрицательные или нулевые значения для currencyTimeLimit. Чтобы указать, что кешированное значение никогда не является действительным, опустите поле currencyTimeLimit. Чтобы указать, что оно всегда действительное, используйте очень большое число для этого поля.
serialVersionUID этого класса — 6181543027787327345L.
- C тех пор как:
- 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()
Возвращает копию связанного Descriptor для ModelMBeanAttributeInfo.
- Задано в:
-
getDescriptorв интерфейсеDescriptorRead - Переопределяет:
-
getDescriptorв классеMBeanFeatureInfo - Возвращает:
- Descriptor, связанный с объектом ModelMBeanAttributeInfo.
- См. также:
setDescriptor(javax.management.Descriptor)
setDescriptor
public void setDescriptor(Descriptor inDescriptor)
Устанавливает связанный Descriptor (полная замена) для ModelMBeanAttributeDescriptor. Если новый Descriptor равен null, связанный Descriptor возвращается к дескриптору по умолчанию. Descriptor валидируется перед назначением. Если новый Descriptor некорректен, будет брошено исключение RuntimeOperationsException, содержащее IllegalArgumentException.
- Задано в:
-
setDescriptorв интерфейсеDescriptorAccess - Параметры:
-
inDescriptor- заменяет Descriptor, связанный с ModelMBeanAttributeInfo - Исключения:
-
RuntimeOperationsException- Оборачивает IllegalArgumentException для некорректного Descriptor - См. также:
getDescriptor()
clone
public Object clone()
Создаёт и возвращает новый ModelMBeanAttributeInfo, являющийся дубликатом этого ModelMBeanAttributeInfo.
- Переопределяет:
-
cloneв классеMBeanAttributeInfo - Возвращает:
- клон этого экземпляра.
- Исключения:
-
RuntimeOperationsException- для некорректного значения для поля Names или поля Values. Если построение дескриптора завершилось неудачно по какой-либо причине, будет брошено это исключение. - См. также:
Cloneable
toString
public String toString()
Возвращает удобочитаемый вариант экземпляра ModelMBeanAttributeInfo.
© 1993, 2020, 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/11/docs/api/java.management/javax/management/modelmbean/ModelMBeanAttributeInfo.html