Javaでカスタム例外を作成する方法をわかりやすく解説

アプリケーションの要件によっては、標準の例外だけでは不十分な場合があり、より意味のある独自の例外を定義したい場面があります。Javaでは、Exceptionクラスを継承することで、自分専用の例外クラス（カスタム例外）を簡単に作成できます。

このように開発者が独自に定義した例外は「ユーザー定義例外」と呼ばれ、一般的にカスタム例外（Custom Exception）という名称でも知られています。

カスタム例外を作成する手順

• CustomExceptionクラスはカスタム例外クラスであり、Exceptionクラスを継承して定義します。
• 例外メッセージを保持するためのローカル変数 message をクラス内に用意します。
• カスタム例外オブジェクトのコンストラクタに文字列引数を渡し、その値をprivateなString型変数 message に格納します。
• toString() メソッドをオーバーライドし、例外メッセージを見やすい形式で出力できるようにします。
• mainメソッド内のtry-catchブロックでCustomExceptionをスローし、例外生成時にメッセージがどのように渡されるかを確認します。catchブロック内では受け取ったメッセージを出力します。

サンプルコード

class CustomException extends Exception {
    String message;
    CustomException(String str) {
        message = str;
    }
    public String toString() {
        return ("Custom Exception Occurred : " + message);
    }
}
public class MainException {
    public static void main(String args[]) {
        try {
            throw new CustomException("This is a custom message");
        } catch(CustomException e) {
            System.out.println(e);
        }
    }
}

実行結果

Custom Exception Occurred : This is a custom message

コードのポイント解説

1. Exceptionクラスの継承

extends Exception とすることで、CustomExceptionはチェックド例外（検査例外）として扱われます。実行時のみ発生させる例外にしたい場合は、代わりに RuntimeException を継承します。

2. コンストラクタでメッセージを受け取る

コンストラクタ経由でエラー内容を表す文字列を受け取ることで、例外発生時に具体的な情報を呼び出し元へ伝えられます。より実践的には、親クラスの super(str) を呼び出す書き方も推奨されます。

3. toString()のオーバーライド

System.out.println(e) のように例外オブジェクトを直接出力すると、自動的に toString() が呼び出されます。ここをオーバーライドすることで、独自の読みやすいメッセージ形式を提供できます。

カスタム例外を使うメリット

• エラーの種類を明確に区別でき、原因の特定が容易になる
• 業務ロジック固有のエラー状況を直感的に表現できる
• catch句を分けることで、例外ごとに適切な処理を実装できる

このように、カスタム例外を活用することで、エラーハンドリングの可読性と保守性を大幅に向上させることができます。