JSPのpageディレクティブのsession属性を完全解説！初心者でもわかるHttpSessionとの関係と使い方

1. JSPのpageディレクティブとsession属性とは何か

1. JSPのpageディレクティブとsession属性とは何か

JSPは、Javaを利用したWebアプリケーションでHTML画面を作成するために使われる仕組みです。Servletで処理した利用者情報、商品情報、検索結果などをJSPへ渡し、ブラウザへ表示する画面を作成できます。

JSPには、そのページ全体に関係する設定を指定するためのpageディレクティブがあります。pageディレクティブでは、文字コード、Javaクラスの読み込み、エラー処理、セッション利用など、JSPをどのような条件で動かすのかを設定できます。

その中でsession属性は、そのJSPページでセッション機能を利用するかどうかを指定するための属性です。Java ServletではHttpSessionを使って、ログイン中の利用者情報やショッピングカートなどを複数のリクエストにまたがって保持できます。

JSPでもセッション情報を参照することができ、その利用可否に関係するのがpageディレクティブのsession属性です。

<%@ page session="true" %>

<h1>会員ページ</h1>

この例では、そのJSPでセッションを利用する設定を明示しています。JSP初心者は、session属性をHttpSessionを利用するページかどうかを指定する設定だと考えると理解しやすいでしょう。

2. session属性のtrueとfalseの違いを理解しよう

2. session属性のtrueとfalseの違いを理解しよう

pageディレクティブのsession属性には、セッションを利用する設定と利用しない設定があります。基本的にはtrueまたはfalseを指定します。

sessionをtrueにすると、そのJSPでは暗黙オブジェクトとして用意されるsessionを利用できます。ログイン中の利用者名やセッションに保存された商品情報などをJSPから参照できます。

<%@ page
    contentType="text/html; charset=UTF-8"
    pageEncoding="UTF-8"
    session="true"
%>

<h1>ログイン後のページ</h1>

一方、sessionをfalseにすると、そのJSPでは暗黙オブジェクトとしてのsessionを利用しません。

<%@ page
    contentType="text/html; charset=UTF-8"
    pageEncoding="UTF-8"
    session="false"
%>

<h1>公開ページ</h1>
<p>このページではセッションを利用しません。</p>

例えば、誰でも閲覧できる単純な案内ページなどでセッション情報をまったく利用しないのであれば、sessionをfalseにすることもできます。

3. session属性を省略した場合の初期設定を覚えよう

3. session属性を省略した場合の初期設定を覚えよう

JSPのpageディレクティブでsession属性を書かなかった場合にどうなるのかも、初心者が疑問に感じやすいポイントです。

通常、session属性を省略した場合はセッションを利用できる設定として扱われます。そのため、多くのJSPではsession属性を毎回明示的に書かなくても、session暗黙オブジェクトを利用できます。

<%@ page
    contentType="text/html; charset=UTF-8"
    pageEncoding="UTF-8"
%>

<h1>会員情報</h1>

このようにsession属性が書かれていなくても、通常はセッションを利用できる状態です。そのため、既存のJSPを見たときにsession属性が見当たらないからといって、必ずセッションが利用できないわけではありません。

逆に、セッションを利用したくない場合はsessionをfalseにする必要があります。JSP初心者は、何も書かなければ通常はセッション利用可能、明確に利用しない場合はfalseと覚えると分かりやすいでしょう。

4. JSPのsession暗黙オブジェクトとは何か

4. JSPのsession暗黙オブジェクトとは何か

JSPには、あらかじめ利用できる便利なオブジェクトがあります。このようなものを暗黙オブジェクトと呼びます。requestやresponseなどと同じように、sessionも代表的なJSPの暗黙オブジェクトです。

session暗黙オブジェクトは、Java Servletで使われるHttpSessionに関係するオブジェクトです。Servlet側でセッションに保存した値をJSP側で取得したい場合などに利用できます。

例えばServletでログイン利用者の名前をセッションへ保存しているとします。

HttpSession session = request.getSession();

session.setAttribute("userName", "山田太郎");

request.getRequestDispatcher("/mypage.jsp")
        .forward(request, response);

この処理では、userNameという属性名で利用者名をHttpSessionへ保存しています。JSP側ではセッションから同じ属性名を指定して取得できます。

<%@ page
    contentType="text/html; charset=UTF-8"
    pageEncoding="UTF-8"
    session="true"
%>

<%
    String userName =
            (String) session.getAttribute("userName");
%>

<p>ログイン利用者は<%= userName %>さんです。</p>

このように、Servlet側で作成したセッションとJSP側のsession暗黙オブジェクトは関連しています。Java ServletとJSPを別々に考えるのではなく、同じ利用者のセッション情報を共有する仕組みとして理解することが重要です。

5. EL式を使ってセッション属性を表示する方法

5. EL式を使ってセッション属性を表示する方法

現在のJSPでは、JSPの中へJavaコードを直接書くよりも、Servletで処理を行い、JSPではEL式などを使って値を表示する方法が分かりやすい設計になります。

Servlet側でHttpSessionへ属性を保存しておけば、JSPではEL式を使って値を参照できます。これにより、JSPの中へgetAttributeなどのJavaメソッド呼び出しを直接書く量を減らせます。

HttpSession session = request.getSession();

session.setAttribute("userName", "佐藤花子");

request.getRequestDispatcher("/mypage.jsp")
        .forward(request, response);

JSPでは、セッションに保存されている属性をEL式から参照できます。

<%@ page
    contentType="text/html; charset=UTF-8"
    pageEncoding="UTF-8"
    session="true"
%>

<h1>マイページ</h1>
<p>こんにちは、${sessionScope.userName}さん</p>

この例では、sessionScopeを使ってセッションスコープに保存されているuserNameを参照しています。Servlet側で保存した属性名とJSP側で参照する属性名を一致させることがポイントです。

JSP初心者は、まずServletでsetAttributeを使ってセッションへ値を保存し、JSPではEL式を使って表示する流れを練習すると、ServletとJSPの役割分担を理解しやすくなります。

6. sessionをfalseにしたJSPで注意すること

6. sessionをfalseにしたJSPで注意すること

pageディレクティブでsessionをfalseにした場合、そのJSPでは暗黙オブジェクトとしてのsessionを利用できなくなります。

そのため、sessionを使ったJavaコードがJSP内に残っている状態でsessionをfalseにすると、JSPの変換やコンパイル時に問題が発生する可能性があります。

<%@ page
    contentType="text/html; charset=UTF-8"
    pageEncoding="UTF-8"
    session="false"
%>

<h1>お知らせ</h1>
<p>このページではセッションを利用しません。</p>

このような公開ページで、ログイン情報やショッピングカートなどのセッション属性をまったく参照しないのであれば、sessionをfalseにすることができます。

一方、ログイン後のマイページや購入確認画面など、利用者ごとの情報をセッションから取得する必要があるJSPでsessionをfalseにすると、期待している処理ができなくなります。

session属性を設定するときは、単純にtrueとfalseの意味だけを覚えるのではなく、そのJSPが本当にセッション情報を必要としているのかを考えることが重要です。

7. request属性とsession属性の違いを理解しよう

7. request属性とsession属性の違いを理解しよう

Java ServletとJSPを学習すると、request属性とsession属性のどちらを利用すればよいのか迷うことがあります。この二つは、値を利用できる範囲が異なります。

request属性は、基本的に一回のリクエスト処理で利用する情報に向いています。例えば検索結果、入力エラーメッセージ、確認画面へ表示する一時的な情報などです。

一方、session属性は同じ利用者の複数のリクエストにまたがって利用したい情報に向いています。代表的なのがログイン利用者やショッピングカートです。

pageディレクティブのsession属性を理解するときも、この違いを意識すると分かりやすくなります。JSPでセッション情報を必要とする場合はsessionを利用できる状態が必要ですが、一画面だけで使うデータを表示するために必ずセッションが必要というわけではありません。

何でもsessionへ保存すると、必要以上に長くデータを保持することになります。そのため、Servletで値を保存するときは、一回のリクエストだけで必要なのか、複数画面で継続して必要なのかを考えてrequestとsessionを使い分けましょう。

8. ログイン画面やショッピングカートでのsession属性の考え方

8. ログイン画面やショッピングカートでのsession属性の考え方

JSPのsession属性が特にイメージしやすいのが、ログイン機能やショッピングカートを持つWebアプリケーションです。

ログイン処理では、Servletが利用者を確認したあと、ログイン利用者の情報をHttpSessionへ保存することがあります。その後、商品一覧、マイページ、注文確認画面など複数のJSPで同じ利用者情報を利用できます。

ショッピングカートでも同様です。利用者が商品を追加したあと、別の商品ページへ移動してもカート内容を保持したい場合は、セッションを利用できます。

このようなJSPではセッション情報が必要になるため、sessionを利用できる設定にしておく必要があります。一方、会社概要や利用案内など、利用者ごとの情報が必要ない公開ページではセッションを使わない設計も考えられます。

ただし、セッションは便利だからという理由だけですべてのデータを保存するものではありません。長期間必要のない情報や一回の画面表示だけで使う情報はrequest属性などを利用し、セッションには本当に継続して必要な情報を保存するという考え方が大切です。

9. session属性でエラーになるときの確認ポイント

9. session属性でエラーになるときの確認ポイント

JSPのpageディレクティブでsession属性を設定したあと、期待したようにセッション情報を取得できない場合は、いくつかのポイントを確認すると原因を見つけやすくなります。

まず確認したいのは、sessionをfalseにしていないかという点です。JSPでsession暗黙オブジェクトを利用したい場合にfalseを指定していると、そのままでは利用できません。

次に、Servlet側で本当にHttpSessionへ必要な値を保存しているかを確認しましょう。例えばloginUserという名前で保存したのであれば、JSP側でも同じ属性名を参照する必要があります。

また、ログアウト処理などですでにセッションが無効化されている場合、それまで保存されていた値をそのまま利用することはできません。HttpSessionの状態とJSPのsession属性を別々に考えず、一連のセッション管理として確認することが重要です。

JSP初心者は、pageディレクティブのsession属性だけを単独で暗記するのではなく、ServletのHttpSession、setAttribute、getAttribute、EL式、request属性との違いまで一緒に理解すると、セッション管理の全体像をつかみやすくなります。

基本的な流れは、ServletでHttpSessionを取得し、必要な情報をセッション属性として保存し、JSPでその情報を利用するというものです。JSPでセッションを利用する場合は、pageディレクティブのsession属性がその利用に関係していることを覚えておきましょう。

また、session属性を省略した場合は通常セッションを利用できるため、既存のJSPにsessionの記述がなくても不思議ではありません。一方、sessionをfalseにしているJSPを見つけた場合は、そのページではセッション情報を利用しない設計になっている可能性があります。

JSPのpageディレクティブにあるsession属性を理解すると、ログイン機能、HttpSession、ショッピングカート、ServletからJSPへのデータ受け渡し、EL式、request属性とsession属性の違いなど、JavaのWebアプリケーションで重要な仕組みがつながって見えるようになります。単純にtrueとfalseを覚えるだけでなく、そのJSPがどの範囲の情報を必要としているのかを考えながら設定することが大切です。

まとめ

まとめ

JSPのpageディレクティブに用意されているsession属性は、そのJSPページでセッション機能を利用するかどうかを指定するための設定です。Java ServletとJSPを使ったWebアプリケーションでは、ログインした利用者の情報やショッピングカートなど、複数のリクエストや複数の画面にまたがって保持したいデータを扱うことがあります。このような利用者ごとの情報を管理するときに利用されるのがHttpSessionです。

JSPのsession属性を理解するときは、pageディレクティブだけを単独で覚えるのではなく、ServletのHttpSessionと関連付けて考えることが大切です。Servlet側でセッションへ保存した利用者名や会員情報などをJSP側でも利用できるため、ログイン後のマイページ、商品一覧、注文確認画面、ショッピングカートなどを作成するときにセッションの仕組みが役立ちます。

pageディレクティブのsession属性には、基本的にtrueまたはfalseを指定します。trueの場合はJSPでsession暗黙オブジェクトを利用できます。falseの場合は、そのJSPでsession暗黙オブジェクトを利用しない設定になります。単純にtrueが正しくfalseが間違いということではなく、そのJSPでセッション情報が必要かどうかによって使い分けます。

session属性を省略した場合は通常セッションを利用できる

JSP初心者が覚えておきたい重要なポイントの一つが、session属性を省略した場合の動作です。pageディレクティブへsession属性を書かなかった場合でも、通常はセッションを利用できる設定として扱われます。そのため、既存のJSPファイルを確認したときにsession属性が見つからなくても、セッションが利用できないという意味ではありません。

<%@ page
    contentType="text/html; charset=UTF-8"
    pageEncoding="UTF-8"
%>

<h1>会員ページ</h1>
<p>ログイン後の情報を表示します。</p>

このようにsession属性を明示していないJSPでも、通常はセッションを利用できます。一方で、そのページではセッションを使わないということを明確にしたい場合にはsessionをfalseにします。

<%@ page
    contentType="text/html; charset=UTF-8"
    pageEncoding="UTF-8"
    session="false"
%>

<h1>公開ページ</h1>
<p>このページではセッションを利用しません。</p>

会社概要や利用案内のように利用者ごとの情報を必要としないページでは、このような設定を検討できます。ただし、ログイン利用者やショッピングカートなどのセッション情報を利用するJSPでfalseを指定すると、期待した処理ができなくなるため注意が必要です。

JSPのsession暗黙オブジェクトとHttpSessionの関係

JSPには、あらかじめ利用できる暗黙オブジェクトがあります。requestやresponseなどと同じように、sessionも代表的な暗黙オブジェクトです。session暗黙オブジェクトは、Servletで利用するHttpSessionと関係しており、Servlet側で保存したセッション属性をJSP側から参照できます。

例えばログイン処理を担当するServletで利用者名をHttpSessionへ保存した場合、そのあと表示するJSPから同じ利用者名を取得できます。ServletからJSPへ画面が切り替わっても、同じ利用者のセッションとして情報を共有できるところが重要です。

HttpSession session = request.getSession();

session.setAttribute("userName", "山田太郎");

request.getRequestDispatcher("/mypage.jsp")
        .forward(request, response);

Servlet側では、まずHttpSessionを取得してからsetAttributeを使い、userNameという属性名で利用者名を保存しています。この属性名は、あとからJSPや別のServletでデータを取り出すための名前になります。

JSP側で古い書き方を利用する場合は、session暗黙オブジェクトから同じ属性名を指定して値を取り出せます。

<%@ page
    contentType="text/html; charset=UTF-8"
    pageEncoding="UTF-8"
    session="true"
%>

<%
    String userName =
            (String) session.getAttribute("userName");
%>

<p>ログイン利用者は<%= userName %>さんです。</p>

Servlet側で保存するときの属性名と、JSP側で取得するときの属性名を一致させることが大切です。例えばServletではuserNameという名前で保存しているのに、JSPではuserやnameなど別の属性名を指定すると、期待している値を取得できません。

現在のJSPではEL式を使った表示も理解しておこう

JSPではsession暗黙オブジェクトを使ってJavaのメソッドを直接呼び出す方法もありますが、現在のJSPではEL式を使って値を表示する方法も重要です。Servlet側で処理を担当し、JSPでは画面表示を中心にすることで、JavaコードとHTMLが混ざりすぎることを防ぎやすくなります。

ServletでHttpSessionへ保存した属性は、JSPのEL式からセッションスコープを指定して参照できます。これにより、JSPの中へgetAttributeなどのJavaコードを直接書く量を減らせます。

<%@ page
    contentType="text/html; charset=UTF-8"
    pageEncoding="UTF-8"
    session="true"
%>

<h1>マイページ</h1>
<p>こんにちは、${sessionScope.userName}さん</p>

この場合、sessionScopeはセッションに保存された属性を参照するために使われています。userNameはServlet側でsetAttributeを使って保存した属性名です。Servlet側でデータを準備し、JSP側ではEL式を使って表示するという流れを理解すると、Java ServletとJSPの役割分担が分かりやすくなります。

request属性とsession属性は利用できる範囲が違う

Java ServletとJSPを学ぶと、request属性とsession属性のどちらへデータを保存すればよいのか迷うことがあります。この二つの大きな違いは、保存したデータを利用する範囲です。

request属性は、基本的に一回のリクエスト処理の中で利用するデータに向いています。例えば検索結果、入力内容、入力エラーメッセージ、画面へ一度だけ表示するメッセージなどです。ServletからJSPへフォワードして表示するだけなら、request属性で十分なことがあります。

一方、session属性は複数のリクエストや複数の画面にまたがって継続して利用したい情報に向いています。ログイン利用者の情報やショッピングカートの内容などが代表例です。

何でもセッションへ保存すれば便利に見えるかもしれませんが、必要以上の情報をセッションへ保存すると、その情報を長く保持することになります。そのため、一回の画面表示だけで必要な値なのか、それとも利用者が別の画面へ移動したあとも必要なのかを考えて保存先を選ぶことが重要です。

ログイン機能ではsession属性の役割をイメージしやすい

JSPのsession属性を理解する代表的な例がログイン機能です。利用者がログインすると、Servlet側で利用者情報を確認し、ログインに成功した利用者の情報をHttpSessionへ保存することがあります。そのあと商品一覧やマイページへ移動しても、同じセッションから利用者情報を取得できます。

例えばログイン後のマイページで利用者名を表示したり、注文確認画面でログイン中の会員情報を利用したりする場合、複数のリクエストにまたがって情報を保持する必要があります。このような場面ではHttpSessionとJSPのsession属性との関係を理解しておくことが重要です。

ショッピングカートも同じ考え方です。利用者が一つの商品をカートへ追加し、そのあと別の商品ページへ移動した場合でも、カートの内容を保持したいことがあります。このような複数画面にまたがる情報はセッションと相性がよく、JSPで内容を表示する場合にはセッション情報を参照できます。

sessionをfalseにするときはページの役割を確認する

sessionをfalseに設定するときは、そのJSPで本当にセッション情報を使っていないかを確認しましょう。例えばsession暗黙オブジェクトから利用者情報を取得する処理が残っている状態でfalseに変更すると、JSPの変換やコンパイル時に問題が発生する可能性があります。

また、ログイン後のページだから必ずJSP内でsession暗黙オブジェクトを直接利用しなければならないという意味でもありません。どのようにServletとJSPを設計しているのかによってデータの渡し方は異なります。重要なのは、そのページでセッション機能が必要なのかを理解したうえで設定することです。

セッション情報を取得できないときは順番に確認しよう

JSPで期待していたセッション情報が表示されない場合は、まずpageディレクティブのsession属性を確認します。sessionを利用する必要があるJSPなのにfalseが指定されていないかを確認しましょう。

次にServlet側の処理を確認します。HttpSessionを取得しているか、setAttributeを使って必要な値を保存しているか、保存した属性名が正しいかを確認します。そしてJSP側で参照している属性名がServlet側と一致しているかも重要です。

さらに、ログアウトなどによってセッションがすでに無効になっていないかも確認する必要があります。ログアウト処理でセッションを終了した場合、それまで保存されていた利用者情報を同じように利用することはできません。

JSPのpageディレクティブにあるsession属性だけを見るのではなく、Servletでセッションを作成した場所、属性を保存した場所、JSPで値を表示している場所、セッションを終了している場所という順番で処理を追いかけると、問題の原因を探しやすくなります。

JSP初心者は、session属性、HttpSession、setAttribute、getAttribute、EL式、sessionScope、request属性を別々の用語として暗記するのではなく、一連のデータの流れとして理解するとよいでしょう。Servletで継続して使いたい情報をセッションへ保存し、JSPで必要な情報を表示するという流れを意識すると、それぞれの役割が分かりやすくなります。

pageディレクティブのsession属性を正しく理解すると、ログイン状態の保持、会員情報の表示、ショッピングカート、ServletとJSPのデータ受け渡し、EL式によるセッション属性の参照など、JavaのWebアプリケーションで頻繁に登場する機能への理解がつながります。単にtrueとfalseの意味だけを覚えるのではなく、そのJSPでどの情報をどの範囲まで利用したいのかを考えて設定することが重要です。