zoukankan      html  css  js  c++  java
  • WCF中的异常

       一、考虑到安全因素,为了避免将服务端的异常发送给客户端。默认情况下,服务端出现异常会对异常屏蔽处理后,再发送到客户端。所以客户端捕捉到的异常都是同一个FaultException异常。

    例如在服务端直接产生一个空引用异常,客户端捕获到的是上述异常。

    服务端:

     class Program
        {
            static void Main(string[] args)
            {
                ServiceHost host = new ServiceHost(typeof(SayHello));
                host.AddServiceEndpoint(typeof(ISayHello), new WSHttpBinding(), "http://localhost:4216");
                host.Opened += delegate { Console.WriteLine("Service Start!"); };
                host.Open();
                Console.ReadLine();
            }
        }
        [ServiceContract]
        public interface ISayHello
        {
            [OperationContract]
            void Say();
        }
    
        public class SayHello : ISayHello
        {
            public void Say()
            {
                string name = null;
                Console.Write("Hello {0}", name.Length);
            }
        }
    

     客户端:

     class Program
        {
            static void Main(string[] args)
            {
              ISayHello ClientChannel =  ChannelFactory<ISayHello>.CreateChannel(new WSHttpBinding(), new EndpointAddress("http://localhost:4216"));
              try
              {
                  ClientChannel.Say();
              }
              catch (Exception ex)
              {
                  Console.WriteLine(ex.Message);
                  Console.WriteLine(ex.StackTrace);
              }
            }
        }
    

     二、可通过配置ServiceDebugBehavior将IncludeExceptionDetailInFaults,将其置为true。则服务端会将异常原封不动的传递到客户端,该配置默认为false。

     [ServiceBehavior(IncludeExceptionDetailInFaults=true)]
        public class SayHello : ISayHello
        {
            public void Say()
            {
                string name = null;
                Console.Write("Hello {0}", name.Length);
            }
        }
    

     客户端捕捉到空引用异常。

    三、自定义异常信息

    1.直接通过FaultException构造函数,构造异常。

        [ServiceBehavior(IncludeExceptionDetailInFaults=true)]
        public class SayHello : ISayHello
        {
            public void Say()
            {
                throw new FaultException("自定义异常");
            }
        }
    

    2.通过FaultException<TDetail>构造异常。

      TDetail是一个可序列化的数据结构,如下面定义的myException。需要注意的是在操作契约上需要加一个错误契约,   [FaultContract(typeof(myException))]。

       [ServiceContract]
        public interface ISayHello
        {
            [OperationContract]
            [FaultContract(typeof(myException))]
            void Say();
        }
        [ServiceBehavior(IncludeExceptionDetailInFaults=true)]
        public class SayHello : ISayHello
        {
            public void Say()
            {
                myException ex = new myException
                {
                    Message = "自定义异常",
                    OperatorMethodName = "SayHello:Say()"
                };
                throw new FaultException<myException>(ex, ex.Message);
            }
        }
    
        [DataContract]
        public class myException
        {
            [DataMember]
            public string Message;
            [DataMember]
            public string OperatorMethodName;
        }
    

     客户端:

     class Program
        {
            static void Main(string[] args)
            {
                ISayHello ClientChannel = ChannelFactory<ISayHello>.CreateChannel(new WSHttpBinding(), new EndpointAddress("http://localhost:4216"));
              try
              {
                  ClientChannel.Say();
              }
              catch (Exception ex)
              {
                  myException myex = (ex as FaultException<myException>).Detail;
                  Console.WriteLine(myex.Message);
                  Console.WriteLine(myex.OperatorMethodName);
              }
            }
        }
    

     

     使用错误契约需要注意的地方:

      (1)不能再同一个操作方法上声明相同的细节类型。如下所示:

        [ServiceContract]
        public interface ISayHello
        {
            [OperationContract]
            [FaultContract(typeof(myException))]
            [FaultContract(typeof(myException))]
            void Say();
        }
    

     (2)错误契约上的细节类型不能等效。

        [ServiceContract]
        public interface ISayHello
        {
            [OperationContract]
            [FaultContract(typeof(myException),Name="PersonalException",Namespace="www.cnblogs.cn/lh218")]
            [FaultContract(typeof(myError), Name = "PersonalException", Namespace = "www.cnblogs.cn/lh218")]
            void Say();
        }
    

    四、可以指定异常的序列化方式

        默认的情况下异常消息还DataContractSerializer序列化的。可以通过XmlSerializerFormat的SupportFaults,指定使用XmlSerializer序列化异常消息。

       [ServiceContract]
        public interface ISayHello
        {
            [OperationContract]
            [FaultContract(typeof(myException))]
            [XmlSerializerFormat(SupportFaults=true)]
            void Say();
        }
    

     五、错误消息的结构

         由5部分组成

         (1)FaultCode,可以看出是对异常消息的分类。结点内部的Value表示错误类型,SubCode表示错误子代码。

         (2)FaultReason表示错误原因,内部有一个FaultReasonText集合,FaultReasonText支持全球化语言描述。

         (3)FaultNode元素,表示在SOAP消息路由过程中产生异常的结点。

         (4)FaultRole表示处理消息时所担当的角色。

         (5)FaultDetail 即之前描述的错误细节。

     下面代码讲创建一个错误消息:

    using System.Xml;
    using System.Xml.Serialization;
    using System.ServiceModel;
    using System.ServiceModel.Description;
    using System.Runtime.Serialization;
    using System.ServiceModel.Channels;
    namespace ConsoleApplication4
    {
        class Program
        {
            static void Main(string[] args)
            {
                FaultCode subCode = new FaultCode("lh218", "www.cnblogs.com/lh218");
                FaultCode code = new FaultCode("myFault", subCode);
                var text1=new FaultReasonText("异常消息","zh-CN");
                var text2=new FaultReasonText("Exception Message","en-US");
                FaultReason reason=new FaultReason(new FaultReasonText[]{text1,text2});
                myException exDetail = new myException
                {
                    Message = "自定义异常细节",
                    OperatorMethodName = "myException"
                };
                MessageFault fault = MessageFault.CreateFault(code, reason, exDetail, new DataContractSerializer(typeof(myException)), "lhActor","lhNode");
                Message msg = Message.CreateMessage(MessageVersion.Soap12WSAddressing10, fault, "http://myaction");
                Write(msg, @"D://1.txt");
                Console.ReadLine();
            }
    
            public static  void Write(Message msg,string path)
            {
                using (XmlTextWriter writer = new XmlTextWriter(path,Encoding.UTF8))
                {
                    writer.Formatting = Formatting.Indented;
                    msg.WriteMessage(writer);
                }
            }
        }
    }
    

     消息为:

    <s:Envelope xmlns:a="http://www.w3.org/2005/08/addressing" xmlns:s="http://www.w3.org/2003/05/soap-envelope">
      <s:Header>
        <a:Action s:mustUnderstand="1">http://myaction</a:Action>
      </s:Header>
      <s:Body>
        <s:Fault>
          <s:Code>
            <s:Value>s:myFault</s:Value>
            <s:Subcode>
              <s:Value xmlns:a="www.cnblogs.com/lh218">a:lh218</s:Value>
            </s:Subcode>
          </s:Code>
          <s:Reason>
            <s:Text xml:lang="zh-CN">异常消息</s:Text>
            <s:Text xml:lang="en-US">Exception Message</s:Text>
          </s:Reason>
          <s:Node>lhNode</s:Node>
          <s:Role>lhActor</s:Role>
          <s:Detail>
            <PersonalException xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="www.cnblogs.com/lh218">
              <Message>自定义异常细节</Message>
              <OperatorMethodName>myException</OperatorMethodName>
            </PersonalException>
          </s:Detail>
        </s:Fault>
      </s:Body>
    </s:Envelope>
    

     六、异常与消息之间的转换关系

     如上图所示,MessageFault是FaultException和Message直接的中转对象。

     先看Server端:

      FaultException ==》MessageFault转换方法:FaultException对象可以调用CreateMessageFault创建MessageFault对象。

        public virtual MessageFault CreateMessageFault();

     MessageFault   ==》 Message:Message调用CreateMessage创建,传入MessageFault参数。

        public static Message CreateMessage(MessageVersion version, MessageFault fault, string action);

     Client端:

      Message==>MessageFault:MessageFault类型内部的CreateFault方法可以提取异常消息中的MessageFault

         public static MessageFault CreateFault(Message message, int maxBufferSize);

      MessageFault ==》FaultException:FaultException类型提供两个静态方法创建FaultException。

        public static FaultException CreateFault(MessageFault messageFault, params Type[] faultDetailTypes);

        public static FaultException CreateFault(MessageFault messageFault, string action, params Type[] faultDetailTypes);

  • 相关阅读:
    [leetcode] Valid Sudoku
    [leetcode] Count and Say
    [leetcode] Decode Ways
    [leetcode] Sqrt(x)
    [leetcode] Best Time to Buy and Sell Stock II
    7-27 兔子繁衍问题
    7-26 最大公约数和最小公倍数
    7-25 求奇数和
    7-24 猜数字游戏
    7-23 分段计算居民水费
  • 原文地址:https://www.cnblogs.com/lh218/p/4553250.html
Copyright © 2011-2022 走看看