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