Пакет javax.management.modelmbean

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

Модель 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"