上限値を設定する対象になるのは，有効なHttpSessionオブジェクトです。

有効なHttpSessionオブジェクトとは，javax.servlet.http.HttpServletRequestクラスのgetSessionメソッドで取得したHttpSessionオブジェクトのうち，次の二つの条件を満たすオブジェクトを指します。

• タイムアウトしていないオブジェクト
• invalidateメソッドが呼ばれていないオブジェクト

HttpSessionオブジェクト数の上限値を設定していると，設定した上限値を超えてHttpSessionオブジェクトを生成しようとした場合にjavax.servlet.http.HttpServletRequestクラスのgetSessionメソッドで例外が発生します。設定に応じて，次のどちらかの例外が発生します。

• java.lang.IllegalStateException
• java.lang.IllegalStateExceptionの派生クラスであるcom.hitachi.software.web.session.HttpSessionLimitExceededException

どちらの例外をスローするかは，J2EEアプリケーションのパラメタで設定します。J2EEアプリケーションの設定については，「2.7.8(1)　J2EEサーバの設定」を参照してください。

WebコンテナでのHttpSessionオブジェクト生成は，次のタイミングで実行されます。

• JSP実行時
  pageディレクティブのsession属性に「true」を指定した場合，またはsession属性を省略している場合に，JSPを実行したときを指します。
  
• FORM認証を必要とするURLへのアクセス時

設定した上限値を超えてHttpSessionオブジェクトの生成処理が発生すると，次のように動作します。

• JSP実行時に上限値を超えた場合
  JSPのユーザコードが実行される前に，java.lang.IllegalStateExceptionまたはcom.hitachi.software.web.session.HttpSessionLimitExceededExceptionがスローされます。
  
• FORM認証を必要とするURLへのアクセス時に上限値を超えた場合
  ログイン用ページにリクエストが転送される前に，java.lang.IllegalStateExceptionまたはcom.hitachi.software.web.session.HttpSessionLimitExceededExceptionがスローされます。
  

  ポイント

  com.hitachi.software.web.session.HttpSessionLimitExceededExceptionクラスを使用する場合は，J2EEアプリケーションの開発時に<Cosminexusのインストールディレクトリ>/CC/lib/ejbserver.jarをクラスパスに追加して，Javaプログラムをコンパイルしてください。

HttpSessionオブジェクト数の上限値を設定していると，設定した上限値を超えてHttpSessionオブジェクトを生成しようとした場合にKDJE39225-Eのメッセージがログに出力されます。

KDJE39225-Eは，HTTPセッションを使用するリクエストが実行されるたびに出力されるため，同じメッセージでログが埋まってしまうおそれがあります。同じメッセージが繰り返し出力されるのを抑止するために，KDJE39225-Eのインターバル（出力間隔）を設定できます。必要に応じて，インターバルを設定してください。このインターバルはWebアプリケーション単位に適用されます。

メッセージの出力インターバルの設定については，「2.7.8(1)　J2EEサーバの設定」を参照してください。