Distributed Map interface for Dynamic Caching

這項特性提供本端快取服務,您可以透過 DistributedMap API 來存取。預設快取會連結到 JNDI 中的 "services/cache/distributedmap"。快取可以通過新增 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 boolean false 要使用 jar: 或 wsjar: URL 來參照保存檔中的檔案
distributedMap
本端快取的分散式對映配置。
屬性名稱 資料類型 預設值 說明
cacheProviderName string default 指定替代快取提供者的名稱。
highThreshold int

下限:-1

上限:100

-1 指定何時啟動記憶體快取收回原則。這個臨界值是用記憶體快取大小 (MB) 的百分比來表示。
id string   唯一的配置 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
資料類型:string
distributedMap > diskCache
說明:啟用磁碟卸載,以指定當快取已滿時,即會將快取項目從快取中移除,並儲存在磁碟中。位置是磁碟卸載功能所用的完整目錄位置。「停止時沖寫至磁碟」選項指定當伺服器停止時,將記憶體快取內容移至磁碟。
必要:false
資料類型:
屬性名稱 資料類型 預設值 說明
evictionPolicy
  • RANDOM
  • SIZE
RANDOM 指定磁碟快取在收回項目時所用的收回演算法和臨界值。當磁碟大小抵達高臨界值限制時,磁碟快取記憶體回收器就會起動,且會收回磁碟中隨機選取(隨機)或最大(大小)的項目,直到磁碟大小到達低臨界值限制為止。
RANDOM
隨機
SIZE
大小
flushToDiskOnStopEnabled boolean false 如果將這個值設為 true,則在伺服器停止時,會將快取到記憶體中的物件儲存在磁碟中。如果「啟用磁碟卸載」設為 false,就會忽略這個值。
highThreshold int

下限:0

上限:100

80 指定開始收回原則的時機。
location 目錄的路徑   指定進行磁碟卸載時所用的目錄。
lowThreshold int

下限:0

上限:100

70 指定結束收回原則的時機。
sizeInEntries int

下限:0

100000 指定項目數,以作為磁碟快取大小上限值。
sizeInGB int

下限:3

3 指定磁碟快取大小上限值 (GB)。
distributedMap > library
說明:指定共用程式庫的參照。
必要:false
資料類型:
屬性名稱 資料類型 預設值 說明
apiTypeVisibility string spec,ibm-api,api 這個程式庫的類別載入器將能夠看到的 API 套件類型,方式為下列項目之任何組合的逗點區隔清單:spec、ibm-api、api、third-party。
description string   管理者的共用程式庫說明
filesetRef 最上層 fileset 元素的參照清單(逗點區隔的字串)。   參照的檔案集 ID
name string   管理者的共用程式庫名稱
distributedMap > library > file
說明:參照的檔案 ID
必要:false
資料類型:
屬性名稱 資料類型 預設值 說明
id string   唯一的配置 ID。
name 檔案的路徑   完整檔名
distributedMap > library > fileset
說明:參照的檔案集 ID
必要:false
資料類型:
屬性名稱 資料類型 預設值 說明
caseSensitive boolean true 指出搜尋是否應該區分大小寫的布林值(預設值:true)。
dir 目錄的路徑 ${server.config.dir} 搜尋檔案的基本目錄。
excludes string   要從搜尋結果中且以逗點或空格區隔的檔名型樣清單,預設為不排除任何檔案。
id string   唯一的配置 ID。
includes string * 要併入搜尋結果中且以逗點或空格區隔的檔名型樣清單(預設值:*)。
scanInterval 精準度是毫秒的時間量 0 用以檢查檔案集之變更的掃描間隔,以時間單位字尾 h-小時、m-分鐘、s-秒、ms-毫秒的長整數來表示(例如 2ms 或 5s)。預設為已停用 (scanInterval=0)。. 指定正整數加上時間單位,時間單位可以是小時 (h)、分鐘 (m)、秒 (s) 或毫秒 (ms)。例如,指定 500 毫秒為 500ms。您可以在單一項目中包括多個值。例如,1s500ms 相等於 1.5 秒。
distributedMap > library > folder
說明:參照的資料夾 ID
必要:false
資料類型:
屬性名稱 資料類型 預設值 說明
dir 目錄的路徑   要併到程式庫類別路徑中以便尋找資源檔的目錄或資料夾
id string   唯一的配置 ID。
library
共用程式庫
屬性名稱 資料類型 預設值 說明
apiTypeVisibility string spec,ibm-api,api 這個程式庫的類別載入器將能夠看到的 API 套件類型,方式為下列項目之任何組合的逗點區隔清單:spec、ibm-api、api、third-party。
description string   管理者的共用程式庫說明
filesetRef 最上層 fileset 元素的參照清單(逗點區隔的字串)。   參照的檔案集 ID
id string   唯一的配置 ID。
name string   管理者的共用程式庫名稱
library > file
說明:參照的檔案 ID
必要:false
資料類型:
屬性名稱 資料類型 預設值 說明
id string   唯一的配置 ID。
name 檔案的路徑   完整檔名
library > fileset
說明:參照的檔案集 ID
必要:false
資料類型:
屬性名稱 資料類型 預設值 說明
caseSensitive boolean true 指出搜尋是否應該區分大小寫的布林值(預設值:true)。
dir 目錄的路徑 ${server.config.dir} 搜尋檔案的基本目錄。
excludes string   要從搜尋結果中且以逗點或空格區隔的檔名型樣清單,預設為不排除任何檔案。
id string   唯一的配置 ID。
includes string * 要併入搜尋結果中且以逗點或空格區隔的檔名型樣清單(預設值:*)。
scanInterval 精準度是毫秒的時間量 0 用以檢查檔案集之變更的掃描間隔,以時間單位字尾 h-小時、m-分鐘、s-秒、ms-毫秒的長整數來表示(例如 2ms 或 5s)。預設為已停用 (scanInterval=0)。. 指定正整數加上時間單位,時間單位可以是小時 (h)、分鐘 (m)、秒 (s) 或毫秒 (ms)。例如,指定 500 毫秒為 500ms。您可以在單一項目中包括多個值。例如,1s500ms 相等於 1.5 秒。
library > folder
說明:參照的資料夾 ID
必要:false
資料類型:
屬性名稱 資料類型 預設值 說明
dir 目錄的路徑   要併到程式庫類別路徑中以便尋找資源檔的目錄或資料夾
id string   唯一的配置 ID。

指示主題類型的圖示 參照主題

資訊中心條款 | 意見


「時間戳記」圖示 前次更新: 2015 年 6 月 22 日
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