Java 9のStackWalkerで各スタック要素にアクセスする方法を解説

Java 9では、Thread.getStackTrace()、Throwable.getStackTrace()、SecurityManager.getClassContext()の代替手段として、StackWalker APIが新たに導入されました。このAPIは、必要なスタックフレームだけを走査・生成（マテリアライズ）する仕組みを提供しており、追加のスタックフレームが必要になった時点で初めて取得する「遅延アクセス」により、従来よりも効率的なスタックトレース処理を実現します。

一方、例外のスタックトレースに含まれる各スタック要素へ個別にアクセスしたい場合は、Throwableクラスが提供するgetStackTrace()メソッドを使用できます。このメソッドは、StackTraceElementオブジェクトの配列を返し、呼び出された順序（最も新しいフレームから古いフレームへ）でスタック情報を格納しています。

サンプルコード

以下の例では、複数のクラスをまたいだメソッド呼び出しの中で意図的にゼロ除算を発生させ、キャッチした例外からgetStackTrace()を使ってスタック要素を1行ずつ出力しています。

import java.util.*;

// Test1クラス
class Test1 {
    public void test() throws Exception {
        Test2 test2 = new Test2();
        test2.test();
    }
}

// Test2クラス
class Test2 {
    public void test() throws Exception {
        System.out.println(1/0);
    }
}

// メインクラス
public class StackWalkerTest {
    public static void main(String args[]) {
        Test1 test1 = new Test1();
        try {
            test1.test();
        } catch(Exception e) {
            Arrays.stream(e.getStackTrace()).forEach(System.out::println);
        }
    }
}

ここではArrays.stream()とforEach()を組み合わせることで、返されたStackTraceElementの配列をストリームとして扱い、簡潔に標準出力へ表示しています。

実行結果

Test2.test(StackWalkerTest.java:14)
Test1.test(StackWalkerTest.java:7)
StackWalkerTest.main(StackWalkerTest.java:23)

出力を見ると、実際に例外が発生したTest2.test()から呼び出し元のTest1.test()、さらにエントリポイントであるmain()まで、スタックフレームが上から順に表示されていることがわかります。各要素にはクラス名・メソッド名・ソースファイル名・行番号が含まれており、デバッグやログ出力の際に有用です。大量のスタックフレームを扱うパフォーマンス重視のケースでは、このような一括取得ではなく、前述のStackWalkerによる遅延アクセスの活用が推奨されます。