【JMX】4. 用Apache的commons-modeler辅助开发JMX

         前面各章中，每一个MBean都要有一个接口，比如前面的Hello要有一个HelloMBean接口。要多维护一个接口，的确是件麻烦的事。

        Apache的commons-modeler利用JMX中的动态MBean原理很好的解决了这一问题，commons-modeler使用得我们可以只写Hello，而不用写HelloMBean这个接口。不过这是有代价的，它要求我们写一个mbean的xml描述文件（唉，少了一件事，却又多出另一件事来）。但commons-modeler还是有优点的，就是它让mbean的装配更加灵活，把多个mbean的装配都集中在一个XML文件里来了。

　　开始实例之前，你需要先去apache网站下载commons-modeler，以及modeler的依赖项目commons-logging。

1）commons-modeler

        http://commons.apache.org/proper/commons-modeler/      
        注意：官网网站的下载页面基本上打不开，可在我上传的资源里下载：http://download.csdn.net/detail/vking_wang/5166221

2）commons-logging

        http://commons.apache.org/proper/commons-logging//download_logging.cgi

1）编写MBean

这里的Hello.java与第一篇基本一致，只是不用继承MBean:

public class Hello {   
    private String name;   
    public String getName() {   
        return name;   
    }   
    public void setName(String name) {   
        this.name = name;   
    }   
    public void printHello() {   
        System.out.println("DynamicMbean: Hello World, " + name);   
    }   
    public void printHello(String whoName) {   
        System.out.println("DynamicMbean: Hello , " + whoName);   
    }   
} 

2）编写XML描述文件

取名为mbeans-descriptors.xml

<?xml version="1.0"?>  
   <mbeans-descriptors>  
     <mbean name="Hello" 
            description="the hello bean" 
            domain="alpha" 
            group="helloGroup" 
            type="mbean.modelbean.Hello">  
        <attribute name="name" 
                   description="a name attribute" 
                   type="java.lang.String" 
                   writeable="true"/>  
        <operation name="printHello" 
                   description="a operation to print hello" 
                   impact="INFO" 
                   returnType="String"/>  
        <operation name="printHello" 
                   description="a operation to print hello" 
                   impact="ACTION" 
                   returnType="String">  
            <parameter name="whoName" 
                       description="who's name." 
                       type="java.lang.String"/>  
        </operation> 
    </mbean>  
</mbeans-descriptors> 

    * name：mbean在xml中的唯一标识，不一定要和类同名

    * description：　mbean的注释说明信息
    * domain： mbean所属域
    * group： mbean所属组
    * type： mbean的类全名（包名＋类名）
    * classname： 指定实现代理功能的ModelMbean的全名，如果不指定则默认为BaseModelMBean

3）编写Agent

public class HelloAgent {   
    public static void main(String[] args) throws Exception {   
        //基于xml中的信息构建一个Registry   
        Registry registry = Registry.getRegistry(null, null);   
        InputStream stream = HelloAgent.class.
                       getResourceAsStream("mbeans-descriptors.xml");   
        registry.loadMetadata(stream);   
        stream.close(); 
        
        //由Registry得到一个MBeanServer   
        MBeanServer server = registry.getMBeanServer();    
        //得到Hello在描述文件中的信息类，对应于xml文件<mbean>标签的name属性。   
        ManagedBean managed = registry.findManagedBean("Hello");   
        //创建ObjectName   
        ObjectName helloName = new ObjectName(managed.getDomain() + ":name=HelloWorld");   
        //得到ModelMBean   
        ModelMBean hello = managed.createMBean(new Hello());   //MBean
        //注册MBean   
        server.registerMBean(hello, helloName);   
  
        ObjectName adapterName = new ObjectName("HelloAgent:name=htmladapter,port=8082");   
        HtmlAdaptorServer adapter = new HtmlAdaptorServer();   
        server.registerMBean(adapter, adapterName);   
        adapter.start();   
        System.out.println("start.....");   
    }   
}  

HelloAgent是效复杂的地方，我们来和以前的HelloAgent逐步比较一下，前后有什么不同：

（1）首先，新的HelloAgent需要将xml信息读入到Registry对象中，这是旧HelloAgent所没有的。
Registry registry = Registry.getRegistry(null, null);
InputStream stream = HelloAgent.class.getResourceAsStream("Mbeans-descriptors.xml");
registry.loadMetadata(stream);
stream.close();
 
（2）接着创建MBeanServer的方式也不同了
现在：MBeanServer server = registry.getMBeanServer();
以前: MBeanServer server = MBeanServerFactory.createMBeanServer();
　
（3）Hello相应的ObjectName创建也略不相同。主要是域名在XML描述文件里设置好了。
现在：ManagedBean managed = registry.findManagedBean("Hello");
            ObjectName helloName = new ObjectName(managed.getDomain() + ":name=HelloWorld");
以前：ObjectName helloName = new ObjectName("chengang:name=HelloWorld")
　
（4）得到MBean的方式也不同，这里就是关键的不同点
现在：ModelMBean hello = managed.createMBean(new Hello());
以前：Hello hello = new Hello();

注意：为什么现在要比以前多一个createMbean步骤呢，就是因为现在的写法并没有写Mbean，所以需要动态才需要生成一个。而以前就直接把new Hello()注册到mbean server就可以了，server会自动找到它的HelloMBean接口文件。
commons Modeler为Hello动态生成了一个MBean接口：BaseModelBean