EffectiveJava学习笔记29：异常（下）-方法抛出异常建立文档、异常注意事项

1.方法抛出异常建立文档

为每个受检异常，尽量都利用javadoc的@throws标签单独声明，记录抛出每个异常的条件。

同时为方法可能抛出的未受检异常，通过@throws标签记录下来，不过不要放到方法的声明中。

如果一个类中有多个方法因为相同原因抛出同一异常，则在该类的文档注释中可以对这个异常建立文档

 

2.异常注意事项

1.捕获信息的处理：异常的细节信息应该是有关联的域的值，但不要包含密码、密钥等信息。

2.对于对象抛出异常，我们仍需要对其保持失败原子性（失败时仍使对象保持被调用前的状态），这里有四种方法获得失败原子性：

• 在执行操作之前检查参数的有效性。
• 调整计算处理过程的顺序，使可能失败的计算部分都在对象状态被修改前发生。
• 在对象的一份临时拷贝上操作，操作完成后，临时拷贝的结果代替对象的内容。
• 编写一段恢复代码。

3.不要忽略异常：指尽量不要让catch为空，因为有些异常需要进行处理，为程序流畅而特地写个抛出来忽略异常的是不可取的。