JSPのpageディレクティブとisErrorPage属性とは？初心者向け完全ガイド

JSPのpageディレクティブのisErrorPage属性

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

生徒

「JSPのpageディレクティブでisErrorPage属性って何に使うんですか？」

先生

「isErrorPage属性は、JSPページがエラーページとして動作するかどうかを指定するためのものです。エラーページを指定する際には必須の設定ですよ。」

生徒

「エラーページって具体的にはどんな動きをするんですか？」

先生

「エラーが発生したときに、エラーメッセージを表示したり、例外オブジェクトを使ってエラーの詳細を表示する役割があります。具体例を見ながら説明していきますね！」

1. JSPのpageディレクティブとは？

JSPのpageディレクティブは、JSPファイル全体の動作を設定するための命令であり、ファイルの先頭に記述されます。このディレクティブを使用することで、エラーページの設定や文字エンコーディング、セッション管理など、ページ全体の動作を細かく制御できます。

主なpageディレクティブの属性：

使用するプログラミング言語の指定（language）
文字エンコーディングの設定（pageEncoding）
エラーページの指定（errorPage）
エラーページでの動作指定（isErrorPage）

基本構文は以下の通りです：


<%@ page 属性="値" 属性="値" ... %>

2. isErrorPage属性とは？

isErrorPage属性は、JSPページがエラーページとして動作するかどうかを指定するための属性です。この属性がtrueに設定されている場合、例外オブジェクト（exception）を使用してエラーの詳細を取得することができます。

基本的な使い方：


<%@ page isErrorPage="true" %>

エラーページとして動作させるには、この属性をtrueに設定する必要があります。

3. isErrorPage属性の使用例

以下は、isErrorPage属性を設定したエラーページの例です。このエラーページは、発生したエラーの詳細を表示します。


<%@ page isErrorPage="true" %>
<!DOCTYPE html>
<html>
<head>
    <title>エラーページ</title>
</head>
<body>
    <h1>エラーが発生しました</h1>
    <p>エラー内容：<%= exception.getMessage() %></p>
</body>
</html>

このエラーページでは、exception.getMessage()を使用してエラーの詳細メッセージを表示しています。

4. エラー処理の流れ

エラー処理を行うには、エラーが発生するページでerrorPage属性を設定し、エラーページでisErrorPage属性を設定する必要があります。以下はその例です：


<!-- エラーを発生させるページ -->
<%@ page errorPage="errorPage.jsp" %>
<!DOCTYPE html>
<html>
<head>
    <title>エラーページ設定</title>
</head>
<body>
    <h1>エラーを発生させるページ</h1>
    <%
        int result = 10 / 0; // 故意にエラーを発生
    %>
</body>
</html>

<!-- エラーページ -->
<%@ page isErrorPage="true" %>
<!DOCTYPE html>
<html>
<head>
    <title>エラーページ</title>
</head>
<body>
    <h1>エラーが発生しました</h1>
    <p>エラー内容：<%= exception.getMessage() %></p>
</body>
</html>

この設定により、エラーが発生すると自動的にエラーページに遷移します。

5. isErrorPage属性の注意点

isErrorPage属性を使用する際には、以下の点に注意してください：

エラーページでは必ずisErrorPage="true"を指定する必要があります。
エラーページではexceptionオブジェクトが自動的に利用可能になります。
エラーページのデザインを整えることで、ユーザーに安心感を与えることができます。

6. エラーページのカスタマイズ

エラーページをカスタマイズすることで、よりユーザーフレンドリーなエラーメッセージを提供することが可能です。以下はカスタマイズされたエラーページの例です：


<%@ page isErrorPage="true" %>
<!DOCTYPE html>
<html>
<head>
    <title>カスタムエラーページ</title>
</head>
<body>
    <h1>エラーが発生しました</h1>
    <p>エラーの種類：<%= exception.getClass().getName() %></p>
    <p>エラーの内容：<%= exception.getMessage() %></p>
    <a href="/">トップページに戻る</a>
</body>
</html>

7.まとめ

isErrorPage属性を使用することで、エラーページとして機能するJSPページを簡単に設定できることがわかりました。エラーページを作成することで、ユーザーに対して適切なエラーメッセージを表示し、アプリケーションの信頼性を高めることができます。また、exceptionオブジェクトを活用することで、詳細なエラー情報を表示したり、エラーの種類ごとに適切な対応を提供することも可能です。実際にコードを記述してみることで、その効果を確認することができました。

以下に振り返りとして、シンプルなサンプルプログラムを示します。


<%@ page isErrorPage="true" %>
<!DOCTYPE html>
<html>
<head>
    <title>振り返り用エラーページ</title>
</head>
<body>
    <h1>エラーが発生しました</h1>
    <p>エラー詳細：<%= exception.getMessage() %></p>
</body>
</html>

このコードを通して、エラー発生時にどのようにページが動作するのかを体験してみてください。

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

生徒

「isErrorPage属性を設定することで、例外オブジェクトを利用できるようになるんですね！」

先生

「その通りです。エラーページで適切な情報を表示するためには、この属性の設定が欠かせません。」

生徒

「エラーページのデザインを工夫することで、ユーザーにもわかりやすい情報を提供できますね。」

先生

「そうです。ユーザー体験を向上させるために、見やすく使いやすいエラーページを作ることが重要です。」

サーブレットやJSPの基礎を体系的に理解したい人には、定番の入門書がこちらです。

スッキリわかるサーブレット＆JSP入門をAmazonで見る

※ Amazon広告リンク

元・職業訓練講師が直接指導【サーブレット & JSP実践セミナー】

職業訓練講師が解剖！Java Web開発の真髄「Servlet/JSP」とMVCアーキテクチャの本質。

累計120万PV超の技術メディア運営チームが贈る、商用開発基準の特別カリキュラム

職業訓練講師が解剖！Java Web開発の真髄「Servlet/JSP」とMVCアーキテクチャの本質。

Spring Boot等のモダンなフレームワークの背後で動く、Web開発の原点ServletとJSP。本講座では、HTTPリクエストからレスポンスまでのライフサイクルを徹底解剖。MVCモデルの真の役割分担を明確にし、ブラックボックス化されたWebの仕組みを「自力で制御する力」を60分で養います。