Пакет javax.management.modelmbean

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

Model MBean реализует интерфейс ModelMBean. Это DynamicMBean, метод getMBeanInfo которого возвращает объект, реализующий ModelMBeanInfo.

Каждый MBean имеет MBeanInfo со сведениями о самом MBean, его атрибутах, операциях, конструкторах и уведомлениях. Model MBean дополняет этот MBeanInfo объектами Descriptor, кодирующими дополнительные сведения в виде пар (ключ, значение). Обычно объекты Descriptor являются экземплярами класса DescriptorSupport.

Класс RequiredModelMBean предоставляет стандартную реализацию Model MBean.

В следующем примере показано, как Model MBean используется для предоставления метода get класса HashMap для управления через сервер MBean. Другие методы через сервер MBean недоступны. В данном случае в HashMap нет ничего особенного. Таким же образом для управления можно открыть общедоступные методы любого общедоступного класса.

import java.lang.reflect.Method;
import java.util.HashMap;
import javax.management.*;
import javax.management.modelmbean.*;

// ...

MBeanServer mbs = MBeanServerFactory.createMBeanServer();
// The MBean Server

HashMap map = new HashMap();
// The resource that will be managed

// Construct the management interface for the Model MBean
Method getMethod = HashMap.class.getMethod("get", new Class[] {Object.class});
ModelMBeanOperationInfo getInfo =
    new ModelMBeanOperationInfo("Get value for key", getMethod);
ModelMBeanInfo mmbi =
    new ModelMBeanInfoSupport(HashMap.class.getName(),
                  "Map of keys and values",
                  null,  // no attributes
                  null,  // no constructors
                  new ModelMBeanOperationInfo[] {getInfo},
                  null); // no notifications

// Make the Model MBean and link it to the resource
ModelMBean mmb = new RequiredModelMBean(mmbi);
mmb.setManagedResource(map, "ObjectReference");

// Register the Model MBean in the MBean Server
ObjectName mapName = new ObjectName(":type=Map,name=whatever");
mbs.registerMBean(mmb, mapName);

// Resource can evolve independently of the MBean
map.put("key", "value");

// Can access the "get" method through the MBean Server
mbs.invoke(mapName, "get", new Object[] {"key"}, new String[] {Object.class.getName()});
// returns "value"
    

Спецификация пакета

• См. Спецификацию JMX 1.4 Спецификация JMX, версия 1.4