Configuration

La configuration de tous les types de cache dans Cúram Cache est entièrement déclarative et se base sur le mécanisme de configuration fourni par l'application. Les paramètres de configuration de cache doivent être ajoutés à la section APP_CACHE des propriétés.

Dans l'implémentation actuelle, les caches globaux prennent en charge à la fois les stratégie d'expulsion basées sur la taille et la durée alors que les caches multi-instance ne prennent en charge que la stratégie d'expulsion basée sur la durée.

Les paramètres de configuration de cache suivants peuvent être ajustés :

Taille – Nombre maximum d'éléments en mémoire. La valeur par défaut est 200. Le type est INT32.
Stratégie d'expulsion – Stratégie utilisée pour expulser des éléments de la mémoire lorsque le nombre maximum d'éléments en mémoire est atteint. La valeur par défaut est LRU. Le type est STRING. Les valeurs admises sont les suivantes :
- LRU – Le moins récemment utilisé
- LFU – Le moins fréquemment utilisé
- FIFO – Premier entré, premier sorti
Durée de vie - Durée, en secondes, de conservation d'un élément dans un cache. Lorsque ce paramètre est défini sur une valeur positive différente de zéro, tous les éléments en cache depuis une durée supérieure à la valeur de ce paramètre, en secondes, sont supprimés.
Durée d'inactivité - Durée, en secondes, pendant laquelle un élément du cache peut rester inactif avant d'être supprimé. Lorsque ce paramètre est défini sur une valeur positive différente de zéro, tous les éléments inactifs depuis une durée supérieure à la valeur de ce paramètre, en secondes, sont supprimés.

Toutes les propriétés de configuration de cache doivent respecter la notation suivante :

curam.cache.<cache_group_name>.<cache_name>.<parameter>

où :

<cache_group_name> - est le nom du groupe de cache auquel appartient le cache.
<cache_name> - est le nom du cache. Il peut également s'agir de "*" ; le paramètre de configuration est alors appliqué à tous les caches dans ce groupe de cache.
<parameter> - peut être size , evictionPolicy, timeToIdle ou timeToLive.

Dans l'exemple ci-dessous, le cache global est curam.myproject.mycache dans le groupe de cache global par défaut curam-group est configuré avec une taille de 1000 éléments et la stratégie d'expulsion Le moins récemment utilisé.

Figure 1. Configuration d'un cache

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

Dans ce second exemple, le cache local de transaction curam.myproject.mycache du groupe de caches locaux de transaction transaction-group est configuré avec une durée d'inactivité de 10 secondes alors que tous les autres caches locaux de transaction sont configurés avec une valeur de 5 secondes.

Figure 2. Configuration de tous les caches d'un groupe

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

Les données de configuration de cache stockées dans le référentiel de configuration d'application peuvent être remplacées en passant les valeurs pertinentes en tant que propriétés systèmes JVM. Cela peut s'avérer utile pour les traitements par lots où le profil d'application peut différer de l'application en ligne.

Voici un exemple de désactivation du cache global curam.myproject.mycache dans le groupe de caches globaux par défaut pour un traitement par lots.

Figure 3. Désactivation d'un cache pour un traitement par lots

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