概述
双工(Duplex)模式的消息交换方式体现在消息交换过程中,参与的双方均可以向对方发送消息。基于双工MEP消息交换可以看成是多个基本模式下(比如请求-回复模式和单项模式)消息交换的组合。双工MEP又具有一些变体,比如典型的订阅-发布模式就可以看成是双工模式的一种表现形式。双工消息交换模式使服务端回调(Callback)客户端操作成为可能。
在Wcf中不是所有的绑定协议都支持回调操作,BasicHttpBinding,WSHttpBinding绑定协议不支持回调操作;NetTcpBinding和NetNamedPipeBinding绑定支持回调操作;WSDualHttpBinding绑定是通过设置两个HTTP信道来支持双向通信,所以它也支持回调操作。
两种典型的双工MEP
1.请求过程中的回调
这是一种比较典型的双工消息交换模式的表现形式,客户端在进行服务调用的时候,附加上一个回调对象;服务在对处理该处理中,通过客户端附加的回调对象(实际上是调用回调服务的代理对象)回调客户端的操作(该操作在客户端执行)。整个消息交换的过程实际上由两个基本的消息交换构成,其一是客户端正常的服务请求,其二则是服务端对客户端的回调。两者可以采用请求-回复模式,也可以采用单向(One-way)的MEP进行消息交换。下图描述了这样的过程,服务调用和回调都采用请求-回复MEP。
2.订阅-发布
订阅-发布模式是双工模式的一个典型的变体。在这个模式下,消息交换的双方变成了订阅者和发布者,若干订阅者就某个主题向发布者申请订阅,发布者将所有的订阅者保存在一个订阅者列表中,在某个时刻将主题发送给该主题的所有订阅者。实际上基于订阅-发布模式的消息交换也可以看成是两个基本模式下消息交换的组合,申请订阅是一个单向模式的消息交换(如果订阅者行为得到订阅的回馈,该消息交换也可以采用请求-回复模式);而主题发布也是一个基于单向模式的消息交换过程。订阅-发布消息交换模式如下图所示。
示例
接下来我们将会创建一个简单的Wcf通信服务,包括使使用NetTcpBinding实现双工通信,和监控双工通信过程中的客户端和服务端一方断开后的捕捉事件。
项目如图所示
第一步:
先创建IGateWayService和INotifyCallBack接口
class="brush: csharp; auto-links: true; collapse: false; first-line: 1; gutter: true; html-script: true; light: false; ruler: true; smart-tabs: true; tab-size: 4; toolbar: true;"> [ServiceContract(CallbackContract = typeof(INotifyCallBack))] public interface IGateWayService { [OperationContract] void RegisterClient(string clientName); [OperationContract] string GetData(int value); [OperationContract] CompositeType GetDataUsingDataContract(CompositeType composite); } // 使用下面示例中说明的数据约定将复合类型添加到服务操作。 [DataContract] public class CompositeType { bool boolValue = true; string stringValue = "Hello "; [DataMember] public bool BoolValue { get { return boolValue; } set { boolValue = value; } } [DataMember] public string StringValue { get { return stringValue; } set { stringValue = value; } } }
INotifyCallBack.cs如下:
public interface INotifyCallBack { [OperationContract(IsOneWay = true)] void NotifyFunction(string sender); }
记住在IGateWayService接口上方设置Attribute [ServiceContract(CallbackContract = typeof(INotifyCallBack))] 这样设置表示这个接口是支持回调的。
接下来定义一个ClientRegisterInfo.cs来定义客户端的名字和客户端的INotifyCallBack属性,再定义一个Timer 来调用INotifyCallBack给客户端发送消息。再通过
wcf 的ICommunicationObject来定义通信出错和关闭的事件。
public class ClientRegisterInfo { public ClientRegisterInfo() { _senderTimer.Elapsed += OnSenderMessage; _senderTimer.Start(); } private void OnSenderMessage(object sender, ElapsedEventArgs e) { if (_notifyCallBack != null) { var communication = _notifyCallBack as ICommunicationObject; if(communication.State==CommunicationState.Opened) _notifyCallBack.NotifyFunction(DateTime.Now.ToString()); } } public Timer _senderTimer=new Timer(10*1000); private INotifyCallBack _notifyCallBack; public INotifyCallBack NotifyCallBack { get { return _notifyCallBack; } set { lock (_syncNotifyObj) { _notifyCallBack = value; if (_notifyCallBack != null) { var communication = _notifyCallBack as ICommunicationObject; if (communication != null) { communication.Closed += OnChannelClose; communication.Faulted += OnChannelFault; } } } } } private readonly object _syncNotifyObj = new object(); private void OnChannelFault(object sender, EventArgs e) { ClientInfoCache.Instance.Remove(this); } private void OnChannelClose(object sender, EventArgs e) { ClientInfoCache.Instance.Remove(this); } public string ClientName { get; set; } }
再定义一个单例来保存客户端的信息。
public class ClientInfoCache { private static readonly object SyncObj = new object(); private static ClientInfoCache _instance; public static ClientInfoCache Instance { get { lock (SyncObj) { if (_instance == null) _instance = new ClientInfoCache(); } return _instance; } } private ClientInfoCache() { _clientList = new List<ClientRegisterInfo>(); } private List<ClientRegisterInfo> _clientList; private static object SyncOperator = new object(); /// <summary> /// Add client entity /// </summary> /// <param name="entity">client entity</param> public void Add(ClientRegisterInfo entity) { if (entity == null) return; lock (SyncOperator) { var findClient = _clientList.FirstOrDefault( t => t.ClientName.Equals(entity.ClientName, StringComparison.OrdinalIgnoreCase)); if (findClient == null) _clientList.Add(entity); else { findClient.NotifyCallBack = entity.NotifyCallBack; } } } /// <summary> /// Remove client /// </summary> /// <param name="entity">Client entity</param> public void Remove(ClientRegisterInfo entity) { lock (SyncOperator) { _clientList.Remove(entity); } } }
再新建个控制台运应程序来启动Wcf,代码如下:
public class Program { static void Main(string[] args) { StartListener(); } private static void StartListener() { try { using (var host = new ServiceHost(typeof(GateWayService))) { host.Opened += delegate { Console.WriteLine("[Server] Begins to listen request on " + host.BaseAddresses[0]); }; host.Open(); Console.Read(); } } catch (Exception ex) { } } }
在App.config设置配置如下:
<?xml version="1.0" encoding="utf-8" ?> <configuration> <system.serviceModel> <bindings> <netTcpBinding> <binding name="longTimeoutBinding" closeTimeout="01:10:00" openTimeout="01:10:00" receiveTimeout="10:10:00" sendTimeout="10:10:00" maxBufferPoolSize="655350000" maxBufferSize="655350000" maxReceivedMessageSize="655350000"> <readerQuotas maxDepth="32" maxStringContentLength="655350000" maxArrayLength="655350000" maxBytesPerRead="655350000" maxNameTableCharCount="655350000" /> <reliableSession inactivityTimeout="23:59:59" /> <security mode="None" /> </binding> </netTcpBinding> </bindings> <behaviors> <serviceBehaviors> <behavior name="NewBehavior"> <serviceMetadata httpGetEnabled="True" httpGetUrl="Http://localhost:7789/" httpsGetEnabled="True"/> <serviceDebug includeExceptionDetailInFaults="False" /> <serviceThrottling maxConcurrentCalls="1000" maxConcurrentSessions="1000" maxConcurrentInstances="1000" /> </behavior> </serviceBehaviors> </behaviors> <services> <service name="WcfService.GateWayService" behaviorConfiguration="NewBehavior" > <endpoint address="net.tcp://localhost:7788/GatewayService.svc" binding="netTcpBinding" contract="WcfService.IGateWayService" name="WcfService_GateWayService" bindingConfiguration="longTimeoutBinding" > </endpoint> <endpoint address="mex" binding="mexTcpBinding" contract="IMetadataExchange" ></endpoint> <host > <baseAddresses > <add baseAddress="net.tcp://localhost:7788/GatewayService.svc" /> <add baseAddress="Http://localhost:7789/" /> </baseAddresses> </host > </service> </services> </system.serviceModel> </configuration>
longTimeoutBinding是设置传输的属性,如最大传输大小,TimeOut的时间等。
在客户端新建个WcfCallBack.cs 继承IGateWayServiceCallback接口,代码如下。
[CallbackBehavior(ConcurrencyMode = ConcurrencyMode.Multiple)] public class WcfCallBack : IGateWayServiceCallback { public void NotifyFunction(string sender) { Console.WriteLine("Get a message,message info is {0}", sender); } }
设置属性[CallbackBehavior(ConcurrencyMode = ConcurrencyMode.Multiple)]表示服务器是通过并发的给客户端来发送消息的。
控制台代码如下
class Program { private static GateWayServiceClient _client; static void Main(string[] args) { var cb = new WcfCallBack(); var context = new InstanceContext(cb); _client = new GateWayServiceClient(context); _client.RegisterClient("Test1"); ((ICommunicationObject)_client).Closed += OnChannelClose; ((ICommunicationObject)_client).Faulted += OnChannelFaulted; Console.WriteLine("Input Q to exit."); while (string.Compare(Console.ReadLine(), ConsoleKey.Q.ToString(), StringComparison.OrdinalIgnoreCase) != 0) { } } private static void OnChannelFaulted(object sender, EventArgs e) { if (FaultedEvent != null) FaultedEvent(sender, e); } private static void OnChannelClose(object sender, EventArgs e) { if (CloseEvent != null) CloseEvent(sender, e); } public static EventHandler CloseEvent; public static EventHandler FaultedEvent; }
运行的结果如下图:
当我关闭客户端时,能捕捉到Closed和Faulted事件
当我关闭服务端时,在客户端能捕捉到Faulted事件
总结:
Wcf 通信使用简单,功能丰富。