Guava Throwables類


Throwable類提供了相關的Throwable介面的實用方法。

類宣告

以下是com.google.common.base.Throwables類的宣告:

public final class Throwables
   extends Object

類方法

S.N. 方法及說明
1 static List<Throwable> getCausalChain(Throwable throwable)
獲取一個Throwable的原因鏈的列表。
2 static Throwable getRootCause(Throwable throwable)
返回丟擲的最裡面的原因。
3 static String getStackTraceAsString(Throwable throwable)
返回包含toString()的結果字串,隨後完整丟擲,遞回的堆疊跟蹤。
4 static RuntimeException propagate(Throwable throwable)
傳播丟擲原樣如果RuntimeException或Error是一個範例,否則作為最後的報告,把它包裝在一個RuntimeException,然後傳播。
5 static <X extends Throwable> void propagateIfInstanceOf(Throwable throwable, Class<X> declaredType)
傳播丟擲物件完全按原樣,當且僅當它是declaredType的一個範例。
6 static void propagateIfPossible(Throwable throwable)
傳播丟擲物件完全按原樣,當且僅當它是RuntimeException或Error的一個範例。
7 static <X extends Throwable> void propagateIfPossible(Throwable throwable, Class<X> declaredType)
傳播丟擲物件完全按原樣,當且僅當它是RuntimeException,錯誤或的declaredType的一個範例。
8 static <X1 extends Throwable,X2 extends Throwable>void propagateIfPossible(Throwable throwable, Class<X1> declaredType1, Class<X2> declaredType2)
傳播丟擲物件完全按原樣,當且僅當它是RuntimeException,Error,declaredType1或declaredType2的一個範例。

繼承的方法

這個類繼承了以下類方法:

  • java.lang.Object

Throwables範例

建立使用所選擇的任何編輯器下面的java程式,比如 C:/> Guava

GuavaTester.java
import java.io.IOException;

import com.google.common.base.Objects;
import com.google.common.base.Throwables;

public class GuavaTester {
   public static void main(String args[]){
      GuavaTester tester = new GuavaTester();
      try {
         tester.showcaseThrowables();
      } catch (InvalidInputException e) {
         //get the root cause
         System.out.println(Throwables.getRootCause(e));
      }catch (Exception e) {
         //get the stack trace in string format
         System.out.println(Throwables.getStackTraceAsString(e));				
      }

      try {
         tester.showcaseThrowables1();			
      }catch (Exception e) {
         System.out.println(Throwables.getStackTraceAsString(e));				
      }
   }

   public void showcaseThrowables() throws InvalidInputException{
      try {
         sqrt(-3.0);			
      } catch (Throwable e) {
         //check the type of exception and throw it
         Throwables.propagateIfInstanceOf(e, InvalidInputException.class);		
         Throwables.propagate(e);
      }	
   }

   public void showcaseThrowables1(){
      try {			
         int[] data = {1,2,3}; 
         getValue(data, 4);			
      } catch (Throwable e) {        
         Throwables.propagateIfInstanceOf(e, IndexOutOfBoundsException.class);		
         Throwables.propagate(e);
      }	
   }

   public double sqrt(double input) throws InvalidInputException{
      if(input < 0) throw new InvalidInputException();
      return Math.sqrt(input);
   }

   public double getValue(int[] list, int index) throws IndexOutOfBoundsException {
      return list[index];
   }

   public void dummyIO() throws IOException {
      throw new IOException();
   }
}

class InvalidInputException extends Exception {
}

驗證結果

使用javac編譯器編譯如下類

C:\Guava>javac GuavaTester.java

現在執行GuavaTester看到的結果

C:\Guava>java GuavaTester

看到結果。

InvalidInputException
java.lang.ArrayIndexOutOfBoundsException: 4
	at GuavaTester.getValue(GuavaTester.java:52)
	at GuavaTester.showcaseThrowables1(GuavaTester.java:38)
	at GuavaTester.main(GuavaTester.java:19)