Javaでカスタム非チェック例外（Unchecked Exception）を作成する方法

Javaでは、RuntimeExceptionクラスを継承することで、カスタムの非チェック例外（Unchecked Exception）を作成できます。

非チェック例外は、ErrorクラスまたはRuntimeExceptionクラスを継承する例外です。多くのプログラマーは、これらの例外がプログラム実行中に回復が期待できない種類のエラーを表すため、アプリケーション内で明示的に処理しない方針を取ることがあります。非チェック例外がスローされる場合、その原因は通常、コードの誤用、nullの受け渡し、あるいは不正な引数の指定などです。

基本構文

public class MyCustomException extends RuntimeException {
    public MyCustomException(String message) {
        super(message);
    }
}

非チェック例外の実装ポイント

カスタム非チェック例外の実装方法は、チェック例外（Checked Exception）の場合とほぼ同じです。唯一の違いは、ExceptionクラスではなくRuntimeExceptionクラスを継承するという点です。

実用的なカスタム例外クラスには、以下のような複数のコンストラクターを用意しておくと便利です。

• メッセージを受け取るコンストラクター： 例外スロー時に独自のエラーメッセージを指定したい場合に使用します（例： throw new CustomUncheckedException("カスタム非チェック例外")）。
• 原因例外（Throwable）を受け取るコンストラクター： catchブロック内で捕捉した例外をラップして再スローしたい場合に使用します。
• メッセージと原因例外の両方を受け取るコンストラクター： エラーメッセージとスタックトレースの情報を併せて保持したい場合に使用します。

実装例

public class CustomUncheckedException extends RuntimeException {

    /*
     * 例外スロー時にカスタムメッセージを指定したい場合に使用
     * 例： throw new CustomUncheckedException("Custom Unchecked Exception");
     */
    public CustomUncheckedException(String message) {
        // superを呼び出すことで、すべての親クラスのコンストラクターが実行され、
        // 完全なスタックトレースが生成されます。
        super(message);
    }

    /*
     * catchブロック内で発生した例外をラップして再スローしたい場合に使用
     * 例： catch(ArrayIndexOutOfBoundsException e) {
     *          throw new CustomUncheckedException(e);
     *      }
     */
    public CustomUncheckedException(Throwable cause) {
        // 適切な親クラスのコンストラクターを呼び出します。
        super(cause);
    }

    /*
     * メッセージと原因例外の両方が必要な場合に使用
     * 例： catch(ArrayIndexOutOfBoundsException e) {
     *          throw new CustomUncheckedException(e, "File not found");
     *      }
     */
    public CustomUncheckedException(String message, Throwable throwable) {
        // 適切な親クラスのコンストラクターを呼び出します。
        super(message, throwable);
    }
}

まとめ

カスタム非チェック例外を作成する際は、RuntimeExceptionを継承し、用途に応じて複数のコンストラクターを定義しておくことで、メッセージの付与や例外のラップなど、柔軟なエラーハンドリングが可能になります。これにより、呼び出し元でtry-catchによる明示的な処理を強制されず、必要に応じてのみ例外を捕捉できる、クリーンなAPI設計を実現できます。