SOAP - 编码

SOAP 包含一组内置规则，用于编码数据类型。它使 SOAP 消息能够指示特定的数据类型，例如整数、浮点数、双精度数或数组。

• SOAP 数据类型分为两大类：标量类型和复合类型。

• 标量类型只包含一个值，例如姓氏、价格或产品描述。

• 复合类型包含多个值，例如采购订单或股票报价列表。

• 复合类型进一步细分为数组和结构体。

• SOAP 消息的编码样式通过SOAP-ENV:encodingStyle 属性设置。

• 要使用 SOAP 1.1 编码，请使用值 http://schemas.xmlsoap.org/soap/encoding/

• 要使用 SOAP 1.2 编码，请使用值 http://www.w3.org/2001/12/soap-encoding

• 最新的 SOAP 规范采用 XML Schema 定义的所有内置类型。但是，SOAP 保持其自身约定来定义 XML Schema 未标准化的结构，例如数组和引用。

标量类型

对于标量类型，SOAP 采用 XML Schema 规范指定的所有内置简单类型。这包括字符串、浮点数、双精度数和整数。

下表列出了主要简单类型，摘自 XML Schema 第 0 部分 - Primer http://www.w3.org/TR/2000/WD-xmlschema-0-20000407/

例如，这是一个带有双精度数据类型的 SOAP 响应：

<?xml version = '1.0' encoding = 'UTF-8'?>
<SOAP-ENV:Envelope 
   xmlns:SOAP-ENV = "http://www.w3.org/2001/12/soap-envelope"
   xmlns:xsi = "http://www.w3.org/2001/XMLSchema-instance" 
   xmlns:xsd = "http://www.w3.org/2001/XMLSchema">
   
   <SOAP-ENV:Body>
      <ns1:getPriceResponse 
         xmlns:ns1 = "urn:examples:priceservice"  
         SOAP-ENV:encodingStyle = "http://www.w3.org/2001/12/soap-encoding">
         <return xsi:type = "xsd:double">54.99</return>
      </ns1:getPriceResponse>
   </SOAP-ENV:Body>
</SOAP-ENV:Envelope>

复合类型

SOAP 数组有一套非常具体的规则，要求您同时指定元素类型和数组大小。SOAP 也支持多维数组，但并非所有 SOAP 实现都支持多维功能。

要创建数组，必须将其指定为数组的xsi:type。数组还必须包含arrayType 属性。此属性是必需的，用于指定所包含元素的数据类型和数组的维度。

例如，以下属性指定了一个包含 10 个双精度值的数组：

arrayType = "xsd:double[10]"

相反，以下属性指定了一个二维字符串数组：

arrayType = "xsd:string[5,5]"

这是一个包含双精度值数组的 SOAP 响应示例：

<?xml version = '1.0' encoding = 'UTF-8'?>
<SOAP-ENV:Envelope
   xmlns:SOAP-ENV = "http://www.w3.org/2001/12/soap-envelope" 
   xmlns:xsi = "http://www.w3.org/2001/XMLSchema-instance" 
   xmlns:xsd = "http://www.w3.org/2001/XMLSchema">

   <SOAP-ENV:Body>
      <ns1:getPriceListResponse 
         xmlns:ns1 = "urn:examples:pricelistservice"  
         SOAP-ENV:encodingStyle = "http://www.w3.org/2001/12/soap-encoding">

         <return xmlns:ns2 = "http://www.w3.org/2001/09/soap-encoding"  
            xsi:type = "ns2:Array" ns2:arrayType = "xsd:double[2]">
            <item xsi:type = "xsd:double">54.99</item>
            <item xsi:type = "xsd:double">19.99</item>
         </return>
      </ns1:getPriceListResponse>
   </SOAP-ENV:Body>
</SOAP-ENV:Envelope>

结构体包含多个值，但每个元素都使用唯一的访问器元素指定。例如，考虑产品目录中的一个项目。在这种情况下，结构体可能包含产品 SKU、产品名称、描述和价格。以下是此类结构体在 SOAP 消息中的表示方式：

<?xml version = '1.0' encoding = 'UTF-8'?>
<SOAP-ENV:Envelope 
   xmlns:SOAP-ENV = "http://www.w3.org/2001/12/soap-envelope"
   xmlns:xsi = "http://www.w3.org/2001/XMLSchema-instance" 
   xmlns:xsd = "http://www.w3.org/2001/XMLSchema">

   <SOAP-ENV:Body>
      <ns1:getProductResponse
         xmlns:ns1 = "urn:examples:productservice" 
         SOAP-ENV:encodingStyle = "http://www.w3.org/2001/12/soap-encoding">
		
         <return xmlns:ns2 = "urn:examples" xsi:type = "ns2:product">
            <name xsi:type = "xsd:string">Red Hat Linux</name>
            <price xsi:type = "xsd:double">54.99</price>
            <description xsi:type = "xsd:string">
               Red Hat Linux Operating System
            </description>
            <SKU xsi:type = "xsd:string">A358185</SKU>
         </return>
      </ns1:getProductResponse>
   </SOAP-ENV:Body>
</SOAP-ENV:Envelope>

注意 - 请在编写 SOAP 代码时注意正确的缩进。结构体中的每个元素都使用唯一的访问器名称指定。例如，上述消息包含四个访问器元素：名称、价格、描述和 SKU。每个元素可以具有自己的数据类型。例如，名称指定为字符串，而价格指定为双精度数。