控制如何使用 JCache 來持續保存 HTTP 階段作業。

名稱 類型 預設值 說明

cacheManagerRef

最上層 cacheManager 元素的參照(字串)。

用來取得 HTTP 階段作業 JCache 快取的 JCache CacheManager 參照。

libraryRef

最上層 library 元素的參照(字串)。

識別 JCache 提供者檔案。

uri

檔案、目錄或 URL。

供應商特定的 JCache 配置 URI,在取得 CacheManager 時,會傳遞給 JCache 提供者。 當使用 cacheManagerRef 時,會忽略這項設定。

效能

appInCacheName

boolean

false

依預設,會使用環境定義根目錄來產生每個應用程式的 JCache 階段作業快取名稱。 當 JCache 階段作業快取分散在多部伺服器時,可能有多個環境定義根目錄相同的應用程式存在,且不能共用階段作業快取。 當啟用這個選項時,應用程式名稱會包含在 JCache 快取名稱中,以協助避免 JCache 快取名稱衝突。 預設值為 false。

cacheSeparator

string

%

用來區隔階段作業 meta 快取名稱的單一字元。 通常應使用預設值。

scheduleInvalidationFirstHour

int
下限: 0
上限: 23

啟用這個選項時,可減少移除失效 HTTP 階段作業所需的快取更新數目。當活動最少時,請指定一天一小時。當這個選項停用時,失效程式程序會每隔幾分鐘執行來移除失效的 HTTP 階段作業。

scheduleInvalidationSecondHour

int
下限: 0
上限: 23

啟用這個選項時,可減少移除失效 HTTP 階段作業所需的快取更新數目。當活動最少時,請指定一天一小時。當這個選項停用時,失效程式程序會每隔幾分鐘執行來移除失效的 HTTP 階段作業。

writeContents

  • ALL_SESSION_ATTRIBUTES

  • GET_AND_SET_ATTRIBUTES

  • ONLY_SET_ATTRIBUTES

ONLY_SET_ATTRIBUTES

指定要寫入至持續儲存庫的階段作業資料。
ALL_SESSION_ATTRIBUTES
不論是否呼叫 getAttribute 或 setAttribute,都會將所有屬性寫入至持續儲存庫。
GET_AND_SET_ATTRIBUTES
將會呼叫其 getAttribute 或 setAttribute 的屬性寫入至持續儲存庫。如果應用程式會使用 getAttribute 來取得並改變屬性值,而不使用 setAttribute 來明確要求將它們寫入至持續儲存庫,則這樣做很有幫助。
ONLY_SET_ATTRIBUTES
只將會呼叫其 setAttribute 的屬性寫入至持續儲存庫。

writeFrequency

  • END_OF_SERVLET_SERVICE

  • MANUAL_UPDATE

  • TIME_BASED_WRITE

END_OF_SERVLET_SERVICE

指定階段作業資料何時寫入持續儲存庫。
END_OF_SERVLET_SERVICE
階段作業資料會在 Servlet 完成執行之後寫入持續儲存庫。
MANUAL_UPDATE
在 IBMSession 物件完成程式化同步時,將階段作業資料寫入至持續儲存庫。
TIME_BASED_WRITE
根據寫入間隔,將階段作業資料寫入至持續儲存庫。

writeInterval

精準度是秒鐘的時間量

2m

指定階段作業資料寫入至持續儲存庫的頻率。當啟用時間型寫入頻率時,會使用此值。. 指定正整數加上時間單位,時間單位可以是小時 (h)、分鐘 (m) 或秒 (s)。例如,指定 30 秒為 30s。您可以在單一項目中包括多個值。例如,1m30s 相等於 90 秒。

cacheManager

用來取得 HTTP 階段作業 JCache 快取的 JCache CacheManager 參照。

名稱 類型 預設值 說明

cachingProviderRef

最上層 cachingProvider 元素的參照(字串)。

這個 JCache CacheManager 實例使用的 JCache CachingProvider。

uri

檔案、目錄或 URL。

供應商特定的 JCache 配置 URI,在取得 CacheManager 實例時,會傳遞給 CachingProvider。

cacheManager > cachingProvider

這個 JCache CacheManager 實例使用的 JCache CachingProvider。

名稱 類型 預設值 說明

commonLibraryRef

最上層 library 元素的參照清單(逗點區隔的字串)。

一個以上的程式庫,其中包含可能儲存在快取中的任何類別。

jCacheLibraryRef

最上層 library 元素的參照(字串)。

包含 JCache 實作的程式庫。

providerClass

string

JCache javax.cache 的完整類別名稱。CachingProvider 實例。

cacheManager > cachingProvider > commonLibrary

一個以上的程式庫,其中包含可能儲存在快取中的任何類別。

名稱 類型 預設值 說明

apiTypeVisibility

string

spec,ibm-api,api,stable

這個類別載入器支援這種 API 套件的類型。值是下列 API 套件之任何組合的逗點區隔清單:spec、ibm-api、api、stable、third-party。

description

string

管理者的共用程式庫說明

filesetRef

最上層 fileset 元素的參照清單(逗點區隔的字串)。

指定要包含在此函式庫類別路徑中的 JAR 或 ZIP 檔案集

id

字串

唯一的配置 ID。

name

string

管理者的共用程式庫名稱

cacheManager > cachingProvider > commonLibrary > file

新增 JAR 或 ZIP 檔案,以包含在此函式庫的類別路徑中。 指定的 JAR 或 ZIP 中包含的類別和資源可供此函式庫載入。

名稱 類型 預設值 說明

id

字串

唯一的配置 ID。

name

檔案的路徑
必要

檔案的路徑可以是完全限定路徑或相對路徑。 相對路徑是相對於 $ {server.config.dir} 屬性的值。

cacheManager > cachingProvider > commonLibrary > fileset

指定要包含在此函式庫類別路徑中的 JAR 或 ZIP 檔案集

名稱 類型 預設值 說明

caseSensitive

boolean

true

指出搜尋是否應該區分大小寫的布林值(預設值:true)。

dir

目錄的路徑

${server.config.dir}

搜尋檔案的基本目錄。

excludes

string

要從搜尋結果中且以逗點或空格區隔的檔名型樣清單,預設為不排除任何檔案。

id

字串

唯一的配置 ID。

includes

string

*

要併入搜尋結果中且以逗點或空格區隔的檔名型樣清單(預設值:*)。

scanInterval

精準度是毫秒的時間量

0

掃描間隔,用來判定是否從檔案集新增或移除檔案。 不會掃描個別檔案。 時間間隔的字尾是 h-小時、m-分鐘、s-秒及ms-毫秒,例如 2ms 或 5s。 依預設會停用掃描間隔,並透過將掃描間隔 scanInterval 設為 0 來手動停用。. 指定正整數加上時間單位,時間單位可以是小時 (h)、分鐘 (m)、秒 (s) 或毫秒 (ms)。例如,指定 500 毫秒為 500ms。您可以在單一項目中包括多個值。例如,1s500ms 相等於 1.5 秒。

cacheManager > cachingProvider > commonLibrary > folder

新增資料夾,以包含在此函式庫的類別路徑中。 指定資料夾及其子資料夾中所包含的類別和資源可供此函式庫載入。 指定資料夾中包含的 JAR 和 ZIP 檔案不會新增至此函式庫的類別路徑。

名稱 類型 預設值 說明

dir

目錄的路徑
必要

資料夾的路徑可以是完全限定路徑或相對路徑。 相對路徑是相對於 $ {server.config.dir} 屬性的值。

id

字串

唯一的配置 ID。

cacheManager > cachingProvider > commonLibrary > path

新增 JAR 檔案、ZIP 檔案或資料夾,以包含在此函式庫的類別路徑中。 如果指定的路徑是 JAR 或 ZIP 檔案,則指定的 JAR 或 ZIP 檔案中所包含的類和資源可供此函式庫載入。 如果指定的路徑是資料夾,則指定資料夾及其子資料夾中包含的類別和資源可供此函式庫載入。 指定資料夾中包含的 JAR 和 ZIP 檔案不會新增至此函式庫的類別路徑。

名稱 類型 預設值 說明

id

字串

唯一的配置 ID。

name

檔案、目錄或 URL。
必要

路徑可以是完全限定路徑或相對路徑。 相對路徑是相對於 $ {server.config.dir} 屬性的值。

cacheManager > cachingProvider > jCacheLibrary

包含 JCache 實作的程式庫。

名稱 類型 預設值 說明

apiTypeVisibility

string

spec,ibm-api,api,stable

這個類別載入器支援這種 API 套件的類型。值是下列 API 套件之任何組合的逗點區隔清單:spec、ibm-api、api、stable、third-party。

description

string

管理者的共用程式庫說明

filesetRef

最上層 fileset 元素的參照清單(逗點區隔的字串)。

指定要包含在此函式庫類別路徑中的 JAR 或 ZIP 檔案集

name

string

管理者的共用程式庫名稱

cacheManager > cachingProvider > jCacheLibrary > file

新增 JAR 或 ZIP 檔案,以包含在此函式庫的類別路徑中。 指定的 JAR 或 ZIP 中包含的類別和資源可供此函式庫載入。

名稱 類型 預設值 說明

id

字串

唯一的配置 ID。

name

檔案的路徑
必要

檔案的路徑可以是完全限定路徑或相對路徑。 相對路徑是相對於 $ {server.config.dir} 屬性的值。

cacheManager > cachingProvider > jCacheLibrary > fileset

指定要包含在此函式庫類別路徑中的 JAR 或 ZIP 檔案集

名稱 類型 預設值 說明

caseSensitive

boolean

true

指出搜尋是否應該區分大小寫的布林值(預設值:true)。

dir

目錄的路徑

${server.config.dir}

搜尋檔案的基本目錄。

excludes

string

要從搜尋結果中且以逗點或空格區隔的檔名型樣清單,預設為不排除任何檔案。

id

字串

唯一的配置 ID。

includes

string

*

要併入搜尋結果中且以逗點或空格區隔的檔名型樣清單(預設值:*)。

scanInterval

精準度是毫秒的時間量

0

掃描間隔,用來判定是否從檔案集新增或移除檔案。 不會掃描個別檔案。 時間間隔的字尾是 h-小時、m-分鐘、s-秒及ms-毫秒,例如 2ms 或 5s。 依預設會停用掃描間隔,並透過將掃描間隔 scanInterval 設為 0 來手動停用。. 指定正整數加上時間單位,時間單位可以是小時 (h)、分鐘 (m)、秒 (s) 或毫秒 (ms)。例如,指定 500 毫秒為 500ms。您可以在單一項目中包括多個值。例如,1s500ms 相等於 1.5 秒。

cacheManager > cachingProvider > jCacheLibrary > folder

新增資料夾,以包含在此函式庫的類別路徑中。 指定資料夾及其子資料夾中所包含的類別和資源可供此函式庫載入。 指定資料夾中包含的 JAR 和 ZIP 檔案不會新增至此函式庫的類別路徑。

名稱 類型 預設值 說明

dir

目錄的路徑
必要

資料夾的路徑可以是完全限定路徑或相對路徑。 相對路徑是相對於 $ {server.config.dir} 屬性的值。

id

字串

唯一的配置 ID。

cacheManager > cachingProvider > jCacheLibrary > path

新增 JAR 檔案、ZIP 檔案或資料夾,以包含在此函式庫的類別路徑中。 如果指定的路徑是 JAR 或 ZIP 檔案,則指定的 JAR 或 ZIP 檔案中所包含的類和資源可供此函式庫載入。 如果指定的路徑是資料夾,則指定資料夾及其子資料夾中包含的類別和資源可供此函式庫載入。 指定資料夾中包含的 JAR 和 ZIP 檔案不會新增至此函式庫的類別路徑。

名稱 類型 預設值 說明

id

字串

唯一的配置 ID。

name

檔案、目錄或 URL。
必要

路徑可以是完全限定路徑或相對路徑。 相對路徑是相對於 $ {server.config.dir} 屬性的值。

cacheManager > properties

供應商特定的 JCache 配置內容,當取得 CacheManager 實例時,會將這些內容傳遞給 CachingProvider。

library

識別 JCache 提供者檔案。

名稱 類型 預設值 說明

apiTypeVisibility

string

spec,ibm-api,api,stable

這個類別載入器支援這種 API 套件的類型。值是下列 API 套件之任何組合的逗點區隔清單:spec、ibm-api、api、stable、third-party。

description

string

管理者的共用程式庫說明

filesetRef

最上層 fileset 元素的參照清單(逗點區隔的字串)。

指定要包含在此函式庫類別路徑中的 JAR 或 ZIP 檔案集

name

string

管理者的共用程式庫名稱

library > file

新增 JAR 或 ZIP 檔案,以包含在此函式庫的類別路徑中。 指定的 JAR 或 ZIP 中包含的類別和資源可供此函式庫載入。

名稱 類型 預設值 說明

id

字串

唯一的配置 ID。

name

檔案的路徑
必要

檔案的路徑可以是完全限定路徑或相對路徑。 相對路徑是相對於 $ {server.config.dir} 屬性的值。

library > fileset

指定要包含在此函式庫類別路徑中的 JAR 或 ZIP 檔案集

名稱 類型 預設值 說明

caseSensitive

boolean

true

指出搜尋是否應該區分大小寫的布林值(預設值:true)。

dir

目錄的路徑

${server.config.dir}

搜尋檔案的基本目錄。

excludes

string

要從搜尋結果中且以逗點或空格區隔的檔名型樣清單,預設為不排除任何檔案。

id

字串

唯一的配置 ID。

includes

string

*

要併入搜尋結果中且以逗點或空格區隔的檔名型樣清單(預設值:*)。

scanInterval

精準度是毫秒的時間量

0

掃描間隔,用來判定是否從檔案集新增或移除檔案。 不會掃描個別檔案。 時間間隔的字尾是 h-小時、m-分鐘、s-秒及ms-毫秒,例如 2ms 或 5s。 依預設會停用掃描間隔,並透過將掃描間隔 scanInterval 設為 0 來手動停用。. 指定正整數加上時間單位,時間單位可以是小時 (h)、分鐘 (m)、秒 (s) 或毫秒 (ms)。例如,指定 500 毫秒為 500ms。您可以在單一項目中包括多個值。例如,1s500ms 相等於 1.5 秒。

library > folder

新增資料夾,以包含在此函式庫的類別路徑中。 指定資料夾及其子資料夾中所包含的類別和資源可供此函式庫載入。 指定資料夾中包含的 JAR 和 ZIP 檔案不會新增至此函式庫的類別路徑。

名稱 類型 預設值 說明

dir

目錄的路徑
必要

資料夾的路徑可以是完全限定路徑或相對路徑。 相對路徑是相對於 $ {server.config.dir} 屬性的值。

id

字串

唯一的配置 ID。

library > path

新增 JAR 檔案、ZIP 檔案或資料夾,以包含在此函式庫的類別路徑中。 如果指定的路徑是 JAR 或 ZIP 檔案,則指定的 JAR 或 ZIP 檔案中所包含的類和資源可供此函式庫載入。 如果指定的路徑是資料夾,則指定資料夾及其子資料夾中包含的類別和資源可供此函式庫載入。 指定資料夾中包含的 JAR 和 ZIP 檔案不會新增至此函式庫的類別路徑。

名稱 類型 預設值 說明

id

字串

唯一的配置 ID。

name

檔案、目錄或 URL。
必要

路徑可以是完全限定路徑或相對路徑。 相對路徑是相對於 $ {server.config.dir} 屬性的值。

properties

供應商特定的 JCache 配置內容清單,當取得 CacheManager 時,會將這些內容傳遞給 JCache 提供者。 當使用 cacheManagerRef 時,會忽略這項設定。