第二十七章 使用 MTOM 进行附件

可以在 SOAP 请求和响应消息中包含附件。首选方法是使用 IRIS 数据平台对 MTOM（消息传输优化机制）的支持。

还可以在策略中指定 MTOM 的使用；请参阅保护 Web 服务。

还可以配置IRIS 数据平台 Web 服务和 Web 客户端，以在执行任何打包后使用 gzip 压缩其消息；请参阅在 IRIS 中微调 Web 服务和在IRIS 中微调 Web 客户端。

附件和 SOAP 消息打包

附件通常用于携带二进制数据。SOAP 支持提供了三种打包 SOAP 消息的方法。在讨论详细选项之前，有必要回顾一下这些打包类型。

• 将消息的所有部分都打包成内联格式（不带附件）。对任何二进制数据使用 base-64 编码。

这是 Web 服务和 Web 客户端的默认行为，除非 Web 服务收到 MTOM 请求（在这种情况下，服务会以 MTOM 响应进行响应）。

• 根据 MTOM（消息传输优化机制）规范对消息进行打包，这样产生的消息比全内联消息略微紧凑一些。这是目前 SOAP 消息的首选方法。

当使用此技术时，系统会自动对 SOAP 消息进行适当的打包。也就是说，MIME 部分会根据需要创建并添加到消息中，无需您的干预。

此外，默认情况下，当 IRIS 创建 MTOM 包时，它会使用附件输出二进制流，并以内联方式输出二进制字符串（输出 %Binary或输出 %xsd.base64Binary）；可以控制此行为。

• 根据带附件的 SOAP 规范打包消息，这样产生的消息比全内联消息稍微紧凑一些。

使用此技术时，必须手动创建 MIME 部分、用数据填充它们、根据需要指定 MIME 标头，并将这些部分附加到 SOAP 消息。这通常比 MTOM 技术需要更多的工作。请参阅使用带附件的 SOAP。

具有全部内联部分的 SOAP 消息（默认）

打包 SOAP 消息的默认方式是将其所有元素作为内联部分（即不包含附件）包含在内。任何二进制数据都以 base-64 编码数据的形式内联包含。例如（为便于阅读添加了换行符和空格）：

HTTP/1.1 200 OK
Date: Wed, 19 Nov 2008 21:57:50 GMT
Server: Apache
SET-COOKIE: CSPSESSIONID-SP-8080-UP-csp-gsoap-=003000010000248
guobl000000K7opwlDlY$XbvrGR1eYZsA--; path=/csp/mysamples/;
CACHE-CONTROL: no-cache
EXPIRES: Thu, 29 Oct 1998 17:04:19 GMT
PRAGMA: no-cache
TRANSFER-ENCODING: chunked
Connection: close
Content-Type: text/xml; charset=UTF-8

1d7b
<?xml version="1.0" encoding="UTF-8" ?>
<SOAP-ENV:Envelope xmlns:SOAP-ENV='https://schemas.xmlsoap.org/soap/envelope/' 
xmlns:xsi='https://www.w3.org/2001/XMLSchema-instance' 
xmlns:s='https://www.w3.org/2001/XMLSchema'>
<SOAP-ENV:Body>
  <DownloadResponse xmlns="https://www.filetransfer.org">
     <DownloadResult><Filename>sample.pdf</Filename>
     <IsBinary>true</IsBinary>
     <BinaryContents>
        [very long binary content not shown here]
     </BinaryContents></attachment></Upload>  
</SOAP-ENV:Body>
</SOAP-ENV:Envelope>

请注意，此包装不使用 MIME，并且没有消息边界。