一、流操作概述
在默认情况下,当客户端调用服务时,服务只有在接收到完整的消息后才会被调用,同样,客户端只有在包含了调用结果的返回消息被完整接受时,才会解除对它的阻塞。
对于数据量小的消息,这种交换模式提供了简单的编程模型,因为接收消息的耗时较之处理消息本身而言是微不足道的。然而,一旦需要处理数据量较大的消息,如包含了多媒体内容、大文本或数据块的消息,如果每次都要等到完整接收消息之后才能解除阻塞,则未免不太现实。
为了解决这样的问题,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(out System.IO.Stream stream); [OperationContract] void StreamRequest(System.IO.Stream stream); [OperationContract(IsOneWay = true)] void OneWayStream(System.IO.Stream stream); }注意,只能将抽象类型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绑定执行流操作时,同样不能启用可靠消息传输。
示例下载:下载