【Java学習｜初心者向け】throw文で自信を持ってエラーを投げよう！初心者のためのJavaエラーハンドリング入門

皆さん、こんにちは！Javaエンジニアの経験を活かして、今日は皆さんが「これならわかる！」と思えるように、Javaのエラーハンドリング、特に`throw`文について、分かりやすく解説していきます。

1. なぜ`throw`文が重要なのか？

プログラムを開発していると、予期せぬ事態が発生することがありますよね。例えば、ファイルが見つからなかったり、ネットワーク接続が切れたり。あるいは、プログラムのロジック上、ありえない値が渡されてきたり。

このような「異常な状態」が発生したときに、プログラムが突然止まってしまったり、間違った結果を出力してしまったりするのは困ります。そこで登場するのが「例外処理」です。

`throw`文は、この例外処理の要となる機能の一つです。プログラムの実行中に「これはおかしい！」という状況が発生したときに、それを「例外」として投げ出す（`throw`する）ことで、後続の処理に異常を知らせることができます。これにより、プログラム全体が安全かつ安定して動作するように制御できるのです。

2. 基礎知識：例外ってなんだろう？

Javaにおけるエラーは、大きく分けて「Error」と「Exception」の2種類があります。

  • Error:
  • Java仮想マシン（JVM）自体が抱える深刻な問題（例: `OutOfMemoryError` – メモリ不足）や、JVMでは回復不能な問題を表します。
  • 通常、開発者が直接 `catch` して処理するものではなく、プログラムの終了につながることがほとんどです。
  • Exception:
  • プログラムの実行中に発生する、比較的回復可能な問題を表します。
  • 例えば、ファイルが見つからない(`FileNotFoundException`)、配列の範囲外にアクセスした(`ArrayIndexOutOfBoundsException`)、無効な引数を渡した(`IllegalArgumentException`)などがあります。
  • `RuntimeException`: チェックされない例外（Unchecked Exception）とも呼ばれ、コンパイル時に例外処理を強制されません。`NullPointerException`や`ArrayIndexOutOfBoundsException`などがこれにあたります。
  • チェック例外（Checked Exception）: `RuntimeException`以外の`Exception`のサブクラスで、コンパイル時に例外処理（`try-catch`で囲むか、`throws`でメソッドの呼び出し元に投げる）を強制されます。`IOException`や`SQLException`などがこれにあたります。

`try-with-resources`文とは？

リソース（ファイルやネットワーク接続など、使い終わったら必ず閉じなければならないもの）を扱う際に、例外が発生しても確実にリソースを閉じたい場合があります。`try-with-resources`文を使うと、`try`ブロックの終了時（正常終了でも例外発生時でも）に、自動的にリソースが閉じられるようになり、`finally`ブロックで手動で `close()` を呼び出す手間が省け、コードがスッキリします。

Multi-catchとは？

複数の例外を `catch` する際に、それぞれの例外に対して個別の `catch` ブロックを書く代わりに、1つの `catch` ブロックで複数の例外をまとめて処理できる機能です。これにより、コードの重複を減らすことができます。

3. `throw`文で例外を投げる方法

`throw`文は、例外オブジェクトを生成し、それを投げ出す（スローする）ために使います。

基本的な構文:

throw new 例外クラス名(“エラーメッセージ”);

  • `throw`: 例外を投げるためのキーワードです。
  • `new 例外クラス名(…)`: 投げたい例外のインスタンスを生成します。`Exception`クラスやそのサブクラス（`IllegalArgumentException`など）のインスタンスを生成します。
  • `”エラーメッセージ”`: 例外の原因を説明する文字列です。このメッセージは、例外が発生したときに表示されるため、原因を特定するのに役立ちます。

例:

あるメソッドで、引数に負の値が渡されたらエラーにしたい場合を考えてみましょう。

public void setAge(int age) {
if (age < 0) { // 年齢が負の値の場合はIllegalArgumentExceptionを投げる throw new IllegalArgumentException("年齢は0以上である必要があります。指定された値: " + age); } this.age = age; } このコードでは、`age`が負の値であれば、`IllegalArgumentException`という例外を生成して投げます。この例外は、メソッドを呼び出した側で `try-catch` を使って捕捉（キャッチ）して処理する必要があります。

4. サンプルプログラム：`throw`文を使ってみよう

ここでは、ユーザーからの入力を受け取り、それが特定の値（例えば「OK」）でない場合に例外を投げる簡単な例を見てみましょう。

import java.util.Scanner; // ユーザー入力を受け取るためのScannerクラスをインポート

public class ThrowExample {

public static void main(String[] args) {
// ユーザーからの入力を受け取るためのScannerオブジェクトを作成
Scanner scanner = new Scanner(System.in);

try {
System.out.print(“「OK」と入力してください：”);
String input = scanner.nextLine(); // ユーザーの入力を文字列として読み取る

// 入力が「OK」でない場合に例外を投げる
validateInput(input);

System.out.println(“入力は正しかったです！”);

} catch (IllegalArgumentException e) {
// IllegalArgumentExceptionが発生した場合の処理
System.err.println(“エラーが発生しました: ” + e.getMessage()); // エラーメッセージを標準エラー出力に表示
} finally {
// try-catchブロックの終了時に必ず実行される処理
scanner.close(); // Scannerリソースを閉じる
System.out.println(“処理を終了します。”);
}
}

// 入力が「OK」であるか検証するメソッド
public static void validateInput(String text) {
// 入力がnull、または「OK」でない場合
if (text == null || !text.equals(“OK”)) {
// IllegalArgumentExceptionを生成して投げる
// 例外メッセージには、何が問題だったかを具体的に記述する
throw new IllegalArgumentException(“不正な入力です。「OK」と入力してください。”);
}
}
}

このコードのポイント:

  • `main`メソッド内で、`Scanner`を使ってユーザーからの入力を受け取ります。
  • `validateInput`メソッドは、受け取った文字列が「OK」でなければ`IllegalArgumentException`を投げます。
  • `main`メソッドの`try`ブロック内で`validateInput`を呼び出しています。
  • `catch (IllegalArgumentException e)`ブロックで、`validateInput`から投げられた例外を捕捉し、エラーメッセージを表示しています。
  • `finally`ブロックでは、`Scanner`を閉じ、終了メッセージを表示しています。

実行例1（正しい入力）:

「OK」と入力してください：OK
入力は正しかったです！
処理を終了します。

実行例2（間違った入力）:

「OK」と入力してください：NG
エラーが発生しました: 不正な入力です。「OK」と入力してください。
処理を終了します。

5. 応用・注意点

  • 例外の種類を適切に選ぶ:

`throw`する例外は、発生した問題の種類に合ったものを選びましょう。例えば、引数の値が不正な場合は`IllegalArgumentException`、リソースが見つからない場合は`FileNotFoundException`（または`IOException`）などです。自分でカスタム例外クラスを作成することも可能です。

  • `throws`キーワードとの違い:

`throw`はメソッド内で例外オブジェクトを「投げる」ための文です。一方、`throws`はメソッドの定義部分で、そのメソッドがどのような例外を投げる可能性があるか（呼び出し元に処理を委ねるか）を示すためのキーワードです。

public void someMethod() throws IOException { // このメソッドはIOExceptionを投げる可能性がある
// …
if (errorCondition) {
throw new IOException(“エラーが発生しました”); // ここでthrow文を使っている
}
// …
}

  • 例外の連鎖 (Exception Chaining):

既存の例外を捕捉し、その原因となった例外を保持したまま新しい例外を投げることで、エラーの原因を追跡しやすくなります。`throw new 新しい例外(“メッセージ”, 原因となった例外);` のようにします。

  • `try-with-resources`と`throw`:

`try-with-resources`文でリソースを扱う場合、`try`ブロック内で例外が発生すると、リソースが閉じられた後にその例外が再スローされます。もし`finally`ブロックでさらに例外処理をしたい場合は注意が必要です。

  • `Multi-catch`の注意点:

`catch (ExceptionType1 | ExceptionType2 e)`のように記述しますが、`ExceptionType1`と`ExceptionType2`が親子関係にある場合（例えば`IOException`と`FileNotFoundException`）、親の例外（`IOException`）を先に書くとコンパイルエラーになります。

`throw`文を使いこなすことで、プログラムの異常事態に適切に対処し、より堅牢なアプリケーションを開発できるようになります。最初は少し難しく感じるかもしれませんが、実際にコードを書いて試してみるのが一番の近道です。ぜひ、今日のTipsを参考に、エラーハンドリングに挑戦してみてください！

スポンサーリンク

コメント

タイトルとURLをコピーしました