Guide du développeur de l’API ScopedCacheManager

Les caches inclus dans le périmètre permettent aux clients de stocker des données personnalisées en mémoire afin d’y accéder plus rapidement et de définir le moment où elles sont invalidées. Cela peut être utile lorsque l’utilisation de données prend plus de temps à être obtenue à partir de zéro, par exemple les résultats d’une requête sur plusieurs tables. Utilisez l’API ScopedCacheManager pour récupérer, définir et vider les données de cache pour les applications incluses dans le périmètre.

Ce guide comprend des instructions pour créer un cache inclus dans le champ d’application et une paire de tables à utiliser avec l’API ScopedCacheManager.

Vous pouvez affecter les types de paires de tables suivants à un cache inclus dans le champ d’application :

• Cache de paire de tables : lorsque vous devez effectuer une opération de mise à jour dans la table, toutes les entrées du cache sont également vidées.
• Cache de paire de lignes de table : lorsque vous devez effectuer une opération de mise à jour dans la table, seules les entrées qui ont la même sys_id que l’enregistrement modifié sont vidées du cache. Les autres entrées restent les mêmes.
• Cache de paire de colonnes de table : lorsque vous modifiez un champ dans la liste des colonnes sélectionnées, l’intégralité du cache est vidée.
• Cache de paire de colonnes et de lignes de table : lorsque vous modifiez un champ dans la liste des colonnes sélectionnées, les entrées qui ont la même sys_id que l’enregistrement modifié sont vidées du cache.

Création d’un cache inclus dans le champ d’application et d’une paire de tables

Créez un cache inclus dans le champ d’application et définissez sa paire de caches.

Avant de commencer

Rôle requis : admin

Procédure

1. Créez un cache inclus dans le champ d’application.
   1. Accéder à Tous > Définition du système > Caches inclus dans le périmètre.
   2. Cliquez sur Nouveau et entrez un nom significatif dans le champ Nom du cache .
   3. Entrez un nombre dans le champ Nombre maximum d’entrées .
      Cette valeur représente le nombre maximal d’entrées autorisées pour ce cache. La valeur maximale est 100.

      Remarque :

      Le champ Application doit inclure automatiquement le nom de l’application incluse dans le périmètre pour laquelle ce cache est créé.
   4. Assurez-vous que la case Actif est cochée.
   5. Cochez la case Toujours compresser si vous souhaitez que les valeurs du cache inclus dans le périmètre occupent moins d’espace mémoire en les compressant.
   6. Cliquez sur Envoyer.
   Le cache inclus dans le champ d’application a été créé.
2. Créez une paire de cache.
   1. Accéder à Tous > Définition du système > Paires de caches incluses dans le champ d'application.
   2. Cliquez sur Nouveau , puis cliquez sur la loupe pour sélectionner un cache dans le champ Cache inclus dans le périmètre .
   3. Sélectionnez une table dans le menu Table .
   4. Sélectionnez une option dans le menu Type de paire .
      • Cache de paire de tables : lorsque vous devez effectuer une opération de mise à jour dans la table, toutes les entrées du cache sont également vidées.
      • Cache de paire de lignes de table : lorsque vous devez effectuer une opération de mise à jour dans la table, seules les entrées qui ont la même sys_id que l’enregistrement modifié sont vidées du cache. Les autres entrées restent les mêmes.
      • Cache de paire de colonnes de table : lorsque vous modifiez un champ dans la liste des colonnes sélectionnées, l’intégralité du cache est vidée.
      • Cache de paire de colonnes et de lignes de table : lorsque vous modifiez un champ dans la liste des colonnes sélectionnées, les entrées qui ont la même sys_id que l’enregistrement modifié sont vidées du cache.
   5. Cliquez sur Envoyer.
   La paire de tables de caches inclus dans le périmètre a été créée et est prête à être utilisée avec l’API ScopedCacheManager .