zoukankan      html  css  js  c++  java
  • 【WCF】自定义错误处理(IErrorHandler接口的用法)

    当被调用的服务操作发生异常时,可以直接把异常的原始内容传回给客户端。在WCF中,服务器传回客户端的异常,通常会使用 FaultException,该异常由这么几个东东组成:

    1、Action:在服务调用中,action标头比较重要,它是塞在SOAP消息的Headers元素下面的,是消息头的一部分,action用来对服务操作进行定义的。用小学生能听懂的话说,就是某个服务操作的“学号”,通道层在消息调度时,会根据它来寻找要调用的Operation。记得老周举过例子,就好比你去王老板家里,你得知道王老板住在哪个窝里面。

    2、FaultCode:姑且翻译为SOAP错误码吧,虽然叫“码”,但它并不是纯数字表示的,与HTTP Error Code不同的。HTTP错误码是个数字,比如妇孺皆知的404错误。SOAP错误码实际上是一个叫Fault的元素,它塞在Body中,Fault元素下面有个叫Code的元素,就是这个FaultCode对象了,其实这个玩意儿你可以不用手动去定义它的,为啥呢,待会儿告诉你。

    3、FaultReason:主要用来指定描述SOAP错误的自定义文本,表示发生错误的原因,其实这个东西在许多时候你也不必手动定义,原因待会儿再说。不过,这个Reason可以指定不同语言版本的错误信息,比如中文的,鸟语的。比如这样:

    <Reason>
      <Text xml:lang="zh-CN">此错误的创建者未指定“原因”。</Text>
    </Reason>

    zh-cn表示简体中文,你可以指定其他物种的语言,如龟语、猫语、兔崽子语种等。

    不过,有时候,FaultException用起来不够爽,于是,类库又提供了一个从FaultException派生的类——FaultException<TDetail>,注意它有个泛型参数,这个类的亮点在于,你可以用某个类型来封装你的错误信息,然后把那个类型定义为数据协定。数据协定懂吧,就是一个类,并且可以XML序列化。如果不能XML序列化,那怎么把它的内容塞进SOAP消息中呢,别忘了,WCF是基于SOAP消息通信的(当然它可以像Web API那样,用JSON/XML通信),为了让对象可以在不同的端之间传递,当然得支持XML序列化了,对吧。就像你要寄快递,你不能叫快递员上门取炸弹,因为炸弹是禁止快递的,所以你必须寄允许的物品,这样物流才能流通。

    如果你的错误信息比较简单,比如string、double、int这些,属于基本类型,那你不用定义数据协定了,因为基础类型是可以序列化的。例如,FaultException<int>。

    好了,上面一堆F话,其实是为了让大伙认识一下FaultException,因为它很帅,也很有用,后面例子会用到它。

    下面介绍一下 IErrorHandler 接口,来,先看看它的长相。

        public interface IErrorHandler
        {
           
            bool HandleError(Exception error);
           
            void ProvideFault(Exception error, MessageVersion version, ref Message fault);
        }

    长得不是很清秀,将就一点吧,代码的颜值都差不多,C#的长相算是比较优雅的了,要是JS的话,估计代码都看得你头晕。

    这个接口的作用就是用来给咱们扩展WCF的错误处理的,实现这个高大上的接口,我们可以自定义返回给客户端的错误消息。接口不是很复杂,只有两个方法,标准的二胎:

    1、HandleError:方法参数是服务操作引发的异常,在这个方法里,你可以通过方法参数拦截这个异常。比如,你可以在这里实现自己的错误日志记录。如果你已经处理了错误,应该让方法返回true,这样运行时知道你已经处理了,就不再往下抛异常了,不然,很有可能导至服务马上挂掉(单实例模式除外)。

    2、ProvideFault:这个方法相当有用,在这个方法里面,你可以自己根据需要产生一条发回客户端的消息,当然是带Fault元素的消息,因为它不是正常消息,是错误消息。方法有三个参数:

    1)error:服务操作抛出来的原始异常,这个能理解吧。

    2)version:SOAP消息需要的版本,随后你产生Fault消息时要用到它。

    3)fault:这是核心,Message,表示错误消息实例。方法被调用时,这个参数是null的,因此,在方法结束前,你必须给它赋值一条Message,就是因为这样,这个参数才声明为 ref。

    实现这个接口后,你得想办法把它放进 ChannelDispatcher 类的 ErrorHandlers 集合中,这个类其实你看它那名字就猜到,它是负责调度通道层的。

    在WCF中,99.9957%的扩展都通过扩展 Behavior 来实现的,而服务的每个层面上都有各自的 behavior ,比如,IServiceBehavior、IEndpointBehavior、IContractBehavior、IOperationBehavior ……

    至于说应该从哪个behavior扩展,没有什么硬性规定,一切视实际应用而定,这很灵活,你知道的,世界上唯一不变的就是变化,学习编程不是背九九乘法表。

    由于通道层与服务协定在正常情形下是对应的,而且在客户端,是可以直接将服务协定(Service Contract)当成通道来用的,WCF内部会有默认的实现来完成这些转化,当然你有本事的话也可以自己写通道。一般也没多大必要,因为我们常用的HTTP,TCP之类的通信协议,默认都有了,反正老周从没写过通道层。唉,老周水平低下,只能玩点简单的东西,玩复杂的东西不行。

    于是,老周今天提供的例子,是从服务协定的behavior来扩展,为了方便用,我还把它写成Attribute,这个老周在前面的文章中说过的,写成Attribute的扩展,WCF运行时也能自动识别,并插入对应的Behaviors集合中。

    这个扩展稍后再扯,先扯重点,就是实现IErrorHandler接口。

    直接上代码,不难。

        public class ServiceErrorHandler : IErrorHandler
        {
            public bool HandleError(Exception error)
            {
                return true;
            }
    
            public void ProvideFault(Exception error, MessageVersion version, ref Message fault)
            {
                FaultException<string> fex = new FaultException<string>(error.Message);
                MessageFault mf = fex.CreateMessageFault();
                fault = Message.CreateMessage(version, mf, "http://zh-ja-demo/svfault");
            }
        }

    这里老周不打算处理异常,所以HandleError直接返回true就行了,省事省代码省时间。

    因为错误消息不是很复杂,老周就选用简单的FaultException<string>,以字符串来包装错误的详细信息。然后调用FaultException<string>的CreateMessageFault 方法就能够得到一个 MessageFault 实例,有了这个 MessageFault 实例,就可以直接创建 Message 了。

    还记得吗,在前文中,介绍FaultException时,老周说过,FaultCode和FaultReasion可以不用自己来定义的,答案就在这里了,一个 CreateMessageFault 方法就全包了,省事省力。

    最后,不要忘了,用 CreateMessage 方法创建一条发回客户端的消息对象。

    请大家记得,这个错误消息的 action 是:

    http://zh-ja-demo/svfault

    好像有点难记,老周也后悔了,干吗用这么屌的 action 名字。为啥要注意action呢,因为虽然它是一条错误消息,可是那也是一条SOAP消息,是吧,既然是SOAP消息,它必须一个action头来定位它要调用的操作,这个操作不是协定操作,而是让客户端能够收到这条错误消息,如果没有action,客户端可能定位不到这条消息,当然不是绝对情况,这里面的事情很复杂,说不清。

    这个 action 后面会用到。

    接下来,扩展一下协定层的behavior。

        [AttributeUsage(AttributeTargets.Class | AttributeTargets.Interface, AllowMultiple = false, Inherited = false)]
        public class MyContractBehaviorAttribute : Attribute, IContractBehavior
        {
            public void AddBindingParameters(ContractDescription contractDescription, ServiceEndpoint endpoint, BindingParameterCollection bindingParameters)
            {
                
            }
    
            public void ApplyClientBehavior(ContractDescription contractDescription, ServiceEndpoint endpoint, ClientRuntime clientRuntime)
            {
            }
    
            public void ApplyDispatchBehavior(ContractDescription contractDescription, ServiceEndpoint endpoint, DispatchRuntime dispatchRuntime)
            {
                ServiceErrorHandler sverr = new ServiceErrorHandler();
                dispatchRuntime.ChannelDispatcher.ErrorHandlers.Add(sverr);
            }
    
            public void Validate(ContractDescription contractDescription, ServiceEndpoint endpoint)
            {
            }
        }

    因为这个只是处理服务器上的错误,不处理客户端,所以ApplyClientBehavior方法留空,不用管它。

    然后把这个Attribute应用到协定接口或者服务类上即可,此处我应用到服务类上,反正不用向客户端公开。

        [MyContractBehavior]
        class DemoService : IDemo
        {
             ……

    现在,我们在实现服务的操作中引发一下异常。

            public long RunWork(int bs)
            {
                if (bs < 0)
                {
                    throw new ArgumentException("参数不能小于0。");
                }
                if(bs > 1000000)
                {
                    throw new ArgumentException("参数不能大于1000000。");
                }
    
                long res = 0L;
                int k = 0;
                while(k <= bs)
                {
                    res += k;
                    k += 1;
                }
                return res;
            }

    这代码的意思很简单,我就不解释了。

    现在,在客户端调用一下服务。

                ChannelFactory<Contracts.IDemo> fac = new ChannelFactory<Contracts.IDemo>("client_ep");
                Contracts.IDemo dmchannel = fac.CreateChannel();
                try
                {
                    long r = dmchannel.RunWork(baseNum);
                    tb.Text = $"计算结果:{r}";
                }catch(FaultException<string> fex)
                {
                    MessageBox.Show(fex.Detail);
                }
                catch(Exception ex)
                { 
                    MessageBox.Show(ex.Message);
                }
                fac.Close();

    如下图,调用时,故意输入一个不符合要求的值,让服务器引发异常。

    很遗憾的是,没有出现我们自定义的错误提示。

    那是因为服务器没有把错误消息回发给客户端就把连接关闭了。

    要排除这个问题也是TMD简单,只需要在服务操作协定上加上这个Attribute即可。

            [FaultContract(typeof(string), Action = "http://zh-ja-demo/svfault")]
            long RunWork(int bs);

    注意,FaultContractAttribute是应用在协定方法上的。

    传给构造函数的Type一定要与FaultException<TDetail>中的泛型匹配,记得吧,刚刚我们用的是string,所以这里也要用string。刚才在实现IErrorHandler时,老周说过,那个错误消息的 action 你要记住,因为这里要用,Action 所指定的值必须和我们刚刚在ErrorHandler中定义的action相匹配,否则客户端找不到错误消息。

    好好,加了这个Attribute后,问题就解决了,此时,就能显示服务器上的错误消息了。

    OK,本文的内容就扯完了,该开饭了。

    示例源代码下载

  • 相关阅读:
    SCP 命令
    linux下IPTABLES配置详解
    Linux rpm 命令参数使用详解
    Linux(Centos7)yum安装最新redis
    YUM常用命令介绍
    Centos7下Yum安装PHP5.5,5.6,7.0
    腾讯云CentOS7.0使用yum安装mysql
    如何在CentOS 6.5上升级PHP
    第一个Python程序
    Python简介及环境部署
  • 原文地址:https://www.cnblogs.com/tcjiaan/p/5903742.html
Copyright © 2011-2022 走看看