WSE发送带有附件的 SOAP.docVIP

使用 发送带有附件的 SOAP 消息 使用 DIME 和 Web Services Enhancements WSE 中的高级 DIME 支持 对 DIME 使用 WSE 时的问题 小结 WS-Attachments 是一种推荐的 Web 服务标准，它能利用 DIME 消息封装协议来帮助在 SOAP 消息中发送附件。本文将介绍 Web Services Enhancements (WSE) 1.0 for Microsoft .NET 支持使用 DIME 和 WS-Attachments 规范来发送附件的方法。 在 Web Services Enhancements 中使用 DIME WSE v1.0 使用 ASP.NET 来支持带 SOAP 附件的 DIME，并可以从 I/O 流读取 DIME 消息或将 DIME 消息写入 I/O 流。本节介绍在 ASP.NET 中向 SOAP 消息添加二进制附件的详细过程，随后讨论 WSE 对 DIME 流的支持。 WSE 运行时实现 DIME 的方法 对于带有附件的 SOAP 消息，WSE 运行时实现了一个 DIME 兼容的消息分析器，用于转换传入的 DIME 消息的记录，并从第一个 DIME 记录中提取主 SOAP 消息，从后续的附件对象记录中提取封装的文件。当主 SOAP 消息从 DIME 中提取出来之后，它被传递到 WSE 消息管道中，并由一系列输入过滤器根据 WSE 支持的其他标头对其进行处理。下图显示了 WSE 运行时和 ASP.NET 处理传入的 DIME 消息的方法。 图 1：WSE 运行时和 ASP.NET 处理传入的 DIME 消息 对于带附件的出站 SOAP 响应消息，WSE 中的 DIME 消息分析器构建一个新的 DIME 消息，其中第一个 DIME 记录是出站 SOAP 响应，而所有指定的附件都被封装在后续的 DIME 记录中。下图显示了 WSE 运行时组装 DIME 消息的方法。 图 2：WSE 运行时组装 DIME 消息 WSE 运行时通过丰富的 API 来进行编程控制并支持 DIME。Microsoft.Web.Services.Dime 命名空间中的对象支持 DIME。对于由 ASP.NET 提供的基于 SOAP 的 Web 服务，Microsoft.Web.Services 命名空间中的SoapContext 类通过为给定的 SOAP 消息指定高级 Web 服务协议的使用和属性来控制 WSE 运行时的行为。在 WSE 编程模型中，当收到 SOAP 请求信息时，运行时为接收到的请求生成一个 HttpSoapContext 对象。HttpSoapContext.RequestContext 属性访问消息的 SoapContext 对象并枚举包含在消息的 WSE 专用标头元素中的信息。 如果传入的 DIME 消息符合 WS-Attachments 规范，WSE 运行时就把它们作为带附件的 SOAP 消息来处理，并提取主 SOAP 消息及其所有附件。对于每个附件，都会向 DimeAttachmentCollection 添加一个 DimeAttachment 对象，这样就可以通过SoapContext.Attachments 属性访问这些附件。与此类似，可以向传出消息的 SoapContext 对象的 DimeAttachmentCollection 中添加附件，以便 WSE 运行时将它们包含在传出消息的 DIME 记录中。 接下来，让我们看一下创建带附件的 DIME 消息作为 Web 服务响应的过程。 为 DIME 配置 Web Services Enhancements 要在 DIME 中使用附件，即使在 ASP.NET Web 服务器上安装了 WSE，仍然需要对 ASP.NET 应用程序进行一些额外的 DIME 相关配置。在 Microsoft? Visual Studio? .NET 中创建新的 ASP.NET Web 服务项目之后，需要把对 Microsoft.Web.Services.dll 程序集的引用添加到项目中。还要向 soapExtensionTypes 元素添加一个新类型，方法是在 Web.config 文件中为项目添加一个 add 元素，如下所示： configuration system.web ... webServices soapExtensionTypes add type= Microsoft.Web.Services.WebServicesExtension,