Descripción de MBean estándar

Question

Quiero hacer que mi MBean estándar sea detallado en JBoss jmx-console. DynamicMBean tiene getMBeanInfo() para hacerlo. El método devuelve MBeanInfo con la descripción de MBean. Pero, ¿cómo puedo hacer lo mismo con Standard MBean? P.ej. He siguiente interfaz MBean:

public interface MyMBean { 
    String f(); 
} 

... con la siguiente implementación:

public class My implements MyMBean { 
    public String f() { 
    return "test"; 
    } 
} 

Lo que se debe hacer para añadir una descripción en estos ejemplos?

Gracias

Answer 1

Para StandardMBeans no hay manera para añadir descripción u otra información meta.

Desde el JavaDoc de MBeanInfo:

Los detalles restantes de la MBeanInfo para un MBean estándar no se especifican. Esto incluye la descripción de MBeanInfo y de los constructores, atributos, operaciones y notificaciones contenidos; y los nombres y descripciones de parámetros para constructores y operaciones.

Por lo tanto, debe utilizar al menos DynamicMBeans (o un ModelMBean o OpenMBean) para especificar esta información. Spring puede ayudarlo en la medida en que permite la creación de DynamicMBeans a través de anotaciones, que al final es incluso más fácil de usar que escribir sus propios StandardMBeans. Ejemplo (de la documentación de primavera):

@ManagedResource(objectName="bean:name=testBean4", 
       description="My Managed Bean") 
public class AnnotationTestBean { 

    private int age; 

    @ManagedAttribute(description="The Age Attribute", currencyTimeLimit=15) 
    public int getAge() { 
     return age; 
    } 
} 

Ver this article para más detalles.

Answer 2

Puede hacerlo a través de un xmbean-descriptor sin la necesidad de modificar el código fuente de mbean existente.

Consulte How to add description for MBean method to see it in jmx-console of JBOSS para una respuesta a esto.

Answer 3

La forma de obtener la información de descripción de las anotaciones de Spring @ Managed * es solo para declarar un Spring "bean administrado" estándar, y no un MBean o MXBean.

Para hacer esto, en su ejemplo, no debe implementar la interfaz con el sufijo "MBean". Luego, el bean se detectará como un "bean administrado" estándar cuando MBeanExporter registrará BeanInstance (..), y se convertirá a un ModelMBean usando todas las anotaciones de primavera, incluyendo descripciones de atributos, operaciones, parámetros, etc.

Como requisito, se debe declarar en su contexto la primavera del MBeanExporter con AnnotationJmxAttributeSource, MetadataNamingStrategy, y MetadataMBeanInfoAssembler atributos, que se puede simplificarse así:

<bean id="mbeanExporter" 
    class="org.springframework.jmx.export.annotation.AnnotationMBeanExporter" /> 

o

<context:mbean-export /> 

Y el bean administrado debe tener este aspecto (como se explica por Roland):

@Component("myManagedBean") 
@ManagedResource(objectName="your.domain.jmx:name=MyMBean", 
       description="My MBean goal") 
public class AnnotationTestBean { 

    private int age; 

    @ManagedAttribute(description="The age attribute", currencyTimeLimit=15) 
    public int getAge() { 
     return age; 
    } 

    @ManagedOperation(description = "Check permissions for the given activity") 
    @ManagedOperationParameters({ 
     @ManagedOperationParameter(name = "activity", 
            description = "The activity to check") 
    }) 
    public boolean isAllowedTo(final String activity) { 
     // impl 
    } 
} 

Recuerde que no implementa una interfaz MBean, lo que sería un StandardMBean !!