双工通讯Duplex具有以下特点:
1它可以在处理完请求之后,通过请求客户端中的回调进行响应操作
2.消息交换过程中,服务端和客户端角色会发生调换
3.服务端处理完请求后,返回给客户端的不是reply,而是callback请求。
4.Duplex模式对Bindding有特殊的要求,它要求支持Duplex MEP(Message Exchange Pattern),如WSDualHttpBinding和NetTcpBinding
注意:在WCF预定义绑定类型中,WSDualHttpBinding和NetTcpBinding均提供了对双工通信的支持,但是两者在对双工通信的实现机制上却有本质的区别。WSDualHttpBinding是基于HTTP传输协议的;而HTTP协议本身是基于请求-回复的传输协议,基于HTTP的通道本质上都是单向的。WSDualHttpBinding实际上创建了两个通道,一个用于客户端向服务端的通信,而另一个则用于服务端到客户端的通信,从而间接地提供了双工通信的实现。而NetTcpBinding完全基于支持双工通信的TCP协议。
我今天的实例讲的就是双工通讯的一个使用场景订阅-发布模式,此时消息的双方变成了订阅者和发布者。订阅者有两个操作(订阅消息、取消订阅),当订阅者订阅消息后,发布者就开始向订阅者广播消息,当订阅者取消订阅后,就不会接收到广播的消息。具体如下图所示:
接下来我们我们创建基于WCF的双工通讯的订阅与发布模式的服务。工程结构如下图所示:
Publisher(发布者)和Subscriber(订阅者)都是Winform工程,我们把发布者作为服务端,订阅者作为客户端,发布者还需要承载寄宿服务。如下图设置好发布者和订阅者的界面,
发布者有一个寄宿服务的lable显示服务是否寄宿成功,一个消息文本框和一个发布按钮,输入文本后,点击发布就可以向订阅的客户端广播消息。
订阅者的界面上有一个消息接收的listbox,以及订阅消息和取消订阅按钮,还有一个输入客户端名称的文本框,界面如下图所示:
接下来我们开始实际的代码操作,首先完成发布者(服务端)的代码实现,创建IPublisher.cs文件,定义服务接口和回调接口,代码如下:
using System; using System.Collections.Generic; using System.Linq; using System.Text; using System.ServiceModel; namespace Publisher { [ServiceContract(CallbackContract = typeof(IPublisherEvents))] public interface IPublisher { [OperationContract(IsOneWay = true)] void Subscriber(string clientID,string clientName); //订阅消息 [OperationContract(IsOneWay = true)] void UnSubscriber(string clientID, string clientName); //取消订阅 } public interface IPublisherEvents { [OperationContract(IsOneWay = true)] void PublishMessage(string message); //发布消息 } }
接口里面只定义了订阅者(客户端)调用的订阅消息和取消订阅的方法,以及服务端调用客户端的回调方法PublishMessage,然后我们在FormPublisher.cs里面实现该接口,具体代码如下:
using System; using System.Collections.Generic; using System.Windows.Forms; using System.ServiceModel; using System.Threading; namespace Publisher { [ServiceBehavior(InstanceContextMode = InstanceContextMode.Single)] public partial class FormPublisher : Form, IPublisher, IDisposable { //定义回调客户端集合 public static List<IPublisherEvents> ClientCallbackList { get; set; } public FormPublisher() { InitializeComponent(); ClientCallbackList = new List<IPublisherEvents>(); } //寄宿服务 private ServiceHost _host = null; private void FormPublisher_Load(object sender, EventArgs e) { _host = new ServiceHost(typeof(Publisher.FormPublisher)); _host.Open(); this.label1.Text = "MessageService Opened."; } //关闭窗体 private void FormPublisher_FormClosing(object sender, FormClosingEventArgs e) { if (_host != null) { _host.Close(); IDisposable host = _host as IDisposable; host.Dispose(); } } //发布消息 private void btn_Publish_Click(object sender, EventArgs e) { var list =Publisher.FormPublisher.ClientCallbackList; if (list == null || list.Count == 0) return; lock (list) { foreach (var client in list) { client.PublishMessage(this.txt_Message.Text); } } } //实现订阅 public void Subscriber(string clientID, string clientName) { var client = OperationContext.Current.GetCallbackChannel<IPublisherEvents>(); var sessionid = OperationContext.Current.SessionId; MessageBox.Show( string.Format("客户端{0} 开始订阅消息。", clientName)); OperationContext.Current.Channel.Closing += new EventHandler(Channel_Closing); ClientCallbackList.Add(client); } //取消订阅 public void UnSubscriber(string clientID, string clientName) { var client = OperationContext.Current.GetCallbackChannel<IPublisherEvents>(); var sessionid = OperationContext.Current.SessionId; MessageBox.Show(string.Format("客户端{0}取消订阅消息", clientName)); OperationContext.Current.Channel.Closing += new EventHandler(Channel_Closing); ClientCallbackList.Remove(client); } //关闭通道,移除回调客户端 void Channel_Closing(object sender, EventArgs e) { lock (ClientCallbackList) { ClientCallbackList.Remove((IPublisherEvents)sender); } } } }
注意:当前使用了实例上下文模式为单例模式,我们启用的是同一个实例上下文模式,即客户端共享同一个同一个会话,关于实例模式有三种:
1. Single —— 表示所有的客户端共享一个会话(服务对象)(服务关闭时才会销毁服务对象)
2. PerCall —— 表示每次调用都会创建一个会话(服务对象)(调用完毕后就会销毁服务对象)
3. PerSession —— 表示为每个连接(每个客户端代理对象) 创建一个会话(服务对象),只有指定IsTerminating=true的操作被调用,或者是设定的SessionTimeout超时的时候,服务对象会被销毁。但支持Session的Binding只有:WSHttpBinding、WSDualHttpBinding、WSFederationHttpBinding、NetTcpBinding。
关于实例上下文模式,我将在后期博文中详细介绍。
完成后,我们就开始配置我们的服务端的”ABC”,服务端的配置文件如下:
<?xml version="1.0" encoding="utf-8" ?> <configuration> <system.web> <compilation debug="true"/> </system.web> <system.serviceModel> <services> <service name="Publisher.FormPublisher"> <endpoint address="" binding="netTcpBinding" bindingConfiguration="netTcpExpenseService_ForSupplier" contract="Publisher.IPublisher"> <identity> <dns value="localhost"/> </identity> </endpoint> <endpoint address="mex" binding="mexHttpBinding" contract="IMetadataExchange"/> <host> <baseAddresses> <add baseAddress="net.tcp://172.0.0.1:9999/WcfDuplexService/"/> <add baseAddress="http://172.0.0.1:9998/WcfDuplexService"/> </baseAddresses> </host> </service> </services> <behaviors> <serviceBehaviors> <behavior> <serviceMetadata httpGetEnabled="True"/> <serviceDebug includeExceptionDetailInFaults="False"/> </behavior> </serviceBehaviors> </behaviors> <bindings> <netTcpBinding> <binding name="netTcpExpenseService_ForSupplier" closeTimeout="00:01:00" openTimeout="00:01:00" receiveTimeout="00:10:00" sendTimeout="00:01:00" transactionFlow="false" transferMode="Buffered" transactionProtocol="OleTransactions" hostNameComparisonMode="StrongWildcard" listenBacklog="10" maxBufferPoolSize="2147483647" maxBufferSize="2147483647" maxConnections="10" maxReceivedMessageSize="2147483647"> <readerQuotas maxDepth="32" maxStringContentLength="2147483647" maxArrayLength="2147483647" maxBytesPerRead="4096" maxNameTableCharCount="16384" /> <reliableSession ordered="true" inactivityTimeout="00:10:00" enabled="false" /> <security mode="None"> <transport clientCredentialType="Windows" protectionLevel="EncryptAndSign" /> <message clientCredentialType="Windows" /> </security> </binding> </netTcpBinding> </bindings> </system.serviceModel> </configuration>
到此我们的发布者(服务端)的代码完成,编译后启动我们的Publisher.exe就可以看到服务寄宿成功的界面如下图所示:
接下来我们在Subscriber项目中添加服务引用,如下图所示:
注意:我们选择http://172.0.0.1:9998/WcfDuplexService地址,因为我们的服务已经采用了元数据地址发布,但是你们在引用的时候把配置文件和引用地址中的172.0.0.1改为
localhost或者是127.0.0.1,再或者是你们本机的IP。要不然服务地址是不准确的,无法引用。(评论中有人出现了这个问题呢)
接下来我们实现FormSubscriber.cs窗体的代码:
using System; using System.Windows.Forms; using System.ServiceModel; using System.Threading; using Subscriber.WcfDuplexService; namespace Subscriber { public partial class FormSubscriber : Form, IPublisherCallback { PublisherClient proxy = null; public FormSubscriber() { InitializeComponent(); InstanceContext instance = new InstanceContext(this); proxy = new PublisherClient(instance); btn_cancle.Enabled = false; } //实现客户端回调函数 public void PublishMessage(string message) { string msg = string.Format("来自服务端的广播消息 : {0}",message); lst_getMsg.Items.Add(msg); } //订阅消息 private void btn_ok_Click(object sender, EventArgs e) { btn_ok.Enabled = false; btn_cancle.Enabled = true; string ClientID = System.Guid.NewGuid().ToString(); string ClientName = this.textBox1.Text; proxy.Subscriber(ClientID, ClientName); } //取消订阅 private void btn_cancle_Click(object sender, EventArgs e) { btn_ok.Enabled = true; btn_cancle.Enabled = false; string ClientID = System.Guid.NewGuid().ToString(); string ClientName = this.textBox1.Text; proxy.UnSubscriber(ClientID, ClientName); } } }
到此,我们整个解决方案已经完成,接下来,我们运行程序来验证我们需要的结果,首先启动发布者(即服务端),再启动订阅者(即客户端,注意:这里我们启动两个,方便验证程序效果),运行效果如下:
效果1:client1和client2都订阅消息,此时两个客户端都能收到广播的消息
效果2:client1订阅消息和client2取消订阅,此时只有client1能收到广播的消息
效果3:client1取消订阅和client2订阅消息,此时只有client2收到广播的消息