Java カスタム例外の作成：ステップバイステップガイド

Java のカスタム例外とは？

カスタム例外は、java.lang.Exception（非チェック例外の場合は RuntimeException）を継承したユーザー定義クラスです。独自の例外型を作成することで、ドメイン固有のエラー状況を表現し、エラー処理を明確にし、呼び出し元により豊かなコンテキストを提供できます。

実践では Exception のすべてのメソッドをオーバーライドする必要は稀です。最も一般的なカスタマイズは、エラーコード、メッセージ、根本原因を受け取るコンストラクタの追加です。以下は必須ステップを示す簡潔な例です。

例：カスタム例外の定義とスロー

ステップ 1 – 例外クラスの作成

public class MyException extends Exception {
    private final int errorCode;
    public MyException(int errorCode) {
        super("Error code: " + errorCode);
        this.errorCode = errorCode;
    }
    @Override
    public String toString() {
        return "MyException{errorCode=" + errorCode + "}";
    }
}

ステップ 2 – クライアントコードで例外を使用

public class JavaExceptionDemo {
    public static void main(String[] args) {
        try {
            // 失敗条件をシミュレート
            throw new MyException(2);
        } catch (MyException e) {
            System.out.println(e);
        }
    }
}

プログラムを実行すると以下の出力が得られます：

Java カスタム例外の作成：ステップバイステップガイド

上記例では throw キーワードが MyException インスタンスを作成し、直ちに一致する最寄りの catch ブロックに渡します。オーバーライドされた toString() メソッドにより、表示メッセージが有益になります。

重要ポイント

Exception（または RuntimeException）を継承してカスタム型を作成
スーパークラスに意味のあるメッセージを渡すコンストラクタを提供
デバッグ出力を明確にするため toString() や getMessage() をオーバーライド
throw で例外を発生させ、処理またはさらに伝播できる場所で catch

これらのプラクティスに従うことで、ドメイン固有のエラー状況を優雅に処理する、より保守性が高く自己文書化された Java コードが書けます。

Java 例外処理マスター：try-catch、finally、クラス階層 Java throws キーワード完全理解：例とベストプラクティス

Java