SOAP协议.docVIP

SOAP协议 SOAP简介 SOAP以XML形式提供了一个简单、轻量的用于在分散或分布环境中交换结构化和类型信息的机制。SOAP本身并没有定义任何应用程序语义 ,如编程模型或特定语义的实现；实际上它通过提供一个有标准组件的包模型和在模块中编码数据的机制 ,定义了一个简单的表示应用程序语义的机制。这使 SOAP能够被用于从消息传递到RPC的各种系统。一条 SOAP 消息就是一个普通的 XML 文档，包含下列元素： 必需的 Envelope 元素，可把此 XML 文档标识为一条 SOAP 消息 可选的 Header 元素，包含头部信息 必需的 Body 元素，包含所有的调用和响应信息 可选的 Fault 元素，提供有关在处理此消息所发生错误的信息 所有以上的元素均被声明于针对 SOAP 封装的默认命名空间中： /2001/12/soap-envelope 以及针对 SOAP 编码和数据类型的默认命名空间： /2001/12/soap-encoding SOAP 消息的基本结构 ?xml version=1.0? soap:Envelope xmlns:soap=/2001/12/soap-envelope soap:encodingStyle=/2001/12/soap-encoding soap:Header ... ... /soap:Header soap:Body ... ... soap:Fault ... ... /soap:Fault /soap:Body /soap:Envelope SOAP Envelope 元素 必需的 SOAP 的 Envelope 元素是 SOAP 消息的根元素。它可把 XML 文档定义为 SOAP 消息。 请注意 xmlns:soap 命名空间的使用。它的值应当始终是： /2001/12/soap-envelope 并且它可把封装定义为 SOAP 封装： ?xml version=1.0? soap:Envelope xmlns:soap=/2001/12/soap-envelope soap:encodingStyle=/2001/12/soap-encoding ... Message information goes here ... /soap:Envelope xmlns:soap 命名空间 SOAP 消息必须拥有与命名空/2001/12/soap-envelope 相关联的一个 Envelope 元素。 如果使用了不同的命名空间，应用程序会发生错误，并抛弃此消息。 encodingStyle 属性 SOAP 的 encodingStyle 属性用于定义在文档中使用的数据类型。此属性可出现在任何 SOAP 元素中，并会被应用到元素的内容及元素的所有子元素上。SOAP 消息没有默认的编码方式。 语法 soap:encodingStyle=URI 实例 ?xml version=1.0? soap:Envelope xmlns:soap=/2001/12/soap-envelope soap:encodingStyle=/2001/12/soap-encoding ... Message information goes here ... /soap:Envelope OAP Header 元素 可选的 SOAP Header 元素可包含有关 SOAP 消息的应用程序专用信息（比如认证、支付等）。如果 Header 元素被提供，则它必须是 Envelope 元素的第一个子元素。 注释：所有 Header 元素的直接子元素必须是合格的命名空间。 ?xml version=1.0? soap:Envelope xmlns:soap=/2001/12/soap-envelope soap:encodingStyle=/2001/12/soap-encoding soap:Header m:Trans xmlns:m=/transaction/ soap:mustUnderstand=1234/m:Trans /soap:Header ... ... /soap:Envelope 上面的例子包含了一个带有一个 Trans 元素的头部，它的值是 234，此元素的 mustUnderstand 属性的值是 1。 SOAP 在默认的命名空间中 (/2001/12/soap-envelope) 定义了三个属性。这三个属性是：actor、 mustUnderstand 以及 encodingStyle。这些被定义在 SOAP 头部的属性可定义容器如何对 SOAP 消息进行处理。 actor 属性 通过沿着消息路径经过不同的