• .NET中Web Service的异常机制


     

        即使拥有了本地代理类等特性,调用Web Service方法毕竟和调用本地方法有所区别,问题之一就是异常的处理。可以想象,如果希望捕获Web Service服务器端产生的异常,那这些异常信息就需要被封装在SOAP信息中发送回客户端。本节将借助回答问题,简要介绍Web Service中的异常机制。
      所涉及到的知识点
    •    SOAP中对异常的规定
    •    服务器端对未捕获异常的处理
    •    客户端代理类对fault节点的处理
      分析问题
    1.SOAP中对异常的规定
    SOAP规定了异常消息的携带方式,那就是全被被放入fault节点中。fault节点必须是Body节点的子节点,同时,一个SOAP消息中只能出现一个fault节点。表11-2列出了fault节点可包含的所有子节点。
    表11-2  Fault的子节点
    子 节 点    描    述
    <faultcode>    供识别故障的代码
    <faultstring>    可供人阅读的有关故障的说明
    <faultactor>    有关是谁引发故障的信息
    <detail>    存留涉及 Body 元素的应用程序专用错误信息
    其中faultcode是一个错误码,其取值和每个值所代表的含义都在SOAP中有所定义,表11-3列出了所有faultcode及其含义。
    表11-3  faultcode节点的值
    faultcode节点的值    描    述
    VersionMismatch    SOAP Envelope 元素的无效命名空间被发现
    MustUnderstand    Header 元素的一个直接子元素(带有设置为"1"的 mustUnderstand 属性)无法被理解。
    Client    消息被不正确地构成,或包含了不正确的信息。
    Server    服务器有问题,因此无法处理进行下去。
    2.服务器端对未捕获异常的处理
    在使用WebService类型和WebMethod特性创建Web Service的情况下,服务器端的异常都会被捕捉,并且所有异常都会被放入到SoapException类型中,并且发还给客户端。这里可能会有两种情况,一种是服务器端抛出了非SoapException的异常,这时候原始的异常会被自动放到一个SoapException异常之中,而包括异常堆栈在内的很多信息都会丢失。而另一种情况是服务器端代码直接使用了SoapException异常,这时候程序员可以使用下列属性来设置SoapException对象:
    •    Message:原始异常的Message属性。
    •    Code:服务器异常码。
    •    Actor:Web Service方法的URL。
    •    Detaul:空引用,但有一个空的详细信息元素存在于故障元素中。
    服务器端会把SoapException放入Fault节点之中并且发还给客户端,以此来告知服务器端产生的异常。下面是一个返回异常的SOAP消息示例:
    <soap:Body xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
      <soap:Fault>
        <faultcode>soap:Server</faultcode>
        <faultstring>
          System.Web.Services.Protocols.SoapException: Server was unable to process request. ---&gt; System.Exception: 异常内容
          at Service.HelloWorld()
          --- End of inner exception stack trace ---
        </faultstring>
        <detail />
      </soap:Fault>
    </soap:Body>
    3.客户端代理类对fault节点的处理
    如果使用.NET自动生成的Web Service代理类,那么它将能自动地识别fault节点,并且还原SoapException异常。所以在客户端通过代理类调用Web Service方法时,将能切实地捕获到一个SoapException异常。下列代码展示了这一点。
    首先在Web Service的服务器端直接抛出一个异常,如代码11-8所示。
    代码11-8  自定义asmx处理程序:Service.cs
    //直接抛出一个Exception异常
    //该异常会被包装成一个SoapException异常
    [WebMethod]
    public string HelloWorld()
    {
        throw new Exception("异常测试!");
    }
    然后根据这个Web Service,在本地生成对应的代理类型,并且捕捉从服务端发送过来的SoapException。
    代码11-9  自定义asmx处理程序:ServiceClient.cs
    class ServiceClient
    {
        static void Main(string[] args)
        {
            Service service = new Service();
            try
            {
                //异常将从Web SErvice代理类中被抛出
                service.HelloWorld();
            }
            //捕捉SoapException异常
            catch (SoapException ex)
            {
                //打印其内容
                Console.WriteLine("Actor:{0}",ex.Actor);
                Console.WriteLine("CodeName:{0}", ex.Code.Name);
                Console.WriteLine("Detail:{0}", ex.Detail.InnerText);
                Console.WriteLine("Message:{0}", ex.Message);
            }
            Console.Read();
        }
    }
    下面是上述代码的执行结果:
    Actor:
    CodeName:Server
    Detail:
    Message:System.Web.Services.Protocols.SoapException: Server was unable to proces
    s request. ---> System.Exception: 异常测试!
       at Service.HelloWorld()
       --- End of inner exception stack trace ---
      答案
    SOAP规定,一个SOAP消息中只能存在一个Fault节点来包含错误消息。在.NET框架中,Web Service服务端抛出的异常,最后多会被捕捉并且装入一个SoapException对象中,此对象会被放入Fault节点并且传输回客户端。如果客户端使用.NET自动生成的代理类,则会解析Fault节点并且重新抛出SoapException异常。
    本文节选自《.NET程序员面试指南》一书
  • 相关阅读:
    SD卡 家族的发展
    onenand小结 及 与nor 和nand 的区别
    PHP程序开发范例学习之表单――获取文本框的值
    Smarty 模板初体验
    symfony object route class: sfDoctrineRoute
    数据结构&算法(PHP描述) 简单选择排序 simple selection sort
    FLEAPHP操作两个数据库
    让Nginx支持ThinkPHP的URL重写和PATHINFO
    Apache中限制和允许特定IP访问(转载)
    php记录日志
  • 原文地址:https://www.cnblogs.com/lover/p/1358600.html
Copyright © 2020-2023  润新知