Hitachi

Cosminexus V11 アプリケーションサーバ 機能解説 基本・開発編(Webコンテナ)


2.7.8 実行環境での設定

セッション管理機能を使用する場合,J2EEサーバの設定が必要です。

また,cosminexus.xmlを含まないJ2EEアプリケーションを使用する場合,実行環境でのプロパティの設定または変更が必要です。

〈この項の構成〉

(1) J2EEサーバの設定

J2EEサーバの設定は,簡易構築定義ファイルで実施します。セッション管理機能の定義は,簡易構築定義ファイルの論理J2EEサーバ(j2ee-server)の<configuration>タグ内に指定します。

簡易構築定義ファイルでのセッション管理機能の定義について次の表に示します。

表2‒30 簡易構築定義ファイルでのセッション管理機能の定義

項目

指定するパラメタ

設定内容

セッションパラメタのカスタマイズ

webserver.session.cookie_config.name

HTTP Cookieの名称,およびURLのパスパラメタ名を指定します。

webserver.session.cookie_config.http_only

HTTP CookieにHttpOnly属性を付けるかどうかを指定します。

webserver.session.tracking_mode

HTTPセッションの管理方法を指定します。

HttpSessionオブジェクト数の上限値の設定

webserver.session.max.throwHttpSessionLimitExceededException

HttpSessionオブジェクト数が上限値を超えた場合にcom.hitachi.software.web.session.HttpSessionLimitExceededException例外をスローするかどうかを指定します。

java.lang.IllegalStateException例外をスローする場合はfalseを指定します。

webserver.session.max.log_interval

KDJE39225-Eの出力インターバルを指定します。

セッションIDおよびHTTPレスポンスへのサーバID追加

webserver.session.server_id.enabled

セッションIDにサーバIDを付加するかどうかを指定します。

webserver.session.server_id.value

セッションIDに付加するサーバIDを指定します。

webserver.container.server_id.enabled

HTTPレスポンスに,サーバIDを示すHTTP Cookieを追加するかどうかを指定します。

webserver.container.server_id.name

HTTPレスポンスに,サーバIDを示すHTTP Cookieを追加する場合に,HTTP Cookieの名前を指定します。

webserver.container.server_id.value

HTTPレスポンスに,サーバIDを示すHTTP Cookieを追加する場合に,HTTP Cookieの値を指定します。

簡易構築定義ファイル,および指定するパラメタの詳細については,マニュアル「アプリケーションサーバ リファレンス 定義編(サーバ定義)」の「4.3 簡易構築定義ファイル」を参照してください。

(2) J2EEアプリケーションの設定

実行環境でのJ2EEアプリケーションの設定は,サーバ管理コマンドおよび属性ファイルで実施します。セッション管理機能の定義には,WAR属性ファイルを使用します。

WAR属性ファイルで指定するタグは,cosminexus.xmlと対応しています。なお,セッションパラメタのカスタマイズの定義は,Servlet3.0の標準仕様に準拠しています。cosminexus.xmlでの定義については,「2.7.7 cosminexus.xmlでの定義」を参照してください。