WSDL 详解(2)

亦凉 2021-11-26 11:02 288阅读 0赞

WSDL 類型與訊息區段中的 XML 結構描述  
WSDL 的資料類型，是根據目前 W3C Recommendation 的「XML Schema: Datatypes」(XSD)。此文件共有三種不同的版本 (1999、2000/10、與 2001)，若欲指定特定 WSDL 檔案所使用的版本，請在 <definitions> 元素中，將其宣告為命名空間的屬性。方法如下：

xmlns:xsd="[http://www.w3.org/2001/XMLSchema][http_www.w3.org_2001_XMLSchema]"

本文僅以 2001 版為考量。WSDL 標準的擁護者，也大力建議使用 2001 版。

在本節與後續章節中，採用的字首或命名空間速記法如下：

字首 對應的命名空間 說明  
soapenc [http://schemas.xmlsoap.org/soap/encoding][http_schemas.xmlsoap.org_soap_encoding] SOAP 1.1 編碼  
wsdl [http://schemas.xmlsoap.org/wsdl/soap][http_schemas.xmlsoap.org_wsdl_soap] WSDL 1.1  
xsd [http://www.w3.org/2001/XMLSchema][http_www.w3.org_2001_XMLSchema] XML Schema

XSD 基本類型  
下表直接取自 MSTK2 文件，列舉了 MSTK2 支援的所有 XSD 基本類型。該表說明，位於客戶端與伺服端的 WSDL 讀者，如何在 VB、C++、與 IDL 中，將 XSD 類型對應至不同與對等的類型。

XSD (Soap) 類型 不同的類型 VB C++ IDL 註解  
anyURI VT\_BSTR String BSTR BSTR  
base64Binary VT\_ARRAY | VT\_UI1 Byte() SAFEARRAY SAFEARRAY(unsigned char)  
boolean VT\_BOOL Boolean VARIANT\_BOOL VARIANT\_BOOL  
byte VT\_I2 Integer short short 轉換時驗證範圍。  
date VT\_DATE Date DATE DATE 時間設為 oo:oo:oo  
dateTime VT\_DATE Date DATE DATE  
double VT\_R8 Double double double  
duration VT\_BSTR String BSTR BSTR 不執行驗證或轉換  
ENTITIES VT\_BSTR String BSTR BSTR 不執行驗證或轉換  
ENTITY VT\_BSTR String BSTR BSTR 不執行驗證或轉換  
float VT\_R4 Single float float  
gDay VT\_BSTR String BSTR BSTR 不執行驗證或轉換  
gMonth VT\_BSTR String BSTR BSTR 不執行驗證或轉換  
gMonthDay VT\_BSTR String BSTR BSTR 不執行驗證或轉換  
gYear VT\_BSTR String BSTR BSTR 不執行驗證或轉換  
gYearMonth VT\_BSTR String BSTR BSTR 不執行驗證或轉換  
ID VT\_BSTR String BSTR BSTR 不執行驗證或轉換  
IDREF VT\_BSTR String BSTR BSTR 不執行驗證或轉換  
IDREFS VT\_BSTR String BSTR BSTR 不執行驗證或轉換  
int VT\_I4 long long long  
integer VT\_DECIMAL Variant DECIMAL DECIMAL 轉換時驗證範圍。  
language VT\_BSTR String BSTR BSTR 不執行驗證或轉換  
long VT\_DECIMAL Variant DECIMAL DECIMAL 轉換時驗證範圍。  
Name VT\_BSTR String BSTR BSTR 不執行驗證或轉換  
NCName VT\_BSTR String BSTR BSTR 不執行驗證或轉換  
negativeInteger VT\_DECIMAL Variant DECIMAL DECIMAL 轉換時驗證範圍。  
NMTOKEN VT\_BSTR String BSTR BSTR 不執行驗證或轉換  
NMTOKENS VT\_BSTR String BSTR BSTR 不執行驗證或轉換  
nonNegativeInteger VT\_DECIMAL Variant DECIMAL DECIMAL 轉換時驗證範圍。  
nonPositiveInteger VT\_DECIMAL Variant DECIMAL DECIMAL 轉換時驗證範圍。  
normalizedString VT\_BSTR String BSTR BSTR  
NOTATION VT\_BSTR String BSTR BSTR 不執行驗證或轉換  
number VT\_DECIMAL Variant DECIMAL DECIMAL  
positiveInteger VT\_DECIMAL Variant DECIMAL DECIMAL 轉換時驗證範圍。  
QName VT\_BSTR String BSTR BSTR 不執行驗證或轉換  
short VT\_I2 Integer short short  
string VT\_BSTR String BSTR BSTR  
time VT\_DATE Date DATE DATE Day 設定成 1899 年 12 月 30 日  
token VT\_BSTR String BSTR BSTR 不執行驗證或轉換  
unsignedByte VT\_UI1 Byte unsigned char unsigned char  
unsignedInt VT\_DECIMAL Variant DECIMAL DECIMAL 轉換時驗證範圍。  
unsignedLong VT\_DECIMAL Variant DECIMAL DECIMAL 轉換時驗證範圍。  
unsignedShort VT\_UI4 long long long 轉換時驗證範圍。

XSD 定義兩組內建的資料類型：基本類型與衍生類型。若需進一步資訊，可前往 [http://www.w3.org/TR/2001/PR-xmlschema-2-20010330][http_www.w3.org_TR_2001_PR-xmlschema-2-20010330]，檢視內建類型的階層架構。

複雜類型  
XML Schema 可定義複雜類型，也就是 C 中的 struct。例如，下列 C struct 的相對定義方式為：

typedef struct \{  
string firstName;  
string lastName;  
long ageInYears;  
float weightInLbs;  
float heightInInches;  
\} PERSON;

若使用 XML Schema 可以撰寫成：

<xsd:complexType name="PERSON">  
<xsd:sequence>  
<xsd:element name="firstName" type="xsd:string"/>  
<xsd:element name="lastName" type="xsd:string"/>  
<xsd:element name="ageInYears" type="xsd:int"/>  
<xsd:element name="weightInLbs" type="xsd:float"/>  
<xsd:element name="heightInInches" type="xsd:float"/>  
</xsd:sequence>  
</xsd:complexType>

不過，<complexType> 所能表示的，絕不僅止於 struct 的對應而已。除了 <sequence> 之外，它還可以有其它的子元素。若不用 <sequence>，也可以使用 <all>：

<xsd:complexType name="PERSON">  
<xsd:all>  
<xsd:element name="firstName" type="xsd:string"/>  
<xsd:element name="lastName" type="xsd:string"/>  
<xsd:element name="ageInYears" type="xsd:int"/>  
<xsd:element name="weightInLbs" type="xsd:float"/>  
<xsd:element name="heightInInches" type="xsd:float"/>  
</xsd:all>  
</xsd:complexType>

其意義則是，成員變數 <element> 可以任何順序輸入，且每一項都具有選擇性。這點便與 C struct 的使用方式不同了。

請注意範例中，string (字串)、int (整數)、float (浮點數) 等內建資料類型的使用方式。C 的字串在 XML 中也是字串，且浮點數還是浮點數。但 C 的 long (長整數)，在 XML 則是 int (請參考上表)。

在 WSDL 檔案中，Types 區段是宣告上述複雜類型的位置。例如，PERSON 類型可以下列方式宣告，並將其用於 Messages 區段中：

</definitions>

在上述的範例中，第一個訊息的名稱是「addPerson」，它有個類型為「PERSON」的 <part>。在 Types 區段中，類型 PERSON 會被宣告為複雜類型。

起始 MSTK2 SoapClient 時，若在上述片段使用完整的 WSDL 檔案，它便可成功地剖析該檔案。不過，它還是不能將函數呼叫，傳送至 <addPerson>。這是因為 SoapClient 本身不知道如何處理複雜類型；它需要自訂的類型對應器 (mapper) 才能處理複雜類型。在 MSTK2 文件中有一個範例應用程式，它含有自訂的類型對應器。

另外還有一個方法，可將 <part> 元素，關連至類型宣告。這個方法使用的是元素，而非類型屬性。下個範例會在 Types 區段中，先宣告兩個元素 (「Person」與「Gender」)；然後在「addPerson」的 <message> 中，再使用元素屬性參照它們。

<?xml version="1.0" encoding="UTF-8" ?>  
<definitions ?>  
<types>  
<schema targetNamespace="someNamespace"  
xmlns:typens="someNamespace" >  
<element name="Person">  
<xsd:complexType>  
<xsd:sequence>  
<xsd:element name="firstName" type="xsd:string"/>  
<xsd:element name="lastName" type="xsd:string"/>  
<xsd:element name="ageInYears" type="xsd:int"/>  
<xsd:element name="weightInLbs" type="xsd:float"/>  
<xsd:element name="heightInInches" type="xsd:float"/>  
</xsd:sequence>  
</xsd:complexType>  
</element>  
<element name="Gender">  
<xsd:simpleType>  
<xsd:restriction base="xsd:string">  
<xsd:enumeration value="Male" />  
<xsd:enumeration value="Female" />  
</xsd:restriction>  
</xsd:simpleType>  
</element>  
</schema>  
</types>

在 Types 區段的 Gender <element> 中，內嵌著一個匿名的列舉類型，其值可以是「Male」或「Female」。然後在「addPerson」的 <message> 中，再使用元素屬性 (不用類型屬性) 參照該元素。

若欲關連特定類型至 <part>，使用「元素」與「類型」屬性有何不同？若使用「類型」屬性，part 可描述成能採取數種類型 (就像變數一樣)；但若使用「元素」屬性，便不能這麼做。請參考下列範例的說明。

<?xml version="1.0" encoding="UTF-8" ?>  
<definitions ?>  
<types>  
<schema targetNamespace="someNamespace"  
xmlns:typens="someNamespace">  
<xsd:complexType name="PERSON">  
<xsd:sequence>  
<xsd:element name="firstName" type="xsd:string"/>  
<xsd:element name="lastName" type="xsd:string"/>  
<xsd:element name="ageInYears" type="xsd:int"/>  
<xsd:element name="weightInLbs" type="xsd:float"/>  
<xsd:element name="heightInInches" type="xsd:float"/>  
</xsd:sequence>  
</xsd:complexType>  
<xsd:complexType name="femalePerson">  
<xsd:complexContent>  
<xsd:extension base="typens:PERSON" >  
<xsd:element name="favoriteLipstick" type="xsd:string" />  
</xsd:extension>  
</xsd:complexContent>  
</xsd:complexType>  
<xsd:complexType name="malePerson">  
<xsd:complexContent>  
<xsd:extension base="typens:PERSON" >  
<xsd:element name="favoriteShavingLotion" type="xsd:string" />  
</xsd:extension>  
</xsd:complexContent>  
</xsd:complexType>  
<xsd:complexType name="maleOrFemalePerson">  
<xsd:choice>  
<xsd:element name="fArg" type="typens:femalePerson" >  
<xsd:element name="mArg" type="typens:malePerson" />  
</xsd:choice>  
</xsd:complexType>  
</schema>  
</types>

</definitions>

此範例也說明了副檔名的衍生用法。「femalePerson」與「malePerson」兩者，都是衍生自「PERSON」。它們都各有一個額外的元素：「femalePerson」的「favoriteLipstick」以及「malePerson」的「favoriteShavingLotion」。使用 <choice> 的 construct，這兩個衍生類型又可結合成一個複雜類型「maleOrFemalePerson」。最後，在「addPerson」的 <message> 中，此結合類型又可供「person」的 <part> 參照。而此 <part> 或參數，可以是「femalePerson」或「malePerson」。

陣列  
XSD 可提供 <list> construct，以宣告空白所分隔的項目陣列。但是，SOAP 並不使用 XSD 清單為陣列編碼；而是為陣列定義自己的類型，即「SOAP-ENC:Array」。下列範例說明，如何為單一維度的整數陣列，依其法則導出此種類型：

<xsd:complexType name="ArrayOfInt">  
<xsd:complexContent>  
<xsd:restriction base="soapenc:Array">  
<attribute ref="soapenc:arrayType" wsdl:arrayType="xsd:int\[\]"/>  
</xsd:restriction>  
</xsd:complexContent>  
</xsd:complexType>

只要使用導出限制的方式，即可從 soapenc:Array 宣告新的複雜類型。接著便可宣告此複雜類型的屬性：arrayType。參照「soapenc:arrayType」實際上即是 arrayType 屬性的宣告，其方式如下：

<xsd:attribute name="arrayType" type="xsd:string"/>

然後，wsdl:arrayType 屬性值，可決定每個陣列成員的類型。陣列項目也可以是複雜類型：

<xsd:complexType name="ArrayOfPERSON">  
<xsd:complexContent>  
<xsd:restriction base="soapenc:Array">  
<attribute ref="soapenc:arrayType"  
wsdl:arrayType="typens:PERSON\[\]"/>  
</xsd:restriction>  
</xsd:complexContent>  
</xsd:complexType>

WSDL 的要求是，陣列的類型名稱必須是，「ArrayOf」與陣列項目類型的的串連 (concatenation)。也因此，單從名稱即可得知，「ArrayOfPERSON」是 PERSON struct 的陣列。在下例中，只要使用 ArrayOfPERSON 宣告一個 <message>，即可新增多個 PERSON：

</definitions>

<portType> 與 <operation> 元素  
PortType 可在抽象中，定義多種作業。PortType 中的作業元素，可定義呼叫所有 PortType 方法的語法。每個作業元素都會宣告，方法的名稱、參數 (使用 <message> 元素)、類型 (每個 <message> 中所宣告的 <part> 元素)。

在 WSDL 文件中，可有多個 <portType> 元素。每個 <portType> 元素，群組化多個相關作業的方式，與 COM 介面群組化方法的方式非常類似。

在一個 <operation> 元素中，最多可有一個 <input> 元素、一個 <output> 元素、與一個 <fault> 元素。這三個元素都各有一個名稱與訊息屬性。

在 <input>、<output>、與 <fault> 元素中使用名稱屬性的目的為何？原來是為了，區別具相同名稱 (多載) 的兩項作業。例如，下列兩個 C 函數，即具有相同的名稱，但不同的參數。

void foo(int arg);  
void foo(string arg);

使用 WSDL 時，這種多載的表達方式如下：

<?xml version="1.0" encoding="UTF-8" ?>  
<definitions name="fooDescription"  
targetNamespace="[http://tempuri.org/wsdl/][http_tempuri.org_wsdl]"  
xmlns:wsdlns="[http://tempuri.org/wsdl/][http_tempuri.org_wsdl]"  
xmlns:typens="[http://tempuri.org/xsd][http_tempuri.org_xsd]"  
xmlns:xsd="[http://www.w3.org/2001/XMLSchema][http_www.w3.org_2001_XMLSchema]"  
xmlns:soap="[http://schemas.xmlsoap.org/wsdl/soap/][http_schemas.xmlsoap.org_wsdl_soap 1]"  
xmlns:stk="[http://schemas.microsoft.com/soap-toolkit/wsdl][http_schemas.microsoft.com_soap-toolkit_wsdl]\-  
extension"  
xmlns="[http://schemas.xmlsoap.org/wsdl/][http_schemas.xmlsoap.org_wsdl]">  
<types>  
<schema targetNamespace="[http://tempuri.org/xsd][http_tempuri.org_xsd]"  
xmlns="[http://www.w3.org/2001/XMLSchema][http_www.w3.org_2001_XMLSchema]"  
xmlns:SOAP-ENC="[http://schemas.xmlsoap.org/soap/encoding/][http_schemas.xmlsoap.org_soap_encoding 1]"  
xmlns:wsdl="[http://schemas.xmlsoap.org/wsdl/][http_schemas.xmlsoap.org_wsdl]"  
elementFormDefault="qualified" >  
</schema>  
</types>

转载于:https://www.cnblogs.com/Jeffer/archive/2009/07/07/1518165.html

[http_www.w3.org_2001_XMLSchema]: http://www.w3.org/2001/XMLSchema
[http_schemas.xmlsoap.org_soap_encoding]: http://schemas.xmlsoap.org/soap/encoding
[http_schemas.xmlsoap.org_wsdl_soap]: http://schemas.xmlsoap.org/wsdl/soap
[http_www.w3.org_TR_2001_PR-xmlschema-2-20010330]: http://www.w3.org/TR/2001/PR-xmlschema-2-20010330
[http_tempuri.org_wsdl]: http://tempuri.org/wsdl/
[http_tempuri.org_xsd]: http://tempuri.org/xsd
[http_schemas.xmlsoap.org_wsdl_soap 1]: http://schemas.xmlsoap.org/wsdl/soap/
[http_schemas.microsoft.com_soap-toolkit_wsdl]: http://schemas.microsoft.com/soap-toolkit/wsdl
[http_schemas.xmlsoap.org_wsdl]: http://schemas.xmlsoap.org/wsdl/
[http_schemas.xmlsoap.org_soap_encoding 1]: http://schemas.xmlsoap.org/soap/encoding/
[http_schemas.xmlsoap.org_soap_http_22]: http://schemas.xmlsoap.org/soap/http%22/
[http_tempuri.org_action_foo1_22]: http://tempuri.org/action/foo1%22/
[http_tempuri.org_message]: http://tempuri.org/message/
[http_tempuri.org_action_foo2_22]: http://tempuri.org/action/foo2%22/
[http_carlos_8080_fooService_foo.asp_22]: http://carlos:8080/fooService/foo.asp%22/