Spring 2.x jmx 及应用（1）Annotation

现在大部分企业的应用程序都需要application提供监视程序运行的健康状况和硬件状况的功能。
举个例子，前段时间做的一个项目，需要在一台机器上监视几十台client的操作，CPU使用率，内存，硬盘等信息，当CPU，内存使用率过高时，发出通知到该client.甚至操作client的执行动作，都可用jmx做到。
今天将从简单入手结合jdk的Annotation来实践Spring对jmx的支持

<?xml version="1.0" encoding="UTF-8"?>
<beans xmlns="http://www.springframework.org/schema/beans"
       xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
       xsi:schemaLocation="http://www.springframework.org/schema/beans http://www.springframework.org/schema/beans/spring-beans-2.0.xsd">
       
    <!-- mbean -->
	<bean id="mbeanManager" class="com.xmlasia.spring.test.jmx.MBeanManager"/>
	
	
	<!-- JMX configuration -->
	<!-- 创建一个mbeanServer -->
	<bean id="mbeanServer" 
		  class="org.springframework.jmx.support.MBeanServerFactoryBean">
	</bean>
		
	<!-- MetadataMBeanInfoAssembler是AutodetectCapableMBeanInfoAssembler 唯一实现
		spring文档中有专门介绍AutodetectCapableMBeanInfoAssembler的章节
	 -->
	<bean id="assembler"
		  class="org.springframework.jmx.export.assembler.MetadataMBeanInfoAssembler">
		<property name="attributeSource" ref="jmxAttributeSource"/>
	</bean>
	
	<!-- 解释mbean中Annotation的类,我们可以看到他给注入到assembler,被org.springframework.jmx.export.assembler.MetadataMBeanInfoAssembler包装-->
	<bean id="jmxAttributeSource"
		  class="org.springframework.jmx.export.annotation.AnnotationJmxAttributeSource"/>

         <!-- spring jmx最核心的类 -->
	<bean id="mBeanExporter" class="org.springframework.jmx.export.MBeanExporter">
		<property name="server" ref="mbeanServer"/>
		<property name="assembler" ref="assembler"/>
		<property name="beans">
			<!-- 将mbean注册到mBeanExporter -->
			<map>
				<entry key="mbean:name=testBean" value-ref="mbeanManager"/>
			</map>
		</property>
	</bean>
</beans>

以前jmx的应用需要编写很长的代码来实现，现在你只需完成以上配置就可以实现一个简单的jmx server的程序，jmx server的实现有很多，通常情况下，jmx会需要一个容器例如jboss,现在的方法是将程序本身作为server,这个方式最经典的例子就是个大apserver,我的第一次jmx体验就是在看jboss源码时发起的。实现方式不同会用到不同的协议，这里我们需要jmxremote.jar，你可在spring的lib中找到。


现在来看下我们的mbean

package com.xmlasia.spring.test.jmx;

import org.springframework.jmx.export.annotation.ManagedAttribute;
import org.springframework.jmx.export.annotation.ManagedOperation;
import org.springframework.jmx.export.annotation.ManagedOperationParameter;
import org.springframework.jmx.export.annotation.ManagedOperationParameters;
import org.springframework.jmx.export.annotation.ManagedResource;

@ManagedResource
public class MBeanManager {
	private int clientStatus;

	@ManagedOperation(description = "pause a single proccess")
	@ManagedOperationParameters( { @ManagedOperationParameter(name = "Name of proccess instance", description = "Mandatory") })
	public void pause(String n) {
		System.out.println("pause");
	}

	@ManagedOperation(description = "shut down the proccess")
	public void monitor() {
		System.out.println("shutting down...");
	}

	public void publicMessage() {
		System.out.println("public Message to monitor server");
	}

	@ManagedAttribute(description = "client status")
	public int getClientStatus() {
		return clientStatus;
	}

	@ManagedAttribute(description = "client status")
	public void setClientStatus(int clientStatus) {
		this.clientStatus = clientStatus;
	}
}

我们可以到类中定义了几个方法，monitor server可以通过clientStatus了解到client的状态，publicMessage是用来主动的发送消息到monitor server，所有不需要想外界暴露。monitor server可以通过
获得信息中的ObjectName和Ip来连接到client操作mbean.

mbean在jdk的标准实现是需要实现一个以MBean结尾的interface的，其中定义向外界暴露的方法和属性
现在之需要在类前定义@ManagedResource，在属性方法前分别用@ManagedOperation或者@ManagedAttribute修饰就可以了,Annotation实在是太方便了。未来将会有更多的应用。


该测试了

public static void main(String[] args){
		ClassPathXmlApplicationContext context = new ClassPathXmlApplicationContext("/jmxContext.xml");
		
		while(true){
			try {
				Thread.sleep(1000);
			} catch (InterruptedException e) {
				// TODO Auto-generated catch block
				e.printStackTrace();
			}
		}
	}

现在我们只需要让Spring加载上面那段bean的定义就好了。jmx mbean server的启动是不会阻塞主线程的，所以需要保持主线程活着，不然加载完main方法就结束了，mbean server也挂了。

jdk里有个强大的monitor server那就是jconsole,不过一次只有一个连接
大家可以用jconsole来连接到mbean,调用方法或属性察看结果。

spring jmx很有多有用的功能本人正在挖掘，过段时间再放出一些心得，欢迎有兴趣的一起讨论。

评论

2 楼 jlcon 2009-05-15  

我试着做了配置了一下，但是用jconsole却不知道怎么连接上去，不晓得选哪个链接。

1 楼 sunson468 2009-02-11  

annotation是很强大啊，呵呵！

你里面的spring的配置都可以通过注解代替，呵呵～目前学习中。