定义可以从工具包API抛出的异常

Question

是否有从工具包API中抛出异常的最佳实践或行业标准？

面向方法的用户是否应该捕获并Exception以某种形式包装,CustomException以便用户只需担心CustomExceptionAPI的出现？

或者只是让那些泡沫破灭的惯例？

我们关注的是能够记录我们的API方法可能引发的所有可能的异常.(例如,如果我们的API方法调用Stream.Write()抛出4或5个异常,除了其他调用方法可能抛出的其他异常之外,我们还必须记录所有这些异常.)

我们想做这样的事情:

public void customerFacingApiMethod(){
   try {
      //api functionality goes here
   } catch (Exception e) {
      throw new CustomException(e);
   }
}

Answer 1

在我看来,API只抛出一个异常类型是一个坏主意.不同异常的好处之一是您可以选择捕获不同类型的异常并以不同方式处理它们.将异常包装到单个异常类型中将删除该工具.

在适当的地方使用框架提供的异常类型,并在适当的情况下为特定情况创建自己的自定义异常类型.最重要的是,请确保为每种方法记录可能抛出的异常.