Java Throwable addSuppressed()用法及代码示例

Throwable类的addSuppressed？(Throwable异常)方法用于将异常附加到为了传递此异常而被抑制的异常之后。此方法是线程安全的方法。通常由try-catch子句调用此方法。除非通过构造函数禁用，否则将启用Throwable的抑制行为；并且当禁用抑制时，此方法除了验证其参数外不执行其他操作。

在try-finally块的默认行为中，我们有两个异常，原始的异常被抑制，而finally块的异常被显示。在某些情况下，使用finally块来关闭资源，在这种情况下，我们希望看到原始异常，除了final块中的某些异常，它关闭了资源并失败了，因此我们可以添加通过这种方法。

如果存在多个同级例外，并且只能传播一个，则可以使用此方法来推广该方法。

用法:

public final void addSuppressed?(Throwable exception)

参数：此方法仅接受一个我们要添加为抑制异常的参数异常。

返回值：此方法不返回任何内容。

异常：此方法引发以下异常：

IllegalArgumentException：如果此抛出抛出异常；一个可抛物不能压制自己。
NullPointerException：如果exception为null。

以下示例程序旨在说明addSuppressed？()方法：

示例1:

// Java program to demonstrate 
// the addSuppressed() Method. 
  
import java.io.*; 
  
class GFG { 
  
    // Main Method 
    public static void main(String[] args) 
        throws Exception 
    { 
  
        try { 
  
            testException(); 
        } 
  
        catch (Throwable e) { 
  
            // get StackTraceElements 
            Throwable[] suppExe 
                = e.getSuppressed(); 
  
            // print element of suppExe 
            for (int i = 0; i < suppExe.length; i++) { 
  
                System.out.println("Suppressed Exceptions:"); 
                System.out.println(suppExe[i]); 
            } 
        } 
    } 
  
    // method which throws Exception 
    public static void testException() 
        throws Exception 
    { 
  
        // creating a suppressed Exception 
        Exception 
            suppressed 
            = new ArithmeticException(); 
  
        // creating a IOException object 
        final Exception exe = new Exception(); 
  
        // adding suppressed Exception 
        // using addSuppressed method 
        exe.addSuppressed(suppressed); 
  
        // throwing IOException 
        throw exe; 
    } 
}

输出：

Suppressed Exceptions:
java.lang.ArithmeticException

示例2:

// Java program to demonstrate 
// the addSuppressed() Method. 
  
import java.io.*; 
  
class GFG { 
  
    // Main Method 
    public static void main(String[] args) 
        throws Exception 
    { 
  
        try { 
  
            testException(); 
        } 
  
        catch (Throwable e) { 
  
            // get StackTraceElements 
            Throwable[] suppExe 
                = e.getSuppressed(); 
  
            System.out.println("Suppressed Exceptions:"); 
  
            // print element of suppExe 
            for (int i = 0; i < suppExe.length; i++) { 
  
                System.out.println(suppExe[i]); 
            } 
        } 
    } 
  
    // method which throws Exception 
    public static void testException() 
        throws Exception 
    { 
  
        // creating a IOException object 
        final Exception exe = new Exception(); 
  
        // adding suppressed Exception 
        // using addSuppressed method 
        exe.addSuppressed(new ArithmeticException()); 
        exe.addSuppressed(new IndexOutOfBoundsException()); 
        exe.addSuppressed(new ClassNotFoundException()); 
        exe.addSuppressed(new IOException()); 
  
        // throwing IOException 
        throw exe; 
    } 
}

输出：

Suppressed Exceptions:
java.lang.ArithmeticException
java.lang.IndexOutOfBoundsException
java.lang.ClassNotFoundException
java.io.IOException

示例3:显示IllegalArgumentException

// Java program to demonstrate 
// Exception IllegalArgumentException 
// the addSuppressed() Method. 
  
import java.io.*; 
  
class GFG { 
  
    // Main Method 
    public static void main(String[] args) 
        throws Exception 
    { 
  
        try { 
  
            ArithmeticException 
                e 
                = new ArithmeticException(); 
            e.addSuppressed(e); 
        } 
  
        catch (Throwable e) { 
            System.out.println("Exception:" + e); 
        } 
    } 
}

输出：

Exception:java.lang.IllegalArgumentException:
 Self-suppression not permitted

示例4:显示NullPointerException

// Java program to demonstrate 
// Exception NullPointerException 
// the addSuppressed() Method. 
  
import java.io.*; 
  
class GFG { 
  
    // Main Method 
    public static void main(String[] args) 
        throws Exception 
    { 
  
        try { 
  
            ArithmeticException 
                e 
                = new ArithmeticException(); 
            e.addSuppressed(null); 
        } 
  
        catch (Throwable e) { 
            System.out.println("Exception:" + e); 
        } 
    } 
}

输出：

Exception:java.lang.NullPointerException:
 Cannot suppress a null exception.

参考文献：

相关用法

注：本文由纯净天空筛选整理自AmanSingh2210大神的英文原创作品 Throwable addSuppressed() method in Java with Examples。非经特殊声明，原始代码版权归原作者所有，本译文未经允许或授权，请勿转载或复制。