[WCF编程]10.操作:流操作

一、流操作概述

    在默认情况下,当客户端调用服务时,服务只有在接收到完整的消息后才会被调用,同样,客户端只有在包含了调用结果的返回消息被完整接受时,才会解除对它的阻塞。

    对于数据量小的消息,这种交换模式提供了简单的编程模型,因为接收消息的耗时较之处理消息本身而言是微不足道的。然而,一旦需要处理数据量较大的消息,如包含了多媒体内容、大文本或数据块的消息,如果每次都要等到完整接收消息之后才能解除阻塞,则未免不太现实。

    为了解决这样的问题,WCF允许接收到(客户端或服务)在通过通道接收消息的同时,启动对消息数据的处理。这种类型的处理过程称为流传输模型。对于具有大量负载的消息而言,流操作改善了系统的吞吐量和响应速度,因为在发送 或接收消息的同时,不管是发送方还是接收方都不会被阻塞。

二、I/O流

    若要处理消息流,WCF需要使用.NET的Stream类。事实上,契约操作对流的使用看起来和传统的I/O方法并无区别。在.NET中,Stream类是所有I/O的基类(如FileStream、NetworkStream和MemoryStream类),它允许将I/O资源中的内容转化为流。我们需要做的就是返回或接收一个Stream类型的操作参数,如下例所示:

[ServiceContract]
    interface IMyContract
    {
        [OperationContract]
        System.IO.Stream StreamReply1();
    [OperationContract]
    System.IO.Stream StreamReply2(</span><span style="color: #0000ff">out</span><span style="color: #000000"> System.IO.Stream stream);

    [OperationContract]
    </span><span style="color: #0000ff">void</span><span style="color: #000000"> StreamRequest(System.IO.Stream stream);

    [OperationContract(IsOneWay </span>= <span style="color: #0000ff">true</span><span style="color: #000000">)]
    </span><span style="color: #0000ff">void</span><span style="color: #000000"> OneWayStream(System.IO.Stream stream);
}</span></pre></div>

    注意,只能将抽象类型Stream类型或特定的可序列化的子类(如MemoryStream)作为操作参数。诸如FileStream这样的子类都不支持序列化,因为使用基类Stream其实是无奈之举。

    WCF允许服务将请求消息、应答消息,以及请求与应答消息转换为流。

三、流操作与绑定

    只有TCP、IPC和基本的HTTP绑定支持流操作。在默认的情况下,这些绑定是禁止流操作的。即使使用了Stream对象,绑定仍然会将消息整体放到缓存中。我们需要根据所需的流模式,通过设置TrasferMode属性启用流操作,例如,以下使用BasicHttpBingding时。

public enum TransferMode
{
    //对请求和响应消息进行缓冲处理
    Buffered,
    //对请求和响应消息进行流式处理
    Streamed,
    //对请求消息进行流式处理,对响应消息进行缓冲处理
    StreamedRequest,
    //对请求消息进行缓冲处理,对响应消息进行流式处理
    StreamedResponse
}

public class BasicHttpBingding:Bingding
{
public TransferMode TransferMode{get;set}
.......
}

    TransferMode.Streamed支持所有的流模式,也是唯一支持第二节例子中定义的所有操作。但是,如果契约只包含特定的流类型,如以下转换为流的应答消息,则可以包含一个设置为buffered的请求消息,也可以通过选择TransferMode.StreamedResponse将消息转化为流:

[ServiceContract]
interface IMyConttract
{
    //流的应答消息
    [OperationContract]
    Stream GetStream1();
    [OperationContract]
    int MyMethod();
}

    在客户端或服务段(或同时在两端),必须为每个所需的流模式配置绑定。

<system.serviceModel>
      <client>
         <endpoint 
            address  = "http://localhost:8000/MediaService" 
            binding  = "basicHttpBinding"
            bindingConfiguration = "StreamedHTTP"
            contract = "IMediaService"
         />
      </client>
      <bindings>
         <basicHttpBinding>
            <binding name = "StreamedHTTP" transferMode="Streamed">
            </binding>
         </basicHttpBinding>
      </bindings>
   </system.serviceModel>

四、流操作与传输

    WCF的流操作只不过是一种良好的编程模型。从根本上讲,传输自身并不支持流操作,它默认的最大消息长度为64KB。这样的数据可能存在问题时,开发者可能希望使用流操作,转换为流的消息往往会非常大。如果默认的限制不够大,开发者可以增加接收端消息的最大长度,以适应大数据量的消息。可以通过MaxReceivedMessageSize属性,以获得期望的最大消息长度。

public class BasicHttpBingding:Bingding,...
{
    public long MaxReceivedMessageSize{get;set;}
}

    可以在运行时采用反复试验找出消息的大小,然后设置相应的绑定。

    通常,我们应避免使用编程方式,而是将一段配信息放到配置文件中,因为消息大小的改变通常发生在部署阶段:

<bindings>
     <basicHttpBinding>
        <binding name = "StreamedHTTP" transferMode="Streamed" maxReceivedMessageSize ="120000">
        </binding>
     </basicHttpBinding>
</bindings>

    当使用流操作时,不能使用消息层的传输安全。这是因为TCP、IPC和基本的HTTP绑定支持流操作,对于这些绑定,通常不能使用消息安全。在使用TCP绑定执行流操作时,同样不能启用可靠消息传输。

示例下载:下载

posted @ 2014-09-26 12:12  烧点饭  阅读(685)  评论(0编辑  收藏  举报