XML SOAP

• SOAP 代表S实施氧对象A访问磷罗托科尔
• SOAP是一种应用程序通信协议
• SOAP 是一种发送和接收消息的格式
• SOAP 是独立于平台的
• SOAP 基于 XML
• SOAP 是 W3C 的推荐标准

为什么是 SOAP？

对于 Web 应用程序来说，能够通过 Internet 进行通信非常重要。

应用程序之间通信的最佳方式是通过 HTTP，因为所有 Internet 浏览器和服务器都支持 HTTP。 SOAP 的创建就是为了实现这一目标。

SOAP 提供了一种在使用不同技术和编程语言的不同操作系统上运行的应用程序之间进行通信的方法。

SOAP 构建块

SOAP 消息是一个普通的 XML 文档，包含以下元素：

• 将 XML 文档标识为 SOAP 消息的 Envelope 元素
• 包含标头信息的 Header 元素
• 包含调用和响应信息的 Body 元素
• 包含错误和状态信息的故障元素

上述所有元素均在 SOAP 信封的默认命名空间中声明：

http://www.w3.org/2003/05/soap-envelope/

SOAP 编码和数据类型的默认命名空间是：

http://www.w3.org/2003/05/soap-encoding

语法规则

以下是一些重要的语法规则：

• SOAP 消息必须使用 XML 进行编码
• SOAP 消息必须使用 SOAP Envelope 命名空间
• SOAP 消息不得包含 DTD 引用
• SOAP 消息不得包含 XML 处理指令

骨架 SOAP 消息

SOAP 信封元素

所需的 SOAP Envelope 元素是 SOAP 消息的根元素。该元素将 XML 文档定义为 SOAP 消息。

示例

xmlns:soap 命名空间

请注意上面示例中的 xmlns:soap 命名空间。它的值应始终为："http://www.w3.org/2003/05/soap-envelope/"。

命名空间将信封定义为 SOAP 信封。

如果使用不同的命名空间，应用程序会生成错误并丢弃该消息。

编码样式属性

encodingStyle 属性用于定义文档中使用的数据类型。该属性可以出现在任何 SOAP 元素上，并应用于该元素的内容和所有子元素。

SOAP 消息没有默认编码。

语法

示例

SOAP 标头元素

可选的 SOAP 标头元素包含有关 SOAP 消息的特定于应用程序的信息（如身份验证、支付等）。

如果 Header 元素存在，则它必须是 Envelope 元素的第一个子元素。

笔记：Header 元素的所有直接子元素都必须是命名空间限定的。

上面的示例包含带有 "Trans" 元素的标头、值为 1 的 "mustUnderstand" 属性和值为 234。

SOAP 在默认名称空间中定义了三个属性。这些属性是：mustUnderstand、actor 和encodingStyle。

SOAP 标头中定义的属性定义接收者应如何处理 SOAP 消息。

必须理解属性

SOAP MustUnderstand 属性可用于指示接收者处理的标头条目是强制的还是可选的。

如果将 MustUnderstand="1" 添加到 Header 元素的子元素，则表明处理 Header 的接收者必须识别该元素。如果接收方无法识别该元素，则在处理标头时将会失败。

语法

示例

演员属性

SOAP 消息可以通过沿消息路径传递不同的端点从发送方传输到接收方。然而，并非 SOAP 消息的所有部分都适用于最终端点，相反，它可能适用于消息路径上的一个或多个端点。

SOAP actor 属性用于将 Header 元素寻址到特定端点。

语法

示例

编码样式属性

encodingStyle 属性用于定义文档中使用的数据类型。该属性可以出现在任何 SOAP 元素上，并将应用于该元素的内容和所有子元素。

SOAP 消息没有默认编码。

语法

SOAP 主体元素

所需的 SOAP Body 元素包含用于消息最终端点的实际 SOAP 消息。

SOAP Body 元素的直接子元素可以是命名空间限定的。

示例

上面的示例请求苹果的价格。请注意，上面的 m:GetPrice 和 Item 元素是特定于应用程序的元素。它们不是 SOAP 名称空间的一部分。

SOAP 响应可能如下所示：

SOAP 错误元素

可选的 SOAP 错误元素用于指示错误消息。

SOAP Fault 元素保存 SOAP 消息的错误和状态信息。

如果存在Fault 元素，则它必须显示为Body 元素的子元素。故障元素只能在 SOAP 消息中出现一次。

SOAP 错误元素具有以下子元素：

SOAP 故障代码

描述故障时，必须在故障代码元素中使用下面定义的故障代码值：

HTTP 协议

HTTP 通过 TCP/IP 进行通信。 HTTP 客户端使用 TCP 连接到 HTTP 服务器。建立连接后，客户端可以向服务器发送HTTP请求消息：

然后服务器处理该请求并将 HTTP 响应发送回客户端。响应包含指示请求状态的状态代码：

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

如果服务器无法解码请求，它可能会返回如下内容：

SOAP 绑定

SOAP 规范定义了 SOAP 消息的结构，而不是它们的交换方式。这个空白由所谓的"SOAP Bindings" 来填补。 SOAP 绑定是允许使用传输协议有效交换 SOAP 消息的机制。

大多数 SOAP 实现都提供常见传输协议（例如 HTTP 或 SMTP）的绑定。

HTTP 是同步的并且被广泛使用。 SOAP HTTP 请求至少指定两个 HTTP 标头：Content-Type 和 Content-Length。

SMTP 是异步的，仅在最后手段或特殊情况下使用。

SOAP 的 Java 实现通常为 JMS（Java 消息系统）协议提供特定的绑定。

内容类型

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

语法

示例

内容长度

SOAP 请求和响应的 Content-Length 标头指定请求或响应正文中的字节数。

语法

示例

SOAP 示例

在下面的示例中，GetStockPrice 请求被发送到服务器。该请求具有一个 StockName 参数和一个将在响应中返回的 Price 参数。该函数的命名空间在"http://www.example.org/stock" 中定义。

SOAP 请求：

SOAP 响应：