???? axis2 有三种配置文件 用来配置系统.第一个是用来配置整个系统(全局配置)--axis2.xml.第二个是配置一个服务(服务配置),第三个是配置一个module .
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的配置,还没搞懂,先不写了.