4·SOAP封装

　　SOAP消息是一个XML文档，包括一个必需的SOAP封装，一个可选的SOAP头和一个必需的SOAP体。在这篇规范剩余部分中，提到SOAP消息时就是指这个XML文档。这一节中定义的元素和属性的名域标志符为：  "http://schemas.xmlSOAP.org/SOAP/envelope/";  。
　　一个SOAP消息包括以下部分：
　　1）在表示这个消息的XML文档中，封装是顶层元素。
　　2）应用SOAP交换信息的各方是分散的且没有预先协定，SOAP头提供了向SOAP消息中添加关于这条SOAP消息的某些要素(feature)的机制。SOAP定义了少量的属性用来表明这项要素（feature）是否可选以及由谁来处理。（见4.2节）
　　3）SOAP体是包含消息的最终接收者想要的信息的容器（见4.3节）。

SOAP为SOAP体定义了一个Fault元素用来报告错误信息。语法规则如下所示： 

封装 

元素名是  "envelope"
在SOAP消息中必须出现。
可以包含名域声明和附加属性。如果包含附加属性，这些属性必须限定名域。类似的，"Envelope"可以包含附加子元素，这些也必须限定名域且跟在SOAP体元素之后。
SOAP头  （见4.2节） 

元素名是"header"
在SOAP消息中可能出现。如果出现的话，必须是SOAP封装元素的第一个直接子元素。
SOAP头可以包含多个条目，每个都是SOAP头元素的直接子元素。所有SOAP头的直接子元素都必须限定名域。
SOAP体  （见4.3节） 

元素名是"body"
在SOAP消息中必须出现且必须是SOAP封装元素的直接子元素。它必须直接跟在SOAP头元素（如果有）之后。否则它必须是SOAP封装元素的第一个直接子元素。
SOAP体可以包括多个条目，每个条目必须是SOAP体元素的直接子元素。SOAP体元素的直接子元素可以限定名域。SOAP定义了SOAPFault元素来表示错误信息。

　　4-1-1  SOAP  encodingstyle属性

　　Encodingstyle全局属性用来表示SOAP消息的序列化规则。这个属性可以在任何元素中出现，作用范围与名域声明的作用范围很相似，为这个元素的内容和它的所有没有重载此属性的子元素。SOAP消息没有定义缺省编码。属性值是一个或多个URI的顺序列表，每个URI确定了一种或多种序列化规则，用来不同程度反序列化SOAP消息，举例如下： 

"http://schemas.xmlSOAP.org/SOAP/encoding/";
"http://my.host/encoding/restrictedhttp://my.host/encoding/";
"" 

　　第5节中定义的序列化规则由uri"http://schemas.xmlSOAP.org/SOAP/encoding/";  确定。使用这个特定序列化规则的消息应该用encodingstyle属性说明这一点。另外，所有以"http://schemas.xmlSOAP.org/SOAP/encoding/";开头的URI中的序列化规则与第5节中定义的SOAP编码规则相一致。一个零长度的URI（""）明确显示所含元素没有任何编码形式。这可以用来取消上一级元素的所有编码声明。 

　　4-1-2  封装版本模型

　　SOAP没有定义常规的基于主版本号和辅版本号的版本形式。SOAP消息必须有一个封装元素与名域"http://schemas.xmlSOAP.org/SOAP/envelope/";关联。如果SOAP应用程序接收到的SOAP消息中的SOAP封装元素与其他的名域关联，则视为版本错误，应用程序必须丢弃这个消息。如果消息是通过HTTP之类的请求/应答协议收到的，应用程序必须回答一个SOAP  VersionMismatch  错误信息（见4.4节）。 

　　4-2  SOAP头

　　SOAP为相互通信的团体之间提供了一种很灵活的机制：在无须预先协定的情况下，以分散但标准的方式扩展消息。可以在SOAP头中添加条目实现这种扩展，典型的例子有认证，事务管理，支付等等。头元素编码为SOAP封装元素的第一个直接子元素。头元素的所有直接子元素称作条目。条目的编码规则如下： 

一个条目有它的完整的元素名（包括名域uri和局部名）确定。SOAP头的直接子元素必须有名域限制。
SOAP  encodingstyle属性可以用来指示条目所用的编码形式（见4.1.1节）
SOAP  mustUnderstand属性（见4.2.3节）和SOAPactor属性（见4.2.2节）可以用来指示如何处理这个条目以及由谁来处理。（见4.2.1节） 

　　4-2-1  使用头属性

　　这一节中定义的SOAP头属性确定了SOAP消息的接收者应该怎样按第2节中所述的方式处理消息。产生SOAP消息的SOAP应用程序，应该仅仅在SOAP头元素的直接子元素中使用这些SOAP头属性。SOAP消息的接收者必须忽略所有不在SOAP头元素的直接子元素中SOAP头属性。下面的例子是一个SOAP头，包括一个元素标志符"Transaction"，"mustUnderstand"取值为"1"和数值5。这应该以如下方式编码： 

<SOAP-env:header>
<t:Transaction
xmlns:t="some-URI"  SOAP-ENV:mustUnderstand="1">
5
</t:Transaction>
</SOAP-ENV:Header> 

　　4-2-2  SOAP  actor属性

　　一个SOAP消息从始节点到终节点的过程中，可能沿着消息路径经过一系列SOAP中间节点。一个SOAP中间节点是一个可以接收转发SOAP消息的应用程序。中间节点和终节点由URI区分。可能SOAP消息的终节点并不需要所有部分，而在消息路径上的一个和几个中间节点可能需要这些内容。头元素的接收者扮演的角色类似于一个过滤器，防止这些只发给本接受者的消息部分扩散到其它节点。即一个头元素的接收者必须不转发这些头元素到SOAP消息路径上的下一个应用程序。同样的，接收者可能插入一个相似的头元素。SOAP  actor全局属性可以用于指示头元素的接收者。SOAP  actor属性的值是一个URI。 

　　URI"http://schemas.xmlSOAP.org/SOAP/actor/next";指出了第一个处理这个消息的SOAP应用程序需要这个头元素。这类似于HTTP头中用Connection域表示hop-by-hop范围模型。省略SOAP  actor属性表示接收者是SOAP消息的终节点。如果这个属性要生效，它必须出现在SOAP消息实例中。（见第3节和4.2.1节） 

　　4-2-3  SOAP  mustunderstand属性

　　SOAP  mustUnderstand全局属性用来指示接受者在处理消息时这个条目是否必须处理。条目的接收者由SOAP  actor属性定义（见4.2.2节）。MustUnderstand属性的值是"1"  或  "0"。缺少SOAP  mustUnderstand属性在语义上等同于它的值为"0"。如果一个头元素的SOAP  mustUnderstand属性的值是"1",那么条目的接受者必须或者遵守语义（如以元素的全名传送）并按照语义正确的处理，或者放弃处理消息（见4.4节）。SOAP  mustUnderstand  属性考虑了消息演变的准确性（robust  evolution）。必须假定包含SOAP  mustUnderstand属性且值为"1"的元素以某种方式修改了它们的父元素或同层元素的语义。以这种方式连接元素确保了语义上的变化不会被那些不能完全理解它的接收者忽略。如果这个属性要生效，它必须出现在SOAP消息实例中。（见第3节和4.2.1节） 

　　4-3  SOAP体

　　SOAP体元素提供了一个简单的机制，使消息的最终接收者能交换必要的信息。使用体元素的典型情况包括配置RPC请求和错误报告。体元素编码为SOAP封装元素的直接子元素。如果已经有一个头元素，那么体元素必须紧跟在头元素之后，否则它必须是SOAP封装元素的第一个直接子元素。体元素的所有直接子元素称作体条目，每个体条目在SOAP体元素中编码为一个独立的元素。条目的编码规则如下： 

一个条目由它的元素全名（包括名域uri和局部名）确定。SOAP体元素的直接子元素可能是名域限制的。
SOAP  encodingstyle属性可能用来指示条目（见4.1.1节）的编码方式。
SOAP定义了一个Fault条目用来报告错误信息。（见4.4节）

　　4-3-1  SOAP头和体的关系

　　虽然头和体定义为独立的元素，它们实际上是有关系的。体条目和头条目的关系如下：体条目在语义上等同于actor属性为缺省值且mustUnderstand属性值为"1"的头条目。不使用actor属性则表示缺省的actor。（见4.2.2节） 

　　4-4  SOAP错误

　　SOAP错误元素用于在SOAP消息中携带错误和（或）状态信息。如果有SOAP错误元素，它必须以以体条目的方式出现，并且在一个体元素中最多出现一次。SOAP错误元素定义了以下四个子元素： 

faultcode
　　faultcode元素给软件提供了一个识别此错误的算法机制。SOAP错误元素必须有faultcode子元素，并且它的值必须是一个合法的名（在[8]节定义）。SOAP定义一些SOAP  faultcode描述基本的SOAP错误（见4.4.1节）。

faultstring
　　faultstring元素提供了一个错误解释，而不是为了软件处理。faultstring元素类似于HTTP中定义的'Reason-Phrase'。SOAP错误元素必须有faultstring子元素，并且它应该提供一些错误本质的解释信息。

faultactor
　　faultactor元素提供了在消息路径上是谁导致了错误发生的信息（见第2节）。它类似于SOAP  actor属性（见4.2.2节），只是SOAP  actor指的是头条目的目的地，faultactor指的是错误的来源。faultactor属性的值是用来区分错误来源的URI。不是SOAP消息的最终目的地的应用程序必须在SOAP  Fault元素中包含faultactor元素。消息的最终目的地可以使用faultactor元素明确的指示是它产生了这个错误（参见下面的detail元素）

detail
　　detail元素用来携带与Body元素有关的应用程序所要的错误信息。如果Body元素的内容不能被成功的处理，则必须包含detail子元素。它不能用来携带属于头条目的错误信息。头条目的详细出错信息必须由头条目携带。Fault元素中没有detail元素表示这个错误与Body元素的处理无关。在有错误的时候，这可以用来区分Body元素有没有被正确的处理。detail元素的所有直接子元素称作detail条目，并且每个detail条目在detail元素中编码为独立的元素。detail条目的编码规则如下（参见例10）：  一个detail条目由它的元素全名（包括名域URI和局部名）确定。SOAP体元素的直接子元素可能是名域限制的。SOAP  encodingstyle属性可能用来指示detail条目（见4.1.1节）的编码方式。也可以有其它的Fault子元素，只要它们是名域限制的。

　　4-4-1  SOAP  错误代码
在描述这个规范中定义的错误时，这一节中定义的Faultcode值必须用在faultcode元素中。这些faultcode值得名域标志符为"http://schemas.xmlSOAP.org/SOAP/envelope/";。定义这个规范之外的方法时推荐（不要求）使用这个名域。缺省的SOAP  faultcode值以可扩展的方式定义，允许定义新的SOAP  faultcode值，并与现有的faultcode值向后兼容。 字符"."（点）作为faultcode的分隔符，点左边的错误代码比右边的错误代码更为普通。如： 

client.authentication 

这篇文档中定义的faultcode值是： 

名称  含义
VersionMismatch  处理方发现SOAP封装元素有不合法的名域（见4.1.2节）
MustUnderstand  处理方不理解或者不服从一个包含值为"1"的
mustUnderstand  属性的  SOAP头元素的直接子元素。（见4.2.3节） 

client 

　　client错误类表示消息的格式错误或者不包含适当的正确信息。例如，消息可能缺少正确的认证和支付信息。一般地，它表示消息不能不作修改就重发。参见4.4节 

　　SOAP  fault  detail子元素的描述。 

server 

　　server错误类表示由于消息的处理过程而不是消息的内容本身使得消息消息不能正确的处理。例如，处理消息时可能要与其它处理器通信，但它没有响应。这个消息可能在迟一点的时间处理成功。  SOAP  fault子元素的详细信息参见4.4节