Servletにおけるtry-catch文の使い方を徹底解説！初心者でもわかる例外処理の基本
新人
「Servletでプログラムを書いていたら、突然エラー画面が出てしまいました。どうしてこんなことが起きるんですか？」
先輩
「それは、プログラムの途中で予期しない問題が起きた可能性があります。Servletでは、そうした問題に備えるためにtry-catch文を使った例外処理がとても大切なんです。」
新人
「例外処理って難しそうですけど、初心者でも理解できますか？」
先輩
「大丈夫です。パソコンを触ったことがない人でもイメージできるように、身近なたとえで説明していきます。」
1. try-catch文とは？（Servletにおける例外処理の基本概念）
try-catch文とは、JavaやServletでエラーが発生したときに、プログラムが途中で止まってしまうのを防ぐための仕組みです。 ここでいうエラーとは、プログラムの文法ミスではなく、実行中に起きる予期しない問題のことを指します。 これを専門用語では「例外」と呼びます。
例外を身近なもので例えると、自動販売機でお金を入れてボタンを押したのに、商品が出てこない状態です。 何も対処しなければ、利用者は困ってしまいますよね。 しかし「返金する」「別の商品を選ばせる」といった対応が用意されていれば安心です。 try-catch文は、この「もしもの時の対応」をプログラムであらかじめ用意しておく仕組みです。
Servletでは、画面表示やデータ処理、ファイル操作など、さまざまな処理を行います。 その途中で問題が起きても、ユーザーに分かりやすい画面を表示したり、処理を安全に終了させたりするために、try-catch文が重要になります。
2. Servletで例外処理が必要な理由とエラー発生時の課題
Servletで例外処理が必要な最大の理由は、Webサービスを利用するユーザーを混乱させないためです。 例外処理を行わない場合、エラーが発生すると英語だらけのエラーメッセージや、真っ白な画面が表示されてしまうことがあります。 これでは、パソコンに慣れていない人は何が起きたのか全く分かりません。
また、Servletはサーバー側で動くプログラムです。 もし例外が原因で処理が止まってしまうと、他の利用者にも影響が出る可能性があります。 例えば、買い物サイトで注文処理中にエラーが起きると、注文内容が保存されなかったり、二重注文になったりする危険性もあります。
こうした課題を防ぐために、try-catch文を使ってエラーを受け止め、正しい対応を行う必要があります。 具体的には「エラーログを記録する」「エラー専用の画面に遷移する」「処理を安全に中断する」といった対応が考えられます。 これにより、Servletは安定した動作を保つことができます。
3. try-catch文を使った基本的なエラー処理の流れ
try-catch文の基本的な流れはとてもシンプルです。 まず、エラーが起きるかもしれない処理をtryの中に書きます。 そして、もしエラーが発生した場合に実行したい処理をcatchの中に書きます。
文章で表すと、「まずやってみる（try）。問題が起きたら、そのときの対処をする（catch）」という流れです。 料理をしているときに、鍋を落としそうになったらすぐに手を伸ばして支える、というイメージに近いです。
以下は、Servletでよくある例として、数値の変換処理でエラーが起きた場合のサンプルコードです。
try {
int number = Integer.parseInt(request.getParameter("age"));
request.setAttribute("age", number);
} catch (NumberFormatException e) {
request.setAttribute("errorMessage", "数字を入力してください");
}
このコードでは、文字を数字に変換しようとしています。 もし数字以外が入力された場合、例外が発生しますが、catchの中でエラーメッセージを設定することで、画面に分かりやすく伝えることができます。
次に、もう一つ別のパターンとして、Servletで処理全体をtry-catchで囲む例を見てみましょう。
try {
request.setCharacterEncoding("UTF-8");
String name = request.getParameter("name");
request.setAttribute("name", name);
request.getRequestDispatcher("/result.jsp").forward(request, response);
} catch (Exception e) {
response.sendRedirect("error.jsp");
}
このようにServlet全体の処理をtry-catchで囲むことで、どこかで例外が発生しても、必ずエラー画面へ移動させることができます。 初心者のうちは、まずこの基本的な流れを理解することがとても大切です。
try-catch文を正しく使えるようになると、Servletのエラーに強いプログラムが書けるようになります。 これは、ユーザーにとっても、開発者にとっても大きなメリットです。
4. Servletでのtry-catch文の基本的な書き方と構文ルール
Servletで例外処理を行う際、まず理解しておきたいのがtry-catch文の基本的な書き方と構文ルールです。 try-catch文は、エラーが起きる可能性のある処理と、エラーが起きた後の対応を明確に分けて記述します。 この構造を正しく理解することで、Servletの処理内容が読みやすくなり、後から修正する際も混乱しにくくなります。
基本的な構文はとてもシンプルで、「tryブロック」「catchブロック」という二つの要素から成り立っています。 tryの中には、データの取得や計算処理、画面遷移など、例外が発生する可能性がある処理を書きます。 catchの中には、例外が発生したときに実行したい処理を書きます。
重要なルールとして、tryブロックの後には必ずcatch、またはfinallyを記述する必要があります。 catchを何も書かずにtryだけを書くことはできません。 また、catchでは、どの種類の例外を捕まえるのかを明示的に指定する必要があります。 これにより、想定しているエラーだけを適切に処理できます。
初心者の方がよくやってしまうミスとして、tryの中に必要以上に多くの処理を書いてしまうケースがあります。 すべてを一つのtryで囲むと、どこでエラーが起きたのか分かりにくくなります。 そのため、エラーが起きやすい処理ごとにtry-catchを分ける意識が大切です。
try {
String price = request.getParameter("price");
int value = Integer.parseInt(price);
request.setAttribute("price", value);
} catch (NumberFormatException e) {
request.setAttribute("errorMessage", "金額は数字で入力してください");
}
このように、数値変換のようなエラーが起きやすい部分だけをtry-catchで囲むことで、 Servlet全体の処理の流れを分かりやすく保つことができます。 基本構文とルールを正しく押さえることが、安定した例外処理への第一歩です。
5. 例外発生時にリダイレクトやフォワードで画面遷移する方法
Servletで例外が発生した場合、単にエラーメッセージを設定するだけでなく、 画面を切り替えてユーザーに状況を伝えることが重要です。 その際によく使われるのが、フォワードとリダイレクトによる画面遷移です。
フォワードは、同じリクエスト情報を保持したまま、別のJSPへ処理を引き継ぐ方法です。 入力内容やエラーメッセージをそのまま画面に表示したい場合に向いています。 一方、リダイレクトは、ブラウザに対して別のURLへ再アクセスさせる方法です。 処理を完全に切り替えたい場合や、URLを変更したい場合に利用されます。
try-catch文と組み合わせることで、例外が発生したときに自動的にエラー画面へ遷移させることができます。 これにより、ユーザーは突然のエラー画面に戸惑うことなく、案内された画面で状況を理解できます。
try {
String id = request.getParameter("id");
int userId = Integer.parseInt(id);
request.setAttribute("userId", userId);
request.getRequestDispatcher("/success.jsp").forward(request, response);
} catch (Exception e) {
request.setAttribute("errorMessage", "処理中にエラーが発生しました");
request.getRequestDispatcher("/error.jsp").forward(request, response);
}
上記の例では、例外が発生した場合でも、同じリクエストスコープを使ってエラーメッセージを渡しています。 入力内容を保持したままエラーを表示したい場合には、フォワードが非常に便利です。
try {
processBusinessLogic();
response.sendRedirect("complete.jsp");
} catch (Exception e) {
response.sendRedirect("systemError.jsp");
}
こちらはリダイレクトを使った例です。 処理結果によって完全に別の画面へ遷移させたい場合には、この方法が適しています。 フォワードとリダイレクトの特徴を理解し、例外時にどちらを使うべきか判断できるようになることが大切です。
6. 複数例外を想定したcatch処理と設計の考え方
実務でServletを開発していると、一種類の例外だけでなく、複数の例外が発生する可能性を考慮する必要があります。 例えば、入力値の形式が間違っている場合と、データベース接続に失敗した場合では、 ユーザーに伝えるべき内容や対応方法が異なります。
このような場合、catchを複数記述することで、例外の種類ごとに処理を分けることができます。 具体的には、より具体的な例外を先に書き、最後に汎用的な例外を捕まえるのが基本的なルールです。 順番を間違えると、想定したcatchが実行されなくなるため注意が必要です。
try {
String count = request.getParameter("count");
int value = Integer.parseInt(count);
executeDatabaseAccess(value);
} catch (NumberFormatException e) {
request.setAttribute("errorMessage", "数値の形式が正しくありません");
} catch (SQLException e) {
request.setAttribute("errorMessage", "データベース処理でエラーが発生しました");
} catch (Exception e) {
request.setAttribute("errorMessage", "予期しないエラーが発生しました");
}
このように例外ごとにメッセージを分けることで、ユーザーにも管理者にも分かりやすい対応が可能になります。 また、設計の観点では、catchの中に複雑な処理を書きすぎないことも重要です。 例外処理はあくまで「異常時の対応」であり、本来の業務処理とは分離して考える必要があります。
例外ごとの役割を整理し、どの例外でどの画面に遷移するのかを事前に設計しておくことで、 Servlet全体の構造がすっきりし、保守性の高いコードになります。 複数例外を意識したcatch設計は、初心者から一段階レベルアップするための重要なポイントです。
4. Servletでのtry-catch文の基本的な書き方と構文ルール
ここからは、Servletでtry-catch文を書くときの基本的な書き方と、初心者が必ず押さえておきたい構文ルールについて解説します。 try-catch文は自由に書けそうに見えて、実は守るべきルールがいくつかあります。 このルールを理解していないと、エラー処理が正しく動かなかったり、逆に新しい不具合を生んでしまう原因になります。
まず大前提として、tryブロックの中には「例外が発生する可能性がある処理」だけを書くようにします。 何でもかんでもtryで囲ってしまうと、どこで問題が起きたのか分かりにくくなり、保守性が大きく下がります。 Servletでは、リクエストパラメータの取得、型変換、データベース処理、画面遷移などが代表的な対象です。
構文としては、「try → catch」という順番は必ず守る必要があります。 また、catchは一つだけでなく、複数書くこともできますが、その場合は例外の種類に注意が必要です。 Javaでは、より具体的な例外クラスを先に書き、最後に汎用的な例外を書くのが基本ルールです。
try {
String price = request.getParameter("price");
int value = Integer.parseInt(price);
request.setAttribute("price", value);
} catch (NumberFormatException e) {
request.setAttribute("errorMessage", "金額は数字で入力してください");
}
この例では、数値変換で発生しやすい例外だけをcatchで受け止めています。 例外の種類を絞ることで、「どんな問題が起きたのか」をコードから読み取りやすくなります。 初心者のうちは、まずこのように小さなtry-catchを書く練習をするのがおすすめです。
また、try-catch文の中で画面遷移を行う場合は、処理の順番にも注意が必要です。 forwardやredirectの後に処理を書いてしまうと、意図しない動作になることがあります。 try-catch文は、エラー処理だけでなく、Servlet全体の流れを意識しながら書くことが大切です。
5. 例外発生時にリダイレクトやフォワードで画面遷移する方法
Servletで例外が発生したとき、多くの場合は「エラー専用の画面」に遷移させたいと考えます。 その際によく使われるのが、リダイレクトとフォワードです。 どちらも画面遷移を行う方法ですが、仕組みや使いどころが異なります。
フォワードは、サーバー内部で処理を引き継いで画面を切り替える方法です。 リクエスト情報をそのまま次の画面に渡せるため、エラーメッセージを表示したい場合に向いています。 一方、リダイレクトは、ブラウザに新しいリクエストを送り直させる方法です。 URLが変わるため、エラー画面を直接表示させたいときに使われることが多いです。
try {
String id = request.getParameter("id");
int userId = Integer.parseInt(id);
request.setAttribute("userId", userId);
request.getRequestDispatcher("/success.jsp").forward(request, response);
} catch (NumberFormatException e) {
request.setAttribute("errorMessage", "不正なIDが指定されました");
request.getRequestDispatcher("/error.jsp").forward(request, response);
}
この例では、例外が発生した場合でも同じリクエストを使ってエラー画面へフォワードしています。 そのため、error.jsp側でエラーメッセージをそのまま表示することができます。 入力内容の不備など、ユーザーに原因を伝えたいケースでは、フォワードが非常に便利です。
一方で、致命的なエラーや、再読み込みを防ぎたい場合にはリダイレクトが選ばれることもあります。 例えば、システムエラーが発生した場合は、エラーページ専用のURLへ移動させる方が安全です。
try {
// 何らかの重要な処理
} catch (Exception e) {
response.sendRedirect("systemError.jsp");
}
このように、例外の内容やユーザーへの見せ方によって、フォワードとリダイレクトを使い分けることが重要です。 どちらを使うか迷った場合は、「リクエスト情報を引き継ぎたいかどうか」を判断基準にすると分かりやすくなります。
6. 複数例外を想定したcatch処理と設計の考え方
実際のServlet開発では、一つの例外だけを考えていれば良いケースはほとんどありません。 入力エラー、通信エラー、想定外のシステムエラーなど、さまざまな例外が発生する可能性があります。 そのため、複数のcatchを使った設計が重要になります。
複数のcatchを書く場合は、例外を「ユーザーに伝えるもの」と「開発者が対応すべきもの」に分けて考えるのがポイントです。 ユーザー入力が原因の例外は、分かりやすいメッセージを表示します。 一方で、システム内部の問題は、詳細を画面に出さず、ログに記録するだけにするのが一般的です。
try {
String count = request.getParameter("count");
int num = Integer.parseInt(count);
// 処理が続く
} catch (NumberFormatException e) {
request.setAttribute("errorMessage", "数値を正しく入力してください");
request.getRequestDispatcher("/input.jsp").forward(request, response);
} catch (Exception e) {
response.sendRedirect("error.jsp");
}
このように、具体的な例外を先に処理し、最後にExceptionでまとめて受け止めるのが基本形です。 こうすることで、ユーザー向けの対応と、システム全体の安全対策を両立できます。
設計の段階で「この例外は誰のためのものか」を考える癖をつけると、try-catch文は一気に書きやすくなります。 単なるエラー回避ではなく、使いやすいWebアプリケーションを作るための重要な設計要素として、例外処理を意識していきましょう。
7. try-catch文を使ったエラー処理のメリットと実務での活用例
try-catch文を使ったエラー処理の最大のメリットは、Servletが予期しない状況に直面しても、 アプリケーション全体が停止せず、安定して動作し続けられる点にあります。 Webアプリケーションは常に不特定多数のユーザーからアクセスされるため、 想定外の入力や操作が発生することを前提に設計しなければなりません。
もし例外処理を行わなかった場合、たった一人の不正な入力が原因で、 エラー画面が表示されたり、処理が途中で止まったりする可能性があります。 これはユーザー体験を大きく損なうだけでなく、サービス全体の信頼性低下にもつながります。 try-catch文は、こうしたリスクを最小限に抑えるための重要な仕組みです。
実務では、入力チェックやデータベース処理、外部サービスとの連携など、 エラーが発生しやすい箇所が数多く存在します。 try-catch文を適切に配置することで、エラー発生時にも処理の流れを制御し、 ユーザーには分かりやすいメッセージだけを表示することができます。
try {
String ageParam = request.getParameter("age");
int age = Integer.parseInt(ageParam);
request.setAttribute("age", age);
request.getRequestDispatcher("/confirm.jsp").forward(request, response);
} catch (NumberFormatException e) {
request.setAttribute("errorMessage", "年齢は数字で入力してください");
request.getRequestDispatcher("/input.jsp").forward(request, response);
}
上記の例では、ユーザー入力が原因で起こりやすい例外をtry-catchで受け止めています。 これにより、エラーが発生しても入力画面に戻し、適切な案内を表示することができます。 このような実装は、問い合わせや操作ミスを減らす効果もあり、実務では非常によく使われます。
try-catch文は単なるエラー回避ではなく、 「ユーザーにどう振る舞うべきか」を設計に反映させるための重要な手段だと理解しておきましょう。
8. Servletの例外処理でよくあるミスと注意点
Servletの例外処理で初心者がよく陥るミスの一つが、 すべての処理を一つのtry-catchで囲んでしまうことです。 この書き方は一見すると安全そうに見えますが、 実際にはどこでエラーが発生したのか分かりにくくなり、保守性が低下します。
また、catchブロックの中で何も処理をせず、 例外を握りつぶしてしまうケースも注意が必要です。 表面上はエラーが出ていないように見えても、 実際には不正な状態のまま処理が続いてしまう危険性があります。
もう一つのよくあるミスは、例外メッセージをそのまま画面に表示してしまうことです。 システム内部のエラーメッセージは、ユーザーにとって理解しづらいだけでなく、 セキュリティ上の情報を漏らしてしまう可能性もあります。 ユーザー向けのメッセージと、開発者向けのログは分けて考えることが重要です。
try {
executeBusinessLogic();
response.sendRedirect("complete.jsp");
} catch (Exception e) {
// 例外を無視するのは危険
request.setAttribute("errorMessage", "処理に失敗しました");
request.getRequestDispatcher("/error.jsp").forward(request, response);
}
上記のように、最低限でもエラー画面への遷移やメッセージ表示を行うことで、 ユーザーが混乱するのを防ぐことができます。 さらに実務では、ログ出力を行い、後から原因を調査できるようにするのが一般的です。
例外処理を書く際は、「このエラーは誰が見るのか」「どこまで復旧させるのか」 を常に意識することが、品質の高いServlet開発につながります。
9. try-catch文とリダイレクトを使ったエラー処理の重要ポイント整理
try-catch文とリダイレクトを組み合わせたエラー処理は、 Servletにおける実務対応として非常に重要な考え方です。 特に、システムエラーや致命的な例外が発生した場合には、 同じリクエストを引き継がず、完全に処理を切り替える必要があります。
リダイレクトを使うことで、ブラウザに新しいリクエストを送らせ、 エラー画面専用のURLへ遷移させることができます。 これにより、再読み込みによる二重送信や、 不正な状態での処理継続を防ぐことができます。
try {
processPayment();
response.sendRedirect("success.jsp");
} catch (Exception e) {
response.sendRedirect("systemError.jsp");
}
このような実装では、エラーが発生した時点で処理を即座に切り替え、 ユーザーには共通のエラー画面だけを表示します。 詳細な原因はログに残し、画面には必要最低限の情報だけを表示するのが基本です。
重要なポイントとして、try-catch文は「すべてを守る魔法の仕組み」ではありません。 フォワードとリダイレクトの違いを理解し、 エラーの種類ごとに適切な対応を選択することが大切です。 これらを意識して設計することで、Servletはより安全で信頼性の高いものになります。
