JavaのfillInStackTrace()メソッドを使うべき場面とは？使い方を実例で解説

fillInStackTrace()は、JavaのThrowableクラスに定義されている重要なメソッドの一つです。スタックトレースは、例外が「どこで」スローされたのかを正確に特定するための手がかりになります。しかし、一度キャッチした例外を別の場所で再スロー（リスロー）したい場合、そのまま投げ直すと元のスタックトレースが引き継がれてしまい、実際に再スローされた位置が分からなくなってしまいます。

こうしたシナリオで活躍するのがfillInStackTrace()メソッドです。このメソッドを呼び出すと、呼び出し時点での新しいスタックトレースが生成されるため、「例外がどこで再スローされたか」を正確に把握できるようになります。

構文

public Throwable fillInStackTrace()

このメソッドは引数を受け取らず、呼び出し元のThrowableインスタンス自身を返します。戻り値が自分自身であるため、throw e.fillInStackTrace();のように一行で記述できます。

使用例

public class FillInStackTraceTest {
    public static void method1() throws Exception {
        throw new Exception("This is thrown from method1()");
    }
    public static void method2() throws Throwable {
        try {
            method1();
        } catch(Exception e) {
            System.err.println("Inside method2():");
            e.printStackTrace();
            throw e.fillInStackTrace(); // fillInStackTrace()メソッドの呼び出し
        }
    }
    public static void main(String[] args) throws Throwable {
        try {
            method2();
        } catch (Exception e) {
            System.err.println("Caught Inside Main method()");
            e.printStackTrace();
        }
    }
}

実行結果

Inside method2():
java.lang.Exception: This is thrown from method1()
        at FillInStackTraceTest.method1(FillInStackTraceTest.java:3)
        at FillInStackTraceTest.method2(FillInStackTraceTest.java:7)
        at FillInStackTraceTest.main(FillInStackTraceTest.java:18)
Caught Inside Main method()
java.lang.Exception: This is thrown from method1()
        at FillInStackTraceTest.method2(FillInStackTraceTest.java:12)
        at FillInStackTraceTest.main(FillInStackTraceTest.java:18)

実行結果のポイント

最初の出力では、method2()内で例外をキャッチした時点のスタックトレースに、発生元であるmethod1()の情報（3行目）が含まれています。一方、fillInStackTrace()を呼び出して再スローされた例外をmain()メソッドでキャッチすると、スタックトレースはmethod2()の12行目（再スロー地点）から始まり、method1()の情報は消えています。

このように、fillInStackTrace()を使えば「例外がどこで再スローされたか」という新しい位置情報をスタックトレースに記録できます。デバッグ時に例外の伝播経路を追いたい場合や、例外をラップして上位層へ通知したい場合などに有効なテクニックです。

補足：元の例外情報を残したい場合

fillInStackTrace()は既存のスタックトレースを上書きするため、元の発生位置の情報は失われます。もし元の例外の原因も保持したい場合は、initCause()メソッドで原因となる例外を設定するか、例外をラップする（causeとして渡す）方法を検討しましょう。目的に応じて両者を使い分けることが、堅牢な例外処理設計の鍵となります。