【JMX】8. JBoss中的JMX实现

前面都是用JDK自带的JMX实现来写的MBean，JMX的实现不独SUN一家，JBOSS也有自己的JMX实现。如果你使用JBOSS来做WEB服务器，那么基于JBOSS的实现来写MBean，是一个不错的选择。基于JBoss的MBean和基于SUN的MBean有什么不同吗？有一些不同之外，但绝大部份都一样。

　

　

HelloWorld实例

1、准备工作

　　JBOSS实现了JMX规范，这个实例是基于JBOSS来实现的。请先去下载一个JBOSS，我是jboss-3.2.6，下载地址： http://www.jboss.com/downloads/index#as。这个实例需要JBOSS的两个JAR包的支持： jboss-system-3.2.6.jar （应该是jboss-system-jmx.jar？）、jboss-jmx-3.2.6.jar，如果你和我一样用Eclipse来开发（推荐），那么把这个两个包加入到项目的库引用中。

2、程序代码

　　假设我们有一个叫message的属性要需要经常进行改动配置的，那么我们就把它写成一个MBean。

1）HelloWorldServiceMBean接口

　　在写MBean之前，我们先需要写一个MBean接口，接口里的方法都是属性的set/get方法。这个接口必须继承接口ServiceMBean。

    import org.jboss.system.ServiceMBean;   
    public interface HelloWorldServiceMBean extends ServiceMBean {   
        String getMessage();   
        void setMessage(String message);   
    }  

2）HelloWorldService实现类

　　然后写出HelloWorldServiceMBean接口的实现类HelloWorldService，这个实现类还必须继承ServiceMBeanSupport类。这种类再简单不过了，就是属性和相应的set/get方法，EJB中叫实体类、Hibernate中叫POJO。

    import org.jboss.system.ServiceMBeanSupport;   
    public class HelloWorldService extends ServiceMBeanSupport 
                                   implements HelloWorldServiceMBean {   
        private String message;  
        @Override 
        public String getMessage() {   
            System.out.println("getMessage()=" + message);   
            return message;   
        } 
        @Override
        public void setMessage(String message) {   
            System.out.println("setMessage(" + message + ")");   
            this.message = message;   
        }   
    }   

——编译错误；这里还需要jboss-microcontainer.jar；可在这里下载：http://www.java2v.com/Code/Jar/JKL/Downloadjbossmicrocontainerjar.htm
新错误：The type org.jboss.mx.util.JBossNotificationBroadcasterSupport cannot be resolved. It is indirectly referenced from required .class files
导入jboss-jmx-4.2.3.GA.jar之后：The hierarchy of the type HelloWorldService is inconsistent
——可能是JBoss版本问题，挂起。。

3 ）配置文件jboss-service.xml

    <?xml version="1.0" encoding="UTF-8"?>  
    <server>  
        <mbean code="example.mbean.HelloWorldService"
               name="www.chengang.com.cn:service=HelloWorld">  
            <attribute name="Message">Hello World</attribute>  
        </mbean>  
    </server>   

说明：

l code项指向MBean的实现类HelloWorldService
l name项是一个名称，格式一般是：[说明性文字]:service=[类名]
l attribute是为属性设置初始值，这样当JBOSS一加载HelloWorldService类时，message属性就有了一个初始值Hello World。 注意Message的第一个字母必须是大写。

将实例部署到JBOSS

　　在jboss\server\default\deploy目录下创建一个hello.sar目录，然后创建如下目录文件结构：

hello.sar
|----example
|             |----mbean
|                     |----HelloWorldService.class (注意：是*.class，不是*.java)
|                     |----HelloWorldServiceMBean.class
|----META-INF
             |----jboss-service.xml

其他说明：

l 也可以将hello.sar目录用zip格式压缩成一个同名的hello.sar文件，放到jboss\server\default\deploy目录下。
l JBOSS支持热部署，也就是说你在布置这个目录时并不需要重启JBOSS。

MBean的效果

打开网址：http://127.0.0.1:8080/jmx-console/　

后单击“service=HelloWorld”项打开详细页面

将“HelloWorld”改成“Hello World，ChenGang”，再单击“Apply Changes”应用修改

其他类如何使用Messag属性

　　现在我们可以通过一个自动提供的WEB页面来设置Message属性了，接下来的问题是：“在其他类中应该如何得到Message的属性值”。MBean在JBoss是只保留一个MBean的实例（单例模式？），也就是说问题转成我们如何去取得这个唯一实例。例程如下：

1、创建一个使用到Message属性的类

    import org.jboss.mx.util.MBeanProxyExt;   
    import org.jboss.mx.util.ObjectNameFactory;   
    public class Client {   
        public void go() {   
            HelloWorldServiceMBean mbean = (HelloWorldServiceMBean) MBeanProxyExt
                .create(HelloWorldServiceMBean.class, 
                ObjectNameFactory.create(www.chengang.com.cn:service=HelloWorld));   
            String msg = mbean.getMessage();   
            System.out.println("Client.go()=" + msg);   
        }   
    }    

注意：go方法里是三句。第一句比较长，它是根据jboss-service.xml文件中设置的MBean名称，来取得此MBean在JBOSS中的实例。

2、在Mbean中加一个相应的调用Client.go的方法

　在HelloWorldServiceMBean接口中加入一句：

 void callGo();  

    在 HelloWorldService 类中加入现实方法：

 public void callGo() {   
     new Client().go();   
 }  

3 、更新布署

   将三个类的class文件：Clien.class、HelloWorldServiceMBean.class、HelloWorldService.class，更新到JBOSS的hello.sar\example\mbean目录下。然后重启JBOSS。

4、查看效果

   打开JBOSS提供的MBean设置页面，发现多了一个callGo。

   单击callGo项后的invoke按钮，得到DOS输出

其他说明

• 本实例仅演示了一个Message属性，你当然可以在HelloWorldService中加入更多属性，别忘了在HelloWorldServiceMBean接口也加入相应的set/get方法。
• 本实例的message属性是String类型的，但JMX也支持其他的类型，甚至是XML信息。对于jboss-service.xml中的XML信息，这时属性类型要求是org.w3c.dom.Element，JMX将它封装成了一个XML的DOM对象。
• 回顾一下，JMX也是将配置信息写在了一个文件（jboss-service.xml文件）里嘛，相对于将配置文件写到*.properties文件的方式，它似乎也没什么新鲜的地方。但通过本章实例我们可以看到JMX的一些好处：我们不用写代码去读配置文件的信息，而且JMX支持的属性类型是多种多样的（如上面说的org.w3c.dom.Element）。更重要的是JMX还提供了一整套的属性之前互相访问、互相调用的功能，这个HelloWorld实例所反映的只是冰山一角而已。