一步通WCF Stream對象介紹
喜歡用WCF的朋友希望它的功能更強大些,不知道我今天介紹這個會不會給你帶來收獲?WCF支持對Stream對象的操作,尤其對于傳遞size過大的消息而言,如要考慮傳遞消息的效率,WCF推薦通過Stream進行操作。
然而,WCF Stream對象操作規(guī)定了一些限制,在我們編寫相關(guān)程序時,需要特別注意:
1、綁定的限制
如果需要使用Stream操作,可以使用的綁定只能是BasicHttpBinding,NetTcpBinding以及NetNamedPipeBinding。此外,在使用Stream操作時,不能使用ReliableMessaging。如果考慮到消息安全,則此方式是不可取的。
2、對WCF Stream對象的限制
#T#要作為服務(wù)操作所傳遞的消息對象,這樣的對象必須是可序列化的。遺憾的是,F(xiàn)ileStream類的定義卻是不支持序列化的,我們能夠使用的WCF Stream對象,包括Stream,MemoryStream等。使用Stream類對象是大多數(shù)Stream操作的***。一個有趣的現(xiàn)象是FileStream與Stream類型的轉(zhuǎn)換。例如在服務(wù)契約的操作中,有如下的實現(xiàn):
- publicStreamTransferDocument(Documentdocument)
- {
- FileStreamstream=newFileStream
- (document.LocalPath,FileMode.Open,FileAccess.Read);
- returnstream;
- }
注意,操作TransferDocument()的返回類型為Stream,而方法的實現(xiàn)中,返回的對象則為FileStream類型。由于Stream類是FileStream類的父類,這樣的實現(xiàn)沒有問題。
然而,在客戶端調(diào)用該操作時,卻不能將操作的返回值賦給FileStream類型的對象,如下所示:
- Streamstream=m_service.TransferDocument(doc);
此時獲得的Stream對象則為null。因而,我們只能這樣調(diào)用操作:
- Streamstream=m_service.TransferDocument(doc);
但是,還有一個奇怪的問題是WCF并不支持Stream對象Length屬性的序列化,也就是說,在客戶端我們不能使用服務(wù)操作返回的Stream對象的Length屬性。諸如stream.Length的調(diào)用會拋出NotSupportedException異常。
3、TransferMode的限制
若要使用Stream操作,必須修改綁定的TransferMode屬性。該屬性的默認值為Buffered。我們應(yīng)該根據(jù)操作中Stream對象的參數(shù)類型,以決定TransferMode的值分別為Streamed、StreamedRequest或者StreamedResponse。