文档章节

Axis2配置指南(翻译)

abcijkxyz
 abcijkxyz
发布于 2016/07/08 16:28
字数 2762
阅读 1
收藏 0

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). This document explains the above configurations in detail.

在Aixs2中,有三个文件可以用来配置系统。第一个配置整个系统(全局配置),第二个配置一个服务(服务配置),第三个配置一个模块(模块配置)。本文档详细介绍上面的配置。

内容

全局配置

书写axis2.xml

所有在启动axis2时需要的配置信息都从axis2.xml中取得。指明它们的方法非常简单和容易。此部分都是关于如何在axis2中以合适的方式指定配置信息的,在配置文件中可以看到六个顶级元素,如下:

  • Parameter
  • Transport Receiver
  • Transport Sender
  • Phase Order
  • Module References
  • Listeners (Observers)


    Parameter:在Axis2中,parameter(参数)就是一个名-值对,axis2.xml中的每个顶级parameter元素将都被转换成AxisConfiguration中的属性,因此,配置文档中的顶级参数都可以在运行时环境中通过AxisConfiguration得到。下面是定义参数的正确的方法:

     <parameter name="name of the parameter"></parameter>


    Transport Receiver:依赖于Axis2可能需要运行于其上的传输协议(Depending on the underlying transport on which Axis2 is going to run,),你需要不同的传输接收端。在系统中加入它们的方式如下:

     

    <transportreceiver class="org.apache.axis2.transport.http.SimpleHTTPServer" name="http"> 

        <parameter name="port" >6060parameter>

    </transportreceiver>

     

     

    上面的元素说明了如何在axis2.xml中定义传输接收端,这里,transportReceiver标签中的name属性标识指明传输接收端的类型,它可以是http,tcp,smtp,CommonsHTTP等。当系统启动或者你在客户端设置传输器(transport)的时候,你可以使用这些传输名字(transport names)装载合适的传输器。class属性是为了指明为该传输器实现需要的接口的实际的java类。任何的传输都可以有0个或多个参数,任何给定的参数可以通过相应的传输接收端访问。


    Transport Sender:正如传输接收者,你可以在系统中注册传输发送者,也可以在运行时进行。发送者可以用来发送消息。例如,假设Axis2运行于Apache Tomcat中。那么Axis2可以使用TCP传输发送器来发送消息,而不是http。指明传输发送者的方法如下:

    xml 代码
    <transportSender name="http" class="org.apache.axis2.transport.http.CommonsHTTPTransportSender">  
         <parameter name="PROTOCOL" locked="xsd:false">HTTP/1.0parameter>
    </transportSender>

    name:传输的名字,可以是http或者http1。

    class:相应传输的实现类。

    和传输接收者一样,传输发送者可以有0个或多个参数(例如例子中有一个parameter),如果存在,它们可以通过相应的传输发送者得到。



    Phase Order:指明执行链中阶段的顺序必须使用phase order元素。如下:

    xml 代码
    <phaseOrder type="InFlow"> 
       <phase name="TransportIn"/>  
       .
       .
    </phaseOrder> 

    最有趣的是你也可以在这里添加handler。如果你想要添加一个handler到一个阶段中,你可以直接通过在它里面添加一个handler元素来实现。除此之外,Axis2中没有其他的进行handler链硬编码的地方。因此,所有的那些配置也在phase order元素中完成。完整的代码如下:

     

    xml 代码
    1. <phaseOrder type="InFlow">  
    2.           
    3.          <phase name="Transport">  
    4.             <handler name="RequestURIBasedDispatcher"  
    5.                      class="org.apache.axis2.dispatchers.RequestURIBasedDispatcher">  
    6.                 <order phase="Transport"/>  
    7.             handler>  
    8.   
    9.             <handler name="SOAPActionBasedDispatcher"  
    10.                      class="org.apache.axis2.dispatchers.SOAPActionBasedDispatcher">  
    11.                 <order phase="Transport"/>  
    12.             handler>  
    13.         phase>  
    14.         <phase name="Security"/>  
    15.         <phase name="PreDispatch"/>  
    16.         <phase name="Dispatch" class="org.apache.axis2.engine.DispatchPhase">  
    17.             <handler name="AddressingBasedDispatcher"  
    18.                      class="org.apache.axis2.dispatchers.AddressingBasedDispatcher">  
    19.                 <order phase="Dispatch"/>  
    20.             handler>  
    21.   
    22.             <handler name="SOAPMessageBodyBasedDispatcher"  
    23.                      class="org.apache.axis2.dispatchers.SOAPMessageBodyBasedDispatcher">  
    24.                 <order phase="Dispatch"/>  
    25.             handler>  
    26.   
    27.             <handler name="InstanceDispatcher"  
    28.                      class="org.apache.axis2.engine.InstanceDispatcher">  
    29.                 <order phase="Dispatch"/>  
    30.             handler>  
    31.         phase>  
    32.           
    33.           
    34.         <phase name="OperationInPhase"/>  
    35.     phaseOrder>  
    36.     <phaseOrder type="OutFlow">  
    37.           
    38.         <phase name="OperationOutPhase"/>  
    39.           
    40.           
    41.         <phase name="MessageOut"/>  
    42.         <phase name="PolicyDetermination"/>  
    43.     phaseOrder>  
    44.     <phaseOrder type="InFaultFlow">  
    45.         <phase name="PreDispatch"/>  
    46.         <phase name="Dispatch" class="org.apache.axis2.engine.DispatchPhase">  
    47.             <handler name="RequestURIBasedDispatcher"  
    48.                      class="org.apache.axis2.dispatchers.RequestURIBasedDispatcher">  
    49.                 <order phase="Dispatch"/>  
    50.             handler>  
    51.   
    52.             <handler name="SOAPActionBasedDispatcher"  
    53.                      class="org.apache.axis2.dispatchers.SOAPActionBasedDispatcher">  
    54.                 <order phase="Dispatch"/>  
    55.             handler>  
    56.   
    57.             <handler name="AddressingBasedDispatcher"  
    58.                      class="org.apache.axis2.dispatchers.AddressingBasedDispatcher">  
    59.                 <order phase="Dispatch"/>  
    60.             handler>  
    61.   
    62.             <handler name="SOAPMessageBodyBasedDispatcher"  
    63.                      class="org.apache.axis2.dispatchers.SOAPMessageBodyBasedDispatcher">  
    64.                 <order phase="Dispatch"/>  
    65.             handler>  
    66.             <handler name="InstanceDispatcher"  
    67.                      class="org.apache.axis2.engine.InstanceDispatcher">  
    68.                 <order phase="Dispatch"/>  
    69.             handler>  
    70.         phase>  
    71.           
    72.         <phase name="OperationInFaultPhase"/>  
    73.     phaseOrder>  
    74.     <phaseOrder type="OutFaultFlow">  
    75.           
    76.         <phase name="OperationOutFaultPhase"/>  
    77.         <phase name="PolicyDetermination"/>  
    78.         <phase name="MessageOut"/>  
    79.     phaseOrder>  

    type:代表流的类型的属性,只能是以下几种:

  • InFlow
  • OutFlow
  • InFaultFlow
  • OutFaultFlow

    除此之外,允许在phaseOrder内出现的元素是phase元素。phase元素代表了执行链中可用的phases。在phaseOrder中指明phase的方法如下:

    xml 代码
    1. <phase name="Transport"/>  

    name:phase的名字。

     改变phaseOrder的时候,必须牢记一些事情:

    如果phaseOrder的类型是InFlow和InFaultFlow

    1.  所有在"Dispatch"阶段(phase)上的阶段,包括它本身,都是全局阶段(Global Phase)。你可以在这里添加任意数量的新阶段,这些阶段都可以被认为是全局的。

    2.在这两个phaseOrder类型中,添加在Dispatch之后的阶段,被认为是操作阶段(Operation Phase)。

    如果phaseOrder类型是OutFlow和OutFaultFlow

    1.所有在"MessageOut"阶段(phase)下的阶段,包括它本身,都是全局阶段(Global Phase)。你可以根据需求添加任意新的阶段。

    2.添加在MessageOut阶段之前的阶段被认为是操作阶段。

    注意:如果你认真观者默认的axis2.xml,你讲可以明确得发现这些。


    Module References

    如果你想要在系统范围内启用一个模块,你可以通过在axis2.xml文件中增加一个顶级模块元素来实现,例如:

    xml 代码
    1. <module ref="addressing" />  

    ref:将要被启用的模块的名字,系统范围。



    Listeners(Observers):在Axis2中,AxisConfiguration是可被监听的,因此你可以把监听器注册进去。当AxisConfiguration发生改变时,监听器会自动得被通知到。就现在的实现而言,监听器会被通知到下述事件:

    Deploying a service

    Removing a service

    Activate/Inactivate Service

    Module deploy

    Module Remove

    注册监听器对附加的功能非常有用,例如RSS种子的生成,它将向订阅者提供服务信息。下面是注册监听器的正确方法:

    xml 代码
    1. <listener class="org.apache.axis2.ObserverIMPL">  
    2.     <parameter name="RSS_URL" >http://127.0.0.1/rssparameter>  
    3. listener>  

    class:代表监听器的实现类,需要注意该实现类必须实现AxisObserver接口,并且必须在classpath中。


    服务配置(Service Configuration)

    书写services.xml:服务的描述使用services.xml指明。每个服务.aar文件都需要一个services.xml文件以便成为有效的服务,并且这个文件应该放置在META-INF目录下。一个非常简单的services.xml如下:

    xml 代码
    1. <service name="name of the service" scope="name of the scope" class="full qualifide name the service lifecycle class"   targetNamespace="target namespase for the service">  
    2.     <description> The description of the service  description>     
    3.   
    4.     <transports>    
    5.        <transport>HTTPtransport>  
    6.     transports>  
    7.        
    8.     <schema schemaNamespace="schema namespace"/>    
    9.         
    10.     <messageReceivers>  
    11.             <messageReceiver mep="http://www.w3.org/2004/08/wsdl/in-out"  
    12.                              class="org.apache.axis2.rpc.receivers.RPCMessageReceiver"/>  
    13.     messageReceivers>  
    14.         
    15.      <parameter name="ServiceClass" locked="xsd:false">org.apache.axis2.sample.echo.EchoImplparameter>  
    16.        
    17.     <operation name="echoString" mep="operation MEP">    
    18.         <actionMapping>Mapping to actionactionMapping>  
    19.         <module ref=" a module name "/>  
    20.         <messageReceiver class="org.apache.axis2.receivers.RawXMLINOutMessageReceiver"/>  
    21.     operation>  
    22.   service>  

    name:服务的名字将会是.aar文件的名字,如果该文件中只包含一个服务。或者,将是此name属性指定的名字。

    scope:(可选属性)说明部署的服务的运行时信息在什么时间段是有效的。该范围有几种类型,"Application","SOAPSession","TransportSession","Request",默认值是"Request"。

    class:(可选属性)服务生命周期实现类的全名。服务生命周期类可以在系统启动和关闭是做一些任务。

    targetNameSpace:(可选属性)服务的命名空间。这个值将在生成WSDL时用到。如果不指定,这个值将会根据服务实现类的包名生成。

    description:(可选)如果你想通过Axis2 web-admin模块显示关于service的描述,可以使用该标签。

    transports:(可选)服务将被发布成什么传输方式。如果transport标签没有出现,那么服务将会以系统中支持的所有传输协议发布。transport子元素指明传输前缀(也就是axis2.xml指定的传输的名字)。

    parameters:services.xml可以包含任意数量的顶级parameters,所有的指定的parameters将会转换成相应的AxisService中的服务属性。services.xml中有一个强制性参数叫做ServiceClass指定java类,该java类执行上面的转换,这个类由MessageReceiver装载。

    operations:如果服务实现类是java,该服务中所有的公用方法都会被公开。如果用户想覆盖它,就需要使用"operations"标签。在一个非java环境或者没有服务类的情况下,用户想发布的所有方法都必须在services.xml中指定。例如:

    xml 代码
    1. <operation name="echoString">  
    2.     <module ref=" a module name "/>  
    3.     <messageReceiver class="org.apache.axis2.receivers.RawXMLINOutMessageReceiver"/>  
    4. operation>  

    name是唯一必须的属性,它代表将被发布的操作的名字。操作可以包含模块指针也可以包括任何数量的参数。最有趣的是你可以为每个操作注册客户消息接收器。从而,注册的消息接收器将成为相应的操作的消息接收器。如果你不指定消息接收器,那么默认的消息接收器将执行操作。


    模块配置(Module Configuration)

    书写module.xml

    模块的描述使用module.xml描述。每个mar文件需要module.xml文件以便成为有效的模块,并且,这个文件需要放在模块的META-INF文件夹下。下面是一个非常简单的module.xml文件。

    xml 代码
    1. <module class="org.apache.module.Module1Impl">  
    2.     <InFlow>  
    3.         .   
    4.         .   
    5.     InFlow>  
    6.     <OutFlow>  
    7.         .   
    8.         .   
    9.     OutFlow>  
    10.   
    11.     <OutFaultFlow>  
    12.         .      
    13.         .   
    14.     OutFaultFlow>  
    15.   
    16.     <InFaultFlow>  
    17.         .            
    18.         .   
    19.     InFaultFlow>  
    20.   
    21.     <operation name="creatSeq" mep="MEP_URI_IN_OUT">  
    22.         <messageReceiver class="org.apache.axis2.receivers.RawXMLINOutMessageReceiver"/>  
    23.         <parameter name="para1" locked="xsd:true">10parameter>  
    24.     operation>  
    25. module>  

    class:(可选参数)说明模块的实现类,一个模块可以包含实现类,也可以不包含实现类,这是因为模块也可以是handler的集合。如果一个模块包含了实现了org.apache.axis2.modules.Module接口的实现类,那么在部署时,它的init()方法将会被调用。

    parameter:一个模块可以包含任意数量的参数,所有在module.xml中列出来的参数将被转换成这个module的相应的AxisModule。

    flow:在模块中定义handlers必须定义在flows当中。总共有4种flows的类型。

    你可以在一个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

    operations:如果一个模块想在它在某个服务中启动时增加一个操作的话,可以通过在module.xml中增加一个operation标签。这里声明操作的方法与在services.xml中声明操作的方法相同。

    handler:handler元素由必须的和可选的属性组成。定义一个handler的方法如下:

    xml 代码
    1. <handler name="handler1" class="handlerClass ">  
    2.             <order phase="userphase1" />  
    3.  handler>  

    必须的属性:

    name:handler的名字。

    class:handler的实现类。

    phase:handler在执行链中应该所处的阶段的名字。

    可选的属性:

    phaseLast:说明handler是phase中的最后一个。

    phaseFirst:说明handler是phase中的第一个。

    before:说明当前handler应该在被before标识的handler之前被触发。

    after:说明当前handler应该在被after标识的handler之后被触发。

  • 本文转载自:http://blog.csdn.net/yuwenruli/article/details/6670417

    共有 人打赏支持
    abcijkxyz
    粉丝 63
    博文 6196
    码字总数 1876
    作品 0
    深圳
    项目经理
    私信 提问
    Apache Axis2 1.5.2 发布

    Apache Axis2 对Axis1进行了重新设计,支持SOAP1.2/REST以及更多。 改进内容: [AXIS2-3290] surefire is still run even if maven.test.skip is true [AXIS2-4113] Unable to sign axis2 j......

    红薯
    2010/09/27
    710
    0
    MyEclipse6.0 安装axis2插件, 调用加密的SAP webservice

    首先鄙视一下自己,还在用myeclipse,竟然还是6.0版本,没办法,用习惯了,而且自己的开发机配置不高,装过一些别的IDE,发现用的都不是很流畅。 项目要用java调用sap的webservice接口,自己决...

    苏文
    2013/06/06
    0
    0
    Eclipse中开发webservice

    eclipse开发webservie 1.下载axis2相关架包----war,bin是必须的; axis2的eclipse插件(2个)-http://apache.dataguru.cn/axis/axis2/java/core/org.apache.axis2.eclipse.codegen.plugin0.0......

    绿林小子
    2015/11/04
    0
    0
    使用axis2发布web service

    Axis2是一套崭新的WebService引擎,该版本是对Axis1.x重新设计的产物。Axis2不仅支持SOAP1.1和SOAP1.2,还集成了非常流行的REST WebService,同时还支持Spring、JSON等技术。这些都将在后面的...

    NotFoundException
    2013/03/13
    0
    0
    教程:如何用Axis2开发和部署Web服务

    引言 Axis2 是下一代 Apache Axis。Axis2 虽然由 Axis 1.x 处理程序模型提供支持,但它具有更强的灵活性并可扩展到新的体系结构。Axis2 基于新的体系结构进行了全新编写,而且没有采用 Axis...

    小磨磨牙
    2010/10/24
    0
    0

    没有更多内容

    加载失败,请刷新页面

    加载更多

    MySQL 主从同步

    MySQL主从介绍 MySQL主从又叫做Replication、AB复制。简单讲就是A和B两台机器做主从后,在A上写数据,另外一台B也会跟着写数据,两者数据实时同步的 MySQL主从是基于binlog的,主上须开启bin...

    野雪球
    5分钟前
    0
    0
    OSChina 周一乱弹 —— 温柔的人应该这样

    Osc乱弹歌单(2018)请戳(这里) 【今日歌曲】 @clouddyy :#每日一歌# 《フィクション-sumika》 《フィクション-sumika》 手机党少年们想听歌,请使劲儿戳(这里) 假期时间干嘛去, @for...

    小小编辑
    54分钟前
    52
    6
    [LintCode] Serialize and Deserialize Binary Tree(二叉树的序列化和反序列化)

    描述 设计一个算法,并编写代码来序列化和反序列化二叉树。将树写入一个文件被称为“序列化”,读取文件后重建同样的二叉树被称为“反序列化”。 如何反序列化或序列化二叉树是没有限制的,你...

    honeymose
    今天
    6
    0
    java框架学习日志-7(静态代理和JDK代理)

    静态代理 我们平时去餐厅吃饭,不是直接告诉厨师做什么菜的,而是先告诉服务员点什么菜,然后由服务员传到给厨师,相当于服务员是厨师的代理,我们通过代理让厨师炒菜,这就是代理模式。代理...

    白话
    今天
    29
    0
    Flink Window

    1.Flink窗口 Window Assigner分配器。 窗口可以是时间驱动的(Time Window,例如:每30秒钟),也可以是数据驱动的(Count Window,例如:每一百个元素)。 一种经典的窗口分类可以分成: 翻...

    满小茂
    今天
    20
    0

    没有更多内容

    加载失败,请刷新页面

    加载更多

    返回顶部
    顶部