Konfiguration

Die Konfiguration aller Cachetypen im Cúram-Cache ist vollkommen deklarativ und basiert auf den von der Anwendung bereitgestellten Konfigurationsmechanismen. Die Cachekonfigurationsparameter müssen zum Eigenschaftenabschnitt APP_CACHE hinzugefügt werden.

In der aktuellen Implementierung werden von den globalen Caches sowohl größen- als auch zeitbasierte Bereinigungsrichtlinien unterstützt, während von Mehrfachinstanzcaches nur zeitbasierte Bereinigungsregeln unterstützt werden.

Folgende Cachekonfigurationsparameter können angepasst werden:

size - Die maximale Anzahl der Elemente im Speicher. Der Standardwert beträgt 200. Der Typ lautet INT32.
evictionPolicy - Die Richtlinie zum Bereinigen von Elementen im Speicher, wenn die maximale Anzahl an Elementen im Speicher erreicht wird. Der Standardwert lautet LRU. Der Typ ist STRING. Folgende Werte sind gültig:
- LRU - zuletzt verwendete (least recently used)
- LFU - am wenigsten verwendete (least frequently used)
- FIFO - erster rein, erster raus (first in first out)
timeToLive - Die Anzahl der Sekunden, die ein Element im Cache verbleiben darf. Wenn ein positiver Wert ungleich null festgelegt ist, werden Elemente, die sich länger als der Wert für diesen Parameter (in Sekunden) im Cache befinden, gelöscht.
timeToIdle - Die Anzahl der Sekunden, die ein Element im Cache nicht verwendet werden darf, bevor es gelöscht wird. Wenn ein positiver Wert ungleich null festgelegt ist, werden Elemente, die länger als der Wert für diesen Parameter (in Sekunden) nicht verwendet wurden, gelöscht.

Alle Eigenschaften der Cachekonfiguration müssen die folgende Schreibweise aufweisen:

curam.cache.<cachegruppenname>.<cachename>.<parameter>

Dabei gilt Folgendes:

<cachegruppenname> ist der Name der Cachegruppe, zu der der Cache gehört.
<cachename> ist der Name des Cache. Er könnte auch "*" lauten, was zur Folge hätte, dass der Konfigurationsparameter auf alle Caches in dieser Cachegruppe angewendet werden würde.
<parameter> kann entweder für size, evictionPolicy, timeToIdle oder timeToLive stehen.

Im folgenden Beispiel sind für den globalen Cache curam.myproject.mycache in der globalen Standardcachegruppe curam-group eine Größe von 1000 Elementen und die Bereinigungsrichtlinie 'LRU' (Least Recently Used) konfiguriert.

Abbildung 1. Cache konfigurieren

curam.cache.curam-group.curam.myproject.mycache.size=1000
curam.cache.curam-group.curam.myproject.mycache.evictionPolicy=LRU

Im folgenden zweiten Beispiel ist für den lokalen Cache der Transaktion curam.myproject.mycache in der lokalen Cachegruppe der Transaktion transaction-group eine Leerlaufzeit von 10 Sekunden konfiguriert, während für alle anderen lokalen Caches der Transaktion ein Wert von 5 Sekunden konfiguriert ist.

Abbildung 2. Alle Caches in einer Gruppe konfigurieren

curam.cache.transaction-group.curam.myproject.mycache
                                          .timeToIdle=10
curam.cache.transaction-group.*.timeToIdle=5

Die Daten einer Cachekonfiguration, die im Repository für die Anwendungskonfigurationen gespeichert sind, können durch Übergeben der entsprechenden Werte als JVM-Systemeigenschaften überschrieben werden. Dies kann für Batchprozesse sinnvoll sein, wenn das Anwendungsprofil von der Onlineanwendung abweichen kann.

Am folgenden Beispiel wird veranschaulicht, wie der globale Cache curam.myproject.mycache in der lokalen Standardcachegruppe für einen Batchprozess inaktiviert wird.

Abbildung 3. Cache für einen Batchprozess inaktivieren

ant -f app_batchlauncher.xml
     -Dcuram.cache.curam-group.curam.myproject.mycache.size=0
     -Dbatch.userna...