SOAP详解(转)

时间 2019-11-17

标签 soap 详解繁體版

原文原文链接

1. SOAP简介

1.1应用背景

对于应用程序开发来讲，使程序之间进行因特网通讯是很重要的。目前的应用程序经过使用远程过程调用（RPC）在诸如 DCOM 与 CORBA 等对象之间进行通讯，可是 HTTP 不是为此设计的。RPC 会产生兼容性以及安全问题；防火墙和代理服务器一般会阻止此类流量。经过 HTTP 在应用程序间通讯是更好的方法，由于 HTTP 获得了全部的因特网浏览器及服务器的支持。SOAP 就是被创造出来完成这个任务的。SOAP 提供了一种标准的方法，使得运行在不一样的操做系统并使用不一样的技术和编程语言的应用程序能够互相进行通讯。web

1.2概念定义

SOAP 是基于 XML 的简易协议，是用在分散或分布的环境中交换信息的简单的协议，可以使应用程序在 HTTP 之上进行信息交换。或者更简单地说：SOAP 是用于访问网络服务的协议。包括三个部分：封装定义了一个描述消息中包含什么内容以及如何处理它们的框架，编码规则用于表示应用程序定义的数据类型的实例，另外还有一个表示远程过程调用和应答的协定。SOAP被设计为能够与各类其它协议结合使用；这里仅描述如何将SOAP和HTTP及HTTP扩展框架相结合。编程

SOAP以XML形式提供了一个简单、轻量的用于在分散或分布环境中交换结构化和类型化信息的机制。SOAP自己并无定义任何应用程序语义，如编程模型或特定语义的实现；实际上它经过提供一个有标准组件的包模型和在模块中编码数据的机制，定义了一个简单的表示应用程序语义的机制。这使SOAP可以被用于从消息传递到RPC的各类系统。目前最新版本的SOAP1.2是Sun Microsystems、IBM、BEA、Microsoft和Oracle等供应商领导的W3C XML工做组推出并维护的。浏览器

SOAP的两个目标是简单性和可扩展性，这就意味着有一些传统的消息系统或分布式对象系统中的某些性质将不是SOAP规范的一部分。SOAP是一种分布式计算中的技术，它被有意的设计为轻量级的协议，它的某些功能和其余一些机制（如RMI）共有的，但也存在许多不一样的功能，如不支持经过引用传递对象、对象激活、消息批处理等。SOAP也被设计成可扩展的，而简单性和可扩展性意味着SOAP的使用不包含任何特定的编程模式，给定实现的语义是极为灵活的。安全

SOAP基于XML语言和XSD标准，其定义了一套编码规则，该规则定义如何将数据表示为消息，以及怎样经过HTTP协议来传输SOAP消息，它由如下四部分组成：服务器

> SOAP信封（Envelope）：定义了一个框架，该框架描述了消息中的内容是什么，包括消息的内容、发送者、接收者、处理者以及如何处理这些消息。网络

> SOAP编码规则：它定义了一种系列化机制，用于交换应用程序所定义的数据类型的实例。app

> SOAP RPC表示：它定义了用于表示远程过程调用和应答协定。框架

> SOAP绑定：它定义了一种使用底层传输协议来完成在节点间交换SOAP信封的约定。异步

SOAP消息基本上是从发送端到接收端的单向传输，它们经常结合起来执行相似于请求/应答的模式。不须要吧SOAP消息绑定到特定的协议，SOAP能够运行在任何其余传输协议（HTTP、SMTP、FTP等）上。另外，SOAP提供了标准的RPC方法来调用Web Service以请求/响应模式运行。编程语言

注意：

实际上，SOAP在这里有点用词不当：它意味着下面的Web service是以对象的方式表示的，但事实并不必定如此：你彻底能够把你的Web service写成一系列的C函数，并仍然使用SOAP进行调用

2. 消息交换模型

2.1SOAP接点

SOAP结点表示SOAP消息路径的逻辑实体，用于进行消息路由或处理。SOAP结点能够是SOAP消息的发送者、接收方、消息中介。

在SOAP消息模型中，中间方为一种SOAP结点，负责提供发送消息的应用程序和接收方间的消息交换和协议路由功能。中间方结点驻留在发送结点和接收结点之间，负责处理SOAP消息头中定义的部分消息。SOAP发送方和接收方之间能够有0个或多个SOAP中间方，它为SOAP接收方提供分布式处理机制。

通常，SOAP消息中间方分为两种：

1. 转发中间方：这一类型的中间方经过在所转发消息的SOAP消息头块中描述和构造语义和规则，从而实现消息处理。

2. 活动中间方：这一类型的中间方利用一组功能为接收方结点修改外部绑定消息，从而提供更多的消息处理操做。

在SOAP消息交换路径中，借助于SOAP中间方，使得分布式处理模型在SOAP消息交换中得以实现。经过使用SOAP中间方，能够向SOAP应用程序中集成各类功能（如转发、过滤、事务、安全、日志记录、智能路由等）。

2.2没有消息提供者的客户端

不使用消息提供者的应用程序只能交换同步消息。也就是说，扮演客户端角色的应用程序只能发送请求-响应消息。这种类型的客户端采用SAAJ API的SOAPConnection方法。下图演示了在没有消息提供者的状况下，同步消息如何在发送者和接收者之间交换。

图1 不使用消息提供者的SOAP消息

不使用消息提供者的客户端具备如下优势：

> 能够采用J2SE平台编写应用程序。

> 不须要在servlet或J2EE容器中部署应用程序。

> 不须要配置消息提供者。

不使用消息提供者的客户端具备如下局限性：

> 客户端只能发送请求-响应消息

> 客户端只能扮演客户端角色

2.3使用消息提供者的客户端

若是想要得到而且保存在任什么时候间发送给你的请求，你必须使用消息提供者。使用消息提供者的客户端还能发送异步消息JAXM API提供了使用消息提供者发送和接收消息的框架。你须要在容器中运行客户端，容器提供了消息基础结构让提供者使用。下图演示了在使用消息提供者的状况下，异步消息如何在发送者和接收者之间交换。

图2使用消息提供者的SOAP消息

使用消息提供者的客户端具备如下优势：

> 客户端可以扮演客户端或者服务角色

> 客户端可以切换消息传递给提供者

> 在客户端传递消息到最终接收者以前，它可以发送消息到一个或多个目的地。这些中间的消息接收者被称为actor，它们在消息的SOAPHeader对象中被指定。

> 客户端可以利用任何提供者支持的SOAP消息协议和影响消息类型与可靠性的‘服务质量’，以及消息传递服务的质量。

注意

Sun Java System Application Server包含了一个示例JAXM提供者，它演示了如何使用提供者为发送客户端激活“发后不理（fire and forget）”消息。请察看示例文档获取关于如何激活、部署和使用它的全面信息。示例应用程序能够从如下位置获得:

install_dir/samples/webservices/jaxm/jaxm-provider/

Sun Java System Application Server的将来版本将会包括支持可靠SOAP消息和ebXML消息的JAXM提供者。

3.SOAP消息

3.1SOAP消息的组成部分

全部的SOAP消息都使用XML编码，一条SOAP消息就是一个普通的XML文档，该文档包括下列元素。

> Envelope（信封）元素，必选，可把此XML文档标识为一条SOAP消息。

> Header（报头）元素，可选，包含头部信息（包含了使消息在到达最终目的地以前，可以被路由到一个或多个中间节点的信息）。

> Body(主体)元素，必选，包含全部的调用和响应信息。

> Fault元素，位于Body内，可选，提供有关处理此消息所发生错误的信息。

> Attachment（附件）元素，可选，可经过添加一个或多个附件扩展SOAP消息。

图3 SOAP消息的结构和组成部分

SOAPMessage对象包括：

一个SOAPPart对象，其中包括

一个SOAPEnvelope对象，其中包括

一个空的SOAPHeader对象 – 可选，包括它是为了方便，由于大多数消息都要用到它, SOAP头提供了向SOAP消息中添加关于这条SOAP消息的某些要素(feature)的机制。SOAP定义了少许的属性用来代表这项要素（feature）是否可选以及由谁来处理。

一个空的SOAPBody对象 -包含消息的最终接收者想要的信息的容器,能够容纳消息的内容，还能容纳包含了状态信息或者消息故障明细的错误消息。

AttachmentPart可能容纳普通文本或者图像文件。

SOAPEnvelope是表明消息的XML文件的根元素。它为消息如何处理、由谁处理定义了框架。XML内容从SOAPEnvelope开始。

SOAPHeader是添加特性到SOAP消息的基本机制。它能够容纳任意数目的扩展了基础协议的子元素。例如，header子元素可能会定义认证信息、事务信息、本地信息、等等。处理消息的软件能够在没有事先约定的状况下，使用这个机制定义谁应该处理某个特性，以及该特性是强制的仍是可选的。

SOAPBody是发给消息最终接收者的强制信息的容器。SOAP消息还能够容纳一个附件，它不必定非得是XML文件。

3.2SOAP消息举例

先来看一个简单的例子：

在这个例子中，GetLastTradePrice SOAP 请求被发往 StockQuote服务。这个请求携带一个字符串参数ticker符号，在SOAP应答中返回一个浮点数。XML名域用来区分SOAP标志符和应用程序特定的标志符。这个例子说明了在第6节中定义的HTTP绑定。若是SOAP中管理XML负载的规则彻底独立于HTTP是没有意义的，由于事实上该负载是由HTTP携带的。

例1 在HTTP请求中嵌入SOAP消息

POST /StockQuote HTTP/1.1

Host: 

www.stockquoteserver.com

Content-Type: text/xml; 

charset="utf-8"

Content-Length: nnnn

SOAPAction: 

"Some-URI"

<SOAP-ENV:Envelope

  xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"

  SOAP-ENV:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/">

   <SOAP-ENV:Body>

       <m:GetLastTradePrice xmlns:m="Some-URI">

           <symbol>DIS</symbol>

       </m:GetLastTradePrice>

   </SOAP-ENV:Body>

</SOAP-ENV:Envelope>

下面是一条应答消息，包括HTTP消息，SOAP消息是其具体内容：

例2 在HTTP应答中嵌入SOAP消息

HTTP/1.1 200 OK

Content-Type: text/xml; 

charset="utf-8"

Content-Length: 

nnnn

<SOAP-ENV:Envelope

  xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"

  SOAP-ENV:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/"/>

   <SOAP-ENV:Body>

       <m:GetLastTradePriceResponse xmlns:m="Some-URI">

           <Price>34.5</Price>

       </m:GetLastTradePriceResponse>

   </SOAP-ENV:Body>

</SOAP-ENV:Envelope>

 

SOAP虽然是XML文档，但其编写须要知足以下语法规则：

> SOAP消息必须用XML来编码。

> SOAP消息必须用SOAP Envelope命名空间。

> SOAP消息必须用SOAP Encoding命名空间。

> SOAP消息不能包含DTD引用。

> SOAP消息不能包含XML处理指令。

3.3SOAP Envelope

SOAP Envelope 是SOAP消息结构的主要容器，也是SOAP消息的根元素，它必须出如今每一个SOAP消息中，用于把此XML文档标示为一条SOAP消息。

在SOAP中，使用XML命名空间将SOAP标示符与应用程序特定的标示符区分开，将SOAP消息的元素的做用域限制在一个特定的领域。

<soap-env:Envelope xmlns:soap-env="http://schemas.xmlsoap.org/soap/envelope/"

Soap-env:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/">

</ soap-env:Envelope >

以上命名空间都是按照SOAP1.1规范书写，SOAP消息中全部元素必须由第一个命名空间进行限定，SOAP的encodingStyle属性用于定义在文档中使用的数据类型。此属性可出如今任何SOAP元素中，并会被应用到元素的内容及元素的全部子元素上。

对于SOAP1.2规范，对应的命名空间及空信封以下：

<soap:Envelope xmlns:soap="http://www.w3.org/2001/12/soap-envelope"

soap:encodingStyle="http://www.w3.org/2001/12/soap-encoding”>

</ soap:Envelope >

3.4SOAP Header

SOAP Header元素应看成为SOAPEnvelope的第一个直接子元素，它必须使用有效的命名空间。Header还能够包含0个或多个可选的子元素，这些子元素称为Header项，全部的Header项都必须是完整修饰的，即必须由一个命名空间URI和局部名组成，不容许没有命名空间修饰的Header项存在。

Header元素用于与消息一块儿传输附加消息，如身份验证或事务信息。Header元素也能够包含某些属性。SOAP在默认的命名空间中定义了三个属性：actor，mustUnderstand以及encodingStyle。这些被定义在SOAP头部的属性可通知容器如何对SOAP消息进行处理。

<soap-env:Envelope xmlns:soap-env="http://schemas.xmlsoap.org/soap/envelope/"

Soap-env:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/">

<soap-env:Header>

<auth:UserID xmlns:auth=”some-URI”>

Admin

</auth:UserID>

</soap-env:Header>

</ soap-env:Envelope >

定义了新命名空间的附加元素，元素名（UserID）代表它包含身份验证信息。

3.5SOAP Body

SOAP消息的Body块能够包含如下任何元素：

> RPC方法及其参数

> 目标应用程序（消息接收者）专用数据

> 报告故障和状态消息的SOAP Fault

全部Body元素的直接子元素都称为Body项，Body项必须由命名空间修饰。

以下，该主体表示用于从“www.fruit.com”获取Apples的价格信息的RPC调用。

<soap-env:Envelope xmlns:soap-env="http://schemas.xmlsoap.org/soap/envelope/"

Soap-env:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/">

<soap-env:Body>

<m:GetPrice xmlns:m=”http://www.fruit.com/prices”>

<m:Item>Apples</m:Item>

</ m:GetPrice >

</soap-env:Body>

</ soap-env:Envelope >

命名空间http://www.fruit.com/prices是应用程序专用的元素，它们并非SOAP标准的一部分。下面是对上述请求的响应：

<soap-env:Envelope xmlns:soap-env="http://schemas.xmlsoap.org/soap/envelope/"

Soap-env:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/">

<soap-env:Body>

<m:GetPriceResponse xmlns:m=”http://www.fruit.com/prices”>

<m:Price>3.2</m:Price>

</ m:GetPriceResponse >

</soap-env:Body>

</ soap-env:Envelope >

3.6SOAP Fault

子元素	描述
<faultcode>	供识别故障的代码
<faultstring>	可供人阅读的有关故障的说明
<faultactor>	有关是谁引起故障的信息
<detail>	存留涉及 Body 元素的应用程序专用错误信息

SOAP Fault元素用于在SOAP消息中传输错误及状态信息。若是SOAP消息须要包括SOAP Fault元素，它必须做为一个Body项出现，并且至多出现一次。SOAP Fault包括如下子元素：faultcode,faultstring,faultactor,detail.

在下面定义的 faultcode 值必须用于描述错误时的 faultcode 元素中

错误	描述
VersionMismatch	SOAP Envelope 元素的无效命名空间被发现
MustUnderstand	Header 元素的一个直接子元素（带有设置为 "1" 的 mustUnderstand 属性）没法被理解。
Client	消息被不正确地构成，或包含了不正确的信息。
Server	服务器有问题，所以没法处理进行下去。

3.7附件

按照SOAP1.1规范的规定，SOAP消息能够包含XML格式的主SOAP信封，以及包含ASCII或二进制等任何数据格式的SOAP附件。若是SOAP消息包含附件，那么SOAP消息将是一个MIME编码的消息，它包含SOAP内容和一个或多个其余类型的附件。所以SOAP消息实际上分为如下两种类型：

> 仅包含XML内容的消息

> MIME编码的消息，包含初始的XML有效内容以及任何数量的附件。这些附件能够是任何其余类型的数据。

【MIME：Multi-purpose Internet Mail Extensions多用途Internet邮件扩展，是一组技术规范，其目的是使用不一样字符集来传递文本，也能够在计算机之间传递各类各样的多媒体数据】

4.SOAP HTTP Binding

4.1HTTP 协议

HTTP 在 TCP/IP 之上进行通讯。HTTP 客户机使用 TCP 链接到 HTTP 服务器。在创建链接以后，客户机可向服务器发送 HTTP 请求消息：

POST /item HTTP/1.1

Host: 189.123.145.239

Content-Type: text/plain

Content-Length: 200

随后服务器会处理此请求，而后向客户机发送一个 HTTP 响应。此响应包含了可指示请求状态的状态代码：

200 OK

Content-Type: text/plain

Content-Length: 200

在上面的例子中，服务器返回了一个 200 的状态代码。这是 HTTP 的标准成功代码。

假如服务器没法对请求进行解码，它可能会返回相似这样的信息：

400 Bad Request

Content-Length: 0

4.2SOAP HTTP Binding

SOAP 方法指的是遵照 SOAP 编码规则的 HTTP 请求/响应。

HTTP + XML = SOAP

SOAP 请求多是 HTTP POST 或 HTTP GET 请求。

HTTP POST 请求规定至少两个 HTTP 头：Content-Type 和 Content-Length。

Content-Type

SOAP 的请求和响应的 Content-Type 头可定义消息的 MIME 类型，以及用于请求或响应的 XML 主体的字符编码（可选）。

语法

Content-Type: MIMEType; charset=character-encoding

例子

POST /item HTTP/1.1

Content-Type: application/soap+xml; charset=utf-8

Content-Length

SOAP 的请求和响应的 Content-Length 头规定请求或响应主体的字节数。

语法

Content-Length: bytes

例子

POST /item HTTP/1.1

Content-Type: application/soap+xml; charset=utf-8

Content-Length: 250