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
邓兵野 阅读(5499)
评论(0) 编辑 收藏 所属分类:
webservice