WCF异常处理特点体现

开发 开发工具
WCF异常处理是一个有异于传统的处理方式。那么它的特殊之处到底在哪里呢?再这里我们将会为大家详细介绍相关知识。

WCF的出现,为开发人员带来了不一样的体验。在很多方面都有所改变,为编程者提供了一个非常好的开发环境。比如今天为大家介绍的WCF异常处理,就有许多特殊之处,值得我们去深入的研究。

异常消息与特定技术有关,.NET异常同样如此,因而WCF并不支持传统的异常处理方式。如果在WCF服务中采用传统的方式处理异常,由于异常消息不能被序列化,因而客户端无法收到服务抛出的异常,例如这样的服务设计:

  1. [ServiceContract(SessionModeSessionMode = SessionMode.Allowed)]  
  2. public interface IDocumentsExplorerService  
  3. {  
  4. [OperationContract]   
  5. DocumentList FetchDocuments(string homeDir);  
  6. }  
  7. [ServiceBehavior(InstanceContextModeInstanceContextMode
    =InstanceContextMode.Single)]  
  8. public class DocumentsExplorerService : 
    IDocumentsExplorerService,IDisposable  
  9. {  
  10. public DocumentList FetchDocuments(string homeDir)  
  11. {  
  12. //Some Codes  
  13. if (Directory.Exists(homeDir))  
  14. {  
  15. //Fetch documents according to homedir  
  16. }  
  17. else  
  18. {  
  19. throw new DirectoryNotFoundException(  
  20. string.Format("Directory {0} is not found.",homeDir));  
  21. }  
  22. }  
  23. public void Dispose()  
  24. {   
  25. Console.WriteLine("The service had been disposed.");  
  26. }  

 

则客户端在调用如上的服务操作时,如果采用如下的捕获方式是无法获取该异常的:

  1. catch (DirectoryNotFoundException ex)  
  2. {  
  3. //handle the exception;  

 

为了弥补这一缺陷,WCF异常处理会将无法识别的异常均当作为FaultException异常对象,因此,客户端可以捕获FaultException或者Exception异常:

  1. catch (FaultException ex)  
  2. {  
  3. //handle the exception;  
  4. }  
  5. catch (Exception ex)  
  6. {  
  7. //handle the exception;  

然而,这样捕获的异常,却无法识别DirectoryNotFoundException所传递的错误信息。尤为严重的是这样的异常处理方式还会导致传递消息的通道出现错误,当客户端继续调用该服务代理对象的服务操作时,会获得一个CommunicationObjectFaultedException异常,无法继续使用服务。如果服务被设置为PerSession模式或者Single模式,异常还会导致服务对象被释放,终止服务。

WCF异常处理专门提供了FaultContract特性,它可以被应用到服务操作上,指明操作可能会抛出的异常类型。例如前面的服务契约就可以修改为:

  1. [ServiceContract(SessionModeSessionMode = SessionMode.Allowed)]  
  2. public interface IDocumentsExplorerService  
  3. {  
  4. [OperationContract]  
  5. [FaultContract(typeof(DirectoryNotFoundException))]  
  6. DocumentList FetchDocuments(string homeDir);  

 

然而,即使通过FaultContract指定了操作要抛出的异常,然而如果服务抛出的异常并非FaultException或者FaultException<T>异常,同样会导致通道发生错误。因此在服务实现中,正确的实现应该如下:

  1. public class DocumentsExplorerService : 
    IDocumentsExplorerService,IDisposable  
  2. {  
  3. public DocumentList FetchDocuments(string homeDir)  
  4. {  
  5. //Some Codes  
  6. if (Directory.Exists(homeDir))  
  7. {  
  8. //Fetch documents according to homedir  
  9. }  
  10. else  
  11. {  
  12. DirectoryNotFoundException exception = 
    new DirectoryNotFoundException();  
  13. throw new FaultException<DirectoryNotFoundException>
    (exception,   
  14. new FaultReason(string.Format("Directory {0} 
    is not found.", homeDir)));  
  15. }  
  16. }  

 

我们可以将服务所要抛出的异常类型作为FaultException<T>的类型参数,然后创建一个FaultReason对象用以传递错误消息。客户端在调用服务代理对象时,可以捕获FaultException< DirectoryNotFoundException>异常,并且该异常不会使得通道发生错误,并且客户端可以继续使用该服务代理对象。即使服务为PerCall服务,客户端仍然可以继续调用服务操作。如果服务为Session服务或Singleton服务,那么即使发生了异常,服务对象也不会被终结。#t#

如果只是为了让客户端获得异常消息,即使不施加FaultContract特性,或者抛出非FaultException异常,我们也可以通过ServiceBehavior特性,将服务的IncludeExceptionDetailInFaults设置为true(默认为false),此时,客户端可以捕获抛出的非FaultException异常信息,但该异常仍然会导致通道出现错误。

但是,在发布服务与部署服务时,我们应避免将服务的IncludeExceptionDetailInFaults设置为true。

如果不希望使用FaultContract,同时又要保证服务抛出的WCF异常处理能够被客户端捕获,并且不会导致通道错误,我们还可以通过错误处理扩展的方式实现。此时,我们可以将服务本身作为错误处理对象,令其实现System.ServiceModel.Dispatcher.IErrorHandler接口:

  1. public class DocumentsExplorerService : 
    IDocumentsExplorerService,IErrorHandler, IDisposable  
  2. {…} 

 

在该接口的ProvideFault()方法中,可以将非FaultContract异常提升为FaultContract<T>异常,例如将DirectoryNotFoundException异常提升为FaultExceptino<DirectoryNotFoundException>异常:

  1. public void ProvideFault(Exception error,
     MessageVersion version, ref Message fault)  
  2. {  
  3. if (error is DirectoryNotFoundException)  
  4. {  
  5. FaultException<DirectoryNotFoundException> faultException =
     
    new FaultException<DirectoryNotFoundException>(  
  6. new DirectoryNotFoundException(), new FaultReason(error.Message));  
  7. MessageFault messageFault = faultException.CreateMessageFault();  
  8. fault = Message.CreateMessage(version,messageFault,
    faultException.Action);  
  9. }  

 

而在该接口的HandleError()方法中,则可以进行WCF异常处理,例如记录日志。

要使得错误处理扩展生效,还需要向服务通道安装错误处理扩展。方法是让服务类实现System.ServiceModel.Description.IServiceBehavior接口:

  1. public class DocumentsExplorerService : 
    IDocumentsExplorerService,IErrorHandler,IServiceBehavior,IDisposable  
  2. {…} 

 

然后在ApplyDispatchBehavior()方法中安装错误处理扩展:

  1. public void ApplyDispatchBehavior(ServiceDescription 
    serviceDescription, ServiceHostBase serviceHostBase)  
  2. {  
  3. foreach (ChannelDispatcher dispatcher in serviceHostBase.
    ChannelDispatchers)  
  4. {  
  5. dispatcher.ErrorHandlers.Add(this);  
  6. }  

 

通过这样的处理,即使服务抛出的异常为DirectoryNotFoundException异常,并且在服务契约中没有通过FaultContract特性指定该异常,客户端同样能够获得WCF异常处理的错误信息,且该异常不会导致通道发生错误,客户端可以继续调用服务代理对象的操作。

责任编辑:曹凯 来源: 博客园
相关推荐

2010-02-23 16:15:24

WCF Endpoin

2009-11-05 12:45:25

WCF异常

2009-12-22 16:55:26

WCF性能优势

2010-02-24 12:41:58

WCF异常处理

2009-12-17 10:29:04

Ruby异常处理结构

2010-02-23 10:57:34

WCF Streami

2009-11-06 15:25:25

WCF异常

2010-02-23 09:34:15

WCF重载

2010-02-25 14:26:48

WCF特点

2010-02-23 09:51:32

WCF MTOM

2009-12-22 16:03:03

WCF异常

2010-02-25 17:22:39

WCF服务行为

2009-12-21 17:40:25

WCF会话

2010-02-24 14:20:27

WCF并发模型

2010-02-22 17:13:40

WCF会话状态

2009-11-09 10:10:13

WCF异常

2009-12-07 18:38:16

WCF异常

2010-03-02 18:16:45

WCF可靠性传输

2010-02-22 16:34:17

WCF性能计数器

2010-02-23 13:46:37

WCF数据契约
点赞
收藏

51CTO技术栈公众号