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

生徒

「Jakarta EEのJSPでエラーページを作りたいのですが、サーバーエラーがそのまま英語で出てしまいます。初心者でも分かるように、使いやすいエラーページを作る方法を知りたいです。」

先生

「JSPでは、例外が発生したときに自動的に切り替わるエラーページを設定できます。難しい設定は必要なく、初心者でも簡単に導入できます。」

生徒

「Servletやフォーム送信の途中でエラーが出ても、日本語で案内する画面が出せるんですね。具体的にどんな書き方をするのか見てみたいです。」

先生

「それでは、JSPのエラー処理と例外対応の書き方を、順番に詳しく紹介していきましょう。」

1. JSPのエラーページとは？初心者でも理解しやすい仕組み

Jakarta EEのJSPには、エラーページを自動で表示する機能があります。計算処理で発生する例外や、入力値の不具合など、サーバー側で想定外の動きが起きることは少なくありません。そのまま英語のエラー画面が表示されると利用者が混乱してしまうため、独自のエラーページを設定して、使いやすく分かりやすい案内を表示します。

特に、Webアプリケーションの開発では、信頼性や使いやすさが重要になります。見やすいエラーページを作成しておくことは、初心者の学習としても実践的なステップになります。

2. errorPage属性でJSPにエラーページを設定する方法

JSPファイルでエラーページを設定する最も簡単な方法は、pageディレクティブのerrorPage属性を記述することです。エラーが発生したとき、自動的に指定したエラーページへ移動します。


<!DOCTYPE html>
<html>
<head>
    <meta charset="UTF-8">
    <title>サンプルJSP</title>
</head>
<body>
    <%@ page errorPage="error.jsp" %>
    <%
        int number = 10 / 0;
    %>
    <p>この文章は表示されません。</p>
</body>
</html>

上のJSPでは、割り算でゼロ除算が発生し、例外がスローされます。その瞬間にerror.jspというファイルへ自動で遷移する仕組みです。

3. エラーページ側のJSPではisErrorPageを設定する

エラーページには、isErrorPageを指定します。これを設定していないと、例外情報を受け取ることができません。エラー内容を画面に表示したい場合は、必ず設定します。


<!DOCTYPE html>
<html>
<head>
    <meta charset="UTF-8">
    <title>エラーページ</title>
</head>
<body>
    <%@ page isErrorPage="true" %>
    <h2>エラーが発生しました</h2>
    <p>原因：<%= exception.getMessage() %></p>
</body>
</html>

このように、エラー内容を画面に表示したり、案内文や戻りリンクを付けたりして、利用者が迷わない画面を作ることができます。

4. web.xmlでサーバー全体のエラーページを設定する

アプリケーション全体で共通のエラーページを使いたい場合は、web.xmlで設定できます。Jakarta EEでは、状況に応じてHTTPステータスごとのエラーページも指定できます。


<web-app>
    <error-page>
        <error-code>404</error-code>
        <location>/notfound.jsp</location>
    </error-page>

    <error-page>
        <exception-type>java.lang.Exception</exception-type>
        <location>/error.jsp</location>
    </error-page>
</web-app>

この設定により、ファイルが存在しないときはnotfound.jsp、予期しない例外が起きたときはerror.jspが表示されます。初心者でも、アプリ全体のエラーページを統一できます。

5. Servletで例外を発生させてJSPへ遷移する流れ

JSPだけでなく、Servletで例外が発生したときにもエラーページが機能します。フォーム入力やデータ計算など、実際の現場ではServlet側で例外が発生することが多いため、この仕組みはとても便利です。


package servlet;

import java.io.IOException;
import jakarta.servlet.ServletException;
import jakarta.servlet.http.HttpServlet;
import jakarta.servlet.http.HttpServletRequest;
import jakarta.servlet.http.HttpServletResponse;

public class SampleServlet extends HttpServlet {
    protected void doGet(HttpServletRequest request, HttpServletResponse response)
            throws ServletException, IOException {
        throw new RuntimeException("テスト用の例外です");
    }
}

このServletにアクセスすると例外が発生し、自動的にエラーページへ遷移します。複雑な例外処理を書かなくてもよいため、初心者でも扱いやすい仕組みです。

6. エラーページで案内を追加して使いやすくする方法

エラーページには、ユーザーが操作を続けられるように、案内やリンクを追加できます。シンプルなデザインでも十分ですが、Bootstrapなどを利用すると見やすい画面を作れます。


<!DOCTYPE html>
<html>
<head>
    <meta charset="UTF-8">
    <title>エラー表示</title>
</head>
<body class="p-5">
    <%@ page isErrorPage="true" %>
    <h2 class="text-danger">エラーが発生しました</h2>
    <p>お手数ですが、再度操作をお試しください。</p>
    <p>詳細：<%= exception.getMessage() %></p>
    <a class="btn btn-primary" href="index.jsp">トップへ戻る</a>
</body>
</html>

このように案内があるだけで、ユーザーは安心して操作できます。エラーページは見た目よりも、迷わない導線が重要になります。

7. エラーページを作成するときに気をつけたいこと

初心者の開発で多いミスとして、エラーページにisErrorPageを忘れることがあります。この設定がないと、例外情報にアクセスできず、何も表示されない場合があります。また、エラーページ自体にエラーがあると、サーバーがさらに別のエラーを返してしまうこともあります。そのため、エラーページはできるだけシンプルに作成し、無理に複雑な処理を入れないことをおすすめします。

動作確認をするときは、意図的に例外を発生させて画面の内容をチェックする方法がよく使われます。