解決WCF Stream對象綁架限制
WCF有很多值得學習的地方,這里我們主要介紹WCF在支持Stream對象的一些技巧,首先我們就來看看對MaxReceivedMessageSize的限制MaxReceivedMessageSize屬性的默認值為64kb,如果傳遞的WCF Stream對象一旦超過了MaxReceivedMessageSize屬性的設置值,則客戶端在操作該對象時,就會出現(xiàn)CommunicationException異常。因此,我們應根據(jù)實際需要設置MaxReceivedMessageSize的值。MaxReceivedMessageSize屬性的取值范圍為1-9223372036854775807(Int32.MaxValue)。如果設置值不在該范圍之內(nèi),則無法通過編譯。
編程方式設置為:
- binding.MaxReceivedMessageSize=120000;
配置文件的設置方式為:
- <binding……maxReceivedMessageSize="120000"/>
1.操作參數(shù)的限制
WCF對包含了Stream對象的操作參數(shù)進行嚴格的限制,它只允許這樣的操作只能包含一個Stream對象,這里所謂的一個Stream對象,是包含return對象,out和ref對象在內(nèi)的。也就是說如下的操作定義都是錯誤的:
- voidTransfer(Streams1,Streams2);
- voidTransfer(Streams1,outStreams2);
- voidTransfer(Streams1,refStreams2);
- StreamTransfer(Streamstream);
如果定義了這樣的操作,則會出現(xiàn)運行時錯誤。
2.實例激活類型的限制
由于Stream操作受到綁定的限制,只能使用BasicHttpBinding,NetTcpBinding以及NetNamedPipeBinding綁定,因此必然會影響服務實例的激活類型,最主要的是對Session模式的影響。首先BasicHttpBinding并不支持Session模式的激活類型。NetTcpBinding以及NetNamedPipeBinding綁定雖然支持Session模式,但是由于Stream操作不支持可靠消息傳遞,即不能將ReliableSession設置為true。因此在定義服務契約的SessionMode時,不能將其值設置為SessionMode.Required,否則會拋出異常。
#T#實際上,WCF Stream操作(指TransferMode不為Buffered)本身并不支持Session模式。即使我們在使用NetTcpBinding時,將服務契約的SessionMode設置為Allowed,并將服務的InstanceContextMode設置為PerSession,服務的執(zhí)行方式仍然是PerCall方式。(如果不是Stream操作,這樣的設置服務應為PerSession模式)因此,在執(zhí)行Stream操作時,即使按照Session模式對服務進行設置,如果我們通過OperationContext.Current.SessionId去獲得會話ID,其值應該為空。
此外,由于傳輸?shù)腤CF Stream對象較大,可能會消耗過長的時間,因而建議增大綁定的SendTimeout屬性值。例如設置為10分鐘。編程方式設置為:
- binding.SendTimeout=TimeSpan.FromMinutes(10);
配置文件的設置方式為:
- <binding……sendTimeout="00:10:00"/>
注意,對綁定的相關設置必須要求服務端與客戶端的配置一致。最佳實踐是均通過配置文件進行設置。例如在我的應用程序中是這樣設置的:
- <basicHttpBinding>
- <bindingnamebindingname="DocumentExplorerServiceBinding"
- sendTimeout="00:10:00"
- transferMode="Streamed"
- messageEncoding="Text"
- textEncoding="utf-8"
- maxReceivedMessageSize="9223372036854775807">
- </binding>
- </basicHttpBinding>