编写Axis2模块（Module）

    在 Axis2中提供了一个 Axis2模块（ soapmonitor），该模块实现了与 《WebService大讲堂之Axis2(9)：编写Axis2模块（Module）》 中实现的 logging模块相同的功能，所不同的是， logging模块直接将 SOAP请求与响应消息输出到 Tomcat控制台中，而 soapmonitor模块利用 applet直接在页面中输出 SOAP请求和响应消息。

    下面是配置和使用 soapmonitor模块的步骤：   

第 1步：部署 Applet和 Servlet

    由于 axis2默认情况下已经自带了 soapmonitor模块，因此， soapmonitor模块并不需要单独安装。但 applet所涉及到的相应的 .class文件需要安装一下。在 <Tomcat安装目录 >\webapps\axis2\WEB-INF\lib目录中找到 soapmonitor-1.4.1.jar文件，将该文件解压。虽然 applet并不需要 soapmonitor-1.4.1.jar文件中所有的 .class文件，但为了方便，读者也可以直接将解压目录中的 org目录复制到 <Tomcat安装目录 >\webapps\axis2目录中， Applet所需的 .class文件需要放在这个目录。然后再将 org目录复制到 <Tomcat安装目录 >\webapps\axis2\WEB-INF\classes目录中， soapmonitor模块中的 Servlet所对应的 .class文件需要放在这个目录。

第 2步：配置 Servlet

    打开 <Tomcat安装目录 >\webapps\axis2\WEB-INF\web.xml文件，在其中加入如下的内容：

<!-- <br /> <br /> Code highlighting produced by Actipro CodeHighlighter (freeware)<br /> http://www.CodeHighlighter.com/<br /> <br /> -->< servlet >
     < servlet-name > SOAPMonitorService </ servlet-name >
     < servlet-class >
        org.apache.axis2.soapmonitor.servlet.SOAPMonitorService
     </ servlet-class >
     < init-param >
         < param-name > SOAPMonitorPort </ param-name >
         < param-value > 5001 </ param-value >
     </ init-param >
     < load-on-startup > 1 </ load-on-startup >
</ servlet >
< servlet-mapping >
     < servlet-name > SOAPMonitorService </ servlet-name >
     < url-pattern > /SOAPMonitor </ url-pattern >
</ servlet-mapping >

 

第 3步：在 services.xml文件中引用 soapmonitor模块

    与引用logging模块一样，引用soapmonitor模块也需要使用<module>元素，引用soapmonitor模块的services.xml文件的内容如下：

<!-- <br /> <br /> Code highlighting produced by Actipro CodeHighlighter (freeware)<br /> http://www.CodeHighlighter.com/<br /> <br /> -->< service  name ="myService" >
     < description >
        使用logging和soapmonitor模块
     </ description >
     <!--   引用logging模块   -->
     < module  ref ="logging" />
     <!--   引用soapmonitor模块   -->
     < module  ref ="soapmonitor" />
     < parameter  name ="ServiceClass" >
        service.MyService   
     </ parameter >
     < messageReceivers >
         < messageReceiver  mep ="http://www.w3.org/2004/08/wsdl/in-out"
            class ="org.apache.axis2.rpc.receivers.RPCMessageReceiver"   />
     </ messageReceivers >
</ service >

    由于 soapmonitor模块已经在 axis2.xml进行配置了，因此，在本例中不需要再对 axis2.xml文件进行配置了。   

第 4步：使用 soapmonitor模块

    启动Tomcat后，在浏览器中输入如下的URL：

http://localhost:8080/axis2/SOAPMonitor

    在浏览器中将出现 soapmonitor所带的 Applet的界面，当访问 MyService的 getGreeting方法时，在 Tomcat控制台与 Applet中都显示了相应的 SOAP请求和响应消息。如图 1和图 2分别是调用了两次 getGreeting方法后输出的 SOAP请求和响应消息。

图1

图2

    如果读者想让 logging和 soapmonitor模块监视部署在 Axis2中的所有 WebService，可以在 axis2.xml文件中使用 <module>元素来引用这两个模块，代码如下：

<!-- <br /> <br /> Code highlighting produced by Actipro CodeHighlighter (freeware)<br /> http://www.CodeHighlighter.com/<br /> <br /> -->     <!--   引用logging模块   -->
     < module  ref ="logging" />
     <!--   引用soapmonitor模块   -->
     < module  ref ="soapmonitor" />