单向模式(One-Way Calls):
- 在这种交换模式中,存在着如下的特征:
- 只有客户端发起请求,服务端并不会对请求进行回复
- 不能包含ref或者out类型的参数
- 没有返回值,返回类型只能为void
- 通过设置OperationContract的IsOneWay=True可以将满足要求的方法设置为这种消息交换模式
接下来,我们通过实例来演示这种模式,首先新建一个WcfDemo1的解决方案,添加名称为Service的类库项目作为服务端,新建IOneWay接口和 OneWay类,由于单向模式中服务端并不会有返回操作,所以我们可以用线程时间来模拟客户端对服务端的调用情况。总个工程的结构如下:
服务契约接口中的代码如下:
using System.ServiceModel;
namespace Service
{
[ServiceContract]
public interface IOneWay
{
[OperationContract(IsOneWay=true)]
void SayHello(string name);
}
}
服务契约的实现代码如下:
using System;
using System.Collections.Generic;
using System.Linq;
using System.Text;
namespace Service
{
public class OneWay:IOneWay
{
public void SayHello(string name)
{
System.Threading.Thread.Sleep(10000);
}
}
}
接下来我们将服务寄宿起来,Host中的配置文件代码如下:
<?xmlversion="1.0"?>
<configuration>
<system.serviceModel>
<services>
<servicename="Service.OneWay"behaviorConfiguration="OneWayBehavior">
<host>
<baseAddresses>
<addbaseAddress="http://127.0.0.1:1234/OneWay/"/>
</baseAddresses>
</host>
<endpoint address=""binding="wsHttpBinding" contract="Service.IOneWay"/>
<endpoint address="mex"binding="mexHttpBinding" contract="IMetadataExchange"/>
</service>
</services>
<behaviors>
<serviceBehaviors>
<behaviorname="OneWayBehavior">
<serviceMetadatahttpGetEnabled="True"/>
<serviceDebugincludeExceptionDetailInFaults="True"/>
</behavior>
</serviceBehaviors>
</behaviors>
</system.serviceModel>
</configuration>
Program.cs中的代码如下:
using System;
using System.Collections.Generic;
using System.Linq;
using System.Text;
using System.ServiceModel;
using Service;
namespace Host
{
class Program
{
static void Main(string[] args)
{
using (ServiceHost oneWayHost = newServiceHost(typeof(OneWay)))
{
oneWayHost.Opened += delegate
{
Console.WriteLine("单向通讯服务已经启动,按任意键终止!");
};
oneWayHost.Open();
Console.Read();
}
}
}
}
到此,我们完成了对服务的寄宿,启动Host.exe,在浏览器中输入http://127.0.0.1:1234/OneWay/我们可以看到寄宿成功的页面。在客户端添加服务引用:
引用后在客户端程序添加以下代码:
using System;
using System.Collections.Generic;
using System.Linq;
using System.Text;
using Client.OneWayServiceRef;
namespace Client
{
class Program
{
static void Main(string[] args)
{
Console.WriteLine("****************单向通讯服务示例*******************");
OneWayClient proxy = newOneWayClient();
Console.WriteLine("方法调用前时间:"+ System.DateTime.Now);
proxy.SayHello("WCF");
Console.WriteLine("方法调用后时间:" + System.DateTime.Now);
Console.Read();
}
}
}
生成后运行程序Client.exe,可以看到以下效果:
我们发现前后两次的时间相同,虽然服务器方法的时间进程暂停了10s,但客户端的表现出的只是单向的,并没有等待服务器的时间,也就是服务器并没有像客户端发送响应的消息。
以上是我们程序表现出来的结果。接下来,我们通过消息层面说明这个。启动vs自带的WCF客户端验证程序,在开始菜单中找到如下图所示的工具:
点击启动该命令行,输入wcftestclient,回车,启动WCF客户端测试程序:
在客户端测试程序中添加服务地址:
点击对应的方法,点击调用按钮,最后我们发现服务器给出了一条提示:
点击左下角的xml我们可以看到发送的具体消息:
我们发现只有请求消息,没有返回的消息,说明服务器并没有对此作出任何反应。
本文通过程序实例和消息层面说明消息交换模式中的单向模式,在接下来的文章中,我将继续演示消息交换中另外两只模式:请求/答复(Request/Reply) 、双工(Duplex)。