Пакет javax.management.openmbean

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

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

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

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

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

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

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

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

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