WCF技术剖析之三十:一个很有用的WCF调用编程技巧[上篇]
原文:WCF技术剖析之三十:一个很有用的WCF调用编程技巧[上篇]
在进行基于会话信道的WCF服务调用中,由于受到并发信道数量的限制,我们需要及时的关闭信道;当遇到某些异常,我们需要强行中止(Abort)信道,相关的原理,可以参考我的文章《服务代理不能得到及时关闭会有什么后果?》。在真正的企业级开发中,正如我们一般不会让开发人员手工控制数据库连接的开启和关闭一样,我们一般也不会让开发人员手工去创建、开启、中止和关闭信道,这些工作是框架应该完成的操作。这篇文章,我们就来介绍如果通过一些编程技巧,让开发者能够无视“信道”的存在,像调用一个普通对象一样进行服务调用。
一、正常的服务调用方式
如果通过ChannelFactory<TChannel>创建用于服务调用的代理,下面的代码片段描述了客户端典型的服务调用形式:将服务调用在基于代理对象的using块中,并通过try/catch进一步对服务调用操作进行异常处理。当TimeoutException或者CommunicationException被捕获后,调用Abort方法将信道中止。当程序执行到using的末尾,Dispose方法会进一步调用Close方法对信道进行关闭。
class Program
{
static void Main(string[] args)
{
using (ChannelFactory<ICalculator> channelFactory = new ChannelFactory<ICalculator>("calculatorservice"))
{
ICalculator calculator = channelFactory.CreateChannel();
using (calculator as IDisposable)
{
try
{
Console.WriteLine("x + y = {2} when x = {0} and y = {1}", 1, 2, calculator.Add(1, 2));
}
catch (TimeoutException)
{
(calculator as ICommunicationObject).Abort();
throw;
}
catch (CommunicationException)
{
(calculator as ICommunicationObject).Abort();
throw;
}
}
}
Console.Read();
}
}
二、借助通过Delegate实现异常处理和服务代理的关闭
虽然上面的编程方式是正确的服务调用方式,但是在真正的应用中,如果在每处进行服务调用的地方都采用上面的方式,在我看来是不能容忍的。这不但会让你的程序显得臃肿不堪,而且带来非常多重复的代码,此外频繁创建ChannelFactory<TChannel>对性能也会有影响。我们可以通过一些公共个方法实现对重复代码(ChannelFactory<TChannel>的创建,服务调用的创建、中止和关闭,以及异常处理)。为此我创建了如下一个ServiceInvoker类型,通过两个重载的Invoke方法实现对目标服务的调用。
1: using System;
2: using System.Collections.Generic;
3: using System.ServiceModel;
4: namespace Artech.Lib
5: {
6: public class ServiceInvoker
7: {
8: private static Dictionary<string, ChannelFactory> channelFactories = new Dictionary<string, ChannelFactory>();
9: private static object syncHelper = new object();
10:
11: private static ChannelFactory<TChannel> GetChannelFactory<TChannel>(string endpointConfigurationName)
12: {
13: ChannelFactory<TChannel> channelFactory = null;
14: if (channelFactories.ContainsKey(endpointConfigurationName))
15: {
16: channelFactory = channelFactories[endpointConfigurationName] as ChannelFactory<TChannel>;
17: }
18:
19: if (null == channelFactory)
20: {
21: channelFactory = new ChannelFactory<TChannel>(endpointConfigurationName);
22: lock (syncHelper)
23: {
24: channelFactories[endpointConfigurationName] = channelFactory;
25: }
26: }
27: return channelFactory;
28: }
29:
30: public static void Invoke<TChannel>(Action<TChannel> action, TChannel proxy)
31: {
32: ICommunicationObject channel = proxy as ICommunicationObject;
33: if (null == channel)
34: {
35: throw new ArgumentException("The proxy is not a valid channel implementing the ICommunicationObject interface", "proxy");
36: }
37: try
38: {
39: action(proxy);
40: }
41: catch (TimeoutException)
42: {
43: channel.Abort();
44: throw;
45: }
46: catch (CommunicationException)
47: {
48: channel.Abort();
49: throw;
50: }
51: finally
52: {
53: channel.Close();
54: }
55: }
56:
57: public static TResult Invoke<TChannel, TResult>(Func<TChannel, TResult> function, TChannel proxy)
58: {
59: ICommunicationObject channel = proxy as ICommunicationObject;
60: if (null == channel)
61: {
62: throw new ArgumentException("The proxy is not a valid channel implementing the ICommunicationObject interface", "proxy");
63: }
64: try
65: {
66: return function(proxy);
67: }
68: catch (TimeoutException)
69: {
70: channel.Abort();
71: throw;
72: }
73: catch (CommunicationException)
74: {
75: channel.Abort();
76: throw;
77: }
78: finally
79: {
80: channel.Close();
81: }
82: }
83:
84: public static void Invoke<TChannel>(Action<TChannel> action, string endpointConfigurationName)
85: {
86: Guard.ArgumentNotNullOrEmpty(endpointConfigurationName, "endpointConfigurationName");
87: Invoke<TChannel>(action, GetChannelFactory<TChannel>(endpointConfigurationName).CreateChannel());
88: }
89:
90: public static TResult Invoke<TChannel, TResult>(Func<TChannel, TResult> function, string endpointConfigurationName)
91: {
92: Guard.ArgumentNotNullOrEmpty(endpointConfigurationName, "endpointConfigurationName");
93: return Invoke<TChannel, TResult>(function, GetChannelFactory<TChannel>(endpointConfigurationName).CreateChannel());
94: }
95: }
96: }
处于对性能的考虑,避免对ChannelFactory<TChannel>的频繁创建,通过一个字典对象将创建出来的ChannelFactory<TChannel>缓存起来;两个Invoke方法中,服务的调用通过两个Delegate对象(Action<TChannel>和Func<TChannel, TResult>)表示,另一个参数表示终结点的配置名称。那么这时的服务调用就会变得相当简单:
1: using System;
2: using Artech.Lib;
3: using Artech.WcfServices.Contracts;
4: namespace Artech.WcfServices.Clients
5: {
6: class Program
7: {
8: static void Main(string[] args)
9: {
10: int result = ServiceInvoker.Invoke<ICalculator, int>(calculator => calculator.Add(1, 2), "calculatorservice");
11: Console.WriteLine("x + y = {2} when x = {0} and y = {1}", 1, 2, result);
12: Console.Read();
13: }
14: }
15: }
三、对ServiceInvoker的改进
实际上,为了对服务调用实现细节进行进一步的封装,一般地我们可以将其定义在一个独立的层中,比如服务代理层(这里的层不一定像数据访问层、业务逻辑层一样需要一个明显的界限,这里可能就是一个单独的类型而已)。在这种情况下,我们可以上面的ServiceInvoker方法进行一定的改造,使之更加符合这种分层的场景。上面我们调用静态方法的形式进行服务的调用,现在我们需要的是:实例化服务代理对象,并调用相应的方法。为此,我创建了一个泛型的ServiceInvoker<TChannel>类型,该类型继承自上述的ServiceInvoker,泛型类型表示服务契约类型。ServiceInvoker<TChannel>定义如下:
1: using System;
2: namespace Artech.Lib
3: {
4: public class ServiceInvoker<TChannel>:ServiceInvoker
5: {
6: public string EndpointConfigurationName
7: {get; private set;}
8:
9: public ServiceInvoker(string endpointConfigurationName)
10: {
11: Guard.ArgumentNotNullOrEmpty(endpointConfigurationName, "endpointConfigurationName");
12: this.EndpointConfigurationName = endpointConfigurationName;
13: }
14:
15: public void Invoke(Action<TChannel> action)
16: {
17: Invoke<TChannel>(action, this.EndpointConfigurationName);
18: }
19:
20: public TResult Invoke<TResult>(Func<TChannel, TResult> function)
21: {
22: return Invoke<TChannel, TResult>(function, this.EndpointConfigurationName);
23: }
24: }
25: }
通过传入终结点配置名称创建ServiceInvoker<TChannel>对象,直接通过调用基类的静态方法实现了两个Invoke方法。
在分层设计中,为每一个层定义的组件创建基类是一个很常见的设计方式。在这里,假设所有的服务代理类型均继承自基类:ServiceProxyBase<TChannel>,泛型类型为服务契约类型。同样通过传入终结点配置名称创建服务代理,并借助于通过Invoker属性表示的ServiceInvoker<TChannel>对象进行服务的调用。ServiceProxyBase<TChannel>定义如下:
1: namespace Artech.Lib
2: {
3: public class ServiceProxyBase<TChannel>
4: {
5: public virtual ServiceInvoker<TChannel> Invoker
6: { get; private set; }
7:
8: public ServiceProxyBase(string endpointConfigurationName)
9: {
10: Guard.ArgumentNotNullOrEmpty(endpointConfigurationName, "endpointConfigurationName");
11: this.Invoker = new ServiceInvoker<TChannel>(endpointConfigurationName);
12: }
13: }
14: }
那么,具体的服务代理类型就可以通过如下的方式定义了:
1: using Artech.Lib;
2: using Artech.WcfServices.Contracts;
3: namespace Artech.WcfServices.Clients
4: {
5: public class CalculatorProxy : ServiceProxyBase<ICalculator>, ICalculator
6: {
7: public CalculatorProxy():base(Constants.EndpointConfigurationNames.CalculatorService)
8: { }
9:
10: public int Add(int x, int y)
11: {
12: return this.Invoker.Invoke<int>(calculator => calculator.Add(x, y));
13: }
14: }
15:
16: public class Constants
17: {
18: public class EndpointConfigurationNames
19: {
20: public const string CalculatorService = "calculatorservice";
21: }
22: }
23: }
那么现在服务代理的消费者(一般是Presenter层对象),就可以直接实例化服务代理对象,并调用相应的方法(这里的方法与服务契约方法一致)即可,所有关于服务调用的细节均被封装在服务代理中。
1: using System;
2: using Artech.Lib;
3: using Artech.WcfServices.Contracts;
4: namespace Artech.WcfServices.Clients
5: {
6: class Program
7: {
8: static void Main(string[] args)
9: {
10: CalculatorProxy calculatorProxy = new CalculatorProxy();
11: int result = calculatorProxy.Add(1, 2);
12: Console.WriteLine("x + y = {2} when x = {0} and y = {1}", 1, 2, result);
13: Console.Read();
14: }
15: }
16: }
四、局限
这个解决方案有一个很大的局限:服务方式不能包含ref和out参数,因为这两种类型的参数不能作为匿名方法的参数。
本文版权归作者和博客园共有,欢迎转载,但未经作者同意必须保留此段声明,且在文章页面明显位置给出原文连接,否则保留追究法律责任的权利。
WCF技术剖析之三十:一个很有用的WCF调用编程技巧[上篇]的更多相关文章
- WCF技术剖析之三十:一个很有用的WCF调用编程技巧[下篇]
原文:WCF技术剖析之三十:一个很有用的WCF调用编程技巧[下篇] 在<上篇>中,我通过使用Delegate的方式解决了服务调用过程中的异常处理以及对服务代理的关闭.对于<WCF技术 ...
- WCF技术剖析之十五:数据契约代理(DataContractSurrogate)在序列化中的作用
原文:WCF技术剖析之十五:数据契约代理(DataContractSurrogate)在序列化中的作用 [爱心链接:拯救一个25岁身患急性白血病的女孩[内有苏州电视台经济频道<天天山海经> ...
- WCF技术剖析之十四:泛型数据契约和集合数据契约(下篇)
原文:WCF技术剖析之十四:泛型数据契约和集合数据契约(下篇) [爱心链接:拯救一个25岁身患急性白血病的女孩[内有苏州电视台经济频道<天天山海经>为此录制的节目视频(苏州话)]]在.NE ...
- WCF技术剖析之十八:消息契约(Message Contract)和基于消息契约的序列化
原文:WCF技术剖析之十八:消息契约(Message Contract)和基于消息契约的序列化 [爱心链接:拯救一个25岁身患急性白血病的女孩[内有苏州电视台经济频道<天天山海经>为此录制 ...
- WCF技术剖析之十六:数据契约的等效性和版本控制
原文:WCF技术剖析之十六:数据契约的等效性和版本控制 数据契约是对用于交换的数据结构的描述,是数据序列化和反序列化的依据.在一个WCF应用中,客户端和服务端必须通过等效的数据契约方能进行有效的数据交 ...
- WCF技术剖析之十二:数据契约(Data Contract)和数据契约序列化器(DataContractSerializer)
原文:WCF技术剖析之十二:数据契约(Data Contract)和数据契约序列化器(DataContractSerializer) [爱心链接:拯救一个25岁身患急性白血病的女孩[内有苏州电视台经济 ...
- WCF技术剖析之三:如何进行基于非HTTP的IIS服务寄宿
原文:[原创]WCF技术剖析之三:如何进行基于非HTTP的IIS服务寄宿 在上面一篇文章中,我们对不同版本的IIS,以及ASP.NET得的实现机制进行了详细而深入的分析.在介绍IIS7.0的时候,我们 ...
- WCF技术剖析之十九:深度剖析消息编码(Encoding)实现(下篇)
原文:WCF技术剖析之十九:深度剖析消息编码(Encoding)实现(下篇) [爱心链接:拯救一个25岁身患急性白血病的女孩[内有苏州电视台经济频道<天天山海经>为此录制的节目视频(苏州话 ...
- WCF技术剖析之十:调用WCF服务的客户端应该如何进行异常处理
原文:WCF技术剖析之十:调用WCF服务的客户端应该如何进行异常处理 在前面一片文章(服务代理不能得到及时关闭会有什么后果?)中,我们谈到及时关闭服务代理(Service Proxy)在一个高并发环境 ...
随机推荐
- Implement custom foreach function in C#
http://msdn.microsoft.com/en-us/library/System.Collections.IEnumerator.aspx http://support.microsoft ...
- MapReduce的C#实现及单元测试(试验)
MapReduce.cs类文件代码 MapReduce的执行方法 using System; using System.Collections.Generic; //using System.Lin ...
- Cramfs、JFFS2、YAFFS2的全面对比
Cramfs.JFFS2.YAFFS2的全面对比http://blog.csdn.net/daofengdeba/article/details/7721340 由于嵌入式系统自身存在一些特殊要求,使 ...
- 字符串分割函数Demo
#include <stdio.h> int getLength(char *string); int main(int argc, char **argv){ char str[12] ...
- 关于Ubuntu远程ssh连接失败的问题
在做机器人项目的时候,用的是Ubuntu的linux,跟之前的CentOS的操作命令有一点差别,就比如防火墙的名字,在Ubuntu系统中叫什么ufw,真是有点不好接受. 为了能模拟环境,我又弄了一台电 ...
- YII2 使用js
1.在 /backend/assets/ 中新建一个文件 CollectionAsset.php <?php /** * @link http://www.yiiframework.com/ * ...
- 运行PHP
/usr/local/php/bin/php /home/www/index.php
- C语言程序转换为Python语言
python语言是支持用c来它写模块的,其实现有的很多模块也是用c写的.这里我做个简单的介绍. 先决条件:1.在linux上编写,需要自己编译出python的动态连接库.也就是要有libpython2 ...
- Nginx阅读笔记(二)之location的用法
两个配置文件 一: server { listen 80; # # 在本机所有ip上监听80,也可以写为192.168.1.202:80,这样的话,就只监听192.168.1.202上的80口 ser ...
- mybatis用logback日志不显示sql的解决办法
mybatis用logback日志不显示sql的解决方法 1.mybatis-config.xml的设定 关于logimpl的设定值还不支持logback,如果用SLF4J是不好用的. 这是官方文档的 ...