SOAP12规范Word格式.docx

1、 一个作为描述在消息中的内容以及如何处理消息的信息框架的信封（envelope），一组用于表示应用定义的数据类型的编码规则（encoding rules），一个用于表示远程过程调用和返回的约定以及一个使用底层协议进行消息交换的绑定（binding）约定。潜在地，SOAP可以与很多其他的协议绑定使用；不过，在本文档中，只定义了SOAP与HTTP已经SOAP与HTTP Extension Framework的绑定。Status of this DocumentThis section describes the status of this document at the time of its

2、publication. Other documents may supersede this document. The latest status of this document series is maintained at the W3C.This is the first W3C Working Draft of the SOAP version 1.2 specification for review by W3C members and other interested parties. It has been produced by the XML Protocol Work

3、ing Group （WG）, which is part of the XML Protocol Activity.The XML Protocol Protocol Working Group has, in keeping with its charter, produced a set of requirements and usage scenarios that have been published as a Working Draft. To better evaluate SOAP/1.1 against these requirements and usage scenar

4、ios, the Working Group has produced an abstract model and a glossary of terms and concepts used by the Working Group. In addition, the Working Group has produced an issues list that describes issues and concerns raised by mapping its requirements and the XMLP abstract model against the SOAP/1.1 spec

5、ification as well as issues raised on the mailing list against SOAP/1.1.The current name for this specification is SOAP version 1.2, this first Working Draft being based on SOAP/1.1 as per the Working Groups charter （see change log in appendix D）Comments on this document should be sent to xmlp-comme

6、ntsw3.org （public archives）. It is inappropriate to send discussion emails to this address.Discussion of this document takes place on the public mailing list （Archives） per the email communication rules in the XML Protocol Working Group Charter.This is a public W3C Working Draft. It is a draft docum

7、ent and may be updated, replaced, or obsoleted by other documents at any time. It is inappropriate to use W3C Working Drafts as reference material or to cite them as other than work in progress. A list of all W3C technical reports can be found at http:/www.w3.org/TR/.1. 引言SOAP v1.2为在一个松散的、分布的环境中使用XM

8、L对等地交换结构化的和类型化的信息提供了一个简单且轻量级的机制。SOAP本身并不定义任何应用语义，如编程模型或特定语义实现，它只是定义了一种简单的机制，通过一个模块化的包装模型和对模块中特定格式编码的数据的重编码机制来表示应用语义。SOAP的这项能力使得它可被很多类型的系统用于从消息系统到RPC（Remote Procedure Call）的延伸。SOAP由四部分组成:1. SOAP envelop （SOAP信封，参阅 section 4），它构造定义了一个整体的表示框架，可用于表示在消息（message）中的是什么，谁应当处理它，以及这是可选的 还是强制的。2. SOAP encoding

9、 rules （SOAP编码规则，参阅 section 5），定义了一个编序机制用于交换应用程序定义的数据类型的实例。3. SOAP RPC representation （SOAP RPC表示，参阅 section 7），定义了一个用于表示远端过程调用和响应的约定。4. SOAP binding （SOAP绑定，参阅 section 6） 定义了一个使用底层传输协议来完成在结点间交换SOAP信封的约定。为了简化本规范，这四部分在功能上是正交的。特别的，信封和编码规则是被定义在不同的命名空间（namespace）中，这样有利于通过模块化获得简明性。本规范还定义了两种SOAP绑定（binding

10、），用于描述SOAP消息（message）如何通过带或不带HTTP扩展框架6（HTTP Extension Framework）的HTTP5消息（message）进行传输。1.1 设计目标SOAP的主要设计目标是简明性和可扩展性。这就意味着有一些传统消息系统或分布式对象系统中的特性将不包含在SOAP的核心规范中。这些特性包括： 分布式垃圾收集 （distributed garbage collection）; 批量消息传输/处理 （boxcarring or batching of messages）; 对象引用 （objects-by-reference, 需要分布式垃圾收集的支持）; 对象

11、激活 （activation, 需要对象引用的支持）。1.2 符号约定本文中的关键词“MUST”, “MUST NOT”, “REQUIRED”, “SHALL”, “SHALL NOT”, “SHOULD”, “SHOULD NOT”, “RECOMMENDED”, “MAY”, “OPTIONAL”的语义应当参阅RFC-21192。在本中文版规范中被翻译成：“必须”、“必须不”，“需要的”，“将”，“将不”，“应该”，“应该不”，“被推荐的”，“可以”，“可选的”。本文中使用的命名空间前缀“env”和“enc”等关联的SOAP命名空间分别位于以下位置：/www.w3.org/2001/06

12、/soap-envelope 和/www.w3.org/2001/06/soap-encoding。在本文的全部内容中，命名空间前缀xs和xsi总假定是与/www.w3.org/2001/XMLSchema/www.w3.org/2001/XMLSchema-instance相关联的，这是由XML Schemas规范10,11所定义的。值得注意的是其他的对命名空间前缀的使用都是比较随意的而并没有显著语义的约束的。若命名空间的URI使用/example.org/.或本规范使用扩充BNF（Backus-Naur Form）作为构造语言，可参阅RFC-2612 5。编辑的注解将使用黄色背景标识（也许

13、无法在所有的媒介上显示），并使用前缀Ednote1.3 SOAP消息示例第一个例子展示了一个使用SOAP表示的简单的通知消息。该消息包含了一个消息头alertcontrol和消息体alert，这两部分都是由应用程序定义的，而而并不是由SOAP定义的。消息头包含了两个参数priorityexpires，用于消息传输中介和消息接受者对消息的处理。而消息体中则包含是实际传送的消息。Example 0 n:alertcontrol xmlns:n=/example.org/alertcontrolpriority12001-06-22T14:00:00-05:00/env:Bodym:alert xm

14、lns:m=/example.org/alertmsgPick up Mary at school at 2pmEnvelopeSample SOAP Message containing a header block and a body blockSOAP消息能够与不同的底层协议进行绑定，同时可以在很多种消息传输模式中使用。下面的例子则展示了SOAP是如何在HTTP的连接中使用的，其中充分使用了HTTP提供的请求/相应机制（参阅 section 6）。Example 1和Example 2展示了一个SOAP/HTTP请求的例子和一个SOAP/HTTP响应的例子。SOAP/HTTP请求包含了

15、一个获取最后交易价格（GetLastTradePrice）的信息块，其中包含了一个简单的参数，指明需要报价的股票代号。同样，与先前的例子相似，GetLastTradePrice这个XML元素也并不是由SOAP自身定义的。该请求的服务响应也包含了一个简单的参数，股票的价格。SOAP信封元素是表示SOAP消息的XML文档的顶级元素。XML命名空间则用来消除SOAP标识符与应用定义的标识符之间可能存在的歧义。Example 1POST /StockQuote HTTP/1.1Host:Content-Type: text/xml; charset=utf-8Content-Length: nnnnS

16、OAPAction: /example.org/2001/06/quotes GetLastTradePrice env:encodingStyle= xmlns:symbolDISGetLastTradePriceSample SOAP Message embedded in an HTTP RequestExample 2展示了StockQuote服务响应由Example 1描述的请求消息而返回的SOAP消息。Example 2HTTP/1.1 200 OKGetLastTradePriceResponse Price34.5GetLastTradePriceResponseSample

17、SOAP Message embedded in an HTTP Response在Appendix A中提供了更多的例子。1.4 SOAP术语1.4.1 协议概念SOAP 关于SOAP消息的格式和处理规则、为沿着SOAP消息路径交换信息而需要的不同应用程序之间生成和接收SOAP消息的交互过程的简单控制机制等的一整套规范和约定。SOAP绑定 为传输的需要而将SOAP消息在另一个底层协议之上或之内传输的一整套规范和规则。典型的SOAP绑定包括在HTTP消息中传送SOAP消息或在TCP之上传送SOAP消息等。SOAP结点 SOAP结点根据SOAP定义的整套规范来处理SOAP消息。SOAP结点有责任

18、遵守SOAP消息交换的规则以及提供通过依赖底层协议的SOAP绑定来访问的服务。任何不符合SOAP约定的情况都将导致SOAP结点产生一个SOAP错误（可参阅SOAP接受者和SOAP发送者）。1.4.2 数据封装概念SOAP消息 SOAP消息（message）是在对等SOAP结点（SOAP nodes）间通讯的基本单位。SOAP信封 SOAP信封（envelope）是SOAP规范中定义的SOAP消息（SOAP message）在句法上的最外层结构。在句法上，它包含了所有其他的元素。SOAP条目 SOAP条目是一个句法上的结构，它用于包含一个逻辑上的单一元素，这一元素是需要被SOAP结点处理的。一个

19、SOAP条目是由该条目最外层元素的完整修饰名所标识的，这个完整修饰名是由一个局部名和一个命名空间URI组成的。封装在SOAP header中的SOAP条目成为Header条目，而封装在SOAP body中的SOAP条目为Body条目。SOAP header 能够被SOAP消息路径中任意的SOAP接受者处理的一组SOAP条目（0个或多个）。SOAP body 能够被SOAP消息路径中的最终SOAP接受者处理的一组SOAP条目（0个或多个）。SOAP fault SOAP结点产生的用于包含错误信息的特殊的SOAP条目。以下的图表演示了一个SOAP消息是如何组成的。Figure 1: Encapsu

20、lation model illustrating the parts of a SOAP message1.4.3 消息发送者和接收者概念SOAP发送者 SOAP发送者是发出SOAP消息的SOAP结点。SOAP接收者 SOAP接收者是接受SOAP消息的SOAP结点。SOAP消息路径 为传送一个简单的SOAP消息而要经过的一组SOAP发送者和SOAP接受者。其中包含了初始SOAP发送者、零个或多个SOAP中介以及最终SOAP接受者。初始SOAP发送者 SOAP消息的最初产生者，同时也是SOAP消息路径的第一个结点。SOAP中介 SOAP中介即是SOAP接收者也是SOAP发送者，是SOAP消息可

21、到达的某一个应用程序。当SOAP消息沿着SOAP消息路径传输时，SOAP中介将处理一组确定的SOAP条目，然后它将消息转发给消息路径的下一个SOAP结点，直至传送到最终SOAP接收者。最终SOAP接收者 由初始SOAP发送者指定的通过SOAP消息路径传送SOAP消息的最终SOAP接收者。如果在SOAP消息路径中有SOAP结点产生了SOAP错误，那么SOAP消息将不会到达最终接收者。1.4.4 数据编码概念SOAP数据模型 一组抽象的构造约定，用于描述通用的数据类型和数据中的链接关系。SOAP数据编码 在SOAP消息中使用一个或多个SOAP条目，按照SOAP数据模型完成句法上的数据表示。2. S

22、OAP消息交换模型从根本上来看，SOAP消息是从发送方到接受方的一种传输方法，但就象前面例子中阐述的那样，SOAP消息一般会和实现模式结合，例如请求/响应。SOAP的实现可以为特殊网络系统的特有特征来优化。例如，在section 6中描述的HTTP binding将SOAP响应消息通过HTTP响应来传输，使用与相对应请求的同一HTTP连接。2.1 SOAP结点SOAP结点可以是初始SOAP发送者，可以是最终SOAP接收者，也可以是同时作为SOAP发送者和接收者的SOAP中介。SOAP并不提供一个路由机制，曾因此SOAP需要识别SOAP发送者产生的SOAP消息应当通过哪些零个或多个SOAP中介被

23、发送到一个最终SOAP接收者。接收到SOAP消息的SOAP结点必须能够实施处理、产生必要的SOAP错误和SOAP响应，如果合适的话还应当根据本规范的后续描述生成额外的SOAP消息。2.2 SOAP角色与SOAP结点当处理一个SOAP消息的时候，SOAP结点将被告知应当以一个或多个SOAP处理角色来处理，这些SOAP角色由SOAP actor名来标识，SOAP actor的名字是一个URI。每个SOAP结点都必须以一个指定的角色来处理，这个角色使用命名为/www.w3.org/2001/06/soap-envelope/actor/next的SOAP actor来表示，同时可以按照需要应用零个或

24、多个其他SOAP actor表示的额外角色。SOAP结点可以通过以匿名SOAP actor的角色来实施处理以使得自己成为最终SOAP接收者。当SOAP结点在处理一个SOAP消息的时候，其表现出的SOAP角色在整个处理过程中不得更改。这是因为本规范只涉及如何处理单个SOAP消息而无需考虑状态，因此是否允许在处理单个SOAP消息的时候转换角色是没有意义的。SOAP actor名字是用来识别SOAP结点的，并没有与路由或者消息交换的语义相联系。举例来说，一个SOAP actor可以被命名为一个用来发送SOAP消息给适当SOAP结点的URI。相反，也有这样一些SOAP处理角色的名字，这些名字或者直接和

25、消息路由相联系（例如,http:/example.org/banking/anyAccountMgr），或者和路由没有联系（例如，当一个消息头被用来携带一个指示，该指示用来告知任何有关的软件该SOAP消息是长期不变的，是能够被安全的缓存和重用的，在这种SOAP消息头中，一个URI可以用于标识“所有缓存管理软件”），通过名字使用这些SOAP处理角色也是合适的。2.3 定位SOAP Header条目SOAP header条目包含可选的env:actor属性（参阅section 4.2.2）用来把他们定位到合适的SOAP结点。没有该属性的SOAP Header隐含地定位到一个匿名的SOAP acto

26、r，这意味着他们被处理为最终的SOAP接收者。我们把SOAP actor属性的值（隐含的或者直接指明的）作为相应SOAP条目（SOAP Header条目或者SOAP Body条目）的SOAP actor。如果SOAP条目中SOAP actor（如果出现的话）匹配了一个SOAP结点的角色，或者是SOAP条目没有actor属性（包括SOAP Body条目）而该SOAP结点已经假设为匿名SOAP处理角色，这时我们就说SOAP条目被指向一个SOAP结点。2.4 理解SOAP Header我们认为随着时间的过去，会有大量的SOAP Header函数规范出现，而且每个SOAP结点都可以包含一个或多个处理这

27、些扩展所必须的软件。如果SOAP结点的软件是完全兼容的而且实现了那些由条目中完整修饰的最外层元素名所传递的语义，我们说这个SOAP Header被一个SOAP结点理解。当定位到一个SOAP结点的SOAP Header块的mustUnderstand属性为“1”，被指向的SOAP结点必须：或者依照由条目中完整修饰的最外层元素名传递的语义来处理SOAP块，或者更本不处理SOAP消息而失败（参见section 4.4）.。2.5 处理消息本节陈述了SOAP消息处理规则。除非另外规定，处理必须在语义上等同于分别执行下述的步骤，同时还必须按照给定的顺序。注意到，无论如何在这个规范中都没有阻止使用如并行、回滚或者其他可以在处理中提高灵