控制如何使用 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 |
启用此选项,以减少移除已失效的 HTTP 会话时所需要的高速缓存更新数。请指定一天内活动最少的那一个小时。禁用此选项时,失效器进程会每隔几分钟运行一次,以除去失效的 HTTP 会话。 |
|
scheduleInvalidationSecondHour |
int |
启用此选项,以减少移除已失效的 HTTP 会话时所需要的高速缓存更新数。请指定一天内活动最少的那一个小时。禁用此选项时,失效器进程会每隔几分钟运行一次,以除去失效的 HTTP 会话。 |
|
writeContents |
|
ONLY_SET_ATTRIBUTES |
指定将哪个会话数据写入持久存储。 |
writeFrequency |
|
END_OF_SERVLET_SERVICE |
指定将会话数据写入持久存储的时间。 |
writeInterval |
具有秒精度的时间段 |
2m |
指定将会话数据写入持久存储的频率。当启用基于时间的写入频率时,会使用此值。. 指定后跟时间单位的正整数,时间单位可以是小时 (h)、分钟 (m) 或秒 (s)。例如,以 30s 的形式指定 30 秒。可将多个值包括在单个条目中。例如,1m30s 相当于 90 秒。 |
这是用来获取 HTTP 会话 JCache 高速缓存的 JCache CacheManager 引用。
| Name | Type | Default | Description |
|---|---|---|---|
cachingProviderRef |
对顶级 cachingProvider 元素的引用(字符串)。 |
此 JCache CacheManager 实例所使用的 JCache CachingProvider。 |
|
uri |
文件、目录或 URL。 |
特定于供应商的 JCache 配置 URI,此 URI 在获取 CacheManager 实例时传递给 CachingProvider。 |
此 JCache CacheManager 实例所使用的 JCache CachingProvider。
| Name | Type | Default | Description |
|---|---|---|---|
commonLibraryRef |
对顶级 library 元素的引用的列表(以逗号分隔的字符串)。 |
包含可能存储在高速缓存中的任何类的一个或多个库。 |
|
jCacheLibraryRef |
对顶级 library 元素的引用(字符串)。 |
包含 JCache 实现的库。 |
|
providerClass |
string |
JCache javax.cache 标准类的名称。CachingProvider 实例。 |
包含可能存储在高速缓存中的任何类的一个或多个库。
| 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 |
管理员的共享库的名称 |
添加一个 JAR 或 ZIP 文件,以包含在该库的类路径中。 指定 JAR 或 ZIP 中包含的类和资源可用于加载该库。
| Name | Type | Default | Description |
|---|---|---|---|
id |
字符串 |
唯一配置标识。 |
|
name |
文件路径 |
文件路径可以是完全限定路径或相对路径。 相对路径与$ {server.config.dir} 属性的值有关。 |
指定一组 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 秒。 |
添加一个文件夹,以包含在该库的类路径中。 指定文件夹及其子文件夹中包含的类和资源可供该库加载。 指定文件夹中包含的 JAR 和 ZIP 文件不会添加到该库的类路径中。
| Name | Type | Default | Description |
|---|---|---|---|
dir |
目录路径 |
文件夹路径可以是完全限定路径或相对路径。 相对路径与$ {server.config.dir} 属性的值有关。 |
|
id |
字符串 |
唯一配置标识。 |
添加一个 JAR 文件、ZIP 文件或文件夹,以包含在该库的类路径中。 如果指定的路径是 JAR 或 ZIP 文件,则指定的 JAR 或 ZIP 文件中包含的类和资源可用于加载该库。 如果指定的路径是文件夹,则指定文件夹及其子文件夹中包含的类和资源可用于加载该库。 指定文件夹中包含的 JAR 和 ZIP 文件不会添加到该库的类路径中。
| Name | Type | Default | Description |
|---|---|---|---|
id |
字符串 |
唯一配置标识。 |
|
name |
文件、目录或 URL。 |
路径可以是完全合格的路径,也可以是相对路径。 相对路径与$ {server.config.dir} 属性的值有关。 |
包含 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 |
管理员的共享库的名称 |
添加一个 JAR 或 ZIP 文件,以包含在该库的类路径中。 指定 JAR 或 ZIP 中包含的类和资源可用于加载该库。
| Name | Type | Default | Description |
|---|---|---|---|
id |
字符串 |
唯一配置标识。 |
|
name |
文件路径 |
文件路径可以是完全限定路径或相对路径。 相对路径与$ {server.config.dir} 属性的值有关。 |
指定一组 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 秒。 |
添加一个文件夹,以包含在该库的类路径中。 指定文件夹及其子文件夹中包含的类和资源可供该库加载。 指定文件夹中包含的 JAR 和 ZIP 文件不会添加到该库的类路径中。
| Name | Type | Default | Description |
|---|---|---|---|
dir |
目录路径 |
文件夹路径可以是完全限定路径或相对路径。 相对路径与$ {server.config.dir} 属性的值有关。 |
|
id |
字符串 |
唯一配置标识。 |
添加一个 JAR 文件、ZIP 文件或文件夹,以包含在该库的类路径中。 如果指定的路径是 JAR 或 ZIP 文件,则指定的 JAR 或 ZIP 文件中包含的类和资源可用于加载该库。 如果指定的路径是文件夹,则指定文件夹及其子文件夹中包含的类和资源可用于加载该库。 指定文件夹中包含的 JAR 和 ZIP 文件不会添加到该库的类路径中。
| Name | Type | Default | Description |
|---|---|---|---|
id |
字符串 |
唯一配置标识。 |
|
name |
文件、目录或 URL。 |
路径可以是完全合格的路径,也可以是相对路径。 相对路径与$ {server.config.dir} 属性的值有关。 |
特定于供应商的 JCache 配置属性,当获取 CacheManager 实例时,这些属性将传递到 CachingProvider。
标识 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 |
管理员的共享库的名称 |
添加一个 JAR 或 ZIP 文件,以包含在该库的类路径中。 指定 JAR 或 ZIP 中包含的类和资源可用于加载该库。
| Name | Type | Default | Description |
|---|---|---|---|
id |
字符串 |
唯一配置标识。 |
|
name |
文件路径 |
文件路径可以是完全限定路径或相对路径。 相对路径与$ {server.config.dir} 属性的值有关。 |
指定一组 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 秒。 |
添加一个文件夹,以包含在该库的类路径中。 指定文件夹及其子文件夹中包含的类和资源可供该库加载。 指定文件夹中包含的 JAR 和 ZIP 文件不会添加到该库的类路径中。
| Name | Type | Default | Description |
|---|---|---|---|
dir |
目录路径 |
文件夹路径可以是完全限定路径或相对路径。 相对路径与$ {server.config.dir} 属性的值有关。 |
|
id |
字符串 |
唯一配置标识。 |
添加一个 JAR 文件、ZIP 文件或文件夹,以包含在该库的类路径中。 如果指定的路径是 JAR 或 ZIP 文件,则指定的 JAR 或 ZIP 文件中包含的类和资源可用于加载该库。 如果指定的路径是文件夹,则指定文件夹及其子文件夹中包含的类和资源可用于加载该库。 指定文件夹中包含的 JAR 和 ZIP 文件不会添加到该库的类路径中。
| Name | Type | Default | Description |
|---|---|---|---|
id |
字符串 |
唯一配置标识。 |
|
name |
文件、目录或 URL。 |
路径可以是完全合格的路径,也可以是相对路径。 相对路径与$ {server.config.dir} 属性的值有关。 |
特定于供应商的 JCache 配置属性的列表,这些属性在获取 CacheManager 时传递到 JCache 提供程序。 使用 cacheManagerRef 时将忽略此设置。