本部分介紹的所有的WSDD元素的名稱空間都是"http://xml.apache.org/axis/wsdd/"。
<deployment>
告訴Axis Engine這是一個部署描述文件。一個部署描述文件可以表示一個完整的engine配置或者將要部署到一個活動active的一部分組件。
<GlobalConfiguration>
用于控制engine范圍的配置。可以包含以下子元素：
· <parameter> : 用來設置Axis的各種屬性，參考Global Axis Configuration，可以配置任意數量的參數元素.
· <role> : 設置一個SOAP actor/role URI，engine可以對它進行識別。這允許指向這個role的SOAP headers成功的被engine處理。任意數量.
· <requestFlow> : 全局的請求Handlers。在調用實際的服務之前調用.
· <responseFlow> : 全局響應Handlers，在調用完實際的服務后，還沒有返回到客戶端之前調用.
<requestFlow [name="name"] [type="type"] >
可以放置任意多個<handler> or <chain>在<requestFlow>中，但是可能只有一個<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這是個卸載描述文件.
<handler [name="name"] type="type">
位于頂層元素<deployment> or <undeployment>, or inside a <chain>, <requestFlow>, or <responseFlow>. 用于定義Handler，并定義handler的類型。"Type" 可以是已經定義的Handler或者是"java:class.name"形式的QName。可選的"name"屬性允許將這個Handler的定義在其他部署描述部分中引用。可以包含任意數量的<parameter name="name" value="value">元素.
<service name="name" provider="provider" >
部署/卸載一個Axis服務。這是最復雜的一個WSDD標簽。
Options可能通過以下元素來指定: <parameter name="name" value="value"/>, 一些常用的包括:
· className : 后臺實現的類
· allowedMethods : 每個provider可以決定那些方法允許web services訪問
Axis支持的providers有如下幾種:
Java RPC Provider (provider="java:RPC") 默認情況下所有的public方法都可以web service方式提供
Java MsgProvder (provider="java:MSG")
為了更進一步的限制上面的方法，allowedMethods選項用于指定一個以空格分隔的方法名，只有這些方法可以通過web service訪問。也可以將這個值指定為”*”表示所有的方法都可以訪問。同時operation元素用來更進一步的定義被提供的方法，但是它不能決定方法的可見性.
注意，發布任何web service都有安全含義.
· allowedRoles : 都好分離的允許訪問服務的角色列表。注意，這些是安全角色，和SOAP角色相反。安全角色控制訪問，SOAP角色控制哪些SOAPheaders會被處理。
· extraClasses : 指定一個空格或者都好分離的類名稱列表，這些類的名字應該被包含在WSDL文檔的類型定義部分。當服務接口引用一個基類的時候，或者希望WSDL文件包含其他類的XML Schema類型定義的時候，這個參數很有用。
如果希望為服務定義handler，可以在<service>元素中添加<requestFlow>和<responseFlow>子元素。他們的語義和<chain>元素中的定義時一樣的。也就是說，它們可以包含<handler> and <chain> 元素，根據指定的順序被調用.
通過服務的Handlers來控制角色，可以在服務聲明中指定任意數量的<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>
可以通過使用<operation>標簽指定關于服務的特殊操作的元數據。這可以將方法的java參數名和特定的XML名進行映射，為參數指定特定的模式，并將特定的XML名字映射到特定的操作。例如
<operation name="method">
</operation>
<chain name="name">
<subelement/>...
</chain>
定義一個鏈。當chain被調用的時候，按順序調用其中的handler。這樣就可以構建一個常用功能的模塊，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">
定義了一個服務器端的傳輸。當一個輸入請求到達的時候，服務器傳輸被調用。服務器傳輸可能定義<requestFlow> and/or <responseFlow> 元素來指定handlers/chains，在請求和響應被處理的時候被調用，這個功能和service元素中的功能一樣。典型的傳輸請求響應handler實現了關于傳輸的功能。例如轉換協議headers等等.
對于任何種類的傳輸，經常是指HTTP傳輸，當特定的查詢字符串傳遞到servlet的時候用戶可能允許Axis servlets執行任意的動作，以plug-in的方式。 (參考Axis Servlet Query String Plug-ins).當查詢字符串handler的類名被指導后，用戶可以通過在<transport>中添加合適的<parameter>來啟用它(插件)。
<transport name="http">
<parameter name="useDefaultQueryStrings" value="false" />
<parameter name="qs.name" value="class.name" /></transport>
在上面的例子中，AxisServlet會處理的查詢字符串是?name，它調用的類是class.name。<parameter>元素的name屬性必須加上前綴qs來表示這個元素定義了一個查詢字符串handler。value屬性值相實現了org.apache.axis.transport.http.QSHandler 接口的類。默認情況下，Axis提供了三個Axis servlet查詢字符串handlers (?list, ?method, and ?wsdl). 查看Axis服務器配置文件來了解它們的定義。如果不希望使用默認的handlers，就設置"useDefaultQueryStrings" 為false。默認會被設置成true.
<transport name="name" pivot="handler type" >
定義了一個客戶端的傳輸，當發送SOAP消息的時候來調用。"pivot"屬性指定一個Handler來作為實際的傳輸sender，例如HTTPSender。請求和響應流和服務器端的設置相同.
<typeMapping qname="ns:localName" classname="classname" serializer="classname" deserializer="classname"/>
每個typeMapping將一個XML qualified名字和一個Java類進行映射，使用一個序列器和反序列器。
<beanMapping qname="ns:localName" classname="classname">
講話的類型映射，使用一個預定義的序列器/反序列器來編碼/解碼JavaBeans。
<documentation>
在<service>, <operation> 或者操作的<parameter>中使用。.是文檔說明，生成wsdl的<wsdl:document>元素.
Example:
<operation name="echoString" >
<documentation>This operation echoes a string</documentation> <parameter name="param">
<documentation>a string</documentation>
</parameter>
</operation>
全局的Axis配置參數
服務默認的是通過server-config.wsdd文件中的值來進行配置的。但是熟練的Axis用戶可以寫自己的配置handler，這樣就可以將配置數據保存在LDAP服務器，數據庫或者遠程的web service等等。查看源代碼來了解如何實現。也可以在web.xml文件中使自動的獲取配置信息。但是Axis不推薦這樣使用，因為最好將配置信息放在一個位置。
在server-config文件中，有一個全局配置部分，支持以名/值對的形式作為嵌套元素使用。
<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>
本文來自CSDN博客，轉載請標明出處：http://blog.csdn.net/oolala/archive/2009/03/08/3967677.aspx