编写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文件,在其中加入如下的内容:
< 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文件的内容如下:
< 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>元素来引用这两个模块,代码如下:
< module ref ="logging" />
<!-- 引用soapmonitor模块 -->
< module ref ="soapmonitor" />