W3C Working Draft 9 July 2001

英文版:

http://www.w3.org/TR/2001/WD-soap12-20010709/

英文版的最后版:

http://www.w3.org/TR/soap12/

英文版編輯:

Martin Gudgin (DevelopMentor)

Marc Hadley (Sun Microsystems)

Jean-Jacques Moreau (Canon)

Henrik Frystyk Nielsen (Microsoft Corp.)

中文版:

http://www.uddi-china.org/pubs/misc/soap12.htm

中文版編輯:

柴曉路, Fennivel Chai (DealEasy)

中文版貢獻(xiàn)者:

許佑駿, Arthor Xu (DealEasy)

Copyright ©2001 W3C® (MIT, INRIA, Keio), All Rights Reserved. W3C liability, trademark, document use and software licensing rules apply.

--------------------------------------------------------------------------------

Abstract

SOAP 1.2為在一個松散的、分布的環(huán)境中使用XML對等地交換結(jié)構(gòu)化的和類型化的信息提供了一個簡單且輕量級的機(jī)制。這是一個基于XML的協(xié)議，同時它由四部分組成: 一個作為描述在消息中的內(nèi)容以及如何處理消息的信息框架的信封(envelope)，一組用于表示應(yīng)用定義的數(shù)據(jù)類型的編碼規(guī)則(encoding rules)，一個用于表示遠(yuǎn)程過程調(diào)用和返回的約定以及一個使用底層協(xié)議進(jìn)行消息交換的綁定(binding)約定。潛在地，SOAP可以與很多其他的協(xié)議綁定使用；不過，在本文檔中，只定義了SOAP與HTTP已經(jīng)SOAP與HTTP Extension Framework的綁定。

Status of this Document

This section describes the status of this document at the time of its 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 Working 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 scenarios, 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 specification as well as issues raised on the <xml-dist-app@w3.org> 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 Group's charter (see change log in appendix D)

Comments on this document should be sent to xmlp-comments@w3.org (public archives). It is inappropriate to send discussion emails to this address.

Discussion of this document takes place on the public <xml-dist-app@w3.org> 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 document 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/.

Table of Contents

1. 引言

1.1 設(shè)計目標(biāo)

1.2 符號約定

1.3 SOAP消息示例

1.4 SOAP術(shù)語

1.4.1 協(xié)議概念

1.4.2 數(shù)據(jù)封裝概念

1.4.3 消息發(fā)送者和接收者概念

1.4.4 數(shù)據(jù)編碼概念

2. SOAP消息交換模型

2.1 SOAP結(jié)點

2.2 SOAP角色與SOAP結(jié)點

2.3 定位SOAP Header條目

2.4 理解SOAP Header

2.5 處理消息

3. 與XML的關(guān)系

4. SOAP信封

4.1.1 SOAP encodingStyle屬性

4.1.2 Envelope版本模型

4.2 SOAP Header

4.2.1 使用Header屬性

4.2.2 SOAP actor屬性

4.2.3 SOAP mustUnderstand屬性

4.3 SOAP Body

4.3.1 SOAP Header和Body的關(guān)系

4.4 SOAP錯誤

4.4.1 SOAP錯誤代碼

4.4.2 MustUnderstand錯誤

5. SOAP編碼

5.1 使用XML進(jìn)行類型編碼的規(guī)則

5.2 簡單類型

5.2.1 字符串

5.2.2 枚舉

5.2.3 字節(jié)數(shù)組

5.3 多態(tài)存取標(biāo)識

5.4 復(fù)合類型

5.4.1 復(fù)合值及對值的引用

5.4.2 數(shù)組

5.4.2.1 部分傳輸數(shù)組

5.4.2.2 稀疏數(shù)組

5.4.3 通用復(fù)合類型

5.5 默認(rèn)值

5.6 SOAP root屬性

6. 在HTTP中使用SOAP

6.1 SOAP HTTP請求

6.1.1 HTTP Header中的SOAPAction字段

6.2 SOAP HTTP響應(yīng)

6.3 HTTP擴(kuò)展框架

6.4 SOAP HTTP示例

7. 在RPC中使用SOAP

7.1 RPC和SOAP Body

7.2 RPC和SOAP Header

8. 安全機(jī)制的考慮

9. 參考文獻(xiàn)

9.1. Normative references

9.2. Informative references

A. SOAP Envelope Examples

A.1 Sample Encoding of Call Requests

A.2 Sample Encoding of Response

B. Acknowledgements

C. Version Transition From SOAP/1.1 to SOAP/1.2

D. Change Log

D.1 SOAP Specification Changes

D.2 XML Schema Changes