SOAP即简单对象访问协议，是Web Service场景下用于交换结构化信息的轻量级协议，SOAP信封和SOAP编码是SOAP协议规范中的两个核心组成部分，直接影响SOAP消息的封装和数据处理逻辑。
SOAP信封的作用
SOAP信封是SOAP消息的顶层容器，所有SOAP消息都必须包含在信封元素中，它的核心作用可以分为以下几个方面：
1. 封装完整的SOAP消息
SOAP信封作为消息的根元素，将SOAP消息的所有内容包裹起来，明确区分SOAP消息本身和消息之外的其他内容。一个标准的SOAP消息结构如下：
<?xml version="1.0"?>
<soap:Envelope
xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
<soap:Header>
<!-- 可选的头部信息 -->
</soap:Header>
<soap:Body>
<!-- 必选的消息体内容 -->
</soap:Body>
</soap:Envelope>
2. 指定消息的处理规则
SOAP信封可以通过属性定义消息的处理要求，比如soap:encodingStyle属性可以指定消息使用的编码规则，soap:mustUnderstand属性可以标记头部条目是否必须被接收方处理，帮助接收方正确解析和处理消息。
3. 携带附加的头部信息
SOAP信封包含可选的<soap:Header>子元素，用于传递和消息处理相关的附加信息，比如认证令牌、事务标识、路由信息等，这些信息不需要放在消息体中，通过信封的头部区域传递可以让处理逻辑更清晰。
4. 保证消息的完整性和规范性
SOAP信封定义了SOAP消息的固定结构，所有遵循SOAP协议的系统都按照统一的结构封装和解析消息，避免了消息格式混乱的问题，保证了不同平台、不同语言实现的Web Service之间可以正常交互。
如何定义SOAP编码
SOAP编码用于定义SOAP消息中数据的序列化规则，也就是如何将程序中的数据结构转换为XML格式，以及如何将XML格式还原为程序中的数据结构，定义SOAP编码需要关注以下几个要点：
1. 指定编码样式属性
SOAP编码通过soap:encodingStyle属性来声明，该属性可以出现在SOAP信封、消息体或者具体的元素上，用于指定当前元素使用的编码规则。SOAP协议默认定义了两种编码样式：
- SOAP编码：对应值为
http://schemas.xmlsoap.org/soap/encoding/，是SOAP规范自带的编码规则 - XML Schema编码：对应值为
http://www.w3.org/2001/XMLSchema，使用XML Schema定义数据类型和编码规则
示例代码如下：
<soap:Envelope
xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/"
soap:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/">
<soap:Body>
<test:add xmlns:test="http://example.org/test">
<test:a>1</test:a>
<test:b>2</test:b>
</test:add>
</soap:Body>
</soap:Envelope>
2. 遵循SOAP编码的数据类型规则
如果使用SOAP默认的编码样式，需要遵循其定义的数据类型映射规则，常见的映射关系如下：
| 程序数据类型 | SOAP编码XML表示 |
|---|---|
| 整数 | <value xsi:type="xsd:int">10</value> |
| 字符串 | <value xsi:type="xsd:string">test</value> |
| 数组 | <array soapenc:arrayType="xsd:int[2]"><item>1</item><item>2</item></array> |
| 结构体 | <struct><name xsi:type="xsd:string">张三</name><age xsi:type="xsd:int">20</age></struct> |
3. 自定义编码规则
除了使用SOAP默认的编码样式，也可以自定义编码规则，只需要定义自己的编码样式命名空间，然后在soap:encodingStyle属性中指定该命名空间即可。自定义编码需要明确数据类型的映射方式、序列化反序列化的逻辑，保证发送方和接收方使用相同的规则。
如果使用自定义编码，示例代码如下：
<soap:Envelope
xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:myenc="http://ipipp.com/myencoding"
soap:encodingStyle="http://ipipp.com/myencoding">
<soap:Body>
<my:data xmlns:my="http://ipipp.com/test">
<my:content myenc:type="my:customType">自定义数据</my:content>
</my:data>
</soap:Body>
</soap:Envelope>
4. 编码与消息体的配合
SOAP编码的定义需要和消息体的内容匹配，消息体中所有需要序列化的数据都要遵循声明的编码规则，否则接收方解析时会出现错误。如果消息中同时使用了多种编码规则，可以在不同的子元素上分别指定soap:encodingStyle属性。
总结
SOAP信封是SOAP消息的容器，负责封装消息、指定处理规则、携带附加信息，保证SOAP消息的规范性和交互兼容性。定义SOAP编码主要通过指定soap:encodingStyle属性，选择合适的编码样式，遵循对应的数据类型映射规则，也可以根据需求自定义编码规则。在实际开发中，需要根据项目需求选择合适的编码方式，保证SOAP消息的正确封装和解析。
SOAPSOAP_envelopeSOAP_encodingWeb_Service修改时间：2026-06-16 09:06:32