カテゴリ: Servlet 更新日: 2025/08/07

JavaのHttpSessionListenerのsessionCreatedメソッドとは?初心者でもわかるセッション生成検知の仕組み

HttpSessionListenerのsessionCreatedメソッド
HttpSessionListenerのsessionCreatedメソッド

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

生徒

「JavaのWebアプリケーションで、ユーザーのセッションが作られたタイミングを知るにはどうすればいいですか?」

先生

「それにはHttpSessionListenerというインターフェースを使います。その中のsessionCreatedメソッドで、セッションが生成されたときの処理を書くことができますよ。」

生徒

「ログを取ったり初期化したりする処理も書けますか?」

先生

「もちろんです。では、sessionCreatedメソッドの使い方を詳しく見ていきましょう。」

1. HttpSessionListenerとは

1. HttpSessionListenerとは
1. HttpSessionListenerとは

Javaのjavax.servlet.http.HttpSessionListenerインターフェースは、Webアプリケーションにおいてセッションの生成や破棄のイベントを検知するための仕組みです。ユーザーがWebサイトにアクセスし、サーバー側で新しいセッションが作成されるときに通知を受け取ることができます。

このインターフェースを使うことで、セッションライフサイクルに連動した処理を簡単に実装できます。

2. sessionCreatedメソッドとは

2. sessionCreatedメソッドとは
2. sessionCreatedメソッドとは

sessionCreatedメソッドは、HttpSessionListenerインターフェースに定義されているメソッドのひとつで、サーバーが新しいセッションを生成した瞬間に呼び出されます。

ユーザーがWebサイトに初めてアクセスしたときや、前のセッションが無効になり新しいセッションが作られたときに、このメソッドが自動で実行されます。

3. sessionCreatedメソッドの用途

3. sessionCreatedメソッドの用途
3. sessionCreatedメソッドの用途

sessionCreatedメソッドは以下のような用途で活用されます:

  • セッション開始のタイミングでログを出力する
  • ユーザーごとの初期データをセッションに保存する
  • アクティブなセッション数をカウントする
  • 不正アクセス検知用の監視処理を追加する

4. sessionCreatedメソッドの実装例

4. sessionCreatedメソッドの実装例
4. sessionCreatedメソッドの実装例

以下にsessionCreatedメソッドを実装したHttpSessionListenerのサンプルコードを示します。セッションが生成されるたびにIDをログ出力しています。


import jakarta.servlet.http.HttpSessionEvent;
import jakarta.servlet.http.HttpSessionListener;

public class MySessionLogger implements HttpSessionListener {
    @Override
    public void sessionCreated(HttpSessionEvent event) {
        String sessionId = event.getSession().getId();
        System.out.println("セッションが生成されました: " + sessionId);
    }

    @Override
    public void sessionDestroyed(HttpSessionEvent event) {
        // ここではセッション破棄時の処理を書く(今回は省略)
    }
}

5. web.xmlまたはアノテーションによる登録

5. web.xmlまたはアノテーションによる登録
5. web.xmlまたはアノテーションによる登録

HttpSessionListenerをWebアプリケーションに反映させるには、web.xmlにリスナーとして登録するか、@WebListenerアノテーションを使います。

web.xmlでの記述例:

<listener>
    <listener-class>com.example.MySessionLogger</listener-class>
</listener>
@WebListenerアノテーションを使う方法:

import jakarta.servlet.annotation.WebListener;

@WebListener
public class MySessionLogger implements HttpSessionListener {
    @Override
    public void sessionCreated(HttpSessionEvent event) {
        System.out.println("セッション開始: " + event.getSession().getId());
    }

    @Override
    public void sessionDestroyed(HttpSessionEvent event) {
        // セッション終了処理(省略)
    }
}

6. 初期値をセッションに設定する例

6. 初期値をセッションに設定する例
6. 初期値をセッションに設定する例

セッション生成時に初期値を設定したい場合も、sessionCreatedで処理できます。例えば、アクセス回数を0に設定する例は以下の通りです。


@Override
public void sessionCreated(HttpSessionEvent event) {
    event.getSession().setAttribute("accessCount", 0);
    System.out.println("セッションID: " + event.getSession().getId() + " に初期値を設定しました。");
}

7. セッションの生成タイミング

7. セッションの生成タイミング
7. セッションの生成タイミング

Servletにおいて、セッションはリクエスト中でrequest.getSession()が初めて呼び出されたときに生成されます。そのため、sessionCreatedはこのタイミングで発火します。

たとえば、ログイン画面やトップページにアクセスしたタイミングでセッションが必要になり、自動的に生成されるケースが多いです。

8. 注意点と活用ポイント

8. 注意点と活用ポイント
8. 注意点と活用ポイント

セッションは、すべてのユーザーに自動で作られるわけではありません。request.getSession()が呼ばれない限り生成されないため、sessionCreatedが呼び出されない場合もあります。

また、セッション生成のたびにDBアクセスを行ったり、重い処理を入れると負荷の原因になるため注意が必要です。

必要最小限の処理にとどめ、ログ記録や初期設定などに限定するとよいでしょう。

カテゴリの一覧へ
新着記事
Springの@Transactional徹底解説!トランザクションの伝播・分離レベル・タイムアウトの基本
JavaのHashMapクラスgetメソッドの使い方を完全ガイド!初心者でもわかるjava.util入門
Thymeleafのth:fragmentを使ったテンプレートの再利用方法を完全ガイド!初心者でもわかる使い方
Javaの@PathVariableアノテーションの使い方を徹底解説!初心者でもわかるパスパラメータの基本と応用
人気記事
No.1
Java&Spring記事人気No1
Javaのラムダ式で配列を扱う!Arrays.streamの基本と注意点を初心者向けに解説
No.2
Java&Spring記事人気No2
JavaのRuntimeExceptionを完全解説!初心者でもわかるjava.langパッケージの基礎
No.3
Java&Spring記事人気No3
Spring BootとJavaの互換性一覧!3.5/3.4/3.3はJava 21・17に対応してる?
No.4
Java&Spring記事人気No4
JavaのIntegerクラスの使い方を完全ガイド!初心者でもわかる整数操作
No.5
Java&Spring記事人気No5
JavaのBigDecimalクラスcompareToメソッド完全ガイド!初心者でもわかる大小比較の基本
No.6
Java&Spring記事人気No6
Springの@Serviceアノテーションの使い方を徹底解説!初心者でもわかるSpring フレームワーク入門
No.7
Java&Spring記事人気No7
Javaの@SuppressWarningsアノテーションの使い方を完全ガイド!初心者でもわかる警告の抑制方法
No.8
Java&Spring記事人気No8
JavaのHttpSessionを徹底解説!初心者でもわかるセッション管理の基本