WebJMX开源项目应用与进阶.doc

最近公司用到一些关于JMX的使用，在我的BLOG之前介绍过JMX。一个简单的JMX结构由以下几个步骤去完成： 需要一个MBeanServer作为一个容器，去装载你的MBean如下创建：MBeanServer server = MBeanServerFactory.createMBeanServer(Local); ObjectName,JDK文档对它的描述是这样的：表示 MBean 的对象名，或者能够与多个 MBean 名称相匹配的模式。我们可以从字面上了解到他是干什么的了，就好比一个KEY, 当我们的MBean注入MBeanServer后总要有一个标识它，以方便我们以后通过这个KEY去找过我们的MBean.如下创建：ObjectName manager = new ObjectName(NCS:name=scheduler); 将我们需要进行管理的MBean注册到MBeanServer中，具体如下： server.registerMBean(new IScheduler(), manager);这样就算告一段落了，完成以上步骤后，将实现一个MBeanServer（一个容器）中拥有多个MBean(受管理的类).这就是JMX的基本实现。那么如果要对MBean进行管理当然少不了一些管理机制，如SUN自己提供的HtmlAdaptorServer和Jconsole。HtmlAdaptorServer可以通过WEB对MBean进行管理，Jconsole则是C/S结构的。下面列举一下HtmlAdaptorServer的使用方法：HtmlAdaptorServer adapter = new HtmlAdaptorServer(); server.registerMBean(adapter, adapterName);以上代码片段可以看出其实HtmlAdaptorServer 也就是个MBean，而这个MBean可访问注册在MBeanServer的其他MBean而已。最后启动HtmlAdaptorServer ：adapter.start();完整代码片段：/XXX()自定义方法名吧！public void XXX() try / create MBSERVER name is WUBINSERVER List l = MBeanServerFactory.findMBeanServer(null); if (l.size() 0) server = (MBeanServer) l.get(0); else server = MBeanServerFactory.createMBeanServer(Local); / Register HtmlAdaptorserver port is 8082. ObjectName adapterName = new ObjectName( ManagerAgent:name=htmladapter,port=8082); HtmlAdaptorServer adapter = new HtmlAdaptorServer(); server.registerMBean(adapter, adapterName); / your self objectname register. ObjectName manager = new ObjectName(NCS:name=scheduler); server.registerMBean(new IScheduler(), manager); ObjectName manager2 = new ObjectName(NCS:name=scheduler2); server.registerMBean(new IScheduler(), manager2);/ ObjectName manager = new ObjectName(NCS:name=scheduler1);/ server.registerMBean(new JobManagerMBeanImpl(), manager); adapter.start(); System.out.println(start.); catch (MalformedObjectNameException e) / TODO Auto-generated catch block e.printStackTrace(); catch (InstanceAlreadyExistsException e) / TODO Auto-generated catch block e.printStackTrace(); catch (MBeanRegistrationException e) / TODO Auto-generated catch block e.printStackTrace(); catch (NotCompliantMBeanException e) / TODO Auto-generated catch block e.printStackTrace(); catch (NullPointerException e) / TODO Auto-generated catch block e.printStackTrace(); 当我们访问本地的8082后就可以看到HtmlAdaptorServer 所提供的管理界面，但这样的管理界面非常不人性化，（那么丑，怎么见人呢？）那下面我隆重介绍的就是WebJMX！他能帮我们解决管理界面的问题，让我们可自编写自己的管理界面。WebJMX Tag Library Project首先下载WEBJMX/project/showfiles.php?group_id=58769&release_id=102257（建议下1.2a版本）那在DOWNLOADING.的时候我来说一下WEBJMX的缺陷。（是不是开门一棒，呵呵，这个我必须先告诉大家一声，不然你发现如果WEBJMX并不适合你的工程那下来也没什么意义了。）缺陷：1、WEBJMX在2002年之后就再也没有更新过，最后一个版本是1.3。很遗憾，有可能以后都不会有新的更新，如果你觉得这点无法接受，我可以介绍给你其他-MX4J，不过这个东西很麻烦，如果有兴趣自己去找找资料吧。2、WEBJMX是中标签，其他就是利用标签库进行VIEW。虽说标签已属于过去式，但不代表没有人用它嘛，象我这样的老人家还在用呢！：）3、WEBJMX部署混乱，资料较缺。这点没有什么办法，所以我建议大家下WEBJMX1.2a版本，那个1.3版本的必须用ANT部署才行，而且里面有很多需要在环境变量里配置的东西，比如TOMCATHOME啊STRUTSHOME啊等等HOME。而且我发现在那ANT脚本里本提到有个JMX.war包在TEMP目录下，结果去寻找也没找到作者的失败之处4、WEBJMX用的JDK是1.4的，但不要紧也支持1.5好了，废话过后相信你的WEBJMX工程也该下好了，把开始我们的WEBJMX旅程吧，我希望它是轻松愉快的。小女子才疏学浅，如果有错误也希望得到批评，但不要象XX人在我的留言版中一样骂我，说偶的BLOG是垃圾BLOG，即便是垃圾BLOG也麻烦留点所谓的垃圾评语（为虾米垃圾）啊，否则就太不知所为了。我推荐的部署方式并不是用他提供的ANT脚本，而是我们自己的部署手段。我们先用MYECLIPSE创建一个WEB的PROJECT。叫WEBJMX，然后将WEBJMX目录下的org整个目录拷贝到我们的新建的工程的src目录下，然后我们会看到好多红叉叉。不用害怕，这都算少的了然后导入几个包包，这个包包有MX4J的、STRUTS的、QUICK的还有JMX自己的。由于WEBJMX是使用1.4的JDK。所以当时SUN公司还没有将JMX放到JDK中，.1.5就没事了。导完后差不多如下图那么多。有可能在org部署的时候会遇到enum这是因为WEBJMX使用的JDK是1.4的，而我们现在基本使用1.5以上的版本，只要用户自己随便改改变量名就可以了，别用enum这个变量名。以下展示了两幅图：这是HtmlAdaptorServer 的管理界面（ HTML JMX HTMLAdaptor ）而这就是WEBJMX实例的管理界面，是不是比上面那个人性化的多呢？（ WbJMX JSP MBeanServer ）结构（）WEBJMX标签包括这些部分（JMX ） 一套JSP标签和描述标签句法的TLD的Java类。（ JSP TLD Java ） 由一个SERVLET接受页面上表单提交过来的数据。其实在这表单的数据是WebJMX标记修改后生成的。这个表单类似于这样（ SERVLET . s WebJMX . ）：于我们常见的FORM很不同。 通过使用JSP标签和Servlet调用AdapterFactory可以得到MBeanServers 。（MBeanServers Servlet JSP AdapterFactory）结构图：（ ）：我们可以从上图中看到，WEBJMX是怎么工作的（虽然不是流程图，但其实一目了然！）。用户通过WEB浏览器通过HTTP request 触发ACTION（JMXACTION SERVLET）然后通过JMXSerivceAdapter访问MBEANSERVER（能访问MBEANSERVER也以为着能管理SERVER中的MBEAN啦！），那JMXSerivceAdapter其实是种适配器，我们之前介绍过的HTMLAdapter也是适配器。好！下面就开始看看我们的例子来真正认识一下WEBJMX。首先作为一个WEB程序最重要的当然是WEB.xml啦，那我们就从它开始 jmxAction jmxAction Default mapping to the JMXAction servlet. agent org.webjmx.example.AgentServlet locator0 local jmxAction org.webjmx.servlet.JMXAction action org.apache.struts.action.ActionServlet config /WEB-INF/struts-config.xml debug 3 detail 3 0 jmxAction /jmxAction action *.do index.html /WEB-INF/jmx.tld /WEB-INF/jmx.tld /WEB-INF/struts-bean.tld /WEB-INF/struts-bean.tld /WEB-INF/struts-logic.tld /WEB-INF/struts-logic.tld非常关键的一个片段： agent org.webjmx.example.AgentServlet locator0 local 我们可以看到有一个叫agent的servlet被声明了。那在TOMCAT启动的时候同时也被加载了。然后我们来跟踪一下这个servlet的内容。AgentServlet.java先来看看他的init（）public void init(ServletConfig config) throws ServletException super.init(config); doInit();很明显，他在初始化的时候调用了doInit()，然后我们再看看doInit()/* instanitate some test MBeans.*/public void doInit() throws ServletException if (Boolean.getBoolean(DEBUG_PROP) log(AgentServlet init(); List l = MBeanServerFactory.findMBeanServer(null); if (Boolean.getBoolean(DEBUG_PROP) log(MBeanServer count: + l.size(); if (l.size() 0) server = (MBeanServer) l.get(0); else server = MBeanServerFactory.createMBeanServer(Local); if (Boolean.getBoolean(DEBUG_PROP) log(initalizing local server instance: + server); HtmlAdaptorServer html = new HtmlAdaptorServer(8086); ObjectName ob_name = null; try ob_name = new ObjectName(Adaptor:name=html,port=8086); if (Boolean.getBoolean(DEBUG_PROP) log(OBJECT NAME: + ob_name); server.registerMBean(html, ob_name); Enumeration e = getServletConfig().getInitParameterNames(); while (e.hasMoreElements() String paramName = (String) e.nextElement(); if (!paramName.startsWith(locator) continue; String locator = getServletConfig().getInitParameter(paramName); l = AdapterFactory.findMBeanServer(locator); if (Boolean.getBoolean(DEBUG_PROP) log(server list: + l); if (l.size() = 0) return; if (Boolean.getBoolean(DEBUG_PROP) log(initalizing local server instance: + server); server = (MBeanServer) l.get(0); if (Boolean.getBoolean(DEBUG_PROP) log(server: + server); ob_name = new ObjectName(MBeanInfo, name, SimpleStandard); if (Boolean.getBoolean(DEBUG_PROP) log(OBJECT NAME: + ob_name); / server.createMBean(org.webjmx.example.SimpleStandard,ob_name); server.registerMBean(new SimpleStandard(), ob_name); ob_name = new ObjectName(MBeanInfo, name, SimpleDynamic); if (Boolean.getBoolean(DEBUG_PROP) log(OBJECT NAME: + ob_name); server.registerMBean(new SimpleDynamic(), ob_name); / server.createMBean(org.webjmx.example.SimpleDynamic, / ob_name); /* * ObjectName sname = new * ObjectName(JMImplementation:type=MBeanServerDelegate); * MBeanInfo minfo = server.getMBeanInfo(sname); MBeanAttributeInfo * attrs = minfo.getAttributes(); System.out.println(attribute * count: +attrs.length); for(int i = 0; i attrs.length; i+) * System.out.println(attrsi.getName() + : * +server.getAttribute(sname, attrsi.getName(); */ catch (Exception e) log(t! Could not create the HTML adaptor !); e.printStackTrace(); return; html.start();在方法开头就有注释，告诉你这个方法是干什么的了（instanitate some test MBeans.）初始化一些测试的MBEN，这个这个还不完全，在方法的内容我们可以看到，不仅仅是初始化了一些MBEAN，更重要的是实例了一个MBEANSERVER并将适配器和需要管理的MBEAN都加载进去了。创建MBEANSERVER：List l = MBeanServerFactory.findMBeanServer(null);其实这个方法更适合去查找MBEANSERVER，但如果没有找到，则会返回一个默认的MBEANSERVER，创建一个Adaptor:HtmlAdaptorServer html = new HtmlAdaptorServer(8086);ob_name = new ObjectName(Adaptor:name=html,port=8086);注册这个适配器到MBEANSERVER中server.registerMBean(html, ob_name);好，下面是注册我们自己的MBEAN到MBEANSERVER中去。ob_name = new ObjectName(MBeanInfo, name, SimpleStandard);其实这个3参的构造方法跟ob_name= new ObjectName(“MBeanInfo:name=SimpleStandard”);是同理的。注册：server.registerMBean(new SimpleStandard(), ob_name);这样，我们的MBEAN就被注册到了MBEANSERVER中去了。然后就是启动我们的适配器，让我们的用户可以通过适配器去访问我们的MBEANSERVER了。html.start();这样，都WEB.XML和必要的servlet都已经写好了。然后就该在我们的页面上运用我们的标记进行访问我们的MBEAN了。在例子的基本页面index.html细节我就些了，我们看关键的东西/kekemao1可以看到这个超连接是跳转到server1.jsp并带了几个重要的参数。locator=local,domain=Local还有name=Local。哎？！为什么看起来那么想我们的ObjectName的参数？没错！后面两个参数确实是ObjectName的参数所用的,就是new ObjectName(Local:name=Local)。而locator=local这个是WEBJMX特定的，local是指本地的MBEANSERVER访问方式，还有remote方式。在这里我们暂时不说这两种方式，我回在回复栏里细说这两个参数倒底是干什么用的。然后我们看看server1.jsp的内容:头部分：标记的声明变量的声明，这些变量非常重要，这个变量也就类似我们获得了之前在我们的servlet中声明好的MBeanServer,可能你会想，那这个MBeanServer是哪来的啊？其实当我们使用的时候他会根据后面的attribute元素的值去内存中找这个名叫locator的MBeanServer的实例，就好比MBeanServerFactory.findMBeanServer(“locator)。 体部分：MBeanInfo:name=SimpleStandard以名为MBeanInfo:name=SimpleStandard为条件，到server(之前声明好的MBEANSERVER对象)中去找这个ObjectName所对应的MBean，其实ObjectName和MBean是1对1的关系，一个ObjectName对应一个MBean，就好比我们的Map类，一个KEY对应一个Value，用Key找Value一样。他返回的是一个List（其实我个人觉得没必要返回LIST）。获得单个MBean：再下去的内容我就不说了，没什么用。接下去我们就自己来做个一HelloWorld吧.新建一个WEB OBJECT（我这里使用了MYECLIPSE，东西都是自动就加载的，如果你用其他的编译器那只好你自己看着大概去做了），然后导入STRUTS LIBS（MYECLIPSE自动生成）。接着在WEB-INF目录中放下几个WEBJMX重要的文件AdapterFactoryInit.qjml，AdapterFactoryInit.xml，jmx.tld，QJML.dtd。这些文件在WEBJMX开源项目1.2a中都有。然后是我们的web.xml,内容如下： jmxAction jmxAction action org.apache.struts.action.ActionServlet config /WEB-INF/struts-config.xml debug 3 detail 3 0 action *.do index.jsp agent com.kekemao1.jmxexample.servlet.AgentServlet locator0 local jmxAction org.webjmx.servlet.JMXAction jmxAction /jmxAction大家看到其实和我先前介绍的例子的XML没什么区别，其实这些是必要的。写好WEB.XML后，我们来完成servlet部分，如上描述的那样，我们有一个com.kekemao1.jmxexample.servlet.AgentServlet需要去实现：com.kekemao1.jmxexample.servlet.AgentServlet内容如下：package com.kekemao1.jmxexample.servlet;import java.util.Iterator;import java.util.List;import java.util.Set;import javax.management.InstanceAlreadyExistsException;import javax.management.MBeanRegistrationException;import javax.management.MBeanServer;import javax.management.MBeanServerFactory;import javax.management.MalformedObjectNameException;import javax.management.NotCompliantMBeanException;import javax.management.ObjectName;import javax.servlet.ServletConfig;import javax.servlet.ServletException;import javax.servlet.http.HttpServlet;import javax.servlet.http.HttpServletRequest;import javax.servlet.http.HttpServletResponse;import org.webjmx.tags.JMXTaglibConstants;import com.kekemao1.jmxexample.mbeans.Kekemao;import m.HtmlAdaptorServer;public class AgentServlet extends HttpServlet implements JMXTaglibConstants /* */private static final long serialVersionUID = -5092348467994419208L;private MBeanServer server = null;/* Initializes the servlet.*/public void init(ServletConfig config) throws ServletException super.init(config); try doInit(); catch (MalformedObjectNameException e) / TODO Auto-generated catch block e.printStackTrace(); catch (InstanceAlreadyExistsException e) / TODO Auto-generated catch block e.printStackTrace(); catch (MBeanRegistrationException e) / TODO Auto-generated catch block e.printStackTrace(); catch (NotCompliantMBeanException e) / TODO Auto-generated catch block e.printStackTrace(); catch (NullPointerException e) / TODO Auto-generated catch block e.printStackTrace(); private void doInit() throws MalformedObjectNameException, NullPointerException, InstanceAlreadyExistsException, MBeanRegistrationException, NotCompliantMBeanException / TODO Auto-generated method stub / create MBSERVER name is WUBINSERVER List l = MBeanServerFactory.findMBeanServer(null); if (l.size() 0) server = (MBeanServer) l.get(0); else server = MBeanServerFactory.createMBeanServer(Local); ObjectName adapterName = new ObjectName( ManagerAgent:name=htmladapter,port=8083); HtmlAdaptorServer adapter = new HtmlAdaptorServer(); server.registerMBean(adapter, adapterName); / your self objectname register. ObjectName manager = new ObjectName(KEKEMAO:name=miaomiao); server.registerMBean(new Kekemao(), manager); adapter.start();/* Destroys the servlet.*/public void destroy() if (server != null) MBeanServerFactory.releaseMBeanServer(server);/* Processes requests for both HTTP GET and POST* methods.* * param request* servlet request* param response* servlet response*/protected void processRequest(HttpServletRequest request, HttpServletResponse response) throws ServletException, java.io.IOException response.setContentType(text/html); java.io.PrintWriter out = response.getWriter(); / output your page here out.println(); out.println(); out.println(Servlet); out.println(); out.println(); List l