如何基于SOAP请求响应示例及服务文档生成可用WSDL文件？

一、构建可用于服务实现和客户端交互的WSDL #

WSDL是SOAP服务的核心契约，要同时支持服务端开发和客户端调用，必须覆盖数据类型、接口操作、协议绑定、端点地址四个核心模块，结合你手头的文档和示例，按以下步骤来：

1. 定义数据类型（XML Schema） #

从请求响应示例里把所有业务字段梳理出来，用XSD描述结构：

• 先剥离SOAP信封，提取里面的请求、响应根元素
• 逐个梳理嵌套字段、数据类型（比如数字用xs:int、文本用xs:string、时间用xs:dateTime）
• 把这些写成<xs:schema>块，塞进WSDL的<types>标签里

示例代码片段：

<wsdl:types>
  <xs:schema targetNamespace="http://your-service-domain.com/soap">
    <!-- 请求结构 -->
    <xs:element name="FetchOrderRequest">
      <xs:complexType>
        <xs:sequence>
          <xs:element name="OrderId" type="xs:string" minOccurs="1"/>
          <xs:element name="CustomerId" type="xs:int" minOccurs="0"/>
        </xs:sequence>
      </xs:complexType>
    </xs:element>
    <!-- 响应结构 -->
    <xs:element name="FetchOrderResponse">
      <xs:complexType>
        <xs:sequence>
          <xs:element name="OrderNumber" type="xs:string"/>
          <xs:element name="TotalAmount" type="xs:decimal"/>
          <xs:element name="OrderDate" type="xs:dateTime"/>
        </xs:sequence>
      </xs:complexType>
    </xs:element>
  </xs:schema>
</wsdl:types>

2. 定义服务接口（PortType） #

这部分是服务的“功能清单”，指定每个操作的请求和响应对应关系：

<wsdl:portType name="OrderServicePortType">
  <wsdl:operation name="FetchOrder">
    <wsdl:input message="tns:FetchOrderRequestMsg"/>
    <wsdl:output message="tns:FetchOrderResponseMsg"/>
  </wsdl:operation>
</wsdl:portType>

3. 绑定消息与数据类型 #

把XSD定义的元素和接口操作关联起来：

<wsdl:message name="FetchOrderRequestMsg">
  <wsdl:part name="params" element="tns:FetchOrderRequest"/>
</wsdl:message>
<wsdl:message name="FetchOrderResponseMsg">
  <wsdl:part name="params" element="tns:FetchOrderResponse"/>
</wsdl:message>

4. 配置SOAP协议绑定 #

指定服务用的SOAP版本、传输协议（一般是HTTP），还有SOAPAction：

<wsdl:binding name="OrderServiceBinding" type="tns:OrderServicePortType">
  <soap:binding style="document" transport="http://schemas.xmlsoap.org/soap/http"/>
  <wsdl:operation name="FetchOrder">
    <soap:operation soapAction="http://your-service-domain.com/soap/FetchOrder"/>
    <wsdl:input>
      <soap:body use="literal"/>
    </wsdl:input>
    <wsdl:output>
      <soap:body use="literal"/>
    </wsdl:output>
  </wsdl:operation>
</wsdl:binding>

5. 设置服务端点 #

最后指定服务的实际访问地址：

<wsdl:service name="OrderService">
  <wsdl:port name="OrderServicePort" binding="tns:OrderServiceBinding">
    <soap:address location="http://your-server-ip:8080/soap/OrderService"/>
  </wsdl:port>
</wsdl:service>

把这些部分拼起来，加上WSDL的根标签，就是一份完整可用的WSDL文件——服务端可以用它实现接口，客户端可以用它生成调用代码。

二、从SOAP请求/响应示例提取WSDL的步骤 #

如果只有请求响应示例，没有现成WSDL，按以下流程反向推导：

1. 提取命名空间 #

从请求/响应的SOAP信封里找xmlns属性，比如：

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ord="http://your-service-domain.com/soap">
这里的http://your-service-domain.com/soap就是WSDL要用到的目标命名空间。

2. 解析业务数据结构 #

• 去掉SOAP的<Envelope>和<Body>标签，只保留里面的业务请求、响应元素
• 逐个记录元素名称、层级关系、数据类型（从示例值推断，比如"2024-05-20T10:00:00"对应xs:dateTime）
• 参考服务文档标记必填字段（示例里必现的字段大概率是必填的）

3. 生成XSD类型 #

根据解析出的结构编写XSD，这是WSDL的核心部分，嫌手动写麻烦的话，可以用XML工具（比如VSCode的XML插件）自动生成基础XSD，再手动调整细节。

4. 映射操作与消息 #

• 每一组请求-响应对对应一个WSDL操作
• 为请求和响应分别创建message，关联对应的XSD元素

5. 补充绑定和端点信息 #

• 从请求的HTTP头里找SOAPAction值，填到绑定的soapAction属性里
• 传输协议默认用HTTP，设置transport为http://schemas.xmlsoap.org/soap/http
• 端点地址如果暂时不知道，可以先留空，等服务部署后再补充

关键提醒 #

• 示例里没提到的字段约束（比如字符串长度、数值范围），一定要参考服务说明文档补充，不然生成的WSDL会不符合业务要求
• 如果有多个操作，重复上述步骤即可
• 生成后要验证：用工具（比如SoapUI）加载WSDL，发送请求看是否和示例一致

内容的提问来源于stack exchange，提问作者Mohammed Hafiz