物件快取實例設定

物件快取實例是在預設共用動態快取之外的一個位置，任何 Java Platform Enterprise Edition (Java EE) 應用程式都可以在其中儲存、配送和共用資料。這使應用程式能更靈活、更恰當地調整快取資源。請利用 DistributedMap 程式設計介面來存取這個快取實例。如需相關資訊，請參閱 API 說明文件。

如果要檢視這個管理主控台頁面，請按一下資源 > 快取實例 > 物件快取實例 > cache_instance_name。

名稱

指定必要的資源顯示名稱。在 Cell 內，這個名稱必須是唯一的。

雖然 CacheInstance 資源可以建立在不同的範圍內，但這些資源仍必須有唯一名稱，以便 Cell 內的每個 CacheProvider 都有唯一識別。

JNDI 名稱

指定資源的 Java 命名和目錄介面 (JNDI) 名稱。請在查看指向這個快取實例的參照時，使用這個名稱。結果會傳回 DistributedMap 物件。

這個名稱在範圍內必須是唯一的。

說明

請指定資源的說明。這個欄位是選用的。

種類

指定用來分類或分組資源的種類字串。這個欄位是選用的。

快取記憶體大小

指定代表快取記憶體所保留的項目數上限的正整數。快取記憶體大小通常是以千為單位。

參考資訊	值
預設值	2000
範圍	100 - 200,000

預設優先順序

指定可以快取的 Servlet 的預設優先順序。這個值決定項目保留在完整快取記憶體中的時間長度。

建議值是 1。範圍是 1 至 255。

啟用磁碟卸載

指定是否要啟用磁碟卸載。

如果您停用了磁碟卸載，則若是在快取記憶體已滿時建立新項目，會利用配置給每個項目的優先順序以及最近最少使用的演算法來從記憶體快取中移除項目。如果啟用磁碟卸載，則會從快取記憶體中移除的項目會被複製到本端檔案系統。檔案的位置由磁碟卸載位置指定。

註：

若要改善磁碟卸載效能，請對每一個 JVM 僅使用一個硬碟。 [2013 年 2 月更新]

參考資訊	值
預設值	false

卸載位置

指定磁碟卸載所用的目錄。

如果沒有指定磁碟卸載位置，就會使用預設位置 ${WAS_TEMP_DIR}/node/server name/_dynacache/cache JNDI name。如果指定了磁碟卸載位置，就會附加節點、伺服器名稱和快取實例名稱。例如，${USER_INSTALL_ROOT}/diskoffload 會產生位置 ${USER_INSTALL_ROOT}/diskoffload/node/server name/cache JNDI name。如果沒有啟用磁碟卸載，就會忽略這個值。

${WAS_TEMP_DIR} 內容的預設值是 ${USER_INSTALL_ROOT}/temp。如果您在啟動產品後變更了 ${WAS_TEMP_DIR} 內容的值，但是沒有將磁碟快取內容移到新位置：

應用程式伺服器就會在新的磁碟卸載位置中，建立一個新的磁碟快取檔案。
如果有啟用「沖寫到磁碟」設定，則當您重新啟動應用程式伺服器時，在舊位置的所有磁碟快取內容都會全部喪失。

沖寫至磁碟

指定當伺服器停止時，記憶體內的快取物件是否要儲存到磁碟中。如果未選取啟用磁碟卸載，就會忽略這個值。

參考資訊	值
預設值	false

限制磁碟快取記憶體大小 (GB)

指定磁碟快取記憶體大小上限值 (GB)。當您選取這個選項時，您可以指定正的整數值。保持這個選項空白，就表示無大小限制。只有在指定啟用快取記憶體的磁碟卸載時，這項設定才適用。

參考資訊	值
值	0 至 MAXINT。 0 值表示無大小限制。

限制磁碟快取記憶體大小（項目數）

指定磁碟快取記憶體大小上限值（項目數）。當您選取這個選項時，您可以指定正的整數值。保持這個選項空白，就表示無大小限制。只有在指定啟用快取記憶體的磁碟卸載時，這項設定才適用。

參考資訊	值
值	0 至 MAXINT。 0 值表示無大小限制。

限制磁碟快取項目大小

指定個別快取項目的大小上限值 (MB)。當從記憶體中收回時，任何比這個值大的快取項目都不會卸載到磁碟中。當您選取這個選項時，您可以指定正的整數值。保持這個選項空白，就表示無大小限制。只有在指定啟用快取記憶體的磁碟卸載時，這項設定才適用。

參考資訊	值
值	0 至 MAXINT。 0 值表示無大小限制。

效能設定

指定磁碟快取記憶體所需要的效能層次。只有在指定了快取記憶體的 enableDiskOffload 時，這項設定才適用。效能層次決定了應該如何在快取記憶體清理、期限、記憶體回收等背景活動上使用記憶體資源。只有在指定啟用快取記憶體的磁碟卸載時，這項設定才適用。

參考資訊	值
高效能和高記憶體用量	指出所有 Meta 資料都將保留在記憶體中。
平衡的效能和平衡的記憶體用量	指出將部分 Meta 資料保留在記憶體中。這是預設效能設定，它會針對大部分使用者，在效能和記憶體使用之間取得最佳平衡。
低效能和低記憶體用量	指出將有限的 Meta 資料保留在記憶體中。
自訂效能	指出管理者將明確配置記憶體設定，以便用來支援上述背景活動。管理者利用 DiskCacheCustomPerformanceSettings 物件來設定這些值。

磁碟快取記憶體清理頻率

指定磁碟快取記憶體清理頻率值（分鐘）。如果這個值設為 0，就只會在午夜執行清理工作。只有在磁碟卸載效能層次是「低」、「平衡」或「自訂」時，這項設定才適用。高效能層次不需要清理磁碟，系統不處理這個值。

參考資訊	值
值	0 至 1440

每個 Meta 項目之快取 ID 的緩衝區上限

指定記憶體針對磁碟快取 Meta 資料中之個別相依關係 ID 或範本而儲存之快取 ID 的數目上限值。如果超出這個限制，資訊會卸載到磁碟中。只有在磁碟卸載效能層次是自訂時，這項設定才適用。

參考資訊	值
值	100 到 MAXINT

相依關係 ID 的緩衝區上限

指定記憶體中的磁碟快取 Meta 資料相依關係 ID 儲存區的數目上限值。如果超出這個限制，資訊會卸載到磁碟中。只有在磁碟快取效能層次是自訂時，這項設定才適用。

參考資訊	值
值	100 到 MAXINT

範本的緩衝區上限

指定記憶體中的磁碟快取 Meta 資料中之範本儲存區的數目上限值。如果超出這個限制，資訊會卸載到磁碟中。只有在磁碟快取效能層次是自訂時，這項設定才適用。

參考資訊	值
值	10 到 MAXINT

收回原則演算法

指定在到達高臨界值之後，磁碟快取記憶體將用來收回項目的收回演算法。只有在指定啟用快取記憶體的磁碟卸載時，這項設定才適用。

參考資訊	值
無	沒有收回原則，因此，磁碟快取記憶體可以持續增長到達到它的限制，這時動態快取服務會停止寫入磁碟
隨機	當磁碟大小到達高臨界值限制時，會起動磁碟快取記憶體回收器，且會隨機挑選和收回磁碟中的項目，直到大小達到低臨界值限制為止。
大小	當磁碟大小到達高臨界值限制時，會起動磁碟快取記憶體回收器，且會挑選和收回磁碟中最大的項目，直到磁碟大小達到低臨界值限制為止。

高臨界值

指定執行收回原則的時機。這個臨界值是用磁碟快取記憶體大小的百分比來表示（GB 或項目數）。一旦磁碟大小超過高臨界值限制，即會啟動磁碟快取記憶體回收器。低值用以限制「磁碟快取記憶體大小 (GB)」和「磁碟快取記憶體大小（項目數）」。當磁碟快取記憶體收回原則設為「無」時，這項設定不適用。

參考資訊	值
值	1 至 100

低臨界值

指定結束收回原則的時機。這個臨界值是用磁碟快取記憶體大小的百分比來表示（GB 或項目數）。低值用以限制「磁碟快取記憶體大小 (GB)」和「磁碟快取記憶體大小（項目數）」。一旦啟動磁碟快取記憶體回收器，它會收回項目，直到磁碟大小已達低臨界值限制為止。當磁碟快取記憶體收回原則設為「無」時，這項設定不適用。

參考資訊	值
值	1 至 100

使用接聽器環境定義

將這個值設定為 true，會利用接聽器的 Java EE 環境定義，將失效事件傳送至已登錄的失效接聽器。如果您要在回呼上使用接聽器 Java EE 環境定義，請將這個值設定為 true。如果您要在回呼上使用呼叫端執行緒環境定義，請將這個值設定為 false。

相依 ID 支援

指定動態快取服務支援快取項目相依 ID。如果您不需要使用相依 ID，請停用這個選項，相依 ID 元素指定將多個快取項目關聯於您快取原則中的相同群組 ID 的其他快取群組 ID。

舊版產品所建立的快取實例可能無法使用這個選項。

參考資訊	值
預設值	True

啟用快取抄寫

使用快取抄寫，以便能與同一個抄寫網域中的其他伺服器共用快取 ID、快取項目和快取失效。

這個選項可能無法用於舊版產品所建立的快取實例。

完整群組抄寫網域

指定從中抄寫您資料的抄寫網域。

指定從中抄寫您資料的抄寫網域。請選擇任何已定義的抄寫網域。如果沒有列出任何抄寫網域，您必須在叢集建立期間建立一個，或在管理主控台中，手動按一下環境 > 內部抄寫網域 > 新建加以建立。您選擇要與動態快取服務搭配使用的抄寫網域必須使用「完整群組複本」。請勿在抄寫消費端之間共用抄寫網域。動態快取記憶體應該使用與階段作業管理程式或 Stateful Session Bean 不同的抄寫網域。

抄寫類型

指定這個快取實例的廣域共用原則。

可用的設定如下：

推送和拉出會將新更新之內容的快取 ID 傳送給抄寫網域中的其他伺服器。之後，如果其他伺服器中的任何一個伺服器要求內容，且擁有先前更新之內容的快取項目 ID，它會從發佈伺服器中擷取內容。如果是就先前沒有發佈的 ID 來發出要求，伺服器會假設它在叢集中不存在，且會建立一個新的項目。
只有拉出會在應用程式伺服器之間，隨需應變來分享這個物件的快取項目。如果應用程式伺服器遺漏這個物件的快取，它會查詢協同運作的應用程式伺服器，看它們有沒有這個物件。如果沒有任何應用程式伺服器有這個物件的快取複本，原始應用程式伺服器就會執行要求和產生物件。這些項目不能儲存不可序列化的資料。不建議您採用這共用模式。
只有推送會將新內容的快取 ID 和快取內容傳送給抄寫網域中的所有其他伺服器。
不共用的共用原則會造成不與抄寫網域的其他伺服器共用快取 ID 和快取內容。

無叢集作業環境的預設值是不共用。當啟用抄寫時，預設值是不共用。

當啟用抄寫時，預設值是不共用。

推送頻率

指定將新的快取項目或修改過的快取項目推向其他伺服器之前所要等待的秒數。

[2013 年 2 月更新] 如果您將這個內容值設為 1（一）或更大，應用程式伺服器會將在該期間建立或修改的所有快取項目推送到其他伺服器。如果您將內容設為 0（零）或負值，則應用程式伺服器會將內容值轉換為預設值 1（一）。 [2013 年 2 月更新]

檔名： udyn_cacheinstancescollection.html