2022年axis配置指南[参 .pdf

《2022年axis配置指南[参 .pdf》由会员分享，可在线阅读，更多相关《2022年axis配置指南[参 .pdf（9页珍藏版）》请在淘文阁 - 分享文档赚钱的网站上搜索。

1、Axis2 配置指南（翻译）关键字:Axis2 In Axis2,there are three kinds of configuration files to configure the system.The first one is to configure the whole system(global configuration),the second one is to configure a service(service configuration),and the third one is to configure a module(module configuration).

2、This document explains the above configurations in detail.在 Aixs2 中，有三个文件可以用来配置系统。第一个配置整个系统（全局配置），第二个配置一个服务（服务配置），第三个配置一个模块（模块配置）。本文档详细介绍上面的配置。内容全局配置(axis2.xml)服务配置(services.xml)模块配置(module.xml)全局配置书写 axis2.xml 所有在启动 axis2 时需要的配置信息都从axis2.xml 中取得。指明它们的方法非常简单和容易。此部分都是关于如何在axis2 中以合适的方式指定配置信息的，在配置文件中可

3、以看到六个顶级元素，如下：Parameter Transport Receiver Transport Sender Phase Order Module References Listeners(Observers)Parameter：在 Axis2 中，parameter（参数）就是一个名值对，axis2.xml 中的每个顶级 parameter元素将都被转换成AxisConfiguration 中的属性，因此，配置文档中的顶级参数都可以在运行时环境中通过AxisConfiguration 得到。下面是定义参数的正确的方法：parameter value parameter Transpo

4、rtReceiver:依赖于 Axis2 可能需要运行于其上的传输协议（Depending on the underlying transport on which Axis2 is going to run,），你需要不同的传输接收端。在系统中加入它们的方式如下：6060parameter 上面的元素说明了如何在axis2.xml 中定义传输接收端，这里，transportReceiver标 签 中 的name 属 性 标 识 指 明 传 输 接 收 端 的 类 型，它 可 以 是名师资料总结-精品资料欢迎下载-名师精心整理-第 1 页，共 9 页 -http,tcp,smtp,Common

5、sHTTP 等。当 系统 启 动 或 者 你 在 客户 端 设 置 传 输 器（transport）的时候，你可以使用这些传输名字（transport names）装载合适的传输器。class属性是为了指明为该传输器实现需要的接口的实际的java 类。任何的传输都可以有 0 个或多个参数，任何给定的参数可以通过相应的传输接收端访问。Transport Sender：正如传输接收者，你可以在系统中注册传输发送者，也可以在运行时进行。发送者可以用来发送消息。例如，假设 Axis2 运行于 Apache Tomcat中。那么 Axis2 可以使用 TCP传输发送器来发送消息，而不是 http。指明传

6、输发送者的方法如下：xml 代码 HTTP/1.0parameter name：传输的名字，可以是http 或者 http1。class：相应传输的实现类。和传输接收者一样，传输发送者可以有0 个或多个参数（例如例子中有一个parameter），如果存在，它们可以通过相应的传输发送者得到。Phase Order：指明执行链中阶段的顺序必须使用phase order元素。如下：xml 代码 最有趣的是你也可以在这里添加handler。如果你想要添加一个handler到一个阶段中，你可以直接通过在它里面添加一个handler元素来实现。除此之外，Axis2中没有其他的进行handler 链硬编码的

7、地方。因此，所有的那些配置也在phase order元素中完成。完整的代码如下：xml 代码 名师资料总结-精品资料欢迎下载-名师精心整理-第 2 页，共 9 页 -名师资料总结-精品资料欢迎下载-名师精心整理-第 3 页，共 9 页 -type：代表流的类型的属性，只能是以下几种：InFlow OutFlow InFaultFlow OutFaultFlow 除此之外，允许在phaseOrder内出现的元素是 phase元素。phase元素代表了执行链中可用的 phases。在 phaseOrder中指明 phase的方法如下：xml 代码 name：phase的名字。改变 phaseOrd

8、er的时候，必须牢记一些事情：如果 phaseOrder的类型是 InFlow 和 InFaultFlow 1.所有在 Dispatch阶段（phase）上的阶段，包括它本身，都是全局阶段（Global Phase）。你可以在这里添加任意数量的新阶段，这些阶段都可以被认为是全局的。2.在这两个 phaseOrder类型中，添加在 Dispatch之后的阶段，被认为是操作阶段（Operation Phase）。如果 phaseOrder类型是 OutFlow 和 OutFaultFlow 1.所有在 MessageOut阶段（phase）下的阶段，包括它本身，都是全局阶段（Global Phas

9、e）。你可以根据需求添加任意新的阶段。2.添加在 MessageOut阶段之前的阶段被认为是操作阶段。注意：如果你认真观者默认的axis2.xml，你讲可以明确得发现这些。名师资料总结-精品资料欢迎下载-名师精心整理-第 4 页，共 9 页 -Module References 如果你想要在系统范围内启用一个模块，你可以通过在axis2.xml 文件中增加一个顶级模块元素来实现，例如：xml 代码 ref：将要被启用的模块的名字，系统范围。Listeners（Observers）：在 Axis2 中，AxisConfiguration 是可被监听的，因此你可以把监听器注册进去。当 AxisCo

10、nfiguration 发生改变时，监听器会自动得被通知到。就现在的实现而言，监听器会被通知到下述事件：Deploying a service Removing a service Activate/Inactivate Service Module deploy Module Remove 注册监听器对附加的功能非常有用，例如RSS 种子的生成，它将向订阅者提供服务信息。下面是注册监听器的正确方法：xml 代码 http:/127.0.0.1/rssparameter listener class：代表监听器的实现类，需要注意该实现类必须实现AxisObserver 接口，并且必须在 cla

11、sspath中。服务配置（Service Configuration）书写 services.xml：服务的描述使用services.xml指明。每个服务.aar文件都需要一个 services.xml文件以便成为有效的服务，并且这个文件应该放置在META-INF目录下。一个非常简单的services.xml如下：xml 代码 The description of the service HTTPtransport messageReceivers org.apache.axis2.sample.echo.EchoImplparameter Mapping to actionactionMap

12、ping operation service name：服务的名字将会是.aar文件的名字，如果该文件中只包含一个服务。或者，将是此 name属性指定的名字。scope：（可选属性）说明部署的服务的运行时信息在什么时间段是有效的。该范围有几种类型，Application，SOAPSession，TransportSession，Request，默认值是 Request。class：（可选属性）服务生命周期实现类的全名。服务生命周期类可以在系统启动和关闭是做一些任务。targetNameSpace：（可选属性）服务的命名空间。这个值将在生成 WSDL 时用到。如果不指定，这个值将会根据服务实现类

13、的包名生成。description：（可选）如果你想通过 Axis2 web-admin 模块显示关于 service的描述，可以使用该标签。transports：（可选）服务将被发布成什么传输方式。如果 transport标签没有出现，那么服务将会以系统中支持的所有传输协议发布。transport子元素指明传输前缀（也就是 axis2.xml 指定的传输的名字）。parameters：services.xml 可以包含任意数量的顶级parameters，所有的指定的parameters将会转换成相应的AxisService 中的服务属性。services.xml 中有一个强制性参数叫做 Se

14、rviceClass指定 java 类，该 java 类执行上面的转换，这个类由MessageReceiver装载。名师资料总结-精品资料欢迎下载-名师精心整理-第 6 页，共 9 页 -operations：如果服务实现类是java，该服务中所有的公用方法都会被公开。如果用户想覆盖它，就需要使用operations标签。在一个非java 环境或者没有服务类的情况下，用户想发布的所有方法都必须在services.xml中指定。例如：xml 代码 operation name 是唯一必须的属性，它代表将被发布的操作的名字。操作可以包含模块指针也可以包括任何数量的参数。最有趣的是你可以为每个操作注

15、册客户消息接收器。从而，注册的消息接收器将成为相应的操作的消息接收器。如果你不指定消息接收器，那么默认的消息接收器将执行操作。模块配置（Module Configuration）书写 module.xml 模块的描述使用 module.xml 描述。每个 mar 文件需要 module.xml 文件以便成为有效的模块，并且，这个文件需要放在模块的META-INF 文件夹下。下面是一个非常简单的 module.xml 文件。xml 代码 .InFlow .OutFlow .名师资料总结-精品资料欢迎下载-名师精心整理-第 7 页，共 9 页 -OutFaultFlow .InFaultFlow

16、10parameter operation module class：（可选参数）说明模块的实现类，一个模块可以包含实现类，也可以不包含实现类，这是因为模块也可以是handler 的集合。如果一个模块包含了实现了org.apache.axis2.modules.Module接口的实现类，那么在部署时，它的init()方法将会被调用。parameter：一个模块可以包含任意数量的参数，所有在module.xml 中列出来的参数将被转换成这个module 的相应的 AxisModule。flow：在模块中定义 handlers必须定义在 flows 当中。总共有 4 种 flows 的类型。你可以

17、在一个 flow 当中添加任意数量的handlers。当启动时，那些 handlers将会在相应的链中。(原文：You can add any number of handlers into a flow,and those handlers will be available in the corresponding chains at runtime,when they are engaged.)InFlow OutFlow InFaultFlow OutFaultFlow 名师资料总结-精品资料欢迎下载-名师精心整理-第 8 页，共 9 页 -operations：如果一个模块想在它在某

18、个服务中启动时增加一个操作的话，可以通过在module.xml 中增加一个operation 标签。这里声明操作的方法与在services.xml中声明操作的方法相同。handler：handler元素由必须的和可选的属性组成。定义一个 handler的方法如下：xml 代码 handler 必须的属性：name：handler 的名字。class：handler的实现类。phase：handler在执行链中应该所处的阶段的名字。可选的属性：phaseLast：说明 handler是 phase中的最后一个。phaseFirst：说明 handler是 phase中的第一个。before：说明当前 handler应该在被 before标识的 handler之前被触发。after：说明当前 handler应该在被 after 标识的 handler之后被触发。名师资料总结-精品资料欢迎下载-名师精心整理-第 9 页，共 9 页 -