Пакет javax.management.openmbean

Предоставляет открытые типы данных и классы описателей Open MBean. Open MBean — это MBean, где типы атрибутов и параметров операций и возвращаемых значений построены с использованием небольшого набора предопределенных классов Java. Open MBeans облегчают работу с программами удаленного управления, которые не обязательно имеют доступ к типам, специфичным для приложения, включая программы, не написанные на Java.

Каждый MBean имеет MBeanInfo с информацией об самом MBean, его атрибутах, операциях, конструкторах и уведомлениях. В случае Open MBean этот MBeanInfo реализует интерфейс OpenMBeanInfo, обычно являясь экземпляром OpenMBeanInfoSupport.

Информация об атрибутах, возвращаемая MBeanInfo.getAttributes для Open MBean, представляет собой массив объектов, реализующих OpenMBeanAttributeInfo, обычно экземпляры OpenMBeanAttributeInfoSupport. В дополнение к обычной информации об атрибутах, OpenMBeanAttributeInfo задаёт OpenType атрибута. Возможные OpenType значения предопределены, что гарантирует, что удалённые менеджеры их поймут.

Аналогичные замечания относятся к типам параметров операций и конструкторов, а также к типам возвращаемых значений операций.

Существует различие между типом атрибута в языке Java, как возвращается getType(), и его OpenType, как возвращается getOpenType(). Например, если тип в языке Java — java.lang.String, то OpenType будет SimpleType.String. Если тип в языке Java — CompositeData, то OpenType будет CompositeType, который описывает элементы экземпляров CompositeData для атрибута.

Значения по умолчанию и ограничения

В Open MBeans атрибуты и параметры могут иметь значения по умолчанию и/или ограничения, ассоциированные с ними в OpenMBeanAttributeInfo или OpenMBeanParameterInfo. Существует два способа задания этих ограничений. Либо значения напрямую задаются как параметры одному из конструкторов OpenMBeanAttributeInfoSupport или OpenMBeanParameterInfoSupport, например, OpenMBeanParameterInfoSupport(String, String, OpenType, Object, Object[]); либо значения задаются в Descriptor, переданном в качестве параметра одному из конструкторов.

Когда используется Descriptor, поля для анализа — это:

• defaultValue определяет значение, возвращаемое getDefaultValue();
• minValue определяет значение, возвращаемое getMinValue();
• maxValue определяет значение, возвращаемое getMaxValue();
• legalValues определяет значения, возвращаемые getLegalValues().

Для defaultValue, minValue, и maxValue, соответствующее значение должно быть либо типа Java, соответствующего openType, либо строкой, которая может быть преобразована в этот тип. Преобразование использует статический метод valueOf(String) если такой найдётся; в противном случае — конструктор с единственным параметром String если такой найдётся; в противном случае — преобразование не выполняется.

Для legalValues, соответствующее значение должно быть либо массивом, либо Set, а элементы массива или множества должны быть преобразуемы, как описано для defaultValue и т. д.

Для этих полей должны выполняться следующие условия:

• значения должны быть соответствующего типа или строками, которые могут быть преобразованы в соответствующий тип, как описано выше;
• если legalValues присутствует, то ни minValue ни maxValue не должны присутствовать;
• если defaultValue присутствует, то оно должно удовлетворять ограничениям, определённым legalValues, minValue, или maxValue, когда любой из этих элементов также присутствует;
• если minValue и maxValue присутствуют одновременно, то minValue не должно быть больше maxValue.