Java Throwable 類

簡介

Java Throwable 類是 Java 語言中所有錯誤和異常的超類。只有此類的例項物件（或其子類的例項物件）才能被 Java 虛擬機器丟擲，或者可以透過 Java 的 throw 語句丟擲。

類宣告

以下是 java.lang.Throwable 類的宣告：

public class Throwable
   extends Object
      implements Serializable

類建構函式

序號	建構函式及描述
1	Throwable() 使用 null 作為其詳細資訊訊息構造一個新的可丟擲物件。
2	Throwable(String message) 使用指定的詳細資訊訊息構造一個新的可丟擲物件。
3	Throwable(String message, Throwable cause) 使用指定的詳細資訊訊息和原因構造一個新的可丟擲物件。
4	Throwable(Throwable cause) 使用指定的原因和詳細資訊訊息 (cause==null ? null : cause.toString())（通常包含 cause 的類和詳細資訊訊息）構造一個新的可丟擲物件。

類方法

序號	方法及描述
1	Throwable fillInStackTrace() 此方法填充執行堆疊跟蹤。
2	Throwable getCause() 此方法返回此可丟擲物件的原因，如果原因不存在或未知則返回 null。
3	String getLocalizedMessage() 此方法建立此可丟擲物件的本地化描述。
4	String getMessage() 此方法返回此可丟擲物件的詳細資訊字串。
5	StackTraceElement[] getStackTrace() 此方法提供對 printStackTrace() 列印的堆疊跟蹤資訊的程式設計訪問。
6	Throwable initCause(Throwable cause) 此方法將此可丟擲物件的原因初始化為指定的值。
7	void printStackTrace() 此方法將此可丟擲物件及其回溯列印到標準錯誤流。
8	void printStackTrace(PrintStream s) 此方法將此可丟擲物件及其回溯列印到指定的列印流。
9	void printStackTrace(PrintWriter s) 此方法將此可丟擲物件及其回溯列印到指定的列印寫入器。
10	void setStackTrace(StackTraceElement[] stackTrace) 此方法設定將由 getStackTrace() 返回並由 printStackTrace() 和相關方法列印的堆疊跟蹤元素。
11	String toString() 此方法返回此可丟擲物件的簡短描述。

繼承的方法

此類繼承自以下類的方法：

java.lang.Object

示例：列印 Throwable 的堆疊跟蹤

以下示例演示了 Java Throwable printStackTrace() 方法的用法。我們定義了一個方法 raiseException()，它在設定堆疊跟蹤後丟擲一個 Throwable。在 main 方法中，呼叫 raiseException() 方法，並在 catch 塊中檢索異常堆疊跟蹤並使用 printStackTrace() 方法列印。

package com.tutorialspoint;

public class ThrowableDemo {

   public static void main(String[] args) {

      try {
         raiseException();
      } catch(Throwable e) {
         // prints stacktrace for this Throwable Object
         e.printStackTrace();
      }
   }
  
   public static void raiseException() throws Throwable {

      Throwable t = new Throwable("This is new Exception...");
      StackTraceElement[] trace = new StackTraceElement[] {
         new StackTraceElement("ClassName","methodName","fileName",5)
      };

      // sets the stack trace elements
      t.setStackTrace(trace);
      throw t;
   }
}

輸出

讓我們編譯並執行上述程式，這將產生以下結果：

java.lang.Throwable: This is new Exception...
at ClassName.methodName(fileName:5)

列印頁面