WCF Stream正确应用指南
创始人
2024-06-23 06:10:27
0

WCF是由微软公司创建的一个.NET Framework 3.5的重要组成部分,它可以为开发人员创建一个安全性的开发平台。WCF Stream的操作,尤其对于传递size过大的消息而言,如要考虑传递消息的效率,WCF推荐通过Stream进行操作。#t#

然而,WCF Stream操作规定了一些限制,在我们编写相关程序时,需要特别注意:

1、绑定的限制

如果需要使用WCF Stream操作,可以使用的绑定只能是BasicHttpBinding,NetTcpBinding以及NetNamedPipeBinding。此外,在使用Stream操作时,不能使用Reliable Messaging。如果考虑到消息安全,则此方式是不可取的。

2、对Stream对象的限制

要作为服务操作所传递的消息对象,这样的对象必须是可序列化的。遗憾的是,FileStream类的定义却是不支持序列化的,我们能够使用的Stream对象,包括Stream,MemoryStream等。使用Stream类对象是大多数Stream操作的首选。

一个有趣的现象是FileStream与Stream类型的转换。例如在服务契约的操作中,有如下的实现:

  1. public Stream TransferDocument(Document document)  
  2. {  
  3. FileStream stream = new FileStream  
  4. (document.LocalPath, FileMode.Open, FileAccess.Read);  
  5. return stream;  

注意,操作TransferDocument()的返回类型为Stream,而方法的实现中,返回的对象则为FileStream类型。由于Stream类是FileStream类的父类,这样的实现没有问题。

然而,在客户端调用该操作时,却不能将操作的返回值赋给FileStream类型的对象,如下所示:

  1. FileStream stream = m_service.TransferDocument(doc); 

此时获得的WCF Stream对象则为null。因而,我们只能这样调用操作:

  1. Stream stream = m_service.TransferDocument(doc); 

但是,还有一个奇怪的问题是WCF并不支持Stream对象Length属性的序列化,也就是说,在客户端我们不能使用服务操作返回的Stream对象的Length属性。诸如stream.Length的调用会抛出NotSupportedException异常。

3、TransferMode的限制

若要使用Stream操作,必须修改绑定的TransferMode属性。该属性的默认值为Buffered。我们应该根据操作中Stream对象的参数类型,以决定TransferMode的值分别为Streamed、StreamedRequest或者StreamedResponse。

4、MaxReceivedMessageSize的限制

MaxReceivedMessageSize属性的默认值为64kb,如果传递的Stream对象一旦超过了MaxReceivedMessageSize属性的设置值,则客户端在操作该对象时,就会出现CommunicationException异常。因此,我们应根据实际需要设置MaxReceivedMessageSize的值。MaxReceivedMessageSize属性的取值范围为1-9223372036854775807(Int32.MaxValue)。如果设置值不在该范围之内,则无法通过编译。编程方式设置为:

  1. binding.MaxReceivedMessageSize = 120000; 

配置文件的设置方式为:

  1. < binding …… maxReceivedMessageSize="120000"/> 

 

5、操作参数的限制

WCF Stream的操作参数进行严格的限制,它只允许这样的操作只能包含一个Stream对象,这里所谓的一个Stream对象,是包含return对象,out和ref对象在内的。也就是说如下的操作定义都是错误的:

  1. void Transfer(Stream s1, Stream s2);  
  2. void Transfer(Stream s1, out Stream s2);  
  3. void Transfer(Stream s1, ref Stream s2);  
  4. Stream Transfer(Stream stream); 

如果定义了这样的操作,则会出现运行时错误。

6、实例激活类型的限制

由于Stream操作受到绑定的限制,只能使用BasicHttpBinding,NetTcpBinding以及NetNamedPipeBinding绑定,因此必然会影响服务实例的激活类型,最主要的是对Session模式的影响。首先BasicHttpBinding并不支持Session模式的激活类型。NetTcpBinding以及NetNamedPipeBinding绑定虽然支持Session模式,但是由于Stream操作不支持可靠消息传递,即不能将ReliableSession设置为true。因此在定义服务契约的SessionMode时,不能将其值设置为SessionMode.Required,否则会抛出异常。

实际上,Stream操作(指TransferMode不为Buffered)本身并不支持Session模式。即使我们在使用NetTcpBinding时,将服务契约的SessionMode设置为Allowed,并将服务的InstanceContextMode设置为PerSession,服务的执行方式仍然是PerCall方式。(如果不是Stream操作,这样的设置服务应为PerSession模式)

因此,在执行WCF Stream操作时,即使按照Session模式对服务进行设置,如果我们通过OperationContext.Current.SessionId去获得会话ID,其值应该为空。

此外,由于传输的Stream对象较大,可能会消耗过长的时间,因而建议增大绑定的SendTimeout属性值。例如设置为10分钟。编程方式设置为:

  1. binding.SendTimeout = TimeSpan.FromMinutes(10); 

配置文件的设置方式为:

  1. < binding …… sendTimeout="00:10:00"/> 

注意,对绑定的相关设置必须要求服务端与客户端的配置一致。最佳实践是均通过配置文件进行设置。例如在我的应用程序中是这样设置的:

  1. < basicHttpBinding> 
  2. < binding name="DocumentExplorerServiceBinding"   
  3. sendTimeout="00:10:00"   
  4. transferMode="Streamed" 
  5. messageEncoding="Text"   
  6. textEncoding="utf-8"   
  7. maxReceivedMessageSize="9223372036854775807">   
  8. < /binding> 
  9. < /basicHttpBinding> 

以上就是对WCF Stream的相关操作方法。

相关内容

热门资讯

如何允许远程连接到MySQL数... [[277004]]【51CTO.com快译】默认情况下,MySQL服务器仅侦听来自localhos...
如何利用交换机和端口设置来管理... 在网络管理中,总是有些人让管理员头疼。下面我们就将介绍一下一个网管员利用交换机以及端口设置等来进行D...
施耐德电气数据中心整体解决方案... 近日,全球能效管理专家施耐德电气正式启动大型体验活动“能效中国行——2012卡车巡展”,作为该活动的...
Windows恶意软件20年“... 在Windows的早期年代,病毒游走于系统之间,偶尔删除文件(但被删除的文件几乎都是可恢复的),并弹...
20个非常棒的扁平设计免费资源 Apple设备的平面图标PSD免费平板UI 平板UI套件24平图标Freen平板UI套件PSD径向平...
德国电信门户网站可实时显示全球... 德国电信周三推出一个门户网站,直观地实时提供其安装在全球各地的传感器网络检测到的网络攻击状况。该网站...
着眼MAC地址,解救无法享受D... 在安装了DHCP服务器的局域网环境中,每一台工作站在上网之前,都要先从DHCP服务器那里享受到地址动...
为啥国人偏爱 Mybatis,... 关于 SQL 和 ORM 的争论,永远都不会终止,我也一直在思考这个问题。昨天又跟群里的小伙伴进行...