Интерфейс CompositeDataView
- Все известные реализующие классы:
-
GarbageCollectionNotificationInfo,GcInfo
public interface CompositeDataView
Класс Java может реализовать этот интерфейс, чтобы указать, как его следует преобразовать в CompositeData с помощью фреймворка MXBean.
Типичный способ использования этого класса — добавление дополнительных элементов в CompositeData помимо тех, которые объявлены в CompositeType, предоставленных фреймворком MXBean. Для этого необходимо создать другой CompositeType, содержащий все те же элементы, плюс ваши дополнительные элементы.
Например, предположим, что у вас есть класс Measure, состоящий из строки с именем units и value, которая является либо long, либо double. Это может выглядеть так:
public class Measure implements CompositeDataView {
private String units;
private Number value; // a Long or a Double
public Measure(String units, Number value) {
this.units = units;
this.value = value;
}
public static Measure from(CompositeData cd) {
return new Measure((String) cd.get("units"),
(Number) cd.get("value"));
}
public String getUnits() {
return units;
}
// Can't be called getValue(), because Number is not a valid type
// in an MXBean, so the implied "value" property would be rejected.
public Number _getValue() {
return value;
}
public CompositeData toCompositeData(CompositeType ct) {
try {
List<String> itemNames = new ArrayList<String>(ct.keySet());
List<String> itemDescriptions = new ArrayList<String>();
List<OpenType<?>> itemTypes = new ArrayList<OpenType<?>>();
for (String item : itemNames) {
itemDescriptions.add(ct.getDescription(item));
itemTypes.add(ct.getType(item));
}
itemNames.add("value");
itemDescriptions.add("long or double value of the measure");
itemTypes.add((value instanceof Long) ? SimpleType.LONG :
SimpleType.DOUBLE);
CompositeType xct =
new CompositeType(ct.getTypeName(),
ct.getDescription(),
itemNames.toArray(new String[0]),
itemDescriptions.toArray(new String[0]),
itemTypes.toArray(new OpenType<?>[0]));
CompositeData cd =
new CompositeDataSupport(xct,
new String[] {"units", "value"},
new Object[] {units, value});
assert ct.isValue(cd); // check we've done it right
return cd;
} catch (Exception e) {
throw new RuntimeException(e);
}
}
}
CompositeType, которые будут отображаться в поле openType в Descriptor для атрибута или операции этого типа, будут отображать только элемент units, но фактический CompositeData, который генерируется, будет содержать как units, так и value.
- С:
- 1.6
- См. также:
Краткое описание методов
| Модификатор и тип | Метод | Описание |
|---|---|---|
CompositeData |
toCompositeData |
Возвращает CompositeData, соответствующий значениям в этом объекте. |
Подробное описание методов
toCompositeData
CompositeData toCompositeData(CompositeType ct)
Возвращает CompositeData, соответствующий значениям в этом объекте. Возвращаемое значение обычно должно быть экземпляром CompositeDataSupport, или класса, который сериализуется как CompositeDataSupport с помощью метода writeReplace. В противном случае удаленный клиент, получивший объект, может не суметь его восстановить.
- Параметры:
-
ct- ОжидаемыйCompositeTypeвозвращаемого значения. Если возвращаемое значение являетсяcd, тоcd.getCompositeType().equals(ct)должно быть true. Обычно это происходит потому, чтоcdявляетсяCompositeDataSupport, созданным сctв качестве егоCompositeType. - Возвращает:
- возвращаемое
CompositeData.
© 1993, 2023, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.
https://docs.oracle.com/en/java/javase/21/docs/api/java.management/javax/management/openmbean/CompositeDataView.html