技术开发 频道

WCF客户端开发的简化之旅

  【IT168 技术文档】熟悉Web Service开发的程序员对添加服务引用应该并不陌生。在创建某个服务的客户端程序时,并不需要从头开始编写客户端的底层通信和交互代码,可以通过输入服务地址来添加服务来让Visual Studio生成客户端代理,这样访问服务就像访问本地组件一样,而不需要去关心通信的细节。如果创建的客户端程序项目和服务程序项目处在同一个解决方案里(很多开发者在开发服务时,也会同步开发客户端程序),还可以通过Visual Studio来帮助我们“发现(Discovery)”服务,并添加服务引用。

  现在开发WCF Service的程序员也可以得益于这些功能了。如果从WCF Service Library (或者WCF 节点下的Sequential Workflow Service Library 和 State Machine Workflow) 项目模板创建一个项目,那么这些功能就已经具备。

  下面我们来看一下如何使用:

  1.创建一个客户端程序,可以是一个Windows Console程序。

  2. 在同一解决方案里添加一个WCF Service Library。如图:

 

  3.Build WcfServiceLibrary1。

  4.右键ConsoleApplication1,在上下文菜单中选择“添加服务引用“(Add Service Reference).

  5.此时可以看到一个对话框:

 

  6.如果已经知道服务的地址,可以直接在Address栏输入地址来添加服务,单击“Go”。可以找到这个地址对应的服务。

  7.如果想添加同一个解决方案里的服务,可以先单击“发现”来寻找服务。找到服务后,选中需要在客户端程序生成引用的服务,然后单击确定,这个时候WcfSvcHost就会自动启动来HOST服务。几秒以后,可以看到客户端自动生成了服务代理代码:

 

  通过上面的步骤在客户端完成了添加服务引用,现在可以访问服务了,只需要通过下面两行代码就可以调用服务端的一个方法:

ServiceReference1.Service1Client client = new ServiceReference1.Service1Client();
client.GetData(0);

  使用技巧及注意点:

  1.vs2008的WCF节点下有四个项目模板,但是Syndication Service Library项目并不具备这个功能,这是因为这个服务并没有提供Metadata。
  2.在“发现”服务前,必须先Build服务端项目(也就是上文第3步必不可少)以保证添加的服务引用是最新的。在将来版本的Visual Studio 中我们会做进一步的简化。

  本文中介绍的Auto-attaching则可以简化客户-服务的调试工作。Auto-attaching,顾名思义,指的是如果针对客户端程序按下“F5”,当这个客户端程序访问同一个VS解决方案内的服务时,调试器(Debugger)会自动附加 (Attach) 到这个服务的宿主进程(对WCF Service Library 项目来说,宿主程序即为WcfSvcHost),从而开发人员可以针对客户-服务进行一体化调试,就像它们是一个程序一样。我们还是沿用上一个例子,来看看它怎么工作。

  1.现在已经添加好服务引用,并写好了访问服务的代码,假设我们现在想要调试这个客户-服务解决方案。首先将ConsoleApplication1设为“启动(Start-up)”项目,启动项目在VS里以黑体字表示。

  2.在ConsoleApplication1 和 WcfServiceLibrary1分别设置断点,如图:

  客户端代码:

 

  服务端代码:

 

  3.在VS中按下“F5”,我们可以看到WcfSvcHost会自动启动。而调试器首先会附加到ConsoleApplication1进程。几秒钟后,程序执行停在客户端断点处,此时调试器还不会附加到WcfSvcHost进程(出于效率考虑,只有在真正访问一个服务的时候,调试器才会去附加到这个服务的宿主程序)。

  4.继续按下“F5”, client.GetData(0)这个调用会向服务发送请求,而调试器会侦听到这一请求,于是它自动附加到请求对应的服务的宿主程序上(也就是WcfSvcHost),很快程序执行停留在第二个断点。

  这就是Auto-attaching的工作过程,用户不需要做任何设置就可以同时调试客户端和服务端程序。

  使用技巧:

  1. Auto-attaching 功能在服务端程序的App.config里进行配置。打开App.config,我们可以看到

<system.web>
<compilation debug="true" />
</system.web>

  去掉这一部分,Auto-attaching功能就不会再生效。

  2. 在某些应用场景下,大家可能觉得Auto-Attaching 太“智能”了。比如,如果我们所编写的ConsoleApplication1不是服务的客户端,而是WcfServiceLibrary1的host程序,“F5”也会让WcfSvcHost自动启动来 host服务,显然,这会引起冲突,因为在同一个地址/端口只允许一个服务,这个时候ConsoleApplication1因为端口冲突是不能成功host WcfServiceLibrary1的。最合理也是最简单的解决方法是将WcfServiceLibrary1的App.config改名或者删除(这是合理的,因为如果用另一个Project来作为服务的Host Project, WcfServiceLibrary1的App.config是没有什么用处的)。这样,WcfSvcHost就不会很主动地自动运行了。

  3. 有的用户可能会遇到Auto-attaching 功能一开始就不能正常工作的情况,这很可能是因为Visual Studio 2008没有完整地安装好。可以在VS 2008 所带的命令行终端里运行vsdiag_regwcf.exe -i来恢复这个功能。vsdiag_regwcf.exe 位于%VSInstallDir%\Common7\IDE。

0
相关文章