Пакет 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.