轉(zhuǎn)帖|其它|編輯:郝浩|2011-01-06 17:10:23.000|閱讀 1031 次
概述:WCF支持Stream操作,尤其對(duì)于傳遞size過(guò)大的消息而言,如要考慮傳遞消息的效率,WCF推薦通過(guò)Stream進(jìn)行操作。然而,WCF Stream操作規(guī)定了一些限制,在我們編寫(xiě)相關(guān)程序時(shí),本文主要介紹WCF Stream對(duì)象限制操作 ,希望對(duì)大家有幫助。
# 界面/圖表報(bào)表/文檔/IDE等千款熱門(mén)軟控件火熱銷售中 >>
WCF支持Stream操作,尤其對(duì)于傳遞size過(guò)大的消息而言,如要考慮傳遞消息的效率,WCF推薦通過(guò)Stream進(jìn)行操作。然而,WCF Stream操作規(guī)定了一些限制,在我們編寫(xiě)相關(guān)程序時(shí),需要特別注意:
1、綁定的限制
如果需要使用Stream操作,可以使用的綁定只能是BasicHttpBinding,NetTcpBinding以及NetNamedPipeBinding。此外,在使用Stream操作時(shí),不能使用Reliable Messaging。如果考慮到消息安全,則此方式是不可取的。
2、對(duì)Stream對(duì)象的限制
要作為服務(wù)操作所傳遞的消息對(duì)象,這樣的對(duì)象必須是可序列化的。遺憾的是,F(xiàn)ileStream類的定義卻是不支持序列化的,我們能夠使用的Stream 對(duì)象,包括Stream,MemoryStream等。使用Stream類對(duì)象是大多數(shù)Stream操作的首選。一個(gè)有趣的現(xiàn)象是FileStream與Stream類型的轉(zhuǎn)換。例如在服務(wù)契約的操作中,有如下的實(shí)現(xiàn):
public Stream TransferDocument(Document document) { FileStream stream = new FileStream (document.LocalPath, FileMode.Open, FileAccess.Read); return stream; } 注意,操作TransferDocument()的返回類型為Stream,而方法的實(shí)現(xiàn)中,返回的對(duì)象則為FileStream類型。由于Stream類是FileStream類的父類,這樣的實(shí)現(xiàn)沒(méi)有問(wèn)題。
然而,在客戶端調(diào)用該操作時(shí),卻不能將操作的返回值賦給FileStream類型的對(duì)象,如下所示:
FileStream stream = m_service.TransferDocument(doc); 此時(shí)獲得的Stream對(duì)象則為null。因而,我們只能這樣調(diào)用操作:
Stream stream = m_service.TransferDocument(doc); 但是,還有一個(gè)奇怪的問(wèn)題是WCF并不支持Stream對(duì)象Length屬性的序列化,也就是說(shuō),在客戶端我們不能使用服務(wù)操作返回的Stream對(duì)象的 Length屬性。諸如stream.Length的調(diào)用會(huì)拋出NotSupportedException異常。
3、TransferMode的限制
若要使用Stream操作,必須修改綁定的TransferMode屬性。該屬性的默認(rèn)值為Buffered。我們應(yīng)該根據(jù)操作中WCF Stream對(duì)象的參數(shù)類型,以決定TransferMode的值分別為Streamed、StreamedRequest或者StreamedResponse。
4、MaxReceivedMessageSize的限制
MaxReceivedMessageSize屬性的默認(rèn)值為64kb,如果傳遞的Stream對(duì)象一旦超過(guò)了 MaxReceivedMessageSize屬性的設(shè)置值,則客戶端在操作該對(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"/> 5、操作參數(shù)的限制
WCF Stream操作參數(shù)嚴(yán)格的限制,它只允許這樣的操作只能包含一個(gè)Stream對(duì)象,這里所謂的一個(gè)WCF Stream對(duì)象,是包含return對(duì)象,out和ref對(duì)象在內(nèi)的。也就是說(shuō)如下的操作定義都是錯(cuò)誤的:
void Transfer(Stream s1, Stream s2); void Transfer(Stream s1, out Stream s2); void Transfer(Stream s1, ref Stream s2); Stream Transfer(Stream stream); 如果定義了這樣的操作,則會(huì)出現(xiàn)運(yùn)行時(shí)錯(cuò)誤。
此外,由于傳輸?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ù)端與客戶端的配置一致。最佳實(shí)踐是均通過(guò)配置文件進(jìn)行設(shè)置。例如在我的應(yīng)用程序中是這樣設(shè)置的:
<basicHttpBinding> <binding name="DocumentExplorerServiceBinding" sendTimeout="00:10:00" transferMode="Streamed" messageEncoding="Text" textEncoding="utf-8" maxReceivedMessageSize="9223372036854775807"> </binding> </basicHttpBinding>
本站文章除注明轉(zhuǎn)載外,均為本站原創(chuàng)或翻譯。歡迎任何形式的轉(zhuǎn)載,但請(qǐng)務(wù)必注明出處、不得修改原文相關(guān)鏈接,如果存在內(nèi)容上的異議請(qǐng)郵件反饋至chenjj@ke049m.cn
文章轉(zhuǎn)載自:網(wǎng)絡(luò)轉(zhuǎn)載