spring通过annotation注册MBean到JMX

1、前言

JMX管理及使用日趋成熟。spring对bean的管理功能也很强大，通过annotation把某些方法暴露成MBean，然后通过JMX远程管理，在某些场景下会带来意想不到的效果。

 

本文只介绍两个内容：spring通过annotation暴露MBean、相关的xml配置。

 

 

2、spring通过annotation暴露MBean

 

      2.1   涉及到三个重要的annotation：@ManagedResource @ManagedAttribute 和 @ManagedOperation。

 

用途	Commons Attributes属性	JDK 5.0注解	属性/注解类型
将类的所有实例标识为JMX受控资源	ManagedResource	@ManagedResource	Class 类
将方法标识为JMX操作	ManagedOperation	@ManagedOperation	Method方法
将getter或者setter标识为部分JMX属性	ManagedAttribute	@ManagedAttribute	Method (only getters and setters) 方法（仅getters和setters）
定义操作参数说明	ManagedOperationParameter	@ManagedOperationParameter 和 @ManagedOperationParameters	Method 方法

 

 

    2.2   看了上面官方解释，应该有个大概的了解，下面再举个例子。

 

@ManagedResource(objectName="bean:name=lionbuleTest", description="My Managed Bean")
public class AnnotationTestMBean{
	private String name;
	private int age;
	
	@ManagedAttribute(description="The Name Attribute")
	public void setName(String name) {
		this.name = name;
	}

	@ManagedAttribute()
	public String getName() {
		return name;
	}  
	public int getAge() {
		return age;
	}
	public void setAge(int age) {
		this.age = age;
	}
	
	@ManagedOperation(description="Add two numbers")
	@ManagedOperationParameters({
	@ManagedOperationParameter(name = "x", description = "The first number"),
	@ManagedOperationParameter(name = "y", description = "The second number")})
	public int add_1(int x, int y) {
		return x + y;
	}

	@ManagedOperation
	public int add_2(int x, int y){
		return x + y;
	}
  
	public void dontExposeMe() {
		throw new RuntimeException();
	}

}

 

   2.3  Jconsole的管理界面截图：

 

图1、查看已暴露MBean的属性

 

图2、查看已暴露MBean的方法

 

   2.4   解释说明：

 

         1、@ManagedResource @ManagedAttribute 和 @ManagedOperation 还有许多参数，具体使用请参考spring官方手册。( spring手册[2.5.3] ---- 20.3.4. 源代码级的元数据类型)

 

         2、@ManagedOperationParameters 是对@ManagedOperation的补充。具体看代码样例中的add1方法上的注解，然后再看图2(查看已暴露MBean的方法)的add1方法和add2的区别。添加参数说明的add1方法会显示出参数名，而add2方法则是默认的参数名p1/p2。

 

         3、没有添加@ManagedOperation和@ManagedAttribute的方法，在图2中就没有看到，说明添加了注解的方法暴露MBean是可用的。

 

         4、@ManagedOperation和@ManagedAttribute的区别，请查看2.1的详解。

 

3、xml配置

    方式一、通用spring bean配置

    配置中，已经加了相应的注释。还不是很清楚，可以查询spring官方手册。

 

    方式二、简化spring-context配置

    注意：方式二对ClassName和beanName有约束，请以‘MBean’结尾。 

 

4、客户端工具连接

 

    常用的客户端工具：Jconsole、jvisualvm、jmanager等。

    连接方式有多种，但本案只介绍了RMI连接管理，所以本案的链接地址为：

service:jmx:rmi://localhost/jndi/rmi://localhost:2088/myconnector

 

参考资料：

1、spring官方手册

     http://static.springsource.org/spring/docs/2.5.x/reference/jmx.html#jmx-interface

2.  http://wiki.springside.org.cn/display/SpringSide3/JMX