欢迎光临
我的个人博客网站

[.net] 关于Exception的几点思考和在项目中的使用(一)


关于exception的基本语法和作用,这里不再赘述,下面记录一下我在项目中关于Exception的一些思考。

一,使用Exception,而不是Error Code

在初始设计项目的时候,有时候我们为了明确错误类型,定义如下结构:

enum ErrCode {     Ok,     ArgumentErr,     OtherErr1,     OtherErr2 }  class SomeClass {     public ErrCode DealSomething()     {         //.....         return ErrCode.Ok;     } }  class CallerClass {     public void CallSome(SomeClass some)     { 		ErrCode err = some.DealSomething();          		if(err == ErrCode.Ok)         {             //....         }         else         {             //.....         }     } } 

使用ErrCode并不是说完全不可以,比如在Web Api调用中返回ErrCode就是不错的选择。

1,吃掉异常

但是在其他情况,使用ErrCode会让使用者痛苦不堪,因为每次调用都要小心谨慎的处理和判断ErrCode,否则就特别容易吃掉异常

对比如下程序片段:

使用ErrCode 使用Exception
class SomeClass {     public ErrCode DealSomething()     {         //.....         return ErrCode.SomeErr;     } } class CallerClass {     public void CallSome(SomeClass some)     { 		some.DealSomething(); 		giveMoney(); 	} } 
class SomeClass {     public void DealSomething()     {         //.....         if(somthingWrong)         {         	throw new SomeException(...);         }     } } class CallerClass {     public void CallSome(SomeClass some)     { 		some.DealSomething(); 		giveMoney(); 	} } 

 

左侧使用ErrCode因为不小心没有接受处理ErrCode,导致后续代码继续执行;

而使用Exception,即使没有处理,也不会执行后续代码,并且抛出等待上层使用者处理。

此外,Exception还有其他众多好处,比如Stack Trace信息,跨process等等。

所以Exception的本质就是现成的错误处理(error-handling)机制,就不要再去使用自定义的ErrCode了。

二,Exception在项目中的使用

既然明确使用Exception作为我们的错误处理方案。那么具体怎么使用呢?

1,使用细化的Exception

首先要避免以下写法:

class Dal {     public void Add(Entity entity)     {         //....         if(somthingWrong)         {             throw new Exception("add wrong");         }         //...     } } 

这种写法的问题在于,调用者无法明确Exception的原因,类型,仅仅依靠文档或者message去理解,当项目越积越多的时候,就是漫天相同的Exception乱飞,日志里充满了各种神奇的message的时候。

我们可以采取多维度细化Exception:类型、错误种类,具体原因。

使用具体类型化的Exception,比如ConnectionException, TimeoutException, 即为每种错误定义一个Exception类型,

这种方法想必大家都很清楚,但是如果一个模块里有十几种错误,而你又有十几个模块呢?

对于这种情况有两种处理方法。

  • 按内部外部划分

    如果一个异常需要模块外部调用者接收和处理的,那么就定义一个具体的Exception类型,比如ConnectionException,TimeoutException;

    如果一个异常是模块内存自处理的,那么只用同一个InnerException(或者其他名字)加上其他信息来区分。(是不是又闻到了ErrCode的味道,没错)。

    这种方法经常在很多开源类库中看到。

  • 一个模块定义一种Exception类型,Exception与ErrCode相结合

    刚说过ErrCode不能用,这里又提到,大家别误会,仔细往下看。

    比如如下代码:

    class ErrCode {     public int Code { get; set; }     public string? Name { get; set; }     public string? Message { get; set; } }  class DalException : Exception {     public ErrCode Code { get; }          public DalException(ErrCode errCode, Exception? innerException = null):base(errCode.Message, innerException)     {     	Code = errCode;         } } 

    ErrCode已经不简简单单是一个enum了,而是有更大的用处。

    这样每一个模块都拥有自己Exception类型,每一种错误类型又能得到有效的分类。

    这种方法经常在公司项目的业务模块、基础框架模块里用到。

2,使用Exception.Data

上面的代码段,大家是否有点惊讶,哥们儿,你把Message直接干到ErrCode里面固定起来,是不是有点激进啊。

其实这也是在实际开发中,总结出来的经验。尽量不要放任程序员们零散的去写各种Exception的Message。

但是我们可以用Exception.Data来实现更多场景。

比如下面代码段:

static class ExceptionFactory {     public static DalException OnMigrateError(int oldVersion, int newVersion, string sql, string cause)     {         DalException ex = new DalException(ErrCodes.MigrationErr);                  ex.Data["OldVersion"] = oldVersion;         ex.Data["NewVersion"] = newVersion;         ex.Data["Cause"] = cause;     } }  class SomeCls {     void Migration()     {         //.....         throw ExceptionFactory.OnMigrationErr(oldVersion,)     } } 

这样为每种错误固定了具体需要记录的信息,其中cause就是让程序员记录当下的原因。当然了,你可以重写OnMigrateError来记录另外一种场景。

把异常Exception具体需要的信息,记录在Data这个Dictionary中, 而不是写到Message中的好处,是有助于今后进一步的处理,比如结构化日志。

当然这带来了一个需要关注的问题,就是对Exception.Data的显式处理,因为Exception.ToString()方法,并不打印Data。

在记录日志方面,如果你使用 Serilog, 那么推荐你使用 Serilog.Exceptions, 他对Exception.Data十分友好。

 

至此,我们在细化Exception上,以此递进的使用了 类型—> ErrorCode —> 具体cause

 

3,集中化管理

漫天飞的Exception,不明所以的处理方案,都需要用规则来解决,但是规则需要时刻牢记,所以最靠谱的还是用代码结构来解决。

首先建立ErrCodes静态类,然后建立ExceptionFactory类,这样业务代码里抛出异常都具有throw ExceptionFactory.XXException()这样的形式。

//所有的错误代码 internal static class ErrCodes {     public static ErrCode MigrationErr { get; } = new ErrCode(1, nameof(MigrationErr), "Error happens in Migration.");     //........ other errors }  //所有的Exception都由此生成 internal static class ExceptionFactory {     public static DalException OnMigrateError(int oldVersion, int newVersion, string sql, string cause)     {         DalException ex = new DalException(ErrCodes.MigrationErr);                  ex.Data["OldVersion"] = oldVersion;         ex.Data["NewVersion"] = newVersion;         ex.Data["Cause"] = cause;     }     //.....其他场景 } 

这样,code review时,只要看到有程序员在代码中自己 new XXException,那么就督促他在ExceptionFactory里寻找合适的异常场景或者自己添加。

随着项目积累,即使异常、错误种类众多,大家也只需在ErrCodesExcepionFactory两个类中,总结归纳,重构。

4,参考代码

具体的代码,上传在 Github, 欢迎探讨和指正。

三,预告

在下一篇,我将要探讨下关于捕捉异常的话题(这么简单?)。

 

赞(0) 打赏
未经允许不得转载:张拓的天空 » [.net] 关于Exception的几点思考和在项目中的使用(一)
分享到: 更多 (0)

评论 抢沙发

  • 昵称 (必填)
  • 邮箱 (必填)
  • 网址

专业的IT技术经验分享 更专业 更方便

联系我们本站主机

觉得文章有用就打赏一下文章作者

支付宝扫一扫打赏

微信扫一扫打赏