Distributed Map interface for Dynamic Caching
此功能部件提供可通过 DistributedMap API 访问的本地高速缓存服务。在位于“services/cache/distributedmap”处的 JNDI 中绑定了缺省高速缓存。可通过添加网络高速缓存提供程序(例如 WebSphere eXtreme Scale)分发高速缓存。
启用此功能部件
<feature>distributedMap-1.0</feature>
受支持的 Java™ 版本
- JavaSE-1.6
- JavaSE-1.7
- JavaSE-1.8
开发依赖于此功能部件的功能部件
com.ibm.websphere.appserver.distributedMap-1.0; type="osgi.subsystem.feature"
此功能部件启用的功能部件
此功能部件提供的 IBM API 包
功能部件配置元素
可在 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 > 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 秒。
- library
- 共享库
属性名称 数据类型 缺省值 描述 apiTypeVisibility string spec,ibm-api,api 此库的类装入器将能够看到的 API 包的类型,其格式为下列项的任何组合的逗号分隔列表:规范、ibm-api、api 和第三方。 description string 管理员的共享库的描述 filesetRef 对顶级 fileset 元素的引用的列表(以逗号分隔的字符串)。 所引用文件集的标识 id 字符串 唯一配置标识。 name string 管理员的共享库的名称 - 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 秒。