[原创] WCF技术剖析之二十二: 深入剖析WCF底层异常处理框架实现原理[上篇]

varsoft

浏览: 2521735 次
性别:
来自: 上海

最近访客更多访客>>

wangyy

u012363178

songhait

骑驴找骆驼

博主相关

博客

微博

相册

留言

关于我

文章分类

全部博客 (3320)

社区版块

存档分类

WCF 框架 SOAP 编程 XML

对于上一篇文章（WCF基本异常处理模式：[上篇]、[中篇]、[下篇]）,主要是站在最终开发者的角度对WCF关于异常处理编程模式进行了介绍,接下来，我们需要将我们的目光转移到WCF框架内部，深入剖析整个WCF异常处理流程。在基于SOAP的消息交换过程中，异常最终通过Fault消息承载，所以很自然地，接下来的介绍从SOAP Fault说起。

一、从SOAP Fault说起（基于SOAP 1.2）

服务调用的最终实现通过消息交换完成，WCF本质上可以看成是一个消息处理的框架。消息，不但承载着正常服务调用的请求和回复，在出现异常时，消息依然是错误信息的载体。今年来，尽管随着REST的迅速发展，基于POX（Plain of XML）消息交换大行其道；AJAX的持续升温，又是的基于非XML（JSON）的消息开始火热，但是不可否认，在今后不短的一段时间内SOAP依然是主流。看看现在有多少WS-*规范或者标准是建立在SOAP之上，就应该对这个论断不会有怀疑。

W3C先后出台了两个关于SOAP的规范：SOAP 1.1和SOAP 1.2。在《WCF技术剖析（卷1）》的第5章，我曾经按照SOAP 1.2规范对SOAP作了全面的介绍，这其中就包括对SOAP Fault。由于异常在消息交换中通过Fault消息承载，所以很多必要对SOAP Fault的相关规范作一下重申，至于SOAP的其他相关的内容，在这里就不再作重复的介绍了。

要了解SOAP 1.2下关于SOAP 1.2对SOAP Fault的规范,我们首先来看看一下一个具有完整结构的Fault SOAP。

   1: <s:Envelope xmlns:a="http://www.w3.org/2005/08/addressing" xmlns:s="http://www.w3.org/2003/05/soap-envelope">
<!--CRLF-->   2:   <s:Header>
<!--CRLF-->   3:     <a:Action s:mustUnderstand="1">http://www.artech.com/ICalculator/DivideCalculationErrorFault</a:Action>
<!--CRLF-->   4:   </s:Header>
<!--CRLF-->   5:   <s:Body>
<!--CRLF-->   6:     <s:Fault>
<!--CRLF-->   7:       <s:Code>
<!--CRLF-->   8:         <s:Value>s:Sender</s:Value>
<!--CRLF-->   9:         <s:Subcode>
<!--CRLF-->  10:           <s:Value xmlns:a="http://www.artech.com/">a:CalculationError</s:Value>
<!--CRLF-->  11:         </s:Subcode>
<!--CRLF-->  12:       </s:Code>
<!--CRLF-->  13:       <s:Reason>
<!--CRLF-->  14:         <s:Text xml:lang="zh-CN">被除数y不能为零!</s:Text>
<!--CRLF-->  15:       </s:Reason>
<!--CRLF-->  16:       <s:Node>http://http://www.artech.com/calculationcenter</s:Node>
<!--CRLF-->  17:       <s:Role>http://http://www.artech.com/calculatorservice</s:Role>
<!--CRLF-->  18:       <s:Detail>
<!--CRLF-->  19:         <CalculationError xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://www.artech.com/">
<!--CRLF-->  20:           <Message>被除数y不能为零!</Message>
<!--CRLF-->  21:           <Operation>Divide</Operation>
<!--CRLF-->  22:         </CalculationError>
<!--CRLF-->  23:       </s:Detail>
<!--CRLF-->  24:     </s:Fault>
<!--CRLF-->  25:   </s:Body>
<!--CRLF-->  26: </s:Envelope>
<!--CRLF-->

上面一个SOAP是非常完整的Fault消息，它的主体（Body）部分包含了构成SOAP Fault所有类型的元素（必需的和可选的），接下来，我们就在这个Fault消息的基础上介绍SOAP 1.2规范下对SOAP Fault的相关规定。

在SOAP 1.2规范中规定，SOAP Fault作为Fault SOAP消息的主体,用于承载错误相关的信息。具体地，对于SOAP Fault元素，有作了如下几点规范：

元素名称必须为Fault；
元素命名空间必须为http://www.w3.org/2003/05/soap-envelope；
元素包含如下子元素（圆括号中的代表各子元素在上面给定的Fault SOAP中对应的值）：

1、一个必须的Code元素表示错误代码；

2、一个比如的Reason元素表示出错的原因；

3、一个可选的Node元素表示导致出错的SOAP节点（SOAP Node）；

4、一个可选的Role元素表示SOAP节点对应的角色；

5、一个可选的Detail表述对错误的详细描述。

接下来，我们对组成SOAP Fault的五个子元素进行简单的介绍。

1、Fault Code元素

SOAP Fault的Code元素，是一个用以表示错误类型的代码，该错误代码可以大致看作对错误的一种分类。SOAP 1.2对Code元素的格式作了如下的规范：

元素名称必须为“Code”，命名空间名称为“http://www.w3.org/2003/05/soap-envelope”；
Code元素只能先后包含如下两个类型的子元素；

1、一个必须的Value元素用以定义错误代码；

2、一个可选的SubCode元素用以定义错误子代码。

而对于Value元素的格式，又具有如下的规范：

元素名称必须为“Value”，命名空间名称为“http://www.w3.org/2003/05/soap-envelope”；
元素类型为“env:faultCodeEnum”枚举，下面的表格列出了所有的可选枚举值。

枚举值	含义
VersionMismatch	命名空间或者名称和规定的SOAP规范不匹配
MustUnderstand	目标SOAP结点不能理解并处理mustUnderstand属性为“true”或者“1”的SOAP报头
DataEncodingUnknown	SOAP报头或者主体的数据编码方式不被目标SOAP结点支持
Sender	消息格式合法或者缺少必要的数据
Receiver	SOAP结点处理消息出现错误

而SubCode元素相关的规范定义如下：

元素名称必须为“SubCode”，命名空间名称为“http://www.w3.org/2003/05/soap-envelope”
SubCode元素只能包含以下两种类型的子元素：

1、必须Value元素：名称为“Value”，命名空间名称为“http://www.w3.org/2003/05/soap-envelope”，类型为“xs:QName”，一般将具体应用定义错误代码用作该元素的值

2、可选的Subcode元素

可见，SOAP Code是一种具有层级关系的（Hierarchical）的结构（Code的具有一个Code结构的SubCode）。在上面给出的Fault消息，就具有一个具有两层结构的SOAP Code：

   1: <s:Code>
<!--CRLF-->   2:   <s:Value>s:Sender</s:Value>
<!--CRLF-->   3:   <s:Subcode>
<!--CRLF-->   4:     <s:Value xmlns:a="http://www.artech.com/">a:CalculationError</s:Value>
<!--CRLF-->   5:   </s:Subcode>
<!--CRLF-->   6: </s:Code>
<!--CRLF-->

2、Fault Reason元素

对于一个SOAP Fault消息，除了必须有一个表示错误代码的Code元素之外，还需要具有一个Reason元素用以表导致错误的原因。SOAP 1.2对Reason元素的格式作了如下的规范：

元素名称必须为“SubCode”，命名空间名称为“http://www.w3.org/2003/05/soap-envelope”；
包含一个或者多个Text元素用以描述错误。

对于上面给出的SOAP Fault消息，具有如下一个SOAP Reason元素。Text元素中的lang属性表示想相应的语言文化，也就是说，你可通过该属性指定基于不同语言文化的文字用于描绘苏错误的原因。

   1: <s:Reason>
<!--CRLF-->   2:   <s:Text xml:lang="zh-CN">被除数y不能为零!</s:Text>
<!--CRLF-->   3: </s:Reason>
<!--CRLF-->

3、Fault Node元素

由于在整个SOAP消息的路由过程中，错误可能发生在最终接收结点，也可能发生在中间结点。为了使SOAP Fault消息的接收者能够判断导致错误的SOAP结点类型，在生成Fault消息的时候，可以通过Node元素指定结点的类型。SOAP 1.2对Node元素作如下的规范：

元素名称必须为“Node”，命名空间名称为“http://www.w3.org/2003/05/soap-envelope”；
元素值得类型为“xs:anyURI”，即通过URI表示的SOAP结点（参考SOAP报头的Role属性）；

在上面给出的Fault消息中，我将Fault Node指定为http://http://www.artech.com/calculationcenter。

4、Fault Role元素

SOAP结点处理SOAP消息时候担当着不同的角色。SOAP Fault的Role元素即用以表述导致错误的SOAP结点对应的角色。SOAP 1.2对Node元素的格式作了如下的规范：

元素名称必须为“Role”，命名空间名称为“http://www.w3.org/2003/05/soap-envelope”；
元素值得类型为“xs:anyURI”，即通过URI表示的SOAP结点对于得角色（参考SOAP报头的Role属性）。

在上面给出的Fault消息中，我将Fault Node指定为http://http://www.artech.com/calculatorservice。

5、Fault Detail元素

在很多基于SOAP通信的应用中，SOAP Fault消息的接收者处理需要了解通过上面介绍的基本错误元素表示的错误信息之外，往往还需要一些对错误信息更加详尽的描述。这样的描述就可以通过Detail元素来表示。SOAP 1.2对Detail元素作了如下的规范：

元素名称必须为“Detail”，命名空间名称为“http://www.w3.org/2003/05/soap-envelope”
可以包含任意的XML元素，每个元素可以具有各自的命名空间
可以包含任意的XML属性

通过上面给出的Fault消息，我们可以看出该元素对应着我们在第一节介绍的错误明细对象，既FaultException<TDetail>异常最终序列化生成Fault消息的时候，其Detail属性表示的错误明细对象被序列化成Fault Detail元素。

   1: <s:Detail>
<!--CRLF-->   2:   <CalculationError xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://www.artech.com/">
<!--CRLF-->   3:     <Message>被除数y不能为零!</Message>
<!--CRLF-->   4:     <Operation>Divide</Operation>
<!--CRLF-->   5:   </CalculationError>
<!--CRLF-->   6: </s:Detail>
<!--CRLF-->

二、 WCF下的异常：FaultException

在《WCF技术剖析（卷1）》中，我曾经提到过，在整个WCF体系下，数据存在的形态大体可以分为两种：XML和托管对象（Managed Object）。WCF建立在.NET平台下，利用托管语言（C#和VB.NET）开发人员提供了一个面向对象的编程模型，所以，在WCF体系最顶层的数据形态表现为.NET托管对象。而最终服务调用体现在消息的交换上，消息时基于XML的（除了少部分非XML的消息，比如JSON）。从数据转化的角度上讲，WCF起到了一个将数据从这两种形态数据进行转化和适配的作用。

在WCF异常处理体系中，对于异常或者错误，在XML的世界里最终通过Fault消息体现；而在托管对象的世界中，即使相应的Exception对象。上面以小节，我们在消息交换的角度对SOAP Fault进行了讲解，接下来我们介绍的对象就是它在托管世界的对立体：FaultException。

通过千篇一片文章的内容，我们知道了基于WCF异常处理的编程只要围绕着FaultException这个类型来完成的，所以我们很有必要重新深入地认识这个对象。先通过下面的代码片段来看看FaultException的基本定义：

   1: [Serializable]
<!--CRLF-->   2: public class FaultException : CommunicationException
<!--CRLF-->   3: {
<!--CRLF-->   4:    //其他成员
<!--CRLF-->   5:     public FaultException();
<!--CRLF-->   6:     public FaultException(FaultReason reason);
<!--CRLF-->   7:     public FaultException(string reason);   
<!--CRLF-->   8:     public FaultException(FaultReason reason, FaultCode code);
<!--CRLF-->   9:     public FaultException(string reason, FaultCode code);
<!--CRLF-->  10:     public FaultException(FaultReason reason, FaultCode code, string action);
<!--CRLF-->  11:     public FaultException(string reason, FaultCode code, string action);
<!--CRLF-->  12: 
<!--CRLF-->  13:     public string Action { get; }
<!--CRLF-->  14:     public FaultCode Code { get; }
<!--CRLF-->  15:     public override string Message { get; }
<!--CRLF-->  16:     public FaultReason Reason { get; }
<!--CRLF-->  17: }
<!--CRLF-->

上面列出了FaultException的一些构造函数和公共属性。Action表述最终生成到Fault消息中WS-Addressing报头Action的值。而Code和Reason则对应着SOAP Fault中的Code和Reason元素，它们的类型分别为System.ServiceModel.FaultCode和System.ServiceModel.FaultReason，我们先来详细地了解这两种类型。

1、 System.ServiceModel.FaultCode

FaultCode表述错误的代码，该代码大体上可以看成是一种对错误的分类。在序列化FaultException对象生成Fault消息的时候，该对象最终会生成SOAP Fault的Code节点。在介绍SOAP Fault的时候，我们提到SOAP Fault中的Code是一种具有层级关系（Hierarchical）的结构，这也体现在FaultCode的定义上：从下面对FaultCode的定义代码中，我们可以看到属性SubCode的属性是FaultCode本身。

   1: public class FaultCode
<!--CRLF-->   2: {   
<!--CRLF-->   3:     public FaultCode(string name);
<!--CRLF-->   4:     public FaultCode(string name, FaultCode subCode);
<!--CRLF-->   5:     public FaultCode(string name, string ns);
<!--CRLF-->   6:     public FaultCode(string name, string ns, FaultCode subCode);
<!--CRLF-->   7: 
<!--CRLF-->   8:     public static FaultCode CreateReceiverFaultCode(FaultCode subCode);
<!--CRLF-->   9:     public static FaultCode CreateReceiverFaultCode(string name, string ns);
<!--CRLF-->  10:     public static FaultCode CreateSenderFaultCode(FaultCode subCode);
<!--CRLF-->  11:     public static FaultCode CreateSenderFaultCode(string name, string ns);
<!--CRLF-->  12: 
<!--CRLF-->  13:     public bool IsPredefinedFault { get; }
<!--CRLF-->  14:     public bool IsReceiverFault { get; }
<!--CRLF-->  15:     public bool IsSenderFault { get; }
<!--CRLF-->  16:     public string Name { get; }
<!--CRLF-->  17:     public string Namespace { get; }
<!--CRLF-->  18:     public FaultCode SubCode { get; }
<!--CRLF-->  19: }
<!--CRLF-->

FaultCode的Name和NameSpace属性表述SOAP Code中Value元素的值，而SubCode属性则自然对应着同名的SubCode元素。IsPredefinedFault属性表示该Fault Code是否属于预定义的。WCF通过命名空间确定其是否是预定义的Fault Code，具体来讲，只有具有以下三个命名空间的才属于预定义的Fault Code：http://schemas.xmlsoap.org/soap/envelope/（SOAP 1.1）、http://www.w3.org/2003/05/soap-envelope（SOAP 1.2）和http://schemas.microsoft.com/ws/2005/05/envelope/none。对于名称为Sender和Receiver的预定义Fault Code，它们的IsSenderFault和IsReceiverFault分别返回true。

FaultCode还定义了两组静态方法（CreateSenderFaultCode和CreateReceiverFaultCode）帮助我们方便地创建Sender和Receiver预定义FaultCode。比如，下面我们调用静态方法CreateSenderFaultCode创建了一个FaultCode，该FaultCode的内容和我们前面给定的Fault消息中的Fault Code是一致的：

   1: FaultCode code = FaultCode.CreateSenderFaultCode(new FaultCode("CalculationError", "http://www.artech.com/"));
<!--CRLF-->

对应在Fault消息中的Fault Code元素：

   1: <s:Code>
<!--CRLF-->   2:   <s:Value>s:Sender</s:Value>
<!--CRLF-->   3:   <s:Subcode>
<!--CRLF-->   4:     <s:Value xmlns:a="http://www.artech.com/">a:CalculationError</s:Value>
<!--CRLF-->   5:   </s:Subcode>
<!--CRLF-->   6: </s:Code>
<!--CRLF-->

接下来，我们来介绍另一个类型System.ServiceModel.FaultReason。

2、 System.ServiceModel.FaultReason

FaultReason用于定于错误的原因，在SOAP Fault对应的元素为Reason，下面是其定义代码：

   1: public class FaultReason
<!--CRLF-->   2: {
<!--CRLF-->   3:     public FaultReason(IEnumerable<FaultReasonText> translations);
<!--CRLF-->   4:     public FaultReason(FaultReasonText translation);
<!--CRLF-->   5:     public FaultReason(string text);  
<!--CRLF-->   6:  
<!--CRLF-->   7:     public FaultReasonText GetMatchingTranslation();
<!--CRLF-->   8:     public FaultReasonText GetMatchingTranslation(CultureInfo cultureInfo);   
<!--CRLF-->   9:     public override string ToString();
<!--CRLF-->  10: 
<!--CRLF-->  11:     public SynchronizedReadOnlyCollection<FaultReasonText> Translations { get; }
<!--CRLF-->  12: }
<!--CRLF-->

虽然SOAP Fault的Reason的值仅仅是一个字符文本，但是处于本地化（Localization）的支持，允许我们基于不同语言文化定义不同的内容。基于语言文化的Reason文本通过一个特殊的类型表示：FaultReasonText。

   1: public class FaultReasonText
<!--CRLF-->   2:<

  分享到：
      
      广州技术沙龙第 3 期报名开始！
      |
      Google Maps API用法教程
    
    2009-10-28 20:08
浏览 898
评论(0)
查看更多
    
    评论
    
发表评论   您还没有登录,请您登录后再发表评论

最近访客更多访客>>

博主相关

文章分类

社区版块

存档分类

最新评论