本部分介紹的所有的WSDD元素的名稱(chēng)空間都是"http://xml.apache.org/axis/wsdd/"。
<deployment>
告訴Axis Engine這是一個(gè)部署描述文件。一個(gè)部署描述文件可以表示一個(gè)完整的engine配置或者將要部署到一個(gè)活動(dòng)active的一部分組件。
<GlobalConfiguration>
用于控制engine范圍的配置。可以包含以下子元素：
· <parameter> : 用來(lái)設(shè)置Axis的各種屬性，參考Global Axis Configuration，可以配置任意數(shù)量的參數(shù)元素.
· <role> : 設(shè)置一個(gè)SOAP actor/role URI，engine可以對(duì)它進(jìn)行識(shí)別。這允許指向這個(gè)role的SOAP headers成功的被engine處理。任意數(shù)量.
· <requestFlow> : 全局的請(qǐng)求Handlers。在調(diào)用實(shí)際的服務(wù)之前調(diào)用.
· <responseFlow> : 全局響應(yīng)Handlers，在調(diào)用完實(shí)際的服務(wù)后，還沒(méi)有返回到客戶(hù)端之前調(diào)用.
<requestFlow [name="name"] [type="type"] >
可以放置任意多個(gè)<handler> or <chain>在<requestFlow>中，但是可能只有一個(gè)<requestFlow>.
<responseFlow [name="name"] [type="type"] >
This is used to configure handlers in response flow. You may put any number of <handler> or <chain> elements (see below) inside the <responseFlow>, but there may only be one <responseFlow>.
<undeployment>
部署文檔的根元素，用于指示Axis這是個(gè)卸載描述文件.
<handler [name="name"] type="type">
位于頂層元素<deployment> or <undeployment>, or inside a <chain>, <requestFlow>, or <responseFlow>. 用于定義Handler，并定義handler的類(lèi)型。"Type" 可以是已經(jīng)定義的Handler或者是"java:class.name"形式的QName。可選的"name"屬性允許將這個(gè)Handler的定義在其他部署描述部分中引用。可以包含任意數(shù)量的<parameter name="name" value="value">元素.
<service name="name" provider="provider" >
部署/卸載一個(gè)Axis服務(wù)。這是最復(fù)雜的一個(gè)WSDD標(biāo)簽。
Options可能通過(guò)以下元素來(lái)指定: <parameter name="name" value="value"/>, 一些常用的包括:
· className : 后臺(tái)實(shí)現(xiàn)的類(lèi)
· allowedMethods : 每個(gè)provider可以決定那些方法允許web services訪問(wèn)
Axis支持的providers有如下幾種:
Java RPC Provider (provider="java:RPC") 默認(rèn)情況下所有的public方法都可以web service方式提供
Java MsgProvder (provider="java:MSG")
為了更進(jìn)一步的限制上面的方法，allowedMethods選項(xiàng)用于指定一個(gè)以空格分隔的方法名，只有這些方法可以通過(guò)web service訪問(wèn)。也可以將這個(gè)值指定為”*”表示所有的方法都可以訪問(wèn)。同時(shí)operation元素用來(lái)更進(jìn)一步的定義被提供的方法，但是它不能決定方法的可見(jiàn)性.
注意，發(fā)布任何web service都有安全含義.
· allowedRoles : 都好分離的允許訪問(wèn)服務(wù)的角色列表。注意，這些是安全角色，和SOAP角色相反。安全角色控制訪問(wèn)，SOAP角色控制哪些SOAPheaders會(huì)被處理。
· extraClasses : 指定一個(gè)空格或者都好分離的類(lèi)名稱(chēng)列表，這些類(lèi)的名字應(yīng)該被包含在WSDL文檔的類(lèi)型定義部分。當(dāng)服務(wù)接口引用一個(gè)基類(lèi)的時(shí)候，或者希望WSDL文件包含其他類(lèi)的XML Schema類(lèi)型定義的時(shí)候，這個(gè)參數(shù)很有用。
如果希望為服務(wù)定義handler，可以在<service>元素中添加<requestFlow>和<responseFlow>子元素。他們的語(yǔ)義和<chain>元素中的定義時(shí)一樣的。也就是說(shuō)，它們可以包含<handler> and <chain> 元素，根據(jù)指定的順序被調(diào)用.
通過(guò)服務(wù)的Handlers來(lái)控制角色，可以在服務(wù)聲明中指定任意數(shù)量的<role>元素。
例如:
<service name="test">
<parameter name="className" value="test.Implementation"/>
<parameter name="allowedMethods" value="*"/>
<namespace>http://testservice/</namespace>
<role>http://testservice/MyRole</role>
<requestFlow> <!-- Run these before processing the request -->
<handler type="java:MyHandlerClass"/>\
<handler type="somethingIDefinedPreviously"/>
</requestFlow>
</service>
可以通過(guò)使用<operation>標(biāo)簽指定關(guān)于服務(wù)的特殊操作的元數(shù)據(jù)。這可以將方法的java參數(shù)名和特定的XML名進(jìn)行映射，為參數(shù)指定特定的模式，并將特定的XML名字映射到特定的操作。例如
<operation name="method">
</operation>
<chain name="name">
<subelement/>...
</chain>
定義一個(gè)鏈。當(dāng)chain被調(diào)用的時(shí)候，按順序調(diào)用其中的handler。這樣就可以構(gòu)建一個(gè)常用功能的模塊，chain元素的子元素可以是handler或者chain。handler的定義形式可以是如下兩種方式:
<chain name="myChain">
<handler type="java:org.apache.axis.handlers.LogHandler"/></chain>
或者
<handler name="logger" type="java:org.apache.axis.handlers.LogHandler"/>
<chain name="myChain"/>
<handler type="logger"/></chain>
<transport name="name">
定義了一個(gè)服務(wù)器端的傳輸。當(dāng)一個(gè)輸入請(qǐng)求到達(dá)的時(shí)候，服務(wù)器傳輸被調(diào)用。服務(wù)器傳輸可能定義<requestFlow> and/or <responseFlow> 元素來(lái)指定handlers/chains，在請(qǐng)求和響應(yīng)被處理的時(shí)候被調(diào)用，這個(gè)功能和service元素中的功能一樣。典型的傳輸請(qǐng)求響應(yīng)handler實(shí)現(xiàn)了關(guān)于傳輸?shù)墓δ堋＠甾D(zhuǎn)換協(xié)議headers等等.
對(duì)于任何種類(lèi)的傳輸，經(jīng)常是指HTTP傳輸，當(dāng)特定的查詢(xún)字符串傳遞到servlet的時(shí)候用戶(hù)可能允許Axis servlets執(zhí)行任意的動(dòng)作，以plug-in的方式。 (參考Axis Servlet Query String Plug-ins).當(dāng)查詢(xún)字符串handler的類(lèi)名被指導(dǎo)后，用戶(hù)可以通過(guò)在<transport>中添加合適的<parameter>來(lái)啟用它(插件)。
<transport name="http">
<parameter name="useDefaultQueryStrings" value="false" />
<parameter name="qs.name" value="class.name" /></transport>
在上面的例子中，AxisServlet會(huì)處理的查詢(xún)字符串是?name，它調(diào)用的類(lèi)是class.name。<parameter>元素的name屬性必須加上前綴qs來(lái)表示這個(gè)元素定義了一個(gè)查詢(xún)字符串handler。value屬性值相實(shí)現(xiàn)了org.apache.axis.transport.http.QSHandler 接口的類(lèi)。默認(rèn)情況下，Axis提供了三個(gè)Axis servlet查詢(xún)字符串handlers (?list, ?method, and ?wsdl). 查看Axis服務(wù)器配置文件來(lái)了解它們的定義。如果不希望使用默認(rèn)的handlers，就設(shè)置"useDefaultQueryStrings" 為false。默認(rèn)會(huì)被設(shè)置成true.
<transport name="name" pivot="handler type" >
定義了一個(gè)客戶(hù)端的傳輸，當(dāng)發(fā)送SOAP消息的時(shí)候來(lái)調(diào)用。"pivot"屬性指定一個(gè)Handler來(lái)作為實(shí)際的傳輸sender，例如HTTPSender。請(qǐng)求和響應(yīng)流和服務(wù)器端的設(shè)置相同.
<typeMapping qname="ns:localName" classname="classname" serializer="classname" deserializer="classname"/>
每個(gè)typeMapping將一個(gè)XML qualified名字和一個(gè)Java類(lèi)進(jìn)行映射，使用一個(gè)序列器和反序列器。
<beanMapping qname="ns:localName" classname="classname">
講話(huà)的類(lèi)型映射，使用一個(gè)預(yù)定義的序列器/反序列器來(lái)編碼/解碼JavaBeans。
<documentation>
在<service>, <operation> 或者操作的<parameter>中使用。.是文檔說(shuō)明，生成wsdl的<wsdl:document>元素.
Example:
<operation name="echoString" >
<documentation>This operation echoes a string</documentation> <parameter name="param">
<documentation>a string</documentation>
</parameter>
</operation>
全局的Axis配置參數(shù)
服務(wù)默認(rèn)的是通過(guò)server-config.wsdd文件中的值來(lái)進(jìn)行配置的。但是熟練的Axis用戶(hù)可以寫(xiě)自己的配置handler，這樣就可以將配置數(shù)據(jù)保存在LDAP服務(wù)器，數(shù)據(jù)庫(kù)或者遠(yuǎn)程的web service等等。查看源代碼來(lái)了解如何實(shí)現(xiàn)。也可以在web.xml文件中使自動(dòng)的獲取配置信息。但是Axis不推薦這樣使用，因?yàn)樽詈脤⑴渲眯畔⒎旁谝粋€(gè)位置。
在server-config文件中，有一個(gè)全局配置部分，支持以名/值對(duì)的形式作為嵌套元素使用。
<globalConfiguration>
<parameter name="adminPassword" value="admin"/>
<parameter name="axis.servicesPath" value="/services/"/>
<parameter name="attachments.Directory" value="c:\temp\attachments"/>
<parameter name="sendMultiRefs" value="true"/>
<parameter name="sendXsiTypes" value="true"/>
<parameter name="attachments.implementation" value="org.apache.axis.attachments.AttachmentsImpl"/>
<parameter name="sendXMLDeclaration" value="true"/>
<parameter name="enable2DArrayEncoding" value="true"/>
<parameter name="dotNetSoapEncFix" value="false"/>
</globalConfiguration>
本文來(lái)自CSDN博客，轉(zhuǎn)載請(qǐng)標(biāo)明出處：http://blog.csdn.net/oolala/archive/2009/03/08/3967677.aspx