控制如何使用 JCache 持久存储 HTTP 会话。

Name Type Default Description

cacheManagerRef

对顶级 cacheManager 元素的引用(字符串)。

这是用来获取 HTTP 会话 JCache 高速缓存的 JCache CacheManager 引用。

libraryRef

对顶级 library 元素的引用(字符串)。

标识 JCache 提供者文件。

uri

文件、目录或 URL。

特定于供应商的 JCache 配置 URI,它在获取 CacheManager 时传递到 JCache 提供程序。 使用 cacheManagerRef 时将忽略此设置。

性能

appInCacheName

布尔型

false

缺省情况下,将使用上下文根生成每个应用程序的 JCache 会话高速缓存名称。 当 JCache 会话高速缓存分布在多个服务器中时,可能会存在多个具有相同上下文根的应用程序,这些应用程序不得共享会话高速缓存。 启用此选项后,应用程序名称将包含在 JCache 高速缓存名称中,以帮助避免有冲突的 JCache 高速缓存名称。 缺省值为 false。

cacheSeparator

string

%

用于分隔会话 meta 高速缓存名称的单个字符。 通常应该使用缺省值。

scheduleInvalidationFirstHour

int
Min: 0
Max: 23

启用此选项,以减少移除已失效的 HTTP 会话时所需要的高速缓存更新数。请指定一天内活动最少的那一个小时。禁用此选项时,失效器进程会每隔几分钟运行一次,以除去失效的 HTTP 会话。

scheduleInvalidationSecondHour

int
Min: 0
Max: 23

启用此选项,以减少移除已失效的 HTTP 会话时所需要的高速缓存更新数。请指定一天内活动最少的那一个小时。禁用此选项时,失效器进程会每隔几分钟运行一次,以除去失效的 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
在 servlet 完成执行之后,会将会话数据写入持久存储。
MANUAL_UPDATE
程序性同步 IBMSession 对象时,将会话数据写入持久存储。
TIME_BASED_WRITE
按照写入时间间隔将会话数据写入持久存储。

writeInterval

具有秒精度的时间段

2m

指定将会话数据写入持久存储的频率。当启用基于时间的写入频率时,会使用此值。. 指定后跟时间单位的正整数,时间单位可以是小时 (h)、分钟 (m) 或秒 (s)。例如,以 30s 的形式指定 30 秒。可将多个值包括在单个条目中。例如,1m30s 相当于 90 秒。

cacheManager

这是用来获取 HTTP 会话 JCache 高速缓存的 JCache CacheManager 引用。

Name Type Default Description

cachingProviderRef

对顶级 cachingProvider 元素的引用(字符串)。

此 JCache CacheManager 实例所使用的 JCache CachingProvider。

uri

文件、目录或 URL。

特定于供应商的 JCache 配置 URI,此 URI 在获取 CacheManager 实例时传递给 CachingProvider。

cacheManager > cachingProvider

此 JCache CacheManager 实例所使用的 JCache CachingProvider。

Name Type Default Description

commonLibraryRef

对顶级 library 元素的引用的列表(以逗号分隔的字符串)。

包含可能存储在高速缓存中的任何类的一个或多个库。

jCacheLibraryRef

对顶级 library 元素的引用(字符串)。

包含 JCache 实现的库。

providerClass

string

JCache javax.cache 标准类的名称。CachingProvider 实例。

cacheManager > cachingProvider > commonLibrary

包含可能存储在高速缓存中的任何类的一个或多个库。

Name Type Default Description

apiTypeVisibility

string

spec,ibm-api,api,stable

该类装入器支持的 API 包的类型。此值是下列 API 包的任意组合的逗号分隔列表:spec、ibm-api、api、stable 和第三方。

description

string

管理员的共享库的描述

filesetRef

对顶级 fileset 元素的引用的列表(以逗号分隔的字符串)。

指定一组 JAR 或 ZIP 文件,以包含在该库的类路径中

id

字符串

唯一配置标识。

name

string

管理员的共享库的名称

cacheManager > cachingProvider > commonLibrary > file

添加一个 JAR 或 ZIP 文件,以包含在该库的类路径中。 指定 JAR 或 ZIP 中包含的类和资源可用于加载该库。

Name Type Default Description

id

字符串

唯一配置标识。

name

文件路径
Required

文件路径可以是完全限定路径或相对路径。 相对路径与$ {server.config.dir} 属性的值有关。

cacheManager > cachingProvider > commonLibrary > fileset

指定一组 JAR 或 ZIP 文件,以包含在该库的类路径中

Name Type Default Description

caseSensitive

布尔型

true

指示搜索是否应区分大小写的布尔值(缺省值:true)。

dir

目录路径

${server.config.dir}

用于搜索文件的基本目录。

excludes

string

要排除在搜索结果以外的文件名模式的逗号或空格分隔列表,缺省情况下不排除任何文件。

id

字符串

唯一配置标识。

includes

string

*

要包含在搜索结果中的文件名模式的逗号或空格分隔列表(缺省值:*)。

scanInterval

具有毫秒精度的时间段

0

用于确定是向文件集添加文件还是从文件集除去文件的扫描时间间隔。 不会扫描单个文件。 时间间隔的后缀为 h(小时)、m(分钟)、s(秒)和 ms(毫秒),例如 2ms 或 5s。 缺省情况下,扫描时间间隔处于禁用状态,通过将扫描时间间隔 scanInterval 设置为 0 可手动禁用扫描时间间隔。. 指定后跟时间单位的正整数,时间单位可以是小时 (h)、分钟 (m)、秒 (s) 或毫秒 (ms)。例如,以 500ms 的形式指定 500 毫秒。可将多个值包括在单个条目中。例如,1s500ms 相当于 1.5 秒。

cacheManager > cachingProvider > commonLibrary > folder

添加一个文件夹,以包含在该库的类路径中。 指定文件夹及其子文件夹中包含的类和资源可供该库加载。 指定文件夹中包含的 JAR 和 ZIP 文件不会添加到该库的类路径中。

Name Type Default Description

dir

目录路径
Required

文件夹路径可以是完全限定路径或相对路径。 相对路径与$ {server.config.dir} 属性的值有关。

id

字符串

唯一配置标识。

cacheManager > cachingProvider > commonLibrary > path

添加一个 JAR 文件、ZIP 文件或文件夹,以包含在该库的类路径中。 如果指定的路径是 JAR 或 ZIP 文件,则指定的 JAR 或 ZIP 文件中包含的类和资源可用于加载该库。 如果指定的路径是文件夹,则指定文件夹及其子文件夹中包含的类和资源可用于加载该库。 指定文件夹中包含的 JAR 和 ZIP 文件不会添加到该库的类路径中。

Name Type Default Description

id

字符串

唯一配置标识。

name

文件、目录或 URL。
Required

路径可以是完全合格的路径,也可以是相对路径。 相对路径与$ {server.config.dir} 属性的值有关。

cacheManager > cachingProvider > jCacheLibrary

包含 JCache 实现的库。

Name Type Default Description

apiTypeVisibility

string

spec,ibm-api,api,stable

该类装入器支持的 API 包的类型。此值是下列 API 包的任意组合的逗号分隔列表:spec、ibm-api、api、stable 和第三方。

description

string

管理员的共享库的描述

filesetRef

对顶级 fileset 元素的引用的列表(以逗号分隔的字符串)。

指定一组 JAR 或 ZIP 文件,以包含在该库的类路径中

name

string

管理员的共享库的名称

cacheManager > cachingProvider > jCacheLibrary > file

添加一个 JAR 或 ZIP 文件,以包含在该库的类路径中。 指定 JAR 或 ZIP 中包含的类和资源可用于加载该库。

Name Type Default Description

id

字符串

唯一配置标识。

name

文件路径
Required

文件路径可以是完全限定路径或相对路径。 相对路径与$ {server.config.dir} 属性的值有关。

cacheManager > cachingProvider > jCacheLibrary > fileset

指定一组 JAR 或 ZIP 文件,以包含在该库的类路径中

Name Type Default Description

caseSensitive

布尔型

true

指示搜索是否应区分大小写的布尔值(缺省值:true)。

dir

目录路径

${server.config.dir}

用于搜索文件的基本目录。

excludes

string

要排除在搜索结果以外的文件名模式的逗号或空格分隔列表,缺省情况下不排除任何文件。

id

字符串

唯一配置标识。

includes

string

*

要包含在搜索结果中的文件名模式的逗号或空格分隔列表(缺省值:*)。

scanInterval

具有毫秒精度的时间段

0

用于确定是向文件集添加文件还是从文件集除去文件的扫描时间间隔。 不会扫描单个文件。 时间间隔的后缀为 h(小时)、m(分钟)、s(秒)和 ms(毫秒),例如 2ms 或 5s。 缺省情况下,扫描时间间隔处于禁用状态,通过将扫描时间间隔 scanInterval 设置为 0 可手动禁用扫描时间间隔。. 指定后跟时间单位的正整数,时间单位可以是小时 (h)、分钟 (m)、秒 (s) 或毫秒 (ms)。例如,以 500ms 的形式指定 500 毫秒。可将多个值包括在单个条目中。例如,1s500ms 相当于 1.5 秒。

cacheManager > cachingProvider > jCacheLibrary > folder

添加一个文件夹,以包含在该库的类路径中。 指定文件夹及其子文件夹中包含的类和资源可供该库加载。 指定文件夹中包含的 JAR 和 ZIP 文件不会添加到该库的类路径中。

Name Type Default Description

dir

目录路径
Required

文件夹路径可以是完全限定路径或相对路径。 相对路径与$ {server.config.dir} 属性的值有关。

id

字符串

唯一配置标识。

cacheManager > cachingProvider > jCacheLibrary > path

添加一个 JAR 文件、ZIP 文件或文件夹,以包含在该库的类路径中。 如果指定的路径是 JAR 或 ZIP 文件,则指定的 JAR 或 ZIP 文件中包含的类和资源可用于加载该库。 如果指定的路径是文件夹,则指定文件夹及其子文件夹中包含的类和资源可用于加载该库。 指定文件夹中包含的 JAR 和 ZIP 文件不会添加到该库的类路径中。

Name Type Default Description

id

字符串

唯一配置标识。

name

文件、目录或 URL。
Required

路径可以是完全合格的路径,也可以是相对路径。 相对路径与$ {server.config.dir} 属性的值有关。

cacheManager > properties

特定于供应商的 JCache 配置属性,当获取 CacheManager 实例时,这些属性将传递到 CachingProvider。

library

标识 JCache 提供者文件。

Name Type Default Description

apiTypeVisibility

string

spec,ibm-api,api,stable

该类装入器支持的 API 包的类型。此值是下列 API 包的任意组合的逗号分隔列表:spec、ibm-api、api、stable 和第三方。

description

string

管理员的共享库的描述

filesetRef

对顶级 fileset 元素的引用的列表(以逗号分隔的字符串)。

指定一组 JAR 或 ZIP 文件,以包含在该库的类路径中

name

string

管理员的共享库的名称

library > file

添加一个 JAR 或 ZIP 文件,以包含在该库的类路径中。 指定 JAR 或 ZIP 中包含的类和资源可用于加载该库。

Name Type Default Description

id

字符串

唯一配置标识。

name

文件路径
Required

文件路径可以是完全限定路径或相对路径。 相对路径与$ {server.config.dir} 属性的值有关。

library > fileset

指定一组 JAR 或 ZIP 文件,以包含在该库的类路径中

Name Type Default Description

caseSensitive

布尔型

true

指示搜索是否应区分大小写的布尔值(缺省值:true)。

dir

目录路径

${server.config.dir}

用于搜索文件的基本目录。

excludes

string

要排除在搜索结果以外的文件名模式的逗号或空格分隔列表,缺省情况下不排除任何文件。

id

字符串

唯一配置标识。

includes

string

*

要包含在搜索结果中的文件名模式的逗号或空格分隔列表(缺省值:*)。

scanInterval

具有毫秒精度的时间段

0

用于确定是向文件集添加文件还是从文件集除去文件的扫描时间间隔。 不会扫描单个文件。 时间间隔的后缀为 h(小时)、m(分钟)、s(秒)和 ms(毫秒),例如 2ms 或 5s。 缺省情况下,扫描时间间隔处于禁用状态,通过将扫描时间间隔 scanInterval 设置为 0 可手动禁用扫描时间间隔。. 指定后跟时间单位的正整数,时间单位可以是小时 (h)、分钟 (m)、秒 (s) 或毫秒 (ms)。例如,以 500ms 的形式指定 500 毫秒。可将多个值包括在单个条目中。例如,1s500ms 相当于 1.5 秒。

library > folder

添加一个文件夹,以包含在该库的类路径中。 指定文件夹及其子文件夹中包含的类和资源可供该库加载。 指定文件夹中包含的 JAR 和 ZIP 文件不会添加到该库的类路径中。

Name Type Default Description

dir

目录路径
Required

文件夹路径可以是完全限定路径或相对路径。 相对路径与$ {server.config.dir} 属性的值有关。

id

字符串

唯一配置标识。

library > path

添加一个 JAR 文件、ZIP 文件或文件夹,以包含在该库的类路径中。 如果指定的路径是 JAR 或 ZIP 文件,则指定的 JAR 或 ZIP 文件中包含的类和资源可用于加载该库。 如果指定的路径是文件夹,则指定文件夹及其子文件夹中包含的类和资源可用于加载该库。 指定文件夹中包含的 JAR 和 ZIP 文件不会添加到该库的类路径中。

Name Type Default Description

id

字符串

唯一配置标识。

name

文件、目录或 URL。
Required

路径可以是完全合格的路径,也可以是相对路径。 相对路径与$ {server.config.dir} 属性的值有关。

properties

特定于供应商的 JCache 配置属性的列表,这些属性在获取 CacheManager 时传递到 JCache 提供程序。 使用 cacheManagerRef 时将忽略此设置。