SOAP 响应架构验证

Question

简短版本：

我正在尝试编写一个 XSD 来验证我的 SOAP 服务的响应。我觉得有必要导入 http:// schemas.xmlsoap.org/soap/envelope/ 而不是重新定义 SOAP 元素，如 Envelope、Head 和 Body，但是 xmlsoap.org 的 Body 模式定义对于我的使用来说太宽泛了 - - 一旦我导入 SOAP 架构，我的 XSD（我为我的服务精心定制的）就会突然验证所有 SOAP 消息。

我应该如何处理 XSD 中 SOAP 信封、头部、主体的定义？

我怀疑问题是我正在尝试重用其他我不应该尝试重新使用的模式-使用。当然，这些 SOAP 模式旨在定义（所有）SOAP 消息应该是什么样子。也许我只需要在我的架构中定义我想要的特定肥皂体的外观。

我可能刚刚回答了我自己的问题。也许有人有不同的解决方案？

长版本：

我在编写 XSD 来描述来自我的一项 SOAP 服务的响应消息时遇到了一些麻烦。

以下是我尝试验证的来自我的服务的示例响应：

<?xml version="1.0" encoding="UTF-8"?>
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
   <soap:Body>
      <helloResponse xmlns="http://justinfaulkner/wsdl/1.0">
         <Message>Hello, Justin!</Message>
         <Message>Your lucky numbers are: 329, 9</Message>
      </helloResponse>
   </soap:Body>
</soap:Envelope>

我的目标是使用 XSD 验证来自我的服务的响应。 因此，当我尝试使用 PHP 的 DOMDocument::schemaValidateSource() 功能通过架构（第二个片段）验证示例响应（第一个 XML 片段）时，我手动编写了一个 XSD 来描述属于我的服务的soap:Body 中的

<?xml version="1.0"?>
<xsd:schema xmlns:xsd="http://www.w3.org/2001/XMLSchema" targetNamespace="http://justinfaulkner/wsdl/1.0" xmlns:tns="http://justinfaulkner/wsdl/1.0">
   <xsd:complexType name="helloResponseType">
      <xsd:sequence>
         <xsd:element name="Message" type="xsd:string" minOccurs="0" maxOccurs="unbounded"/>
      </xsd:sequence>
   </xsd:complexType>
   <xsd:element name="helloResponse" type="tns:helloResponseType"/>
</xsd:schema>

所有类型，验证者指出了我的第一个明显错误：

元素“soap:Envelope”：没有可用的匹配全局声明

“哎呀，废话，”我想，“这些元素是在 SOAP 的命名空间中定义的，所以我需要导入 SOAP 的 XSD。”

所以我编辑了我的 XSD 并添加了一个导入：

<xsd:import namespace="http://schemas.xmlsoap.org/soap/envelope/" schemaLocation="http://schemas.xmlsoap.org/soap/envelope/"/>

它起作用了！当我使用 XSD 验证肥皂响应时，DOMDocument::schemaValidateSource 返回 true。

然后，作为健全性检查，我采用了我周围的不同肥皂响应 XSD：

<?xml version="1.0"?>
<xsd:schema xmlns:xsd="http://www.w3.org/2001/XMLSchema" targetNamespace="http://justinfaulkner/wsdl/1.0" xmlns:tns="http://justinfaulkner/wsdl/1.0">
   <xsd:import namespace="http://schemas.xmlsoap.org/soap/envelope/" schemaLocation="http://schemas.xmlsoap.org/soap/envelope/"/>
   <xsd:complexType name="OtherServiceResponseType">
      <xsd:all>
         <xsd:element name="CompletionCode" type="xsd:string"/>
         <xsd:element name="ResponseMessage" type="xsd:string"/>
      </xsd:all>
   </xsd:complexType>
   <xsd:element name="OtherServiceResponse" type="tns:OtherServiceResponseType"/>
</xsd:schema>

我尝试使用这个完全不相关的架构来验证我的肥皂响应...

乍一看，该架构，根本没有描述此消息，还验证了肥皂响应。

然后我意识到 XSD 的架构一定是响应针对这两个不同架构进行验证的原因。我从 http://schemas.xmlsoap.org/soap/envelope/ 将 Body 元素定义为：

<xs:element name="Body" type="tns:Body" />
<xs:complexType name="Body" >
<xs:sequence>
  <xs:any namespace="##any" minOccurs="0" maxOccurs="unbounded" processContents="lax" />
</xs:sequence>
<xs:anyAttribute namespace="##any" processContents="lax" >
  <xs:annotation>
 <xs:documentation>
   Prose in the spec does not specify that attributes are allowed on the Body element
 </xs:documentation>
  </xs:annotation>
</xs:anyAttribute>
</xs:complexType>

这允许 Body 标记的内容基本上可以是任何内容。

这是有道理的，XSD 的 XSD 的目的是定义所有 XSD 应该是什么样子，而不仅仅是我的。

所以我的问题是，我应该如何构建 XSD 来验证这些 SOAP 响应，如果可能的话重用现有的 SOAP XSD？

这是我一直追求的方向...

• 我我想我可以将 xmlsoap.org 的 XSD 模式扔到窗外，自己重新定义 Envelope 和 Body，准确指定 Body 元素中应显示的内容。但我觉得我最终基本上会在自己的 XSD 中拥有所有肥皂元素的副本，头部和身体定义略有不同，这感觉像是违反了 DRY。
• 有没有办法可以导入 xmlsoap.org 的 XSD，然后从我的 XSD 中覆盖soap:Body 的定义？

Answer 1

您应该使用 SOAP Web 服务框架来做到这一点。 维基百科页面上列出了许多针对各种编程语言的信息。您编写 WSDL 来指定您的 Web 服务 API，并在其中导入 XSD 来定义有效负载格式（契约优先方法）。使用框架提供的wsdl2xxx工具生成API存根。您编写 API 实现代码。该框架将负责剩下的工作（处理 SOAP 消息并绑定到您的实现代码）。