化零为整WCF(8) - 消息处理(使用流数据传输文件)

[索引页]
[×××] 

化零为整WCF(8) - 消息处理(使用流数据传输文件)

作者：webabcd


介绍
WCF(Windows Communication Foundation) - 消息处理：使用流数据传输文件，减少内存开销。


示例
1、服务
IStreamed.cs

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

using System.ServiceModel;
using System.IO;

namespace WCF.ServiceLib.Message
{
        /// <summary>
        /// 消息契约（定义与 SOAP 消息相对应的强类型类）
        /// </summary>
        [MessageContract]
        public class FileWrapper
        {
                /// <summary>
                /// 指定数据成员为 SOAP 消息头
                /// </summary>
                [MessageHeader]
                public string FilePath;

                /// <summary>
                /// 指定将成员序列化为 SOAP 正文中的元素
                /// </summary>
                [MessageBodyMember]
                public Stream FileData;
        }

        /// <summary>
        /// IStreamed接口
        /// </summary>
        [ServiceContract]
        public interface IStreamed
        {
                /// <summary>
                /// 上传文件
                /// </summary>
                /// <remarks>
                /// 1、支持数据流传输的绑定有：BasicHttpBinding、NetTcpBinding 和 NetNamedPipeBinding
                /// 2、流数据类型必须是可序列化的 Stream 或 MemoryStream
                // /3、传递时消息体(Message Body)中不能包含其他数据，即参数中只能有一个System.ServiceModel.MessageBodyMember
                /// </remarks>
                /// <param name="fileWrapper">WCF.ServiceLib.Message.FileWrapper</param>
                [OperationContract]
                void UploadFile(FileWrapper fileWrapper);
        }
}

 

Streamed.cs

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

using System.ServiceModel;
using System.IO;

namespace WCF.ServiceLib.Message
{
        /// <summary>
        /// IStreamed类
        /// </summary>
        public class Streamed : IStreamed
        {
                /// <summary>
                /// 上传文件
                /// </summary>
                /// <param name="fileWrapper">WCF.ServiceLib.Message.FileWrapper</param>
                public void UploadFile(FileWrapper fileWrapper)
                {
                        var sourceStream = fileWrapper.FileData;

                        var targetStream = new FileStream(fileWrapper.FilePath,
                                FileMode.Create,
                                FileAccess.Write,
                                FileShare.None);

                        var buffer = new byte[4096];
                        var count = 0;

                        while ((count = sourceStream.Read(buffer, 0, buffer.Length)) > 0)
                        {
                                targetStream.Write(buffer, 0, count);
                        }

                        targetStream.Close();
                        sourceStream.Close();
                }
        }
}

 

2、宿主
Streamed.cs

using (ServiceHost host = new ServiceHost(typeof(WCF.ServiceLib.Message.Streamed)))
{
        host.Open();

        Console.WriteLine("服务已启动(WCF.ServiceLib.Message.Streamed)");
        Console.WriteLine("按<ENTER>停止服务");
        Console.ReadLine();

}

 

 

App.config

<?xml version="1.0" encoding="utf-8" ?>
<configuration>
    <system.serviceModel>
        <services>
            <!--name - 提供服务的类名-->
            <!--behaviorConfiguration - 指定相关的行为配置-->
            <service name="WCF.ServiceLib.Message.Streamed" behaviorConfiguration="MessageBehavior">
                <!--address - 服务地址-->
                <!--binding - 通信方式-->
                <!--contract - 服务契约-->
                <!--bindingConfiguration - 指定相关的绑定配置-->
                <endpoint address="Message/Streamed" binding="netTcpBinding" contract="WCF.ServiceLib.Message.IStreamed" bindingConfiguration="StreamedBindingConfiguration" />
                <endpoint address="mex" binding="mexHttpBinding" contract="IMetadataExchange" />
                <host>
                    <baseAddresses>
                        <add baseAddress="http://localhost:12345/Message/Streamed/"/>
                        <add baseAddress="net.tcp://localhost:54321/"/>
                    </baseAddresses>
                </host>
            </service>
        </services>
        <behaviors>
            <serviceBehaviors>
                <behavior name="MessageBehavior">
                    <!--httpGetEnabled - 使用get方式提供服务-->
                    <serviceMetadata httpGetEnabled="true" />
                    <serviceDebug includeExceptionDetailInFaults="true"/>
                </behavior>
            </serviceBehaviors>
        </behaviors>
        <bindings>
            <netTcpBinding>
                    <!--transferMode - 指示通道是使用流处理模式还是缓冲模式来传输请求和响应消息-->
                    <!--maxReceivedMessageSize - 在采用此绑定配置的通道上可接收的最大消息大小（单位：字节）-->
                    <!--receiveTimeout - 在传输引发异常之前可用于完成读取操作的时间间隔-->
                    <binding name="StreamedBindingConfiguration" transferMode="Streamed" maxReceivedMessageSize="1073741824" receiveTimeout="00:10:00" />
            </netTcpBinding>
        </bindings>
    </system.serviceModel>
</configuration>

 

 

3、客户端
Streamed.cs

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

using System.Windows.Forms;
using System.ServiceModel;
using System.IO;

namespace Client2.Message
{
        /// <summary>
        /// 演示Message.Streamed的类
        /// </summary>
        public class Streamed
        {
                /// <summary>
                /// 流数据上传文件
                /// </summary>
                /// <param name="source">源文件地址</param>
                /// <param name="destination">目标路径</param>
                public void HelloStreamed(string source, string destination)
                {
                        try
                        {
                                var proxy = new MessageSvc.Streamed.StreamedClient();

                                var sr = new System.IO.FileStream(
                                        source, System.IO.FileMode.Open);

                                proxy.UploadFile(destination + Path.GetFileName(source), sr);

                                sr.Close();
                                proxy.Close();

                                MessageBox.Show("上传成功");
                        }
                        catch (Exception ex)
                        {
                                MessageBox.Show(ex.ToString());
                        }
                }
        }
}

 

App.config

<?xml version="1.0" encoding="utf-8" ?>
<configuration>
    <system.serviceModel>
        <client>
            <!--address - 服务地址-->
            <!--binding - 通信方式-->
            <!--contract - 服务契约-->
            <endpoint address="net.tcp://localhost:54321/Message/Streamed" binding="netTcpBinding" contract="MessageSvc.Streamed.IStreamed" bindingConfiguration="StreamedBindingConfiguration" />
        </client>
        <bindings>
            <netTcpBinding>
                    <!--transferMode - 指示通道是使用流处理模式还是缓冲模式来传输请求和响应消息-->
                    <!--sendTimeout - 在传输引发异常之前可用于完成写入操作的时间间隔-->
                    <binding name="StreamedBindingConfiguration" transferMode="Streamed" sendTimeout="00:10:00" />
            </netTcpBinding>
        </bindings>
    </system.serviceModel>
</configuration>

 

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


OK
[×××]