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)

打印页面