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