Comportement et utilisation du compteur dans le cache

Un compteur est un structure de données à valeur longue unique Les données sont stockées dans le cache. Vous pouvez les incrémenter, les décrémenter, les verrouiller et y enregistrer des événements. Par exemple, un compteur peut servir à enregistrer le nombre de vues d'une vidéo sur un réseau social. Il peut également servir à enregistrer les abonnements à un site web où les utilisateurs peuvent s'abonner ou se désabonner. NCache améliore encore ce compteur en fournissant NCache-des fonctionnalités spécifiques telles que Groupes, Tags, Expiration, Verrouillable, Dépendances, et plus. Par exemple, vous pouvez spécifier un compteur pour le groupe Détails de l'abonnement qui peut contenir des objets clients ainsi que le compteur d'abonnement.

Comportement

  • Null n'est pas un type de valeur pris en charge.
  • Les compteurs sont nommés. Par conséquent, vous devez fournir une clé de cache unique pour un compteur.

Pré-requis :

Avant d'utiliser le NCache Pour les API côté client, assurez-vous que les conditions préalables suivantes sont remplies :

Créer un compteur

L'exemple de code suivant montre comment créer un compteur dans le cache à l'aide de CreateCounter contre la clé de cache Compteur d'abonnement.

Astuce

Vous pouvez aussi vous configurer les attributs de recherche tels que Groupes/Tags/Tags nommés et attributs d'invalidation tels que l'expiration/l'expulsion/la dépendance lors de la création d'une structure de données.

try
{
  // Precondition: Cache is already connected

  // Specify unique cache key for counter
  string key = "SubscriptionCounter";

  // Set initial value of counter
  long initialValue = 15;

  // Create counter
  ICounter counter = cache.DataTypeManager.CreateCounter(key, initialValue);
}
catch (OperationFailedException ex)
{
    // NCache specific exception
    if(ex.ErrorCode == NCacheErrorCodes.KEY_ALREADY_EXISTS)
    {
        // The specified key already exists in the cache,
        // Either remove the existing object from the cache
        // Or specify another key
    }
    else
    {
        // NCache specific exception
        // Exception can occur due to:
        // Connection Failures
        // Operation Timeout
        // Operation performed during state transfer
    }
}
catch (Exception ex)
{
    // Any generic exception like ArgumentNullException or ArgumentException
}

Récupérer et mettre à jour la valeur du compteur

Vous pouvez mettre à jour la valeur d'un compteur après sa création. L'exemple de code suivant extrait un compteur du cache à l'aide de GetCounter et définit sa valeur sur une autre valeur, en utilisant SetValue. Il incrémente ensuite sa valeur en utilisant Increment or IncrementBy et décrémente sa valeur en utilisant Decrement or DecrementBy.

// Precondition: Cache is already connected

// Unique key for counter
string key = "SubscriptionCounter";

// Get counter against key
ICounter retrievedCounter = cache.DataTypeManager.GetCounter(key);

// Set value of counter to 100
retrievedCounter.SetValue(100);

// Increment value
long newValue =  retrievedCounter.Increment();

// Decrement value
newValue =  retrievedCounter.Decrement();

// Increment value by 10
newValue =  retrievedCounter.IncrementBy(10);

// Decrement value by 5
newValue =  retrievedCounter.DecrementBy(5);
Note

Pour garantir la sécurité de l'opération, il est recommandé de gérer toutes les exceptions potentielles au sein de votre application, comme expliqué dans Gestion des échecs.

Notifications d'événements sur les compteurs

Vous pouvez enregistrer des événements de cache, des événements basés sur des clés et des événements de structure de données sur une structure de données telle qu'un compteur. Pour le comportement, reportez-vous à comportement intelligent.

L'exemple de code suivant enregistre un événement de cache de ItemAdded et ItemUpdated ainsi qu'enregistre un événement pour ItemAdded et ItemUpdated sur le compteur dans le cache. La création d'un compteur déclenche un ItemAdded événement au niveau du cache. Lorsqu'une modification est apportée à la valeur du compteur, un ItemUpdated événement de structure de données et un ItemUpdated Des événements au niveau du cache sont déclenchés.

Enregistrer l'événement sur le compteur créé

// Precondition: Cache is already connected

// Unique cache key for counter
string key = "SubscriptionCounter";

// Set initial value of counter
long initialValue = 15;

// Create counter
ICounter counter = cache.DataTypeManager.CreateCounter(key, initialValue);

// Register ItemAdded, ItemUpdated, ItemRemoved events on counter created
// DataTypeNotificationCallback is callback method specified
counter.RegisterNotification(DataTypeDataNotificationCallback, 
        EventType.ItemAdded,
        DataTypeEventDataFilter.Data);

// Perform operations

Spécifier le rappel pour la notification d'événement

private void DataTypeDataNotificationCallback(string collectionName, DataTypeEventArg collectionEventArgs)
{
    if (collectionEventArgs.EventType == EventType.ItemUpdated)
    {
        if (collectionEventArgs.CollectionItem != null)
        {
            // Counter value has been updated
            // Perform operations
        }
    }
}

Compteur de verrouillage

Les compteurs peuvent être explicitement verrouillés et déverrouillés pour assurer la cohérence des données. L'exemple de code suivant crée un compteur et le verrouille pendant 10 secondes à l'aide de Verrouillage puis le déverrouille en utilisant Accéder.

// Precondition: Cache is already connected

// Counter exists with key "SubscriptionCounter"
// Cache Key
string key = "SubscriptionCounter";

// Get counter against key
ICounter counter = cache.DataTypeManager.GetCounter(key);

// Lock counter for 10 seconds
bool isLocked = counter.Lock(TimeSpan.FromSeconds(10));
if (isLocked)
{
    // Counter is successfully locked for 10 seconds
    // Unless explicitly unlocked
}
else
{
    // Counter is not locked because either:
    // Counter is not present in the cache
    // Counter is already locked
}

counter.Unlock();

Ressources supplémentaires

NCache fournit un exemple d'application pour la structure de données de compteur sur GitHub.

Voir aussi

.RAPPORTER: Alachisoft.NCache.Client.DataTypes espace de noms.
Java: com.alachisoft.ncache.client.datastructures espace de noms.
Node.js : Counter classe.