JCache 使用して、HTTP セッションをどのように永続化するかを制御します。

名前 タイプ デフォルト 説明

cacheManagerRef

最上位の cacheManager エレメント (ストリング) の参照。

HTTPセッションJCacheキャッシュを取得するために、使用されるJCache CacheManagerを参照する。

libraryRef

最上位の library エレメント (ストリング) の参照。

JCache プロバイダー・ファイルを識別します。

uri

ファイル、ディレクトリー、または URL。

ベンダー固有のJCache構成URIは、CacheManagerの取得時にJCachプロバイダーに渡されます。 設定は、cacheManagerRefが使用されている場合は無視されます。

パフォーマンス

appInCacheName

ブール値

false

デフォルトでは、アプリケーションごとの JCache セッション・キャッシュ名は、コンテキスト・ルートを使用して生成されます。 JCache セッション・キャッシュが複数のサーバーに分散されている場合、セッション・キャッシュを共有してはならない、同じコンテキスト・ルートを持つ複数のアプリケーションが存在する可能性があります。 このオプションを有効にすると、JCache キャッシュ名の競合を避けるために、アプリケーション名が JCache キャッシュ名に組み込まれます。 デフォルト値は false です。

cacheSeparator

string

%

セッション・メタ・キャッシュ名を区切るために使用される単一文字。 通常ではデフォルト値を使用してください。

scheduleInvalidationFirstHour

int
最小: 0
Max: 23

無効になった HTTP セッションを削除するために必要なキャッシュ更新の数を減らすには、このオプションを使用可能にします。 1 日のうち、アクティビティーが最も少ない 1 時間を指定します。 このオプションを使用不可にすると、無効化された HTTP セッションを除去するために、無効化プロセスが数分ごとに実行されます。

scheduleInvalidationSecondHour

int
最小: 0
Max: 23

無効になった HTTP セッションを削除するために必要なキャッシュ更新の数を減らすには、このオプションを使用可能にします。 1 日のうち、アクティビティーが最も少ない 1 時間を指定します。 このオプションを使用不可にすると、無効化された HTTP セッションを除去するために、無効化プロセスが数分ごとに実行されます。

writeContents

  • ALL_SESSION_ATTRIBUTES

  • GET_AND_SET_ATTRIBUTES

  • ONLY_SET_ATTRIBUTES

ONLY_SET_ATTRIBUTES

パーシスタント・ストアに書き込まれるセッション・データを指定します。
ALL_SESSION_ATTRIBUTES
getAttribute または setAttribute が呼び出されたかどうかに関係なく、すべての属性がパーシスタント・ストアに書き込まれます。
GET_AND_SET_ATTRIBUTES
getAttribute または setAttribute が呼び出される属性がパーシスタント・ストアに書き込まれます。 これは、getAttribute を使用して属性値を取得および変更し、そのパーシスタント・ストアへの書き込みを setAttribute を使用して明示的に要求することのないアプリケーションに有用です。
ONLY_SET_ATTRIBUTES
setAttribute が呼び出される属性のみがパーシスタント・ストアに書き込まれます。

writeFrequency

  • END_OF_SERVLET_SERVICE

  • MANUAL_UPDATE

  • TIME_BASED_WRITE

END_OF_SERVLET_SERVICE

セッション・データがパーシスタント・ストアに書き込まれるタイミングを指定します。
END_OF_SERVLET_SERVICE
セッション・データは、サーブレットが実行を完了した後にパーシスタント・ストアに書き込まれます。
MANUAL_UPDATE
セッション・データは、IBMSession オブジェクトのプログラムによる同期時にパーシスタント・ストアに書き込まれます。
TIME_BASED_WRITE
セッション・データは書き込み間隔に従ってパーシスタント・ストアに書き込まれます。

writeInterval

期間 (精度: 秒)

2m

パーシスタント・ストアにセッション・データを書き込む頻度を指定します。 この値は、時間ベースの書き込み頻度が使用可能の場合に使用されます。. 正整数の後に時間単位 (時間 (h)、分 (m)、または秒 (s)) を付けて指定してください。 例えば、30 秒は 30s と指定します。 単一エントリーに複数の値を含めることができます。 例えば、90 秒の場合、1m30s とすることができます。

cacheManager

HTTPセッションJCacheキャッシュを取得するために、使用されるJCache CacheManagerを参照する。

名前 タイプ デフォルト 説明

cachingProviderRef

最上位の cachingProvider エレメント (ストリング) の参照。

この JCache CacheManager インスタンスが使用する JCache CacheingProvider。

uri

ファイル、ディレクトリー、または URL。

ベンダー固有のJCache構成URIは、CacheManagerインスタンスの取得時にCachingProviderに渡されます。

cacheManager > cachingProvider

この JCache CacheManager インスタンスが使用する JCache CacheingProvider。

名前 タイプ デフォルト 説明

commonLibraryRef

最上位の library エレメント (コンマ区切りのストリング) の参照のリスト。

キャッシュに保管される可能性のあるクラスを含む 1 つ以上のライブラリー。

jCacheLibraryRef

最上位の library エレメント (ストリング) の参照。

JCache 実装が含まれているライブラリー。

providerClass

string

JCache javax.cacheの完全修飾されたクラス名。CachingProviderインスタンス。

cacheManager > cachingProvider > commonLibrary

キャッシュに保管される可能性のあるクラスを含む 1 つ以上のライブラリー。

名前 タイプ デフォルト 説明

apiTypeVisibility

string

spec,ibm-api,api,stable

このクラス・ローダーでサポートされる API パッケージのタイプ。この値は、API パッケージ spec、ibm-api、api、stable、third-party を任意に組み合わせたコンマ区切りリストで示されます。

description

string

管理者用の共有ライブラリーの説明

filesetRef

最上位の fileset エレメント (コンマ区切りのストリング) の参照のリスト。

このライブラリのクラスパスに含めるJARファイルまたはZIPファイルのセットを指定します

id

ストリング

固有の構成 ID。

name

string

管理者用の共有ライブラリーの名前

cacheManager > cachingProvider > commonLibrary > file

このライブラリのクラス・パスにインクルードするJARファイルまたはZIPファイルを追加します。 指定されたJARまたはZIPに含まれるクラスとリソースは、このライブラリでロードできます。

名前 タイプ デフォルト 説明

id

ストリング

固有の構成 ID。

name

ファイルのパス
必須

ファイルへのパスは、完全修飾パスまたは相対パスで指定できます。 相対パスは、$ {server.config.dir} プロパティの値に対する相対値です。

cacheManager > cachingProvider > commonLibrary > fileset

このライブラリのクラスパスに含めるJARファイルまたはZIPファイルのセットを指定します

名前 タイプ デフォルト 説明

caseSensitive

ブール値

true

検索で大/小文字を区別するかどうかを指示するブール値 (デフォルト: true)。

dir

ディレクトリーのパス

${server.config.dir}

ファイルを検索するベース・ディレクトリー。

excludes

string

検索結果から除外するファイル名パターンのコンマ区切りリストまたはスペース区切りリスト。デフォルトでは、除外されるファイルがありません。

id

ストリング

固有の構成 ID。

includes

string

*

検索結果に組み込むファイル名パターンのコンマ区切りリストまたはスペース区切りリスト (デフォルト: *)。

scanInterval

期間 (精度: ミリ秒)

0

ファイルがファイル・セットに追加されたか、ファイル・セットから削除されたかを判別するためのスキャン間隔。 個々のファイルはスキャンされません。 時間間隔の接尾部は、h-時間、m-分、s-秒、および m-ミリ秒 (例えば、2ms または 5s) になります。 スキャン間隔はデフォルトで無効になっています。またスキャン間隔の scanInterval を 0 に設定することで手動で無効にできます。. 正整数の後に時間単位 (時間 (h)、分 (m)、秒 (s)、またはミリ秒 (ms)) を付けて指定してください。 例えば、500 ミリ秒は 500ms と指定します。 単一エントリーに複数の値を含めることができます。 例えば、1.5 秒の場合、1s500ms とすることができます。

cacheManager > cachingProvider > commonLibrary > folder

このライブラリのクラス・パスに含めるフォルダを追加します。 指定されたフォルダとそのサブフォルダに含まれるクラスとリソースは、このライブラリで読み込むことができます。 指定されたフォルダに含まれる JAR ファイルと ZIP ファイルは、このライブラリのクラス・パスに追加されません。

名前 タイプ デフォルト 説明

dir

ディレクトリーのパス
必須

フォルダへのパスは、完全修飾パスまたは相対パスで指定できます。 相対パスは、$ {server.config.dir} プロパティの値に対する相対パスです。

id

ストリング

固有の構成 ID。

cacheManager > cachingProvider > commonLibrary > path

このライブラリのクラス・パスに含めるJARファイル、ZIPファイル、またはフォルダを追加します。 指定されたパスが JAR または ZIP ファイルである場合、指定された JAR または ZIP ファイルに含まれるクラスとリソースが、このライブラリ用にロードできます。 指定されたパスがフォルダの場合、指定されたフォルダとそのサブフォルダに含まれるクラスとリソースが、このライブラリの読み込みに利用できます。 指定されたフォルダに含まれる JAR ファイルと ZIP ファイルは、このライブラリのクラス・パスに追加されません。

名前 タイプ デフォルト 説明

id

ストリング

固有の構成 ID。

name

ファイル、ディレクトリー、または URL。
必須

パスは、絶対パスまたは相対パスで指定できます。 相対パスは、$ {server.config.dir} プロパティの値に対する相対パスです。

cacheManager > cachingProvider > jCacheLibrary

JCache 実装が含まれているライブラリー。

名前 タイプ デフォルト 説明

apiTypeVisibility

string

spec,ibm-api,api,stable

このクラス・ローダーでサポートされる API パッケージのタイプ。この値は、API パッケージ spec、ibm-api、api、stable、third-party を任意に組み合わせたコンマ区切りリストで示されます。

description

string

管理者用の共有ライブラリーの説明

filesetRef

最上位の fileset エレメント (コンマ区切りのストリング) の参照のリスト。

このライブラリのクラスパスに含めるJARファイルまたはZIPファイルのセットを指定します

name

string

管理者用の共有ライブラリーの名前

cacheManager > cachingProvider > jCacheLibrary > file

このライブラリのクラス・パスにインクルードするJARファイルまたはZIPファイルを追加します。 指定されたJARまたはZIPに含まれるクラスとリソースは、このライブラリでロードできます。

名前 タイプ デフォルト 説明

id

ストリング

固有の構成 ID。

name

ファイルのパス
必須

ファイルへのパスは、完全修飾パスまたは相対パスで指定できます。 相対パスは、$ {server.config.dir} プロパティの値に対する相対値です。

cacheManager > cachingProvider > jCacheLibrary > fileset

このライブラリのクラスパスに含めるJARファイルまたはZIPファイルのセットを指定します

名前 タイプ デフォルト 説明

caseSensitive

ブール値

true

検索で大/小文字を区別するかどうかを指示するブール値 (デフォルト: true)。

dir

ディレクトリーのパス

${server.config.dir}

ファイルを検索するベース・ディレクトリー。

excludes

string

検索結果から除外するファイル名パターンのコンマ区切りリストまたはスペース区切りリスト。デフォルトでは、除外されるファイルがありません。

id

ストリング

固有の構成 ID。

includes

string

*

検索結果に組み込むファイル名パターンのコンマ区切りリストまたはスペース区切りリスト (デフォルト: *)。

scanInterval

期間 (精度: ミリ秒)

0

ファイルがファイル・セットに追加されたか、ファイル・セットから削除されたかを判別するためのスキャン間隔。 個々のファイルはスキャンされません。 時間間隔の接尾部は、h-時間、m-分、s-秒、および m-ミリ秒 (例えば、2ms または 5s) になります。 スキャン間隔はデフォルトで無効になっています。またスキャン間隔の scanInterval を 0 に設定することで手動で無効にできます。. 正整数の後に時間単位 (時間 (h)、分 (m)、秒 (s)、またはミリ秒 (ms)) を付けて指定してください。 例えば、500 ミリ秒は 500ms と指定します。 単一エントリーに複数の値を含めることができます。 例えば、1.5 秒の場合、1s500ms とすることができます。

cacheManager > cachingProvider > jCacheLibrary > folder

このライブラリのクラス・パスに含めるフォルダを追加します。 指定されたフォルダとそのサブフォルダに含まれるクラスとリソースは、このライブラリで読み込むことができます。 指定されたフォルダに含まれる JAR ファイルと ZIP ファイルは、このライブラリのクラス・パスに追加されません。

名前 タイプ デフォルト 説明

dir

ディレクトリーのパス
必須

フォルダへのパスは、完全修飾パスまたは相対パスで指定できます。 相対パスは、$ {server.config.dir} プロパティの値に対する相対パスです。

id

ストリング

固有の構成 ID。

cacheManager > cachingProvider > jCacheLibrary > path

このライブラリのクラス・パスに含めるJARファイル、ZIPファイル、またはフォルダを追加します。 指定されたパスが JAR または ZIP ファイルである場合、指定された JAR または ZIP ファイルに含まれるクラスとリソースが、このライブラリ用にロードできます。 指定されたパスがフォルダの場合、指定されたフォルダとそのサブフォルダに含まれるクラスとリソースが、このライブラリの読み込みに利用できます。 指定されたフォルダに含まれる JAR ファイルと ZIP ファイルは、このライブラリのクラス・パスに追加されません。

名前 タイプ デフォルト 説明

id

ストリング

固有の構成 ID。

name

ファイル、ディレクトリー、または URL。
必須

パスは、絶対パスまたは相対パスで指定できます。 相対パスは、$ {server.config.dir} プロパティの値に対する相対パスです。

cacheManager > properties

ベンダー固有のJCache構成プロパティーは、CacheManagerインスタンスの取得時にCachingProviderに渡されます。

library

JCache プロバイダー・ファイルを識別します。

名前 タイプ デフォルト 説明

apiTypeVisibility

string

spec,ibm-api,api,stable

このクラス・ローダーでサポートされる API パッケージのタイプ。この値は、API パッケージ spec、ibm-api、api、stable、third-party を任意に組み合わせたコンマ区切りリストで示されます。

description

string

管理者用の共有ライブラリーの説明

filesetRef

最上位の fileset エレメント (コンマ区切りのストリング) の参照のリスト。

このライブラリのクラスパスに含めるJARファイルまたはZIPファイルのセットを指定します

name

string

管理者用の共有ライブラリーの名前

library > file

このライブラリのクラス・パスにインクルードするJARファイルまたはZIPファイルを追加します。 指定されたJARまたはZIPに含まれるクラスとリソースは、このライブラリでロードできます。

名前 タイプ デフォルト 説明

id

ストリング

固有の構成 ID。

name

ファイルのパス
必須

ファイルへのパスは、完全修飾パスまたは相対パスで指定できます。 相対パスは、$ {server.config.dir} プロパティの値に対する相対値です。

library > fileset

このライブラリのクラスパスに含めるJARファイルまたはZIPファイルのセットを指定します

名前 タイプ デフォルト 説明

caseSensitive

ブール値

true

検索で大/小文字を区別するかどうかを指示するブール値 (デフォルト: true)。

dir

ディレクトリーのパス

${server.config.dir}

ファイルを検索するベース・ディレクトリー。

excludes

string

検索結果から除外するファイル名パターンのコンマ区切りリストまたはスペース区切りリスト。デフォルトでは、除外されるファイルがありません。

id

ストリング

固有の構成 ID。

includes

string

*

検索結果に組み込むファイル名パターンのコンマ区切りリストまたはスペース区切りリスト (デフォルト: *)。

scanInterval

期間 (精度: ミリ秒)

0

ファイルがファイル・セットに追加されたか、ファイル・セットから削除されたかを判別するためのスキャン間隔。 個々のファイルはスキャンされません。 時間間隔の接尾部は、h-時間、m-分、s-秒、および m-ミリ秒 (例えば、2ms または 5s) になります。 スキャン間隔はデフォルトで無効になっています。またスキャン間隔の scanInterval を 0 に設定することで手動で無効にできます。. 正整数の後に時間単位 (時間 (h)、分 (m)、秒 (s)、またはミリ秒 (ms)) を付けて指定してください。 例えば、500 ミリ秒は 500ms と指定します。 単一エントリーに複数の値を含めることができます。 例えば、1.5 秒の場合、1s500ms とすることができます。

library > folder

このライブラリのクラス・パスに含めるフォルダを追加します。 指定されたフォルダとそのサブフォルダに含まれるクラスとリソースは、このライブラリで読み込むことができます。 指定されたフォルダに含まれる JAR ファイルと ZIP ファイルは、このライブラリのクラス・パスに追加されません。

名前 タイプ デフォルト 説明

dir

ディレクトリーのパス
必須

フォルダへのパスは、完全修飾パスまたは相対パスで指定できます。 相対パスは、$ {server.config.dir} プロパティの値に対する相対パスです。

id

ストリング

固有の構成 ID。

library > path

このライブラリのクラス・パスに含めるJARファイル、ZIPファイル、またはフォルダを追加します。 指定されたパスが JAR または ZIP ファイルである場合、指定された JAR または ZIP ファイルに含まれるクラスとリソースが、このライブラリ用にロードできます。 指定されたパスがフォルダの場合、指定されたフォルダとそのサブフォルダに含まれるクラスとリソースが、このライブラリの読み込みに利用できます。 指定されたフォルダに含まれる JAR ファイルと ZIP ファイルは、このライブラリのクラス・パスに追加されません。

名前 タイプ デフォルト 説明

id

ストリング

固有の構成 ID。

name

ファイル、ディレクトリー、または URL。
必須

パスは、絶対パスまたは相対パスで指定できます。 相対パスは、$ {server.config.dir} プロパティの値に対する相対パスです。

properties

ベンダー固有のJCache構成プロパティーのリストは、CacheManagerの取得時にJCacheプロバイダーに渡されます。 設定は、cacheManagerRefが使用されている場合は無視されます。