Spring與MX4J集成實現JMX管理

MX4J是一個開源JMX管理框架，支持JSR3 (JMX) 和JSR160 (JMX Remote API)。通過Spring將MX4J集成到我們的應用系統中，可以通過HTTP協議適配，能夠基於Web的方式來實現對應用系統的監控和管理。這裏，使用的版本分別爲：

Spring 2.5
MX4J 3.0.2

MX4J對應的幾個JAR文件，加入到CLASSPATH：

mx4j.jar
mx4j-impl.jar
mx4j-jmx.jar
mx4j-remote.jar
mx4j-rimpl.jar
mx4j-rjmx.jar
mx4j-tools.jar

首先，給出Spring的完整配置，如下所示：

<?xml version="1.0" encoding="UTF-8"?> <beans xmlns="http://www.springframework.org/schema/beans" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:p="http://www.springframework.org/schema/p" xsi:schemaLocation="http://www.springframework.org/schema/beans http://www.springframework.org/schema/beans/spring-beans-2.5.xsd"> <bean id="exporter" class="org.springframework.jmx.export.MBeanExporter" depends-on="mbeanServer"> <property name="beans"> <map> <entry key="CONFIG.SHIRDRN.ORG:name=config" value-ref="config" /> <entry key="MX4J.SOURCEFORGE.COM:name=httpAdaptor" value-ref="httpAdaptor" />  </map> </property> <property name="server" ref="mbeanServer" /> <property name="assembler"> <ref bean="assembler" /> </property> </bean> <bean id="assembler" class="org.springframework.jmx.export.assembler.InterfaceBasedMBeanInfoAssembler"> <property name="managedInterfaces"> <list> <value>org.shirdrn.jmx.mx4j.SelectedMethodsInterface</value> </list> </property> </bean> <bean id="mbeanServer" class="org.springframework.jmx.support.MBeanServerFactoryBean" /> <bean id="httpAdaptor" class="mx4j.tools.adaptor.http.HttpAdaptor"> <property name="processor"> <ref bean="xsltProcessor" /> </property> <property name="host"> <value>192.168.1.102</value> </property> <property name="port" value="9988" /> </bean> <bean id="xsltProcessor" class="mx4j.tools.adaptor.http.XSLTProcessor" /> <bean id="config" class="org.shirdrn.jmx.mx4j.MyConfiguration" />  </beans>

上面配置中，比較核心的是MX4J的HTTP適配器類：mx4j.tools.adaptor.http.HttpAdaptor，它有一個processor屬性，使用MX4J已經實現的mx4j.tools.adaptor.http.XSLTProcessor來對其注入。XSLTProcessor實現了MX4J定義的XML轉換成爲瀏覽器可以解析的格式的文檔，就Web網頁。

通過MX4J的源碼可以看到，在mx4j-3.0.2/src/tools/mx4j/tools/adaptor/http/xsl目錄下面，可以看到MX4J定義的一些XSLT模板，例如serverbydomain.xsl爲Web控制檯首頁模板：

<?xml version="1.0"?>  <xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform" version="1.0"> <xsl:output method="html" indent="yes" encoding="ISO-8859-1"/> <xsl:include href="common.xsl" mce_href="common.xsl"/> <xsl:include href="xalan-ext.xsl" mce_href="xalan-ext.xsl"/> <xsl:param name="html.stylesheet">stylesheet.css</xsl:param> <xsl:param name="html.stylesheet.type">text/css</xsl:param> <xsl:param name="head.title">serverbydomain.title</xsl:param>  <xsl:template match="Domain" name="error"> <xsl:for-each select="Exception"> <tr> <td class="serverbydomain_domainline" colspan="5"> <xsl:call-template name="str"> <xsl:with-param name="id">serverbydomain.error.query</xsl:with-param> <xsl:with-param name="p0"> <xsl:value-of select="@errorMsg"/> </xsl:with-param> </xsl:call-template> </td> </tr> </xsl:for-each> </xsl:template>  <xsl:template match="Domain" name="domain"> <xsl:for-each select="Domain"> <xsl:sort data-type="text" order="ascending" select="@name"/> <tr> <td class="serverbydomain_domainline" colspan="5"> <xsl:call-template name="str"> <xsl:with-param name="id">serverbydomain.domain.label</xsl:with-param> <xsl:with-param name="p0"> <xsl:value-of select="@name"/> </xsl:with-param> </xsl:call-template> </td> <xsl:call-template name="mbean"/> </tr> </xsl:for-each> </xsl:template>  <xsl:template match="MBean" name="mbean"> <xsl:for-each select="MBean"> <xsl:sort data-type="text" order="ascending" select="@objectname"/> <xsl:variable name="classtype"> <xsl:if test="(position() mod 2)=1">darkline</xsl:if> <xsl:if test="(position() mod 2)=0">clearline</xsl:if> </xsl:variable> <xsl:variable name="objectname"> <xsl:call-template name="uri-encode"> <xsl:with-param name="uri" select="@objectname"/> </xsl:call-template> </xsl:variable> <tr class="{$classtype}" width="100%"> <td width="35%" align="left" class="serverbydomain_row"> <a href="mbean?objectname={$objectname}" mce_href="mbean?objectname={$objectname}"> <xsl:value-of select="@objectname"/> </a> </td> <td width="20%" align="left" class="serverbydomain_row"> <p> <xsl:value-of select="@classname"/> </p> </td> <td width="35%" align="left" class="serverbydomain_row"> <p> <xsl:value-of select="@description"/> </p> </td> <td width="10%" align="right" class="serverbydomain_row"> <p> <a href="delete?objectname={$objectname}" mce_href="delete?objectname={$objectname}"> <xsl:call-template name="str"> <xsl:with-param name="id">serverbydomain.mbean.unregister</xsl:with-param> </xsl:call-template> </a> </p> </td> </tr> </xsl:for-each> </xsl:template>  <xsl:template match="Server"> <html> <xsl:call-template name="head"/> <body> <table width="100%" cellpadding="0" cellspacing="0" border="0"> <tr width="100%"> <td> <xsl:call-template name="toprow"/> <xsl:call-template name="tabs"> <xsl:with-param name="selection">server</xsl:with-param> </xsl:call-template> <xsl:variable name="query"> <xsl:call-template name="str"> <xsl:with-param name="id">serverbydomain.server.query</xsl:with-param> </xsl:call-template> </xsl:variable> <table width="100%" cellpadding="0" cellspacing="0" border="0"> <tr> <td class="page_title"> <xsl:call-template name="str"> <xsl:with-param name="id">serverbydomain.server.title</xsl:with-param> </xsl:call-template> </td> <form action="serverbydomain"> <td align="right" class="page_title"> <xsl:call-template name="str"> <xsl:with-param name="id">serverbydomain.server.filter</xsl:with-param> </xsl:call-template> <input type="text" name="querynames" value="*:*"/> <input type="submit" value="{$query}"/> </td> </form> </tr> </table> <table width="100%" cellpadding="0" cellspacing="0" border="0"> <xsl:call-template name="domain"/> <xsl:call-template name="error"/> </table> <xsl:call-template name="bottom"/> </td> </tr> </table> </body> </html> </xsl:template> </xsl:stylesheet>

Spring配置中通過實例化一個HttpAdaptor，註冊到MBean Server中，實現基於HTTP協議遠程訪問管理和監控。org.shirdrn.jmx.mx4j.MyConfiguration我們定義的一個MBean，也註冊到MBean Server中，實現JMX的管理與監控，代碼如下所示：

package org.shirdrn.jmx.mx4j; public class MyConfiguration { private long id = System.currentTimeMillis(); private String name; public MyConfiguration() { super(); } public MyConfiguration(long id, String name) { super(); this.id = id; this.name = name; } public long getId() { return id; } public void setId(long id) { this.id = id; } public String getName() { return name; } public void setName(String name) { // 通過JMX管理調用時，更新id的值 this.id = System.currentTimeMillis(); this.name = name; } public String show() { StringBuffer sb = new StringBuffer().append("id=").append(id).append( ", name=").append(name); System.out.println("show()=" + sb.toString()); return sb.toString(); } }

但是，Spring配置中的org.springframework.jmx.export.assembler.InterfaceBasedMBeanInfoAssembler對MBean暴露的操作進行了限制，主要是通過我們定義的接口org.shirdrn.jmx.mx4j.SelectedMethodsInterface來指定需要將MBean的哪些內容暴露給JMX管理，接口如下所示：

package org.shirdrn.jmx.mx4j; public interface SelectedMethodsInterface { public long getId(); public void setName(String name); public String getName(); public void show(); }

最後，我們可以初始化Spring的IOC容器，啓動MX4J的HttpAdaptor服務，實現通過Web控制檯的JMX管理，代碼如下所示：

package org.shirdrn.jmx.mx4j; import java.io.IOException; import javax.management.MalformedObjectNameException; import mx4j.tools.adaptor.http.HttpAdaptor; import org.springframework.context.ApplicationContext; import org.springframework.context.support.ClassPathXmlApplicationContext; public class JMXTest { public static void main(String[] args) throws IOException, MalformedObjectNameException, Exception { ApplicationContext ctx = new ClassPathXmlApplicationContext( new String[] { "org/shirdrn/jmx/mx4j/applicationContext.xml" }); HttpAdaptor httpAdaptor = (HttpAdaptor) ctx.getBean("httpAdaptor"); httpAdaptor.start(); } }

啓動成功後，可以通過瀏覽http://192.168.1.102:9988，可以看到我們註冊的MBean，並對其進行管理和監控。