Пакет javax.management.openmbean

Предоставляет типы открытых данных и классы дескрипторов Open MBean. Open MBean — это MBean, в котором типы атрибутов, параметров операций и возвращаемых значений формируются с использованием небольшого набора предопределённых классов Java. Open MBean упрощают взаимодействие с удалёнными программами управления, которые не обязательно имеют доступ к типам, специфичным для приложения, в том числе к типам, используемым в программах не на 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 MBean атрибуты и параметры могут иметь значения по умолчанию и/или связанные с ними ограничения, заданные в 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.