【译】11条Java异常处理的最佳实践

阿杜

发布于 2018-08-06 03:50:54

42600

代码可运行

文章被收录于专栏：阿杜的世界阿杜的世界

运行总次数：0

代码可运行

本文翻译自Top 11 Java Exception Best Practices

在之前关于Java异常的文章中，已经探讨过suppressed exceptions和Java Exceptions Tutorial Java Exceptions Tutorial 两个方面的内容。要想在实际项目中正确处理Java异常，你应该熟练掌握一些Java异常处理的最佳实践。

Java 异常处理的最佳实践

不要在catch语句块中压制异常

public class ExceptionExample {
    public FileInputStream testMethod1(){
        File file = new File("test.txt");
        FileInputStream fileInputStream = null;
        try{
            fileInputStream = new FileInputStream(file);
            fileInputStream.read();
        }catch (IOException e){         
            return null;
        }
        return fileInputStream;
    }
    public static void main(String[] args){
        ExceptionExample instance1 = new ExceptionExample();
        instance1.testMethod1();
    }
}

在异常处理时进行异常压制是非常不好的编程习惯，上面的例子中，无论抛出什么异常都会被忽略，以至没有留下任何问题线索。如果在这一层次不知道如何处理异常，最好将异常重新抛出，由上层决定如何处理异常。

public class ExceptionExample {
    public FileInputStream testMethod1() throws IOException{
        File file = new File("test.txt");
        FileInputStream fileInputStream = null;
        try{
            fileInputStream = new FileInputStream(file);
            fileInputStream.read();
        }catch (IOException e){         
            throw e;
        }
        return fileInputStream;
    }
    public static void main(String[] args) throws IOException{
        ExceptionExample instance1 = new ExceptionExample();
        instance1.testMethod1();
    }
}

要在方法定义分句中定义具体的异常按照public FileInputStream testMethod1() throws Exception{这种写法，表示该方法会抛出所有受检查异常，这不是一个良好的编程习惯。在这种情况下，我们最好抛出足够具体的异常，以便调用者进行合适的捕获和处理，例如public FileInputStream testMethod1() throws IOException{。
捕获具体的异常在调用其他模块时，最好捕获由该模块抛出的具体的异常。如果某个被调用模块抛出了多个异常，那么只捕获这些异常的父类是不好的编程习惯。例如，如果一个模块抛出FileNotFoundException和IOException，那么调用这个模块的代码最好写两个catch语句块分别捕获这两个异常，而不要只写一个捕获Exception的catch语句块。正确的写法如下：

try {
   //some statements
catch(FileNotFoundException e){
//handle here
}
catch(IOException e){
//handle here
}

你最好不要这么写：

try {
   //some statements
catch(Exception e){
//handle here
}

记得在finally语句块中释放资源当你在代码中建立了数据库连接、文件操作符或者其他需要被及时释放的系统资源，如果你没有及时释放这些资源，会影响到系统的性能。为了避免这种情况发生，可以使用Java 7的try(open the resources) {deal with resources}语句，如果你还是习惯这种老式写法，则可以按照如下方式写：

finally {
        try {
            if (con != null) {
                con.close();
            }
            if (stat != null) {
                stat.close();
            }
        } catch (SQLException sqlee) {
            sqlee.printStackTrace();
        }
    }

异常会影响性能

Performance 异常处理的性能成本非常高，每个Java程序员在开发时都应牢记这句话。创建一个异常非常慢，抛出一个异常又会消耗1~5ms，当一个异常在应用的多个层级之间传递时，会拖累整个应用的性能。

仅在异常情况下使用异常；
在可恢复的异常情况下使用异常；

尽管使用异常有利于Java开发，但是在应用中最好不要捕获太多的调用栈，因为在很多情况下都不需要打印调用栈就知道哪里出错了。因此，异常消息应该提供恰到好处的信息。

使用标准异常如果使用内建的异常可以解决问题，就不要定义自己的异常。Java API提供了上百种针对不同情况的异常类型，在开发中首先尽可能使用Java API提供的异常，如果标准的异常不能满足你的要求，这时候创建自己的定制异常。尽可能得使用标准异常有利于新加入的开发者看懂项目代码。
正确得包装异常类型当需要在应用重新抛出异常时，应该正确得包装原始异常，否则会丢失原始异常，例如下面的例子中：

import java.io.IOException;
public class HelloWorld{
     public static void main(String []args) throws Exception{
        try{
            throw new IOException("IOException");    
        }catch (IOException e){
            throw new ExampleException1("Example Exception and " + e.getMessage());
        }
        
     }
}
class ExampleException1 extends Exception{
    public ExampleException1(String s, Throwable t){
        super(s,t);
    }
    public ExampleException1(String s){
        super(s);
    }
}

这个程序的输出为：

Exception in thread "main" ExampleException1: Example Exception and IOException                                                                                          
        at HelloWorld.main(HelloWorld.java:8)

这里发现，IOException的调用栈已经丢失了，因为我们在catch语句块中没有正确包装IOException。若将catch语句块修改成下面这样，这可以发现原始异常的调用栈也被打印出来了。

catch (IOException e){
            throw new ExampleException1("Example Exception",e);
        }

这时候的输出如下：

Exception in thread "main" ExampleException1: Example Exception                                                                                                
        at HelloWorld.main(HelloWorld.java:8)                                                                                                                            
Caused by: java.io.IOException: IOException                                                                                                                              
        at HelloWorld.main(HelloWorld.java:6)

避免在finally语句块中抛出异常

try {
  method();  //here throws first exception
} finally {
  shutdown(); //If finally blockthrew any exception the first exception will be lost forever
}

在上面的这个代码片段中，finally代码块也可能再次抛出异常。如果同时抛出两个异常，则第一个异常的调用栈会丢失。在finally语句块中最好只做打印错误信息或者关闭资源等操作，避免在finally语句块中再次抛出异常。

不要使用异常控制程序的流程不应该使用异常控制应用的执行流程，例如，本应该使用if语句进行条件判断的情况下，你却使用异常处理，这是非常不好的习惯，会严重影响应用的性能。
不要捕获Throwable类在应用中不应捕获Throwable类，Error是Throwable类的子类，当应用抛出Errors的时候，一般都是不可恢复的情况。
为异常记录合适的文档为应用中定义的异常定义合适的文档，如果你写了一个自定义的异常却没有文档，其他开发者会不清楚这个异常的含义，为你定义的异常配备对应的文档是一个非常好的习惯。

本文参与腾讯云自媒体同步曝光计划，分享自作者个人站点/博客。

原始发表：2016.03.04 ，如有侵权请联系 cloudcommunity@tencent.com 删除

java