Guide du développeur d’API ScopedCacheManager

Les caches inclus dans le champ d’application permettent aux clients de stocker des données personnalisées en mémoire pour un accès plus rapide, et de définir quand elles sont invalidées. Cela peut être utile lorsque l’utilisation de données prend plus de temps à obtenir à partir de zéro, comme les résultats d’une requête sur plusieurs tables. Utilisez l’API ScopedCacheManager pour récupérer, définir et purger les données de cache pour les applications incluses dans le périmètre.

Ce guide comprend des instructions pour créer une paire cache et table à portée à 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 le 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 paires 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 le même sys_id que l’enregistrement modifié sont vidées du cache.

Création d’une paire cache et table incluse dans le champ d’application

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. Accéder à Tous > Définition du système > Caches inclus dans le champ d'application.
2. Cliquez sur Nouveau et saisissez un nom significatif dans le champ Nom du cache .
3. Saisissez un nombre dans le champ Nbre maximal 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 de cache incluses dans le périmètre occupent moins d’espace mémoire en le compressant.
6. Cliquez sur Envoyer.
   Le cache inclus dans le champ d’application a été créé.
7. Créez une paire de caches. Accéder à Tous > Définition du système > Paires de caches incluses dans le champ d'application.
8. Cliquez sur Nouveau et cliquez sur la loupe pour sélectionner un cache dans le champ Cache inclus dans le champ Scoped Cache .
9. Sélectionnez une table dans le menu Table .
10. 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 le 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 paires 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 le même sys_id que l’enregistrement modifié sont vidées du cache.
11. Cliquez sur Envoyer.
    La paire de table de cache incluse dans le périmètre a été créée et est prête à l’emploi avec l’API ScopedCacheManager .