WSDL 文檔結構完整詳解：核心元素、類型定義、綁定與服務端點解析

WSDL 文檔結構完整詳解：核心元素、類型定義、綁定與服務端點解析

WSDL (Web Services Description Language) 是描述 Web 服務介面的 XML 標準語言。本文以一個完整的 WSDL 範例，逐層解析七大核心元素。

WSDL 文檔整體結構

<?xml version="1.0" encoding="UTF-8"?>
<definitions name="HelloService"
    targetNamespace="https://example.com/hello"
    xmlns:tns="https://example.com/hello"
    xmlns:xsd="https://www.w3.org/2001/XMLSchema"
    xmlns:soap="https://schemas.xmlsoap.org/wsdl/soap/"
    xmlns="https://schemas.xmlsoap.org/wsdl/">

    <!-- 1. 類型定義：資料模型 -->
    <types>
        <xsd:schema targetNamespace="https://example.com/hello">
            <xsd:element name="sayHello">
                <xsd:complexType>
                    <xsd:sequence>
                        <xsd:element name="name" type="xsd:string"/>
                    </xsd:sequence>
                </xsd:complexType>
            </xsd:element>
            <xsd:element name="sayHelloResponse">
                <xsd:complexType>
                    <xsd:sequence>
                        <xsd:element name="return" type="xsd:string"/>
                    </xsd:sequence>
                </xsd:complexType>
            </xsd:element>
        </xsd:schema>
    </types>

    <!-- 2. 訊息定義：通信數據單元 -->
    <message name="sayHelloRequest">
        <part name="parameters" element="tns:sayHello"/>
    </message>
    <message name="sayHelloResponse">
        <part name="parameters" element="tns:sayHelloResponse"/>
    </message>

    <!-- 3. 端口類型：抽象操作集合 -->
    <portType name="HelloPortType">
        <operation name="sayHello">
            <input message="tns:sayHelloRequest"/>
            <output message="tns:sayHelloResponse"/>
        </operation>
    </portType>

    <!-- 4. 綁定：協議與編碼具體化 -->
    <binding name="HelloBinding" type="tns:HelloPortType">
        <soap:binding style="document" transport="https://schemas.xmlsoap.org/soap/http"/>
        <operation name="sayHello">
            <soap:operation soapAction=""/>
            <input><soap:body use="literal"/></input>
            <output><soap:body use="literal"/></output>
        </operation>
    </binding>

    <!-- 5. 服務與端點：部署地址 -->
    <service name="HelloService">
        <port name="HelloPort" binding="tns:HelloBinding">
            <soap:address location="https://localhost:8080/hello"/>
        </port>
    </service>
</definitions>

七大核心元素詳細解析

1. <definitions>：根元素，聲明命名空間、服務名稱、目標命名空間
2. <types>：資料類型定義，通常內嵌 XML Schema (XSD)，定義複雜類型、元素
3. <message>：抽象訊息單元，由一或多個 <part> 組成，對應方法參數/返回值
4. <portType>：抽象介面，定義操作集合（<operation>），每操作含 input/output/fault
5. <binding>：將抽象 portType 映射到具體協議（SOAP 1.1/1.2、HTTP GET/POST、MIME），指定編碼風格
6. <service>：服務集合，聚合一或多個端點
7. <port>：單一端點，關聯 binding 與具體網址 (<soap:address location="..."/>)

關鍵屬性對照表

風格對比：Document vs RPC

• Document/Literal：訊息體為完整 XML 文檔，符合 Schema 驗證，互操作性強，現代首選
• RPC/Literal：訊息體模擬方法調用結構，參數順序敏感，較舊式

開發建議

1. 契約優先：先設計 WSDL/XSD，再用工具生成代碼
2. 命名空間規劃：業務域隔離，避免衝突
3. 版本管理：WSDL 變更需向後相容，新增操作/可選元素
4. 工具鏈：CXF wsdl2java、JDK wsimport、Maven cxf-codegen-plugin