WebService大讲堂之Axis2(9):编写Axis2模块(Module)
Axis2可以通过模块(Module)进行扩展。Axis2模块至少需要有两个类,这两个类分别实现了Module和Handler接口。开发和使用一个Axis2模块的步骤如下:
1. 编写实现Module接口的类。Axis2模块在进行初始化、销毁等动作时会调用该类中相应的方法)。
2. 编写实现Handler接口的类。该类是Axis2模块的业务处理类。
3. 编写module.xml文件。该文件放在META-INF目录中,用于配置Axis2模块。
4. 在axis2.xml文件中配置Axis2模块。
5. 在services.xml文件中配置Axis2模块。每一个Axis2模块都需要使用<module>元素引用才能使用。
6. 发布Axis2模块。需要使用jar命令将Axis2模块压缩成.mar包(文件扩展名必须是.mar),然后将.mar文件放在
<Tomcat安装目录>\webapps\axis2\WEB-INF\modules目录中。
先来编写一个WebService类,代码如下:
public class MyService
{
public String getGreeting(String name)
{
return "您好 " + name;
}
}
下面我们来编写一个记录请求和响应SOAP消息的Axis2模块。当客户端调用WebService方法时,该Axis2模块会将请求和响应SOAP消息输出到Tomcat控制台上。
第1步:编写LoggingModule类
LoggingModule类实现了Module接口,代码如下:
import org.apache.axis2.AxisFault;
import org.apache.axis2.context.ConfigurationContext;
import org.apache.axis2.description.AxisDescription;
import org.apache.axis2.description.AxisModule;
import org.apache.axis2.modules.Module;
import org.apache.neethi.Assertion;
import org.apache.neethi.Policy;
public class LoggingModule implements Module
{
// initialize the module
public void init(ConfigurationContext configContext, AxisModule module)
throws AxisFault
{
System.out.println("init");
}
public void engageNotify(AxisDescription axisDescription) throws AxisFault
{
}
// shutdown the module
public void shutdown(ConfigurationContext configurationContext)
throws AxisFault
{
System.out.println("shutdown");
}
public String[] getPolicyNamespaces()
{
return null;
}
public void applyPolicy(Policy policy, AxisDescription axisDescription)
throws AxisFault
{
}
public boolean canSupportAssertion(Assertion assertion)
{
return true;
}
}
在本例中LoggingModule类并没实现实际的功能,但该类必须存在。当Tomcat启动时会装载该Axis2模块,同时会调用LoggingModule类的init方法,并在Tomcat控制台中输出“init”。
第2步:编写LogHandler类
LogHandler类实现了Handler接口,代码如下:
import org.apache.axis2.AxisFault;
import org.apache.axis2.context.MessageContext;
import org.apache.axis2.engine.Handler;
import org.apache.axis2.handlers.AbstractHandler;
import org.apache.commons.logging.Log;
import org.apache.commons.logging.LogFactory;
public class LogHandler extends AbstractHandler implements Handler
{
private static final Log log = LogFactory.getLog(LogHandler.class);
private String name;
public String getName()
{
return name;
}
public InvocationResponse invoke(MessageContext msgContext)
throws AxisFault
{
// 向Tomcat控制台输出请求和响应SOAP消息
log.info(msgContext.getEnvelope().toString());
return InvocationResponse.CONTINUE;
}
public void revoke(MessageContext msgContext)
{
log.info(msgContext.getEnvelope().toString());
}
public void setName(String name)
{
this.name = name;
}
}
LogHandler类的核心方法是invoke,当使用该Axis2模块的WebService的方法被调用时,LogHandler类的invoke方法被调用。
第3步:编写module.xml文件
在META-INF目录中建立一个module.xml文件,内容如下:
<InFlow>
<handler name="InFlowLogHandler" class="module.LogHandler">
<order phase="loggingPhase"/>
</handler>
</InFlow>
<OutFlow>
<handler name="OutFlowLogHandler" class="module.LogHandler">
<order phase="loggingPhase"/>
</handler>
</OutFlow>
<OutFaultFlow>
<handler name="FaultOutFlowLogHandler" class="module.LogHandler">
<order phase="loggingPhase"/>
</handler>
</OutFaultFlow>
<InFaultFlow>
<handler name="FaultInFlowLogHandler" class="module.LogHandler">
<order phase="loggingPhase"/>
</handler>
</InFaultFlow>
</module>
第4步:在axis2.xml文件中配置Axis2模块
打开axis2.xml文件,分别在如下四个<phaseOrder>元素中加入<phase name="loggingPhase"/>:
<phase name="soapmonitorPhase"/>
<phase name="loggingPhase"/>
</phaseOrder>
<phaseOrder type="OutFlow">
<phase name="Security"/>
<phase name="loggingPhase"/>
</phaseOrder>
<phaseOrder type="InFaultFlow">
<phase name="soapmonitorPhase"/>
<phase name="loggingPhase"/>
</phaseOrder>
<phaseOrder type="OutFaultFlow">
<phase name="Security"/>
<phase name="loggingPhase"/>
</phaseOrder>
第5步:在services.xml文件中引用logging模块
services.xml文件的内容如下:
<description>
使用logging模块
</description>
<!-- 引用logging模块 -->
<module ref="logging"/>
<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>
第6步:发布logging模块
到现在为止,我们应用可以建立两个发行包:logging.mar和service.aar。其中logging.mar文件是Axis2模块的发行包,该包的目录结构如下:
logging.mar
module\LoggingModule.class
module\LogHandler.class
META-INF\module.xml
service.aar文件是本例编写的WebService发行包,该包的目录结构如下:
service.aar
service\MyService.class
META-INF\services.xml
将logging.mar文件放在<Tomcat安装目录>\webapps\axis2\WEB-INF\modules目录中,将service.aar文件放在<Tomcat安装目录>\webapps\axis2\WEB-INF\services目录中。要注意的是,如果modules目录中包含了modules.list文件,Axis2会只装载在该文件中引用的Axis2模块,因此,必须在该文件中引用logging模块,该文件的内容如下:
addressing-1.4.1.mar
soapmonitor-1.4.1.mar
ping-1.4.1.mar
mex-1.4.1.mar
axis2-scripting-1.4.1.mar
logging.mar
如果modules目录中不包含modules.list文件,则Axis2会装载modules文件中的所有Axis2模块。
现在启动Tomcat,使用如下的C#代码调用MyService的getGreeting方法则会在Tomcat控制台中输出相应的请求和响应SOAP消息。
async.myService my = new WSC.asyn.myService();
MessageBox.Show(my.getGreeting("中国"));
MessageBox.Show("完成调用");
在执行上面的代码后,在Tomcat控制台中输出的信息如下图所示。
转载于:https://www.cnblogs.com/weipeng/archive/2012/04/16/2451326.html
WebService大讲堂之Axis2(9):编写Axis2模块(Module)相关推荐
- WebService大讲堂之Axis2(6):跨服务会话(Session)管理
在<WebService大讲堂之Axis2(5):会话(Session)管理>一文中介绍了如何使用Axis2来管理同一个服务的会话,但对于一个复杂的系统,不可能只有一个WebService ...
- WebService大讲堂之Axis2(4):二进制文件传输
在< WebService大讲堂之Axis2(2):复合类型数据的传递 >中讲过,如果要传递二进制文件(如图像.音频文件等),可以使用byte[] 作为数据类型进行传递,然后客户端使用RP ...
- WebService大讲堂之Axis2(3):使用services.xml文件发布WebService
用Axis2 实现Web Service ,虽然可以将POJO 类放在axis2\WEB-INF\pojo 目录中直接发布成Web Service ,这样做不需要进行任何配置,但这些POJO 类不能在 ...
- WebService大讲堂之Axis2(1):用POJO实现0配置的WebService
Axis2 是一套崭新的WebService 引擎,该版本是对Axis1.x 重新设计的产物.Axis2 不仅支持SOAP1.1 和SOAP1.2 ,还集成了非常流行的REST WebService ...
- WebService大讲堂之Axis2(5):会话(Session)管理
WebService给人最直观的感觉就是由一个个方法组成,并在客户端通过SOAP协议调用这些方法.这些方法可能有返回值,也可能没有返回值.虽然这样可以完成一些工具,但这些被调用的方法是孤立的,当一个方 ...
- WebService报错:org.apache.axis2.AxisFault: The given SOAPAction aaa does not match an operation.
最近在写webservice接口,首先是用cxf发布了webservice接口,现在要求用axis2去远程调用cxf写的接口,遇到了一个错误:org.apache.axis2.AxisFault: T ...
- WebService开发与代码的编写
WebService开发与代码的编写 大家或多或少都听过 WebService(Web服务),有一段时间很多计算机期刊.书籍和网站都大肆的提及和宣传WebService技术,其中不乏很多吹嘘和做广告的 ...
- 如何编写Python模块/包?
本文翻译自:How to write a Python module/package? I've been making Python scripts for simple tasks at work ...
- [转]使用 C 编写 Lua 模块
Lua 作为一种小巧的语言,一般都是嵌入到 C/C++ 中作为扩展语言,但是也可以作为独立的脚本语言使用,并且可以使用 C/C++ 编写扩展模块.在参考资料 [1] 中有怎样用 C/C++ 编写模块的 ...
最新文章
- qt udp多线程收发过程_! udp多线程的有关问题
- Mybatis中 Dao接口和XML文件的SQL如何建立关联
- Boost.Flyweight 序列化示例
- appcan 微信支付
- 创建线程的三种方法_Netty源码分析系列之NioEventLoop的创建与启动
- java applet程序设计,Java Applet程序设计基础
- 一个持续6年的针对多国政府机构的网络间谍活动 — “美人鱼行动”
- 逻辑卷备份mysql脚本_对MySQL进行逻辑卷备份与恢复
- 算法高级(10)-如何实现浏览器的前进、后退功能
- Linux安装MYSQL5.7教程(一次成功)
- micropython和python区别-MicroPython简介
- TOMCAT中使用HTTPS的过程
- 315页 A Tutorial on Graph Neural Networks for NLP
- Win7部署Web网站之IIs安装篇
- R语言——查看内置数据集
- python写邮箱系统登录_Python selenium登录163邮箱示例
- 从零搭建自动化测试平台
- 幼儿园手工之自制时钟_「时钟手工」幼儿园玩教具手工时钟,培养孩子的时间观念...
- java面试题(一)java面试题集合
- winform 中自定义有透明度的panel,可用于加载遮盖层
热门文章
- SQL server触发器中 update insert delete 分别给写个例子被。
- JavaScript 变量、函数与原型链
- linux虚拟用户创建目录权限不足,centos7的FTP服务vsftpd里建立虚拟用户不同目录分配不同权限...
- android accessibilityservice自动点击_【Android】无障碍服务(一)入门轻踩
- 1396: 队列问题(2)
- 一朵云、一张网、一体化 ——GRTN 打造最佳流媒体场景实践
- 唯品会在 Flink 容器化与平台化上的建设实践
- 《荣耀战魂》的环境设计制作经验
- Unity图片优化神器 - dither算法究极进化方案
- 论https和http谁对网站优化更友好