化零为整WCF(7) - 消息处理(使用消息传输优化机制 - MTOM)

[索引页]
[源码下载]

化零为整WCF(7) - 消息处理(使用消息传输优化机制 - MTOM)

作者：webabcd


介绍
WCF(Windows Communication Foundation) - 消息处理：MTOM(Message Transmission Optimization Mechanism) - 消息传输优化机制。本文以web方式上传大文件为例。


示例
1、服务
IMtom.cs

using System;
using System.Collections.Generic;
using System.Linq;
using System.Text;

using System.ServiceModel;
using System.IO;

namespace WCF.ServiceLib.Message
{
    /**//// <summary>
    /// IMtom接口
    /// </summary>
    [ServiceContract]
    public interface IMtom
    {
        /**//// <summary>
        /// 上传文件
        /// </summary>
        /// <param name="path">文件目标路径</param>
        /// <param name="fileData">文件字节数组</param>
        [OperationContract]
        void UploadFile(string path, byte[] fileData);
    }
}

Mtom.cs

using System;
using System.Collections.Generic;
using System.Linq;
using System.Text;

using System.ServiceModel;
using System.IO;

namespace WCF.ServiceLib.Message
{
    /**//// <summary>
    /// Mtom类
    /// </summary>
    public class Mtom : IMtom
    {
        /**//// <summary>
        /// 上传文件
        /// </summary>
        /// <param name="path">文件目标路径</param>
        /// <param name="fileData">文件字节数组</param>
        public void UploadFile(string path, byte[] fileData)
        {
            FileStream fs = new FileStream(path, FileMode.Create, FileAccess.Write, FileShare.None);
            fs.Write(fileData, 0, fileData.Length);
            fs.Flush();
            fs.Close();
        }
    }
}

2、宿主
Mtom.svc

<%@ ServiceHost Language="C#" Debug="true" Service="WCF.ServiceLib.Message.Mtom" %>

Web.config

<?xml version="1.0"?>
<configuration>
  <system.serviceModel>
    <services>
      <!--name - 提供服务的类名-->
      <!--behaviorConfiguration - 指定相关的行为配置-->
      <service name="WCF.ServiceLib.Message.Mtom" behaviorConfiguration="MessageBehavior">
        <!--address - 服务地址-->
        <!--binding - 通信方式-->
        <!--contract - 服务契约-->
        <!--bindingConfiguration - 指定相关的绑定配置-->
        <endpoint address="" binding="wsHttpBinding" contract="WCF.ServiceLib.Message.IMtom" bindingConfiguration="MtomBindingConfiguration" />
      </service>
    </services>
    <behaviors>
      <serviceBehaviors>
        <behavior name="MessageBehavior">
          <!--httpGetEnabled - 使用get方式提供服务-->
          <serviceMetadata httpGetEnabled="true" />
          <serviceDebug includeExceptionDetailInFaults="true"/>
        </behavior>
      </serviceBehaviors>
    </behaviors>
    <bindings>
      <wsHttpBinding>
        <!--messageEncoding - 指定用 MTOM 还是 Text 对 SOAP 消息编码-->
        <!--maxReceivedMessageSize - 在采用此绑定配置的通道上可接收的最大消息大小（单位：字节）-->
        <!--receiveTimeout - 在传输引发异常之前可用于完成读取操作的时间间隔-->
        <binding name="MtomBindingConfiguration" messageEncoding="Mtom" maxReceivedMessageSize="1073741824" receiveTimeout="00:10:00">
          <!--maxArrayLength - 配额控制：允许的最大数组长度-->
          <readerQuotas maxArrayLength="1073741824" />
        </binding>
      </wsHttpBinding>
    </bindings>
  </system.serviceModel>
</configuration>

3、客户端
Mtom.aspx

<%@ Page Language="C#" MasterPageFile="~/Site.master" AutoEventWireup="true" CodeFile="Mtom.aspx.cs"
    Inherits="Message_Mtom" Title="消息处理(使用消息传输优化机制 - MTOM)" %>

<asp:Content ID="Content1" ContentPlaceHolderID="head" runat="Server">
</asp:Content>
<asp:Content ID="Content2" ContentPlaceHolderID="ContentPlaceHolder1" runat="Server">
    <p>
        MTOM(Message Transmission Optimization Mechanism) - 消息传输优化机制
    </p>
    <div>
        <ul>
            <li>可以指定用 MTOM 还是 Text 对 SOAP 消息编码</li>
            <li>抓soap消息的时候可以用tcpTrace</li>
            <li>用17,766,901字节大小的文件测试：Text编码（soap大小：31,591,929字节）；MTOM编码（soap大小：23,696,066字节）</li>
        </ul>
    </div>
    <div>
        源文件：
        <asp:FileUpload ID="file" runat="server" />
        &nbsp;
        上传路径：
        <asp:TextBox ID="txtDestination" runat="server" Text="C:\"></asp:TextBox>
        &nbsp;
        <asp:Button ID="btnUpload" runat="server" Text="上传" OnClick="btnUpload_Click" />
    </div>
</asp:Content>

Mtom.aspx.cs

using System;
using System.Collections;
using System.Configuration;
using System.Data;
using System.Linq;
using System.Web;
using System.Web.Security;
using System.Web.UI;
using System.Web.UI.HtmlControls;
using System.Web.UI.WebControls;
using System.Web.UI.WebControls.WebParts;
using System.Xml.Linq;
using System.ServiceModel.Channels;
using System.IO;

public partial class Message_Mtom : System.Web.UI.Page
{
    protected void Page_Load(object sender, EventArgs e)
    {

    }

    protected void btnUpload_Click(object sender, EventArgs e)
    {
        var proxy = new MessageSvc.Mtom.MtomClient();

        var length = file.PostedFile.ContentLength;
        var bytes = new byte[length];
        file.PostedFile.InputStream.Read(bytes, 0, length);

        try
        {
            proxy.UploadFile(
                txtDestination.Text + Path.GetFileName(file.PostedFile.FileName), 
                bytes);
            Page.ClientScript.RegisterStartupScript(typeof(Page), "js", "alert('上传成功');", true);
        }
        catch (Exception ex)
        {
            Page.ClientScript.RegisterStartupScript(typeof(Page), "js", "alert('" + ex.ToString() + "');", true);
        }

        proxy.Close();
    }
}

Web.config

<?xml version="1.0"?>
<configuration>
  <system.serviceModel>
    <client>
      <!--address - 服务地址-->
      <!--binding - 通信方式-->
      <!--contract - 服务契约-->
      <!--bindingConfiguration - 指定相关的绑定配置-->
      <!--behaviorConfiguration - 指定相关的行为配置-->
      <!--endpoint address="http://localhost:3502/ServiceHost/Message/Mtom.svc" binding="wsHttpBinding" contract="MessageSvc.Mtom.IMtom" bindingConfiguration="MtomBindingConfiguration" behaviorConfiguration="MtomEndpointBehavior" /-->
      <endpoint address="http://localhost:3502/ServiceHost/Message/Mtom.svc" binding="wsHttpBinding" contract="MessageSvc.Mtom.IMtom" bindingConfiguration="MtomBindingConfiguration" />
    </client>
    <bindings>
      <wsHttpBinding>
        <!--messageEncoding - 指定用 MTOM 还是 Text 对 SOAP 消息编码-->
        <!--sendTimeout - 在传输引发异常之前可用于完成写入操作的时间间隔-->
        <binding name="MtomBindingConfiguration" messageEncoding="Mtom" sendTimeout="00:10:00">
          <!--maxArrayLength - 配额控制：允许的最大数组长度-->
          <readerQuotas maxArrayLength="1073741824" />
        </binding>
      </wsHttpBinding>
    </bindings>
    <behaviors>
      <endpointBehaviors>
        <behavior name="MtomEndpointBehavior">
          <!--clientVia - 创建传输通道的 URI （tcpTrace抓soap的时候用）-->
          <clientVia viaUri="http://localhost:8888/ServiceHost/Message/Mtom.svc" />
        </behavior>
      </endpointBehaviors>
    </behaviors>
  </system.serviceModel>
</configuration>

运行结果：
上传文件后提示上传成功


OK
[源码下载]