先生と生徒の会話形式で理解しよう

生徒

「先生、Jakarta サーブレットでリクエストを処理しているときにエラーが発生したらどうすればいいですか？」

先生

「サーブレットでは、Javaと同じように例外処理を行う方法があるんだよ。try-catchを使ったり、web.xmlにエラーページを設定してユーザーにわかりやすく伝えることができるんだ。」

生徒

「なるほど！それなら初心者でも使えそうですね。具体的な方法を教えてください！」

先生

「それでは、Jakarta サーブレットでの例外処理の基本から順番に見ていこう。」

1. Jakarta サーブレットで例外処理が必要な理由

Jakarta サーブレットは、クライアントから送られるリクエストを処理する重要な役割を持っています。しかし、処理中にファイルが存在しなかったり、データベース接続が切れたり、予期せぬエラーが発生することがあります。そのままエラーをユーザーに表示してしまうと、見た目が乱れてしまうだけでなく、セキュリティ的にも危険です。そのため、サーブレットでは例外処理を行い、安全でわかりやすいエラーメッセージを返す必要があります。

2. try-catchを使った基本的な例外処理

サーブレットのdoGetやdoPostの中でエラーが発生する可能性がある処理は、try-catchで囲むのが基本です。例えば、数値変換やファイル読み込み処理などです。


@WebServlet("/errorExample")
public class ErrorExampleServlet extends HttpServlet {
    protected void doGet(HttpServletRequest request, HttpServletResponse response)
            throws ServletException, IOException {
        try {
            String number = request.getParameter("num");
            int value = Integer.parseInt(number);
            response.getWriter().println("数値は: " + value);
        } catch (NumberFormatException e) {
            response.getWriter().println("数値に変換できませんでした。入力を確認してください。");
        }
    }
}

このようにすると、ユーザーが誤った入力をしても例外でプログラムが停止せず、わかりやすいメッセージを表示できます。

3. web.xmlでエラーページを設定する方法

Jakarta サーブレットでは、アプリケーション全体で共通のエラーページを設定できます。これにより、例外が発生したときに自動的に指定したページに遷移させることができます。


<web-app>
    <error-page>
        <exception-type>java.lang.NumberFormatException</exception-type>
        <location>/error/numberError.jsp</location>
    </error-page>
    <error-page>
        <error-code>404</error-code>
        <location>/error/notFound.jsp</location>
    </error-page>
</web-app>

この設定を行うと、数値変換エラーが発生した場合はnumberError.jspに、ページが存在しない場合はnotFound.jspに自動で転送されます。

4. カスタムエラーページを作成する

ユーザーにとってわかりやすいエラーページを用意することで、信頼感のあるアプリケーションを構築できます。HTMLとBootstrapを使えば見やすいページを簡単に作れます。


<!DOCTYPE html>
<html>
<head>
    <title>エラーが発生しました</title>
    <link href="https://cdn.jsdelivr.net/npm/bootstrap@5.3.0/dist/css/bootstrap.min.css" rel="stylesheet">
</head>
<body class="bg-light text-center">
    <div class="container mt-5">
        <h1 class="text-danger">エラーが発生しました</h1>
        <p>入力内容を確認して、再度試してください。</p>
        <a href="/" class="btn btn-primary">ホームに戻る</a>
    </div>
</body>
</html>

このようにカスタムページを設定すると、例外発生時でもユーザーが安心できる体験を提供できます。

5. Jakarta サーブレットでのログ出力とデバッグ

例外処理ではユーザーにメッセージを返すだけでなく、開発者向けにログを残すことも重要です。printStackTrace()ではなく、Loggerを使うのがおすすめです。ログを残しておけば、運用中に発生した問題の原因を追跡しやすくなります。

6. 例外処理のベストプラクティス

Jakarta サーブレットで例外処理を行うときは、以下の点に注意するとよいでしょう。

ユーザーにはわかりやすいメッセージを返す
開発者向けには詳細なログを残す
共通のエラーページを設定してデザインを統一する
予期せぬ例外はキャッチしてアプリが止まらないようにする

これらを意識すると、Jakarta EEアプリケーション全体の信頼性とユーザビリティが向上します。

まとめ

Jakarta サーブレットにおける例外処理の重要性の振り返り

今回の記事では、Jakarta サーブレットを使った開発において、なぜ例外処理が重要なのか、そしてどのように実装すれば安全で使いやすいアプリケーションを作れるのかを丁寧に学んできました。サーブレットは、利用者からのリクエストを直接受け取り処理する仕組みであるため、入力値の誤りや想定外のアクセス、サーバー内部の不具合など、さまざまな問題が発生する可能性があります。こうした問題に何も対策をしていないと、画面が崩れたり、意味不明なエラーメッセージが表示されたりして、利用者に不安や不信感を与えてしまいます。そのため、例外処理は単なるエラー対策ではなく、アプリケーション全体の品質を高めるために欠かせない要素であることを理解することが大切です。

try catch による基本的なエラーハンドリングの理解

記事の前半では、Jakarta サーブレットの中で try catch を使った基本的な例外処理について学びました。doGet や doPost の中では、数値変換や外部リソースへのアクセスなど、エラーが起こりやすい処理が多く含まれます。こうした処理を try で囲み、想定される例外を catch することで、プログラムが途中で停止するのを防ぎ、利用者に対して適切なメッセージを返すことができます。初心者のうちは、エラーが出ると怖く感じてしまいがちですが、例外処理を正しく書くことで、エラーは制御できるものであると実感できるようになります。

web 設定による共通エラーページの活用

次に、アプリケーション全体で共通のエラーページを設定する方法について学びました。特定の例外やエラーコードに対して専用のページを用意することで、どの画面でエラーが発生しても、統一された見た目とメッセージを表示できます。これにより、利用者は突然画面が切り替わっても混乱せず、落ち着いて次の行動を選択できます。また、開発者にとっても、エラー対応を一か所にまとめられるため、保守や改善がしやすくなるというメリットがあります。

カスタムエラーページとユーザー体験の向上

カスタムエラーページの作成についても重要なポイントでした。単にエラーが発生したことを伝えるだけでなく、どのようにすれば問題を解決できるのか、次に何をすればよいのかをやさしく案内することで、利用者の不安を軽減できます。見た目を整えたエラーページは、アプリケーション全体の印象を良くし、信頼感のあるサービスとして受け取ってもらえるようになります。

サンプルプログラムで理解を深める


try {
    String param = request.getParameter("value");
    int result = Integer.parseInt(param);
    response.getWriter().println("結果は " + result + " です");
} catch (Exception e) {
    response.getWriter().println("入力内容に問題があります");
}

このようなシンプルな例でも、例外処理があるかないかで、アプリケーションの安定性と安心感は大きく変わります。小さな積み重ねが、実務で通用するサーブレット開発につながっていきます。

先生と生徒の振り返り会話

生徒「今回の内容を通して、サーブレットでエラーが出ても慌てなくていいんだと分かりました。例外処理を入れておけば、利用者にも自分にも優しいですね」

先生「その通りだよ。例外処理は失敗を隠すためではなく、正しく対処するための仕組みなんだ」

生徒「try catch やエラーページの設定を組み合わせることで、アプリ全体が安定する理由も理解できました」

先生「理解が深まっているね。今回学んだことを意識して書くと、実践的な Jakarta サーブレットのコードが書けるようになるよ」

生徒「これからはエラーが出ることを前提に、丁寧な処理を書くように心がけます」