|
在上面的內容中,先后介紹了信道、信道管理器、信道監聽器和信道工廠。從對象的創建來講,信道管理器是信道的創建者。說的再具體點,客戶端的信道通過信道工廠創建,服務端的信道通過信道監聽器創建。但是信道工廠和信道監聽器又是如果被創建出來的呢?
我們在一開始就已經說過,作為終結點三要素的綁定對象實現了所有的通信細節,并且通過創建信道棧實現了消息的傳遞。從這一點來說,綁定對象無疑是信道層所有通信對象的最終締造者,所以信道工廠和信道監聽器最終的創建都是靠綁定對象實現的。關于這個創建過程又和另一個重要的對象密切相關,那就是綁定元素。
1. 綁定元素(Binding Element)
綁定元素,顧名思義就是構成一個綁定對象的元素。綁定對象最根本的目的就是創建信道棧,借此實現對消息的傳輸、編碼和基于消息交換的其他功能,比如安全、可靠傳輸、事務流轉等等。組成信道棧的單個信道對象基于對某項單一功能的實現,在不同環境中,我們需要根據具體的需要創建相應的信道,并根據一定的順序把這些信道組成一個完整的信道棧。對于綁定對象來說,如何實現這種靈活、自由的信道常創建方式,這得益于基于綁定元素的設計模式。
1.1. 關于綁定元素
從結構的角度講,一個綁定對象有一系列綁定元素組成,每個綁定元素負責創建相應的信道。所以綁定元素幾何的構成以及它們之間的先后順序,決定了最終生成的信道棧中的信道組成已經它們位于棧中的先后順序。WCF之所以在設計的時候將綁定和綁定元素分離開發,是基于靈活性、可擴展性考慮的。
在介紹信道和信道棧的時候我們說過,我們不可能、也不應該創建一個萬能的信道能夠提供消息交換中的所有的功能,所以我們讓一個信道只承載某個單一的功能,比如傳輸信道專注于網絡傳輸,消息編碼信到專注于消息的編碼,WCF還定義了一一系列的信道,他們分別關注與安全、可靠傳輸和事務流轉等等。這種信道組合的設計方式使得我們可以根據具體的需求來定制我們將要創建的信道棧,讓它只具有我們必須的功能,而去除不必要的功能。
同理,我們可以根據具體實際需求,將必要的綁定元素進行有序的組合,從而創建最能適合具體場景的綁定對象。由于信道可以分為必須的傳輸信道、消息編碼信道和可選的基于某種WS-*協議實現的協議信道,與之相對地,我們的綁定元素可以分為傳輸綁定元素、消息編碼綁定元素和協議綁定元素。
由于信道的實際創建者是信道管理器(信道工廠和信道監聽器),所以綁定元素只需要實現對信道管理器的創建,而最終實現對具體信道的創建。所以綁定元素的最根本的功能就是實現對信道監聽器和信道工廠的創建。這可以從所有綁定元素的基類, System.ServiceModel.Channels.BindingElement的定義上看出來:
public abstract class BindingElement{ // Methods protected BindingElement(); protected BindingElement(BindingElement elementToBeCloned); public virtual IChannelFactory BuildChannelFactory(BindingContext context); public virtual IChannelListener BuildChannelListener(BindingContext context) where TChannel : class, IChannel; public virtual bool CanBuildChannelFactory(BindingContext context); public virtual bool CanBuildChannelListener(BindingContext context) where TChannel : class, IChannel; public abstract BindingElement Clone(); public abstract T GetProperty(BindingContext context) where T : class;}
BindingElement的核心方法成員有兩個:BuildChannelListener和BuildChannelFactory和CanBuildChannelListener
1.2. 案例演示:如何自定義綁定元素
接下來,我們通過一個案例來演示如果自定義一個綁定元素。通過該綁定元素來創建我們在上面一個案例中創建的兩個自定義信道管理器:SimpleChannelFactory和SimpleChannelListener。按照上面的命名方式,我們把這個自定義綁定元素命名為:SimpleBindingElement,下面是整個SimpleBindingElement的定義:
public class SimpleBindingElement : BindingElement{ public SimpleBindingElement() { PrintHelper.Print(this, "SimpleBindingElement"); } public override BindingElement Clone() { PrintHelper.Print(this, "Clone"); return new SimpleBindingElement(); } public override T GetProperty(BindingContext context) { PrintHelper.Print(this, string.Format("GetProperty<{0}>", typeof(T).Name)); return context.GetInnerProperty(); } public override IChannelFactory BuildChannelFactory(BindingContext context) { PrintHelper.Print(this, "BuildChannelFactory"); return new SimpleChannelFactory(context) as IChannelFactory; } public override IChannelListener BuildChannelListener(BindingContext context) { PrintHelper.Print(this, "BuildChannelListener"); return new SimpleChannelListener(context) as IChannelListener; }}
SimpleBindingElement直接繼承自抽象的基類BindingElement,對SimpleChannelFactory和SimpleChannelListener的創建分別實現在兩個被重寫的方法中:BuildChannelFactory和BuildChannelListener中。此外還重寫了兩個額外的方法:Clone和GetProperty,前者用于克隆一個新的綁定元素,后一個和定義在信道、信道管理器的同名方法一樣,用于獲取基于某種類型的屬性。
2. 綁定揭秘
前面我們一直在談論信道、信道管理器、信道監聽器、信道工廠和綁定元素,現在我們才進體本章的主題。不過由于前面的鋪墊已經很足了,綁定本身反而沒有太多可大書特書了。如果從結構上給綁定下個定義,那么我的定義很簡單:“綁定是綁定元素的有序集合”。
2.1. 綁定是綁定元素的有序集合
由于綁定的終極目標是實現對信道棧的創建,而對于一個信道棧來說,信道的構成和次序決定著該信道棧在最終消息通信中的特性與能力,而綁定元素有決定著信道的創建,所以綁定對象本身的特性與能力由構成它的所有綁定元素以及這些綁定元素之間的先后次序決定。
正因為如此,當我們需要判斷某一個綁定類型是否支持某種特性的時候,可以通過查看該綁定是否具有與此特性相關的綁定元素。比如,我們要判斷某種綁定是否支持某種類型的傳輸協議,只需要看看構成該綁定的傳輸綁定元素就可以了,WsHttpBinding的傳輸綁定元素是HttpTransportBindingElement,所以 只能支持基于HTTP或者HTTPS的傳輸協議;如果需要確定某種類型的綁定是否支持事務的流轉,只需要查看該綁定的綁定元素集合中是否包含TransactionFlowBindingElement就可以了。
在WCF中,所有的綁定都直接或者間接繼承自抽象基類:System.ServiceModel.Channels.Binding,我們現在來簡單地分析一下這個基類。Binding實現了接口IDefaultCommunicationTimeouts。
public abstract class Binding : IDefaultCommunicationTimeouts{ public TimeSpan OpenTimeout { get; set; } public TimeSpan CloseTimeout { get; set; } public TimeSpan SendTimeout { get; set; } public TimeSpan ReceiveTimeout { get; set; }}
四個默認的超時時限可以通過編程的方式顯式指定,也可以通過配置的方式進行設置。他們的默認值分別為:OpenTimeout和CloseTimeout為1分鐘,而SendTimeout和ReceiveTimeout為10分鐘。
對于Binding,最為重要的就是如果構建組成該綁定對象的所有綁定元素集合。基于綁定元素的創建,通過抽象方法CreateBindingElements實現,所有具體的綁定類型均需要實現該方法。
public abstract class Binding : IDefaultCommunicationTimeouts{ ... ... public abstract BindingElementCollection CreateBindingElements(); }
由于信道管理器棧創建相應的信道棧,而綁定創建信道管理器棧,因此在Binding中定義了一系列BuildChannelFactory和BuildChannelListener方法重載,用于創建信道工廠棧和信道監聽器棧。此外,和BindingElement一樣,CanBuildChannelFactory和CanBuildChannelListener用于檢測綁定對象創建信道工廠和信道監聽器的能力:
public abstract class Binding: IDefaultCommunicationTimeouts{ ... public IChannelFactory BuildChannelFactory(params object[] parameters); public virtual IChannelFactory BuildChannelFactory(BindingParameterCollection parameters); public virtual IChannelListener BuildChannelListener(params object[] parameters) where TChannel : class, IChannel; public virtual IChannelListener BuildChannelListener(BindingParameterCollection parameters) where TChannel : class, IChannel; public virtual IChannelListener BuildChannelListener(Uri listenUriBaseAddress, params object[] parameters) where TChannel : class, IChannel; public virtual IChannelListener BuildChannelListener(Uri listenUriBaseAddress, BindingParameterCollection parameters) where TChannel : class, IChannel; public virtual IChannelListener BuildChannelListener(Uri listenUriBaseAddress, string listenUriRelativeAddress, params object[] parameters) where TChannel : class, IChannel; public virtual IChannelListener BuildChannelListener(Uri listenUriBaseAddress, string listenUriRelativeAddress, BindingParameterCollection parameters) where TChannel : class, IChannel; public virtual IChannelListener BuildChannelListener(Uri listenUriBaseAddress, string listenUriRelativeAddress, ListenUriMode listenUriMode, params object[] parameters) where TChannel : class, IChannel; public virtual IChannelListener BuildChannelListener(Uri listenUriBaseAddress, string listenUriRelativeAddress, ListenUriMode listenUriMode, BindingParameterCollection parameters) where TChannel : class, IChannel; public virtual bool CanBuildChannelFactory(BindingParameterCollection parameters); public bool CanBuildChannelFactory(params object[] parameters); public bool CanBuildChannelListener(params object[] parameters) where TChannel : class, IChannel; public virtual bool CanBuildChannelListener(BindingParameterCollection parameters) where TChannel : class, IChannel;}
2.2. 案例演示:如何創建自定義綁定
在上一個案例演示中,我們創建了自定義的綁定元素:SimpleBindingElement,在案例中我們來真正使用綁定元素,為此我們創建一個直接繼承自Binding的自定義綁定。為了簡單起見,對于我們自定義的綁定,他僅僅包含三個必須的綁定元素:傳輸綁定元素和消息編碼綁定元素,外加我們自定義的綁定元素。對于傳輸,我們采用基于HTTP協議的HttpTransportBindingElement,而對應消息編碼,則采用基于文本編碼方式的TextMessageEncodingBindingElement。我們索性將我們自定義的綁定命名為SimpleBinding,下面是SimpleBinding的定義:
namespace Artech.CustomChannels{ public class SimpleBinding : Binding { private string _scheme; private TransportBindingElement _transportBindingElement = new HttpTransportBindingElement(); private MessageEncodingBindingElement _messageEncodingBindingElement = new TextMessageEncodingBindingElement(); private SimpleBindingElement _SimpleBindingElement = new SimpleBindingElement(); public override BindingElementCollection CreateBindingElements() { BindingElementCollection elemens = new BindingElementCollection(); elemens.Add(this._SimpleBindingElement); elemens.Add(this._messageEncodingBindingElement); elemens.Add(this._transportBindingElement); return elemens.Clone(); } public override string Scheme { get { return this._transportBindingElement.Scheme; } } }}
對于整個SimpleBinding的定義,從形式上看顯得異常的簡單,僅僅是實現了定義在Binding中的抽象方法CreateBindingElements。在CreateBindingElements方法中,返回一個表示綁定元素集合的BindingElementCollection對象,在該集合中,包含三種類型的綁定元素,有上到下的順序分別為:SimpleBindingElement、MessageEncodingBindingElement和HttpTransportBindingElement。此外重寫了Scheme只讀屬性,它返回HttpTransportBindingElement的scheme:http。
WCF中的綁定模型:
[WCF中的Binding模型]之一: Binding模型簡介
[WCF中的Binding模型]之二: 信道與信道棧(Channel and Channel Stack)
[WCF中的Binding模型]之三:信道監聽器(Channel Listener)
[WCF中的Binding模型]之四:信道工廠(Channel Factory)
[WCF中的Binding模型]之五:綁定元素(Binding Element)
[WCF中的Binding模型]之六:從綁定元素認識系統預定義綁定
NET技術:[WCF的Binding模型]之五:綁定元素(Binding Element),轉載需保留來源!
鄭重聲明:本文版權歸原作者所有,轉載文章僅為傳播更多信息之目的,如作者信息標記有誤,請第一時間聯系我們修改或刪除,多謝。