herodby
技术 笔记
posts - 14,  comments - 14,  trackbacks - 0
    axis2 有三种配置文件 用来配置系统.第一个是用来配置整个系统(全局配置)--axis2.xml.第二个是配置一个服务(服务配置),第三个是配置一个module .
    1:全局配置----axis2.xml
         所有axis2启动时需要的配置都在包括在axis2.xml文件中.在这个文件中,我们可以看到有6个顶级节点,列表如下:
        
  • Parameter
  • Transport Receiver
  • Transport Sender
  • Phase Order
  • Module References
  • Listeners (Observers)

    Parameter
          这个节点只有一个name属性,和一个value值.每个顶级的parameter节点定义的值都会被写到AxisConfiguration 对象的属性里.因此在系统运行时,我们可以通过AxisConfiguration对象来获得在axis2.xml中配置的顶级parameter节点的值.配置一个parameter的正确方法 如下所示:

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

    Transport Receiver
         
    <transportReceiver name="http"                                                                                            class="org.apache.axis2.transport.http.SimpleHTTPServer">
            <parameter name="port" >6060</parameter>
    </transportReceiver>
         transpaortReceiver元素的name属性,代表了数据传输的名字,可以是 "http,tcp , smtp , commonshttp stc "   ,当系统启动的时候,或者在客户端设置transport的时候,就可以使用在这里命名的transport,来装载相应的transport.
        class属性 描述了实际的java类 ,这个类必须扩展了transport接口.任何transport都可以有0个或者任意多个参数,如果设置了参数,那么这些参数可以被相应的transpaortReceiver 获得.

         Transport Senders
             和Transport Receiver一样,它也是注册倒系统里, 在以后运行时,用来发送消息.
     <transportSender name="http" class="org.apache.axis2.transport.http.CommonsHTTPTransportSender">
            <parameter name="PROTOCOL" locked="xsd:false">HTTP/1.0</parameter>
    </transportSender>
        这个配置段的属性解释和Transport Receiver类似,就不做介绍了.

    Phase Order
        使用 phase order元素,具体描述在执行链中必须被执行的步骤顺序.
    <phaseOrder type="inflow">
             <phase name="Transport">
                            <handler name="RequestURIBasedDispatcher"
                         class="org.apache.axis2.engine.RequestURIBasedDispatcher">
                             <order phase="Dispatch"/>
                      </handler>
                      <handler name="SOAPActionBasedDispatcher"
                         class="org.apache.axis2.engine.SOAPActionBasedDispatcher">
                             <order phase="Dispatch"/>
                         </handler>
            </phase>      
             .
             .
    </phaseOrder> 

    令人兴奋的是,你可以在这里增加自己的handler,而且在axis2(任何axis版本)中,都没有handler 链的硬编码框架,也就是说不需要扩展或者继承axis2的什么接口或者类.
    具体例子可以看axis2.xml文件.
    type 属性 必须是下面中的一种:

  • inflow
  • outflow
  • INfaultflow
  • Outfaultflow

    在phaseOrder节点里第一级子节点只允许有phase元素.<phase name="Transport"/>
    前面已经说了,我们可以改变phaseorder,可以增加自己的phase 和handler,但是必须注意:在axis2的4个 flows里面都有 system pre-defined 的phases, 我们不可以改变他们的顺序,你可以在他们的后面增加自己的phase

    Module References
    如果你想使用一个模块系统,那么你可以在axis2.xml中增加一个顶级的module节点.
    <module ref="addressing"/>

    Listeners (Observers)
     axis2中,AxisConfiguration这个类是采用的观察者模式设计的,所以你可以向类中注册自己的观察者类.当AxisConfiguration类发生改变的时候,你的类会被自动调用 目前当以下事件发生时,观察类就会被触发:
     

  • Deploying a Service
  • Removing a service
  • Activate/Inactivate Service
  • Module deploy
  • Module remove

    注册观察者是非常有用的,比如,rss更新的时候,你可以通知订阅者等等.例如:
      <listener class="org.apache.axis2.ObserverIMPL">
          <parameter name="RSS_URL" >http://127.0.0.1/rss</parameter>
      </listener>
      class属性指定的类,必须扩展AxisObserver 这个接口,而且存在于classph中.
    系统配置就这么多了.
    太累了,休息一会,以后再写剩下的2中配置文件..

  • 2 服务配置 service.xml
        <service name="name of the service" scope="name of the scope" targetNamespace="target namespase for the service">
        <description> The description of the service  </description> 

        <transports>
           <transport>HTTP</transport>
        </transports>
       
        <schema schemaNamespace="schema namespace"/>
        
        <messageReceivers>
                <messageReceiver mep="http://www.w3.org/2004/08/wsdl/in-out"
                                 class="org.apache.axis2.rpc.receivers.RPCMessageReceiver"/>
        </messageReceivers>
        
         <parameter name="ServiceClass"     locked="xsd:false">org.apache.axis2.sample.echo.EchoImpl</parameter>
       
        <operation name="echoString" mep="operation MEP">
            <actionMapping>Mapping to action</actionMapping>
            <module ref=" a module name "/>
            <messageReceiver class="org.apache.axis2.receivers.RawXMLINOutMessageReceiver"/>
        </operation>
      </service>
    如果.aar里面只有一个service那么.aar包的名字就是发布的webservice名字,如果有多个service,那么在这里service元素索指定的那么属性值就表示webservice的名字.
    scope属性指明了webservice发布后的作用范围,有"Application","SOAPSession","TransportSession","Request";
    targetNamingSpace  :服务的名字空间,在生成wsdl时会用到.
    transport:   可选的,字面的意思已经很明显了,不多说了,配置的name就是在axis2.xml文件中指明的transport
    parameter属性,一个service.xml可以有任意多个顶级节点的parameter节点.
    parameter里配置的值会被写到AxisService类的属性里,在service.xml文件中至少要有一个parameter 名字是ServiceClass 它的value值指定具体执行服务的java类,这个类会被MessageReciever装载.
    operation比较简单就是用来指明暴露的方法的.不做介绍了.
    剩下module的配置,还没搞懂,先不写了.

    posted on 2006-08-23 18:04 邓兵野 阅读(5473) 评论(0)  编辑  收藏 所属分类: webservice

    只有注册用户登录后才能发表评论。


    网站导航:
     

    <2006年8月>
    303112345
    6789101112
    13141516171819
    20212223242526
    272829303112
    3456789

    常用链接

    留言簿(2)

    随笔分类

    随笔档案

    文章分类

    文章档案

    搜索

    •  

    最新评论

    阅读排行榜

    评论排行榜