Distributed Map interface for Dynamic Caching
這項特性提供本端快取服務,您可以透過 DistributedMap API 來存取。預設快取會連結到 JNDI 中的 "services/cache/distributedmap"。快取可以通過新增 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 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 > 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 秒。
- 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 > 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 秒。