Apache Mina 文档翻译 - 第十六章 - JMX支持

[size=x-large]第十六章 - JMX支持[/size]

Java Management Extensions (JMX) 是用来管理和监视java应用程序的。在这篇文章里通过一个例子来说明如何让你的MINA应用程序可以被JMX管理。

下面的程序演示了如何将JMX技术整合进MINA的应用程序，我们把JMX类整合进前面的图片服务器的例子。

[size=large]添加JMX支持[/size]

要使MINA应用程序变成JMX可管理，我们需要做如下的事情：

创建/取得MBean服务器
实例化需要的MBean(IoAcceptor, IoFilter)
把MBean注册到MBean服务器

我们下面的代码都是以\src\main\java\org\apache\mina\example\imagine\step3\server\ImageServer.java为基础的来讨论的。

[size=medium]创建/取得MBean服务器[/size]

// 创建一个JMX的MBean服务器实例
MBeanServer mBeanServer = ManagementFactory.getPlatformMBeanServer();

[size=medium]实例化需要的MBean[/size]

下面我们创建一个IoService的MBean

// 创建一个JMX可管理Bean，这个Bean是对MINA的IoService对象的包装。
// 在本例中，是一个NioSocketAcceptor 
IoServiceMBean acceptorMBean = new IoServiceMBean( acceptor );

上面的代码创建了一个IoService的MBean。它接受一个acceptor的实例，并把它通过JMX暴露出来。

同样我们也可以添加一个IoFilterMBean和其他的自定义MBean

[size=medium]把MBean注册到MBean服务器[/size]

// 创建一个JMX的ObjectName实例，必须按照特定的格式
ObjectName acceptorName = new ObjectName( acceptor.getClass().getPackage().getName() +
        ":type=acceptor,name=" + acceptor.getClass().getSimpleName());

// 把bean注册到MBeanServer，如果没有这一行acceptor就不会进入JMX的管理范围
mBeanServer.registerMBean( acceptorMBean, acceptorName );

我们创建一个ObjectName，然后通过这个名字把MBean注册到MBean的服务器。我们的应用程序现在就是JMX可管理的。让我们来看一下是什么效果：

[size=medium]启动一个图片服务器[/size]

如果我们使用java5及以前的版本：

java -Dcom.sun.management.jmxremote -classpath <CLASSPATH> org.apache.mina.example.imagine.step3.server.ImageServer

如果使用Java6以后的版本:

java  -classpath <CLASSPATH> org.apache.mina.example.imagine.step3.server.ImageServer

[size=medium]启动JConsole[/size]

/bin/jconsole

我们就可以看到通过MBean暴露出来的属性和操作。