12.例外処理で想定外の事態に強いシステムにする

新人エンジニア研修で知っておきたい例外の使い方

なぜ、例外の理解が重要なのか、その理由

この記事では、弊社の新人エンジニア研修の参考にJavaを解説します。

前回はカプセル化について解説しました。今回は例外処理について解説します。例外処理も継承を巧みに使った仕組みの一例ですので復習にもなると思います。

この短い新人エンジニア研修の中でも例外がいくつか出てきました。

3.演算子のところで紹介したArithmeticException(標準API)

6.配列の作成と使用のところで紹介したArrayIndexOutOfBoundsException(標準API)

9.インスタンスの活用のところで紹介したNullPointerException(標準API)

10.継承（拡張）のところで紹介したClassCastException(標準API)

等がありましたね。

例外とは、人間に向けたプログラムからのトラブル報告書です。このままでは処理を継続できないという報告です。

例えばあなたがお使いのゲームアプリが突然意味不明なメッセージを表示して落ちてしまったらどうでしょうか？その上、何時間もかけて蓄積したセーブデータが残っていないとしたら。。。

エラーが発生しても続行するか、重要なデータを保存してから適切に終了するようにプログラミングしないといけません。

そのような処理を例外処理といいます。

例外が存在しなかった時代のエラー処理は大変でした。深い階層で起こったエラーを一生懸命バケツリレーで呼び出し元の処理に伝えていたのです。メソッドが返せる値は一つだけですから、大した情報も伝えられませんでした。エラーが発生した時にだけ投げる例外という仕組みができたおかげで、エラー時の処理が画期的に改善されたのです。

この章のゴールは以下のように例額処理を組み込んだコードが書けることです。

package chap12;

import java.util.InputMismatchException;
import java.util.Scanner;

public class KazuateTryCatchTest {
	public static void main(String[] args) {

		System.out.println("0-9の整数で数を当ててください!");

		Scanner sc = new Scanner(System.in);
		int guess = -1;

		try {
			guess = sc.nextInt(); // ユーザーの入力を取得（整数以外だと例外発生）
			
			// 正常に整数が入力された場合の処理
			Kazuate game = new Kazuate();
			game.checkAnswer(guess);

			System.out.println(game.getMessage());
			System.out.println("答えは " + game.getAnswer());

		} catch (InputMismatchException e) {
			System.out.println("整数を入力してください！");
		} finally {
			sc.close(); // Scannerは必ず閉じる
		}
	}
}

1.try～catch

例外処理の構文を以下に示します。

＜構文＞

では、順番に解説していきます。

以下のExample01はtry～catchを解説するプログラムです。

package chap12;

public class Example01 {

    public static void main(String[] args) {
        try {
            System.out.println(5 / 0);
        } catch (ArithmeticException e) {
            System.out.println("例外が発生しました");
            System.out.println(e);
        }
        System.out.println("このプログラムを終了します");
    }
}

＜実行結果＞

このように、例外が発生する可能性がある処理をtryブロックで囲みます。英語の【try】には元来、「上手くいくかどうか分からないが試してみる」という意味があります。

catchブロックには例外が発生した時の処理を書きます。例外をキャッチするという文字通りの意味です。

catchの後ろの（）の中には、あたかもメソッドの仮引数のように例外の型と変数を書きます。変数名は何でも良いですが、【error】の頭文字eや【exception】のexを使うのが慣例となっています。変数eの中身をコンソール出力すると例外の内容（原因）が分かります。

もし、例外が発生したらcatchブロックの処理が実行されるのですが、そうするとIF文との違いに迷う新人エンジニアの方がいます。一般的なガイドラインとして、プログラムの制御フローの分岐や条件に基づく処理は、if文を使用し、予期しないエラーへの対応やエラーハンドリングは、例外処理を使用することが推奨されます。

また、例外が発生した時の処理といっても何か有効なトラブル対応処理が書けるわけではありません。最も多い処理は人間にトラブルの内容を知らせてログに記録することです。次にありえるのはデータベースやファイルをちゃんと閉じる処理です。

例外処理がなければここでプログラムが中断するところですが、今回は中断することなく最後まで終えることができています。

また、エラー処理が主要なロジックから分離されている点にも注目してください。tryブロックで囲まれた主要なロジックとcatchブロックで囲まれたエラー処理のコードが分かれているため、コードの主要な目的が理解しやすくなっています。

2.finally句の意義

finallyブロックにかかれた処理は例外発生の有無を問わず必ず実行されます。ファイルのクローズやデータベースのクローズに使うというのがfinallyブロックの典型的な利用例です。

以下のExample02はfinally句を説明するプログラムです。

package chap12;

public class Example02 {

    public static void main(String[] args) {
        try {
            System.out.println(Integer.parseInt("2byte"));
            System.out.println("例外発生の有無にかかわらず実行したい処理です");
        } catch (NumberFormatException e) {
            System.out.println(e);
        }
        System.out.println("このプログラムを終了します");
    }
}

＜実行結果＞

例外が発生すると処理は一気にcatchブロックまで飛んでしまうため、８行目の処理が実行されません。こんな時はどうしたらよいのでしょうか？

例えば以下のように同じ処理を２回記述するコードは冗長です。

package chap12;

public class Example03 {

    public static void main(String[] args) {
        try {
            System.out.println(Integer.parseInt("2byte"));
            System.out.println("例外発生の有無にかかわらず実行したい処理です");
        } catch (NumberFormatException e) {
            System.out.println("例外発生の有無にかかわらず実行したい処理です");
            System.out.println(e);
        }
        System.out.println("このプログラムを終了します");
    }
}

以下のようにfinallyブロックを追加すれば繰り返しの記述を避けることができます。

package chap12;

public class Example04 {

    public static void main(String[] args) {
        try {
            System.out.println(Integer.parseInt("2byte"));
        } catch (NumberFormatException e) {
            System.out.println(e);
        } finally {
            System.out.println("例外発生の有無にかかわらず実行したい処理です");
        }
        System.out.println("このプログラムを終了します");
    }
}

＜実行結果＞

finallyブロックにかかれた処理は例外発生の有無を問わず必ず実行されます。

当社の新人エンジニア研修の範囲でのfinallyの活用場面としては、データベース処理において例外が発生した場合に、データベースとの接続をクローズするという使い方があります。この点は機会があれば「Javaからデータベースのデータを活用する」というテーマでご紹介したいと思います。それまではfinally句の存在意義は理解できないと思います。

3.複数例外のキャッチ

起こりうる複数の例外の場合に分けて、以下のように例外処理を書き分けることができます。

package chap12;

public class Example05 {

    public static void main(String[] args) {
        try {
            int[] numbers = { 1, 2, 3 };
            numbers[3] = 4;
            System.out.println(5 / 0);
            System.out.println(Integer.parseInt("2byte"));
        } catch (ArithmeticException e) {
            System.out.println(e);
        } catch (ArrayIndexOutOfBoundsException e) {
            System.out.println(e);
        } catch (NumberFormatException e) {
            System.out.println(e);
        }
        System.out.println("このプログラムを終了します");
    }
}

＜実行結果＞

このようにtry～catchは最初に発生した例外を捕捉します。

4.try-with-resourcesを使うとリソースを閉じるコードを書かなくて良い

以前、繰り返しのところで以下のように数え上げ回数をキーボード入力するプログラムを作成しました。

この時に、try-with-resourcesという構文を使っていました。try-with-resourcesは、ファイルやデータベース、ネットワーク接続などのシステムリソースを使用する際に非常に有用です。

これらのリソースは、使用後に閉じる必要がありますが、従来のtry-catch-finallyブロックを使用するとコードが冗長になります。try-with-resourcesを使用すると、リソースが自動で閉じられるため、プログラマはリソースを閉じるコードを書く必要がありません。

以下のExample06はtry-with-resourcesを使っているためScannerをcloseしなくて済んでいます

package chap12;

import java.util.Scanner;

public class Example06 {
	public static void main(String[] args) {
		System.out.println("何回数え上げますか?");

		try (Scanner sc = new Scanner(System.in)) {
			int count = sc.nextInt();

			int i = 0;
			while (i < count) {
				System.out.println(i);
				i++;
			}
		}
	}
}

try-with-resourcesでは、try文の直後に括弧を使用して、クローズ可能なリソースを宣言します。（このリソースはAutoCloseableまたはCloseableインターフェースを実装している必要があります）

tryブロックが終了したら、自動的にclose()メソッドが呼び出され、リソースが安全に閉じられます。

もしも、try-with-resourcesを使わないと以下のようにfinally句が必要になり冗長なコードになります。かなりコードが簡略化されていたのがお分かりになると思います。

package chap12;

import java.util.Scanner;

public class Example07 {
	public static void main(String[] args) {
		Scanner sc = null;
		System.out.println("何回数え上げますか?");

		try {
			sc = new Scanner(System.in);
			int count = sc.nextInt();

			int i = 0;
			while (i < count) {
				System.out.println(i);
				i++;
			}
		} finally {
			if (sc != null) {
				sc.close();
			}
		}
	}
}

5.例外クラスの体系

例によってIDEを使いArithmeticExceptionクラスから、スーパークラスをさかのぼって行きましょう。

まずはArithmeticExceptionクラスの40行目をみてください。

public class ArithmeticException extends RuntimeException {（中略）

Java17標準API

となっていてRuntimeExceptionクラスのサブクラスであることが分かりました。

では次にRuntimeExceptionクラスの43行目を見てスーパークラスを探します。

public class RuntimeException extends Exception {（中略）

Java17標準API

となっています。

このExceptionクラスがすべての例外クラスの親玉（？）です。

さらにExceptionクラスの定義を45行目に見ると以下のようにThrowableクラスのサブクラスとして宣言されています。

public class Exception extends Throwable {（中略）

Java17 標準API

【Throwable:投げられる】という意味のクラスですね。

このThrowableクラス（標準API）を調べると以下の記述があります。

Throwableクラスは、Java言語のすべてのエラーと例外のスーパー・クラスです。

そして、Throwableのスーパークラスは例のObjectクラスです。

Throwableの直系の既知のサブクラスについて以下の記述があります。

クラスThrowable

• java.lang.Object
  • java.lang.Throwable

• すべての実装されたインタフェース:

  Serializable

  直系の既知のサブクラス:

  Error, Exception

Exceptionクラスには兄弟分のErrorクラスがあるということですね。つまり、ここまでを図示すると下図のようになります。

この中でまず抑えるべきはその例外クラスが、RuntimeExceptionクラスのサブクラスであるか、それ以外のExceptionクラスのサブクラスかという区別です。RuntimeExceptionのサブクラスである非チェック例外は、コンパイル時にtry～catchの強制はされません。しかし、適切なエラーハンドリングを行うことが推奨されます。

例えば、これまでも配列を使ったときにtry～catchを書かなくても良かったですね。もし、例外が起きる可能性のある全てのコードにtry～catchを強制していたらJavaプログラムは例外処理で埋め尽くされてしまうからです。

try～catchの記述が任意である例外を非チェック例外（非検査例外）といいます。

※あるいは実行時例外ともいいます。RuntimeExceptionの直訳です。

ちなみに、今までご紹介してきたArithmeticException、ArrayIndexOutOfBoundsException、NullPointerException、ClassCastException、NumberFormatExceptionはすべてRuntimeExceptionクラスのサブクラスであり、非チェック例外です。

なお、Errorクラスが発生する可能性のあるコードはtry～catchで囲むべきではありません。

Errorクラス(標準API)の説明を見ると

ErrorはThrowableのサブクラスで、通常のアプリケーションであればキャッチすべきではない重大な問題を示します。そうしたエラーの大部分は異常な状態です。

とあります。

例えば、Java仮想マシンが壊れているとかメモリ不足等の事態です。いかんともしがたいわけです。

過去の記事の中では、１回目のところでStackOverflowErrorというのを見ましたがあれは、ErrorクラスのサブクラスのVirtualMachineErrorクラスのサブクラスです。

Exceptionクラスのサブクラスであって、RuntimeExceptionクラスのサブクラスでないクラスは、すべてチェック例外（検査例外）ですのでtry～catchで囲む必要があります。

try～catchが強制されるチェック例外として当社の研修内容に関連するものとしては、例えばSQLExceptionがあります。

ただ、これはデータベースに関連した例外ですので、そこでお話ししたいと思います。

上記の例外クラスの体系を見て明らかなように以下のサンプルプログラムは意図した通りの処理を行います。

package chap12;

public class Example08 {

	public static void main(String[] args) {
		try {
			int[] numbers = { 1, 2, 3 };
			numbers[3] = 4;
			System.out.println(5 / 0);
			System.out.println(Integer.parseInt("2byte"));
		} catch (Exception e) {
			System.out.println(e);
		}
		System.out.println("このプログラムを終了します");
	}
}

＜実行結果＞

このように全ての例外クラスはそのスーパークラスであるExceptionクラス型で捕捉できるようになっています。ただし、プログラマの意図が不明瞭になりがちですので手抜きで記述することは避けた方が良いでしょう。

※IDEからも複数のキャッチ句に置換しうることを提案されると思います。

Exceptionクラス型は、具体的な例外を全てcatchして、それでも発生するかもしれない例外を補足する時に使います。

では、ここまでは例外をキャッチする側の処理を見てきましたので、逆に例外をスローする側の処理がどうなっているのかを探検してみましょう。

6.throwsキーワード

ところですべての例外をキャッチすべきでしょうか？　

そのメソッドでは適切な処理ができない場合はどうしたらいいでしょうか？

呼び出し元のメソッドに処理を委ねるべき場合もあるのではないでしょうか？

例外を呼び出し元に投げて処理を任せることができます。

一例として、IntegerクラスのparseInt()メソッドの定義の先頭部分である620行目以降をご覧ください。

        public static int parseInt(String s, int radix)
                throws NumberFormatException
        {
        /*
         * WARNING: This method may be invoked early during VM initialization
         * before IntegerCache is initialized. Care must be taken to not use
         * the valueOf method.
         */

        if (s == null) {
            throw new NumberFormatException("Cannot parse null string");
        }

Java17 標準API

まず、メソッド名（）の後ろの記述をご覧下さい。

このparseInt()メソッドはNumberFormatExceptionを投げる可能性のあることを示しています。そして、例えばnullを受け取ったらNumberFormatExceptionを投げるということを620行目で示しています。

仮にparseIntの内部で例外をキャッチして無理やり続行したらどうなるでしょうか？

例えば…

if (s == null) {
    try {
        // 無理に0を返す
        return 0;
    } catch (Exception e) {
        // ログだけ出して無視
    }
}

こんな実装をしてしまうと、

• 本来エラーで気づけるはずのバグが隠れてしまう
• 無意味な値（ここでは0）がプログラムに流れて、後で深刻な不具合になる

という大問題が起こります！

この parseInt メソッド自身は、「文字列を整数にする」という狭い責任しか持っていません。エラーになったとき、どう対応するか（終了する？リトライする？ユーザーに聞く？）それは 呼び出した側（あなたのコード） が決めるべきなのです。

だから、parseIntは責任を持って「異常を知らせる（スローする）」だけで、
無理にその場でキャッチして何かすることはしないのですね。

メソッドがスローする可能性がある例外を宣言することで、呼び出し元で例外をキャッチする必要があることを明示的に示し、プログラムの可読性と保守性を高めているのです。

throwとthrowsで“s”が付くか付かないかが分かりにいかも知れませんね。

やや強引ですが、

と覚えていただくと比較的スムーズかと思います。

実験してみましょう。

package chap12;

public class Example09 {

	public static void main(String[] args) {
		System.out.println(Integer.parseInt(null));
	}
}

＜実行結果＞

確かにNumberFormatExceptionが発生しました。

この結果をスタックトレース情報というのだとこのテキストの１回目にお話しました。

１行目はどんな例外が発生したかというのを表し、２行目以降でその例外の発生源とその例外がどのように伝播していったかを示すのでした。その順番は、"スタック"トレースという名前のとおり、メソッドの呼び出し順を発生源から順に上に積んでいきます。

スタックトレース情報は上から下に見ていって、自作のクラスの自作のメソッドが怪しいのでそこを重点的に調べればOKです。

また、（）の中の数字は例外発生の原因箇所の行番号です。クリックするとソースコードに飛べます。（ただし、かならずしもその行が例外発生の原因とは限りません。その周辺をチェックして下さい）

7.例外を呼び出し元に投げて判断を任せる

この仕組を使って自作のクラスでも例外処理を呼び出し元に投げる（判断を任せる）事ができます。

以下のサンプルプログラムは例外を呼び出し元に投げて例外処理を任せる例です。throwsを使用すると、呼び出し元が適切なエラーハンドリング（try-catchかthrowsか）を行う責任を持つことになります。

checkAnswer()メソッドで0-9以外の入力があった場合に例外を呼び出し元に投げています。InputMismatchExceptionクラスのコンストラクタで引数に"範囲外の数値が入力されました."という文字列を渡し、インスタンスを投げています。

package chap12;

import java.util.InputMismatchException;
import java.util.Random;

public class KazuateThrow {

	private int answer;
	private String message;

	public KazuateThrow() {
		Random random = new Random();
		this.answer = random.nextInt(10); // 0～9 の乱数
	}
	
	private void setMessage(String message) {
		this.message = message;
	}
	
	public String getMessage() {
		return message;
	}

	public void checkAnswer(int guess) {
		
		if(guess < 0 || guess > 9) {
			throw new InputMismatchException("範囲外の数値が入力されました.");
		}

		if (answer == guess) {
			setMessage("あたり");
		} else if (answer > guess) {
			setMessage("もっと大きいよ");
		} else {
			setMessage("もっと小さいよ");
		}
	}

	public int getAnswer() {
		return answer;
	}
}

以下は呼び出し元のクラスです。ぜひ実行して0-9以外の値を入力した場合と整数値以外を入力したときの結果の違いを確かめてください。

package chap12;

import java.util.InputMismatchException;
import java.util.Scanner;

public class KazuateThrowTest {
	public static void main(String[] args) {

		System.out.println("0-9の整数で数を当ててください!");

		Scanner sc = new Scanner(System.in);
		int guess = -1;

		try {
			guess = sc.nextInt(); // ユーザーの入力を取得（整数以外だと例外発生）
			
			// 正常に整数が入力された場合の処理
			KazuateThrow game = new KazuateThrow();
			
			// 例外が発生する可能性のあるメソッド呼び出し
			game.checkAnswer(guess);

			System.out.println(game.getMessage());
			System.out.println("答えは " + game.getAnswer());

		} catch (InputMismatchException e) {
			System.out.println(e);
		} finally {
			sc.close(); // Scannerは必ず閉じる
		}
	}
}

＜範囲外の整数値を入力した場合の実行結果＞

＜整数値以外を入力した場合の実行結果＞

例えるなら、例外を投げるのは新人エンジニアの皆さんが自分では判断できない状況になったときに、上司に判断を仰ぐようなものです。

例外処理を使うことでプログラムはトラブルの発生をユーザーに伝えることができ、途中終了を避けることができるのでした。また、継承の仕組みを上手く応用しているのも興味深いところでしたね。

実際にお客様の依頼で開発するアプリでは、詳細なエラー情報は画面に表示しないことが多いのです。特に深刻なエラーが起こった場合はなおさらです。
知識が不十分なお客様をいたずらに不安にさせることになりますし、下手をすれば責任問題に発展し、会社同士のもめ事にもなりかねないからです。

こういう場合はいつ、何が起こったのかを詳細にログに出力し、画面には、ただ「システム管理者に連絡して下さい」とだけ表示するようにします。
ですから、非チェック例外に対しても例外処理を何もしなくて良い、というわけでは決して無い、ということも、分かっておいてください。

その他にオリジナルの例外クラスを作るというテーマでリンクに記事があります。余裕のある方は一読下さい。

まとめができたら、アウトプットとして演習問題にチャレンジしましょう。

問題12.例外処理 - セイコンサルティンググループ

以下のプログラムには、題意を明確にするためにあえて無意味な変数名を使用しています。

セイコンサルティンググループ

以上、今回は「例外処理で想定外の事態に強いシステムにする」方法について見てきました。

次回は、「ArrayListでもっと配列を便利に使いこなす」です。

ArrayListを一言で言うと便利なメソッドを持った伸縮自在の配列です。現在では配列よりもよく使われています。

ということで、次回を楽しみに待っていてください。

例外処理で想定外の事態に強いシステムにする　最後までお読みいただきありがとうございます。