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 config

2、uration). 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 v

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

5、 - - - - - - - - - - - - - - 名师精心整理 - - - - - - - 第 1 页，共 9 页 - - - - - - - - - http,tcp,smtp,CommonsHTTP 等 。 当 系统 启 动 或 者 你 在 客户 端 设 置 传 输 器（transport ）的时候，你可以使用这些传输名字（transport names ）装载合适的传输器。 class属性是为了指明为该传输器实现需要的接口的实际的java 类。任何的传输都可以有 0 个或多个参数，任何给定的参数可以通过相应的传输接收端访问。Transport Sender ：正如传输接收者，你可

6、以在系统中注册传输发送者，也可以在运行时进行。发送者可以用来发送消息。 例如，假设 Axis2 运行于 Apache Tomcat中。那么 Axis2 可以使用 TCP传输发送器来发送消息， 而不是 http。指明传输发送者的方法如下：xml 代码 HTTP/1.0parameter name ：传输的名字，可以是http 或者 http1。class ：相应传输的实现类。和传输接收者一样，传输发送者可以有0 个或多个参数（例如例子中有一个parameter ） ，如果存在，它们可以通过相应的传输发送者得到。Phase Order ：指明执行链中阶段的顺序必须使用phase order元素。如

7、下：xml 代码 最有趣的是你也可以在这里添加handler。如果你想要添加一个handler到一个阶段中，你可以直接通过在它里面添加一个handler元素来实现。除此之外， Axis2中没有其他的进行handler 链硬编码的地方。因此，所有的那些配置也在phase order元素中完成。完整的代码如下：xml 代码 名师资料总结 - - -精品资料欢迎下载 - - - - - - - - - - - - - - - - - - 名师精心整理 - - - - - - - 第 2 页，共 9 页 - - - - - - - - - 名师资料总结 - - -精品资料欢迎下载 - - - - -

8、- - - - - - - - - - - - - 名师精心整理 - - - - - - - 第 3 页，共 9 页 - - - - - - - - - type：代表流的类型的属性，只能是以下几种：InFlow OutFlow InFaultFlow OutFaultFlow 除此之外，允许在phaseOrder内出现的元素是 phase元素。 phase元素代表了执行链中可用的 phases 。在 phaseOrder中指明 phase的方法如下：xml 代码 name ：phase的名字。改变 phaseOrder的时候，必须牢记一些事情：如果 phaseOrder的类型是 InFlow

9、 和 InFaultFlow 1. 所有在 Dispatch阶段（phase ） 上的阶段，包括它本身，都是全局阶段 （Global Phase ） 。 你可以在这里添加任意数量的新阶段，这些阶段都可以被认为是全局的。2.在这两个 phaseOrder类型中，添加在 Dispatch之后的阶段， 被认为是操作阶段（Operation Phase ） 。如果 phaseOrder类型是 OutFlow 和 OutFaultFlow 1.所有在 MessageOut阶段 （phase ） 下的阶段，包括它本身，都是全局阶段（Global Phase ） 。你可以根据需求添加任意新的阶段。2.添加在

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

11、2 中，AxisConfiguration 是可被监听的，因此你可以把监听器注册进去。 当 AxisConfiguration 发生改变时， 监听器会自动得被通知到。就现在的实现而言，监听器会被通知到下述事件：Deploying a service Removing a service Activate/Inactivate Service Module deploy Module Remove 注册监听器对附加的功能非常有用，例如RSS 种子的生成，它将向订阅者提供服务信息。下面是注册监听器的正确方法：xml 代码 http:/127.0.0.1/rssparameter listener

12、class ：代表监听器的实现类， 需要注意该实现类必须实现AxisObserver 接口，并且必须在 classpath中。服务配置（ Service Configuration）书写 services.xml：服务的描述使用services.xml指明。每个服务 .aar文件都需要一个 services.xml文件以便成为有效的服务， 并且这个文件应该放置在META-INF目录下。一个非常简单的services.xml如下：xml 代码 The description of the service HTTPtransport messageReceivers org.apache.axis

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

14、任务。targetNameSpace ： （可选属性）服务的命名空间。 这个值将在生成 WSDL 时用到。如果不指定，这个值将会根据服务实现类的包名生成。description：（可选） 如果你想通过 Axis2 web-admin 模块显示关于 service的描述，可以使用该标签。transports ： （可选）服务将被发布成什么传输方式。如果 transport标签没有出现，那么服务将会以系统中支持的所有传输协议发布。transport子元素指明传输前缀（也就是 axis2.xml 指定的传输的名字）。parameters ：services.xml 可以包含任意数量的顶级parame

15、ters ，所有的指定的parameters将会转换成相应的AxisService 中的服务属性。 services.xml 中有一个强制性参数叫做 ServiceClass指定 java 类，该 java 类执行上面的转换， 这个类由MessageReceiver装载。名师资料总结 - - -精品资料欢迎下载 - - - - - - - - - - - - - - - - - - 名师精心整理 - - - - - - - 第 6 页，共 9 页 - - - - - - - - - operations ：如果服务实现类是java，该服务中所有的公用方法都会被公开。如果用户想覆盖它，就需要使用

16、operations标签。在一个非java 环境或者没有服务类的情况下，用户想发布的所有方法都必须在services.xml中指定。例如：xml 代码 operation name 是唯一必须的属性，它代表将被发布的操作的名字。操作可以包含模块指针也可以包括任何数量的参数。 最有趣的是你可以为每个操作注册客户消息接收器。从而，注册的消息接收器将成为相应的操作的消息接收器。如果你不指定消息接收器，那么默认的消息接收器将执行操作。模块配置（ Module Configuration）书写 module.xml 模块的描述使用 module.xml 描述。每个 mar 文件需要 module.xml

17、 文件以便成为有效的模块，并且，这个文件需要放在模块的META-INF 文件夹下。下面是一个非常简单的 module.xml 文件。xml 代码 . . InFlow . . OutFlow . . 名师资料总结 - - -精品资料欢迎下载 - - - - - - - - - - - - - - - - - - 名师精心整理 - - - - - - - 第 7 页，共 9 页 - - - - - - - - - OutFaultFlow . . InFaultFlow 10parameter operation module class ： （可选参数）说明模块的实现类，一个模块可以包含实现类

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

19、ou 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 页 - - - - - - - - - oper

20、ations：如果一个模块想在它在某个服务中启动时增加一个操作的话，可以通过在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 页 - - - - - - - - -