Distributed Map interface for Dynamic Caching

此功能部件提供可通过 DistributedMap API 访问的本地高速缓存服务。在位于“services/cache/distributedmap”处的 JNDI 中绑定了缺省高速缓存。可通过添加网络高速缓存提供程序(例如 WebSphere eXtreme Scale)分发高速缓存。

启用此功能部件

要启用动态高速缓存的分布式映射接口功能部件,请在 server.xml 文件的 featureManager 元素内添加以下元素声明:
<feature>distributedMap-1.0</feature>

受支持的 Java™ 版本

  • JavaSE-1.6
  • JavaSE-1.7
  • JavaSE-1.8

开发依赖于此功能部件的功能部件

如果您要开发依赖于动态高速缓存的分布式映射接口功能部件的功能部件,请在新功能部件的功能部件清单文件的 Subsystem-Content 头中添加以下项:
com.ibm.websphere.appserver.distributedMap-1.0; type="osgi.subsystem.feature"

此功能部件启用的功能部件

功能部件配置元素

可在 server.xml 文件中使用以下元素以配置动态高速缓存的分布式映射接口功能部件:

classloading
全局类装入
属性名称 数据类型 缺省值 描述
useJarUrls 布尔型 false 是将 jar: URL 还是将 wsjar: URL 用于引用归档中的文件
distributedMap
本地高速缓存的分布式映射配置。
属性名称 数据类型 缺省值 描述
cacheProviderName string default 指定备用高速缓存提供程序的名称。
highThreshold int

最小值:-1

最大值:100

-1 指定内存高速缓存逐出策略何时启动。阈值以内存高速缓存大小(以兆字节 (MB) 计)的百分比表示。
id 字符串   唯一配置标识。
jndiName string ${id} 高速缓存实例的 JNDI 名称。
libraryRef 对顶级 library 元素的引用(字符串)。   指定共享库引用。
lowThreshold int

最小值:-1

最大值:100

-1 指定内存高速缓存逐出策略何时结束。阈值以内存高速缓存大小(以兆字节 (MB) 计)的百分比表示。
memorySizeInEntries int

最小值:0

2000 指定一个正整数以定义高速缓存可以保存的最大条目数。值通常以千计。最小值为 100,未设置最大值。缺省值为 2000。
memorySizeInMB int

最小值:-1

-1 指定最大内存高速缓存大小的值(以兆字节 (MB) 计)。
distributedMap > cacheGroup
描述:指定由服务器(例如,IBM(R) WebSphere(R) Edge Server 和 IBM(R) HTTP Server)上的 WebSphere(R) Application Server 控制的外部高速缓存集。
必需:false
数据类型:
属性名称 数据类型 缺省值 描述
name string   指定外部高速缓存组的唯一名称。外部高速缓存组名必须与 servlet 或 Java(TM) Server Pages (JSP) cachespec.xml 文件中定义的 ExternalCache 属性相匹配。
distributedMap > cacheGroup > member
描述:WebSphere Application Server 控制的外部高速缓存组的成员。
必需:false
数据类型:
属性名称 数据类型 缺省值 描述
host string   标准主机名
port int

最小值:0

  端口。
distributedMap > cacheGroup > member > adapterBeanName
描述:指定 WebSphere Application Server 与此外部高速缓存之间的适配器的类名(位于 WebSphere Application Server 类路径上)。
必需:false
数据类型:字符串
distributedMap > diskCache
描述:启用磁盘卸载,以指定高速缓存变满时从高速缓存中除去高速缓存条目并将它们保存到磁盘。此位置是磁盘卸载功能使用的标准目录位置。“停止时清仓至磁盘”选项指定服务器停止时,内存高速缓存的内容移至磁盘。
必需:false
数据类型:
属性名称 数据类型 缺省值 描述
evictionPolicy
  • RANDOM
  • SIZE
RANDOM 指定磁盘高速缓存用来逐出条目的逐出算法和阈值。当磁盘大小达到阈值上限时,磁盘高速缓存垃圾收集器会唤醒,并逐出磁盘上随机选择(随机)的条目或最大(大小)条目,直到磁盘大小达到阈值下限。
RANDOM
随机
SIZE
大小
flushToDiskOnStopEnabled 布尔型 false 将此值设置为 true,以在服务器停止时将内存中高速缓存的对象保存至磁盘。如果“启用磁盘卸载”设置为 false,那么会忽略此值。
highThreshold int

最小值:0

最大值:100

80 指定逐出策略何时启动。
location 目录路径   指定要用于磁盘卸载的目录。
lowThreshold int

最小值:0

最大值:100

70 指定逐出策略何时结束。
sizeInEntries int

最小值:0

100000 指定最大磁盘高速缓存大小的值(以条目数计)。
sizeInGB int

最小值:3

3 指定最大磁盘高速缓存大小的值(以千兆字节 (MB) 计)。
distributedMap > library
描述:指定共享库引用。
必需:false
数据类型:
属性名称 数据类型 缺省值 描述
apiTypeVisibility string spec,ibm-api,api 此库的类装入器将能够看到的 API 包的类型,其格式为下列项的任何组合的逗号分隔列表:规范、ibm-api、api 和第三方。
description string   管理员的共享库的描述
filesetRef 对顶级 fileset 元素的引用的列表(以逗号分隔的字符串)。   所引用文件集的标识
name string   管理员的共享库的名称
distributedMap > library > file
描述:所引用文件的标识
必需:false
数据类型:
属性名称 数据类型 缺省值 描述
id 字符串   唯一配置标识。
name 文件路径   标准文件名
distributedMap > library > fileset
描述:所引用文件集的标识
必需:false
数据类型:
属性名称 数据类型 缺省值 描述
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 秒。
distributedMap > library > folder
描述:所引用文件夹的标识
必需:false
数据类型:
属性名称 数据类型 缺省值 描述
dir 目录路径   要包含在用于定位资源文件的库类路径中的目录或文件夹
id 字符串   唯一配置标识。
library
共享库
属性名称 数据类型 缺省值 描述
apiTypeVisibility string spec,ibm-api,api 此库的类装入器将能够看到的 API 包的类型,其格式为下列项的任何组合的逗号分隔列表:规范、ibm-api、api 和第三方。
description string   管理员的共享库的描述
filesetRef 对顶级 fileset 元素的引用的列表(以逗号分隔的字符串)。   所引用文件集的标识
id 字符串   唯一配置标识。
name string   管理员的共享库的名称
library > file
描述:所引用文件的标识
必需:false
数据类型:
属性名称 数据类型 缺省值 描述
id 字符串   唯一配置标识。
name 文件路径   标准文件名
library > fileset
描述:所引用文件集的标识
必需:false
数据类型:
属性名称 数据类型 缺省值 描述
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
描述:所引用文件夹的标识
必需:false
数据类型:
属性名称 数据类型 缺省值 描述
dir 目录路径   要包含在用于定位资源文件的库类路径中的目录或文件夹
id 字符串   唯一配置标识。

用于指示主题类型的图标 参考主题

信息中心的条款和条件 | 反馈


时间戳记图标 最近一次更新时间: Wednesday, 2 September 2015
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=phil&product=was-libcore-mp&topic=rwlp_feature_distributedMap-1.0
文件名:rwlp_feature_distributedMap-1.0.html