Пакет 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, связанное значение должно быть либо массивом, либо множеством, а элементы массива или множества должны быть преобразуемы, как описано для defaultValue и т.д.

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

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