axis2创办Module

2012-09-09

axis2创建Module创建Module Axis2模块至少需要有两个类，这两个类分别实现了Module和Handler接口?构造和部

axis2创建Module

创建Module

Axis2模块至少需要有两个类，这两个类分别实现了Module和Handler接口

构造和部署 Module 分为以下几个步骤：

现在来创建一个简单的 Logging Module ，这个 Module 包含一个 Hander ，它的作用就是纪录通过它的消息。 Axis 通过 *.mar 来部署 Modules ，下图就是这个部署包的结构

axis2创办Module
Step 1: 创建 LoggingModule Class

Logging Module 是 Axis2 Module 的实现，它必须实现 org.apache.axis2.modules.Module 接口：

Step 2: 创建 LogHandler

Axis 的一个 Module 可以包含一个或者多个 Handler 。这些 Handler 将处理 Soap 头文件中的不同 phases 。一个 Handler 必须实现 org.apache.axis2.engine.Handler 接口，或者通过另一种简单方式，继承 org.apache.axis2.handlers.AbstractHandler 类

public class LogHandler extends AbstractHandler implements Handler {

private Log log = LogFactory.getLog(getClass());

??? private QName name;

public QName getName() {

??????? return name;

??? }

??? public void invoke(MessageContext msgContext) throws AxisFault {

??????? log.info(msgContext.getEnvelope().toString());

??? }

??? public void setName(QName name) {

??????? this.name = name;

??? }

}

Step 3: module.xml

这个文件包含了一个特定 Module 的部署配置。

??????? <handler name="InFlowLogHandler" style="margin: 0cm 0cm 0pt;">??????? <order phase="loggingPhase" />

??????? </handler>

?? </inflow>

?? <outflow>

??????? <handler name="OutFlowLogHandler" style="margin: 0cm 0cm 0pt;">??????? <order phase="loggingPhase"/>

??????? </handler>

?? </outflow>

?? <Outfaultflow>

??????? <handler name="FaultOutFlowLogHandler" style="margin: 0cm 0cm 0pt;">??????? <order phase="loggingPhase"/>

??????? </handler>

?? </Outfaultflow>

?? <INfaultflow>

??????? <handler name="FaultInFlowLogHandler" style="margin: 0cm 0cm 0pt;">??????? <order phase="loggingPhase"/>

??????? </handler>

?? </INfaultflow>

</module>

"<order phase="loggingPhase" />" describes the phase in which this handler runs.

还一种配置情况是?：

module.xml e中仅仅配置一些东西如下：

<module name="logging"? style="margin: 0cm 0cm 0pt;">?但是这样比较麻烦是在axis2.xml u中的配置相对复杂些，如下

.....在OutFlow,InFaultFlow,OutFaultFlow的标签中都要添加完成的配置信息

Step 4: 修改 axis2.xml

在前面用的 ”loggingPhase” 不是一个 pre-defined handler phase ，因此， module 的创建者需要将它介绍给 axis2.xml 于是 Axis 引擎就可以知道在不同的 ’flow’ 中如何放那些 handlers 。

这些增加是在 axis2.xml 的 Phases 部分，在标志了  之后加入

<phase name=" loggingPhase"/>? --------- 和module.xml中的? <order phase="loggingPhase"/>对应

</phaseOrder>

这样，这个 phase 将在引擎的任何消息流中调用

Step 5: 修改 service.xml

到目前为止， logging module 已经做好了，现在需要在服务中使用这个 module ，那么就要修改服务的 service.xml 。在该文件中加上了 "<module ref="logging"/>"

Step 6: 打包

将这个包打成 jar 或者 rar ，然后改后缀名为 mar 。

Step 7: 在 Axis2 中部署这个 Module

首先要在 "webapps/axis2/WEB-INF" 目录下创建一个 modules 文件夹，然后将 *.mar 文件放在这个文件夹中，然后重启 Axis 并运行服务进行测试

热点排行

软件架构设计

axis2创办Module