Scadenza assoluta dei dati nella cache

Scadenza assoluta in NCache Garantisce la coerenza dei dati invalidando gli elementi della cache a una data e ora precise, definite dal cliente. È possibile specificare una scadenza assoluta per gli elementi che devono rimanere nella cache per un periodo di tempo limitato. Ad esempio, un'azienda annuncia una vendita lampo di 24 ore su determinati prodotti. Questi elementi possono quindi essere memorizzati nella cache con una scadenza assoluta di 24 ore, in modo da essere rimossi dalla cache non appena la vendita termina.

Inoltre, questo DateTime il valore viene convertito in Ora UTC per gestire scenari in cui il server di cache e il client si trovano in fusi orari diversi. Pertanto, gli elementi scadranno esattamente all'ora specificata dall'utente.

Prerequisiti

Prima di usare il NCache Le API lato client devono garantire il rispetto dei seguenti prerequisiti:

Come aggiungere o aggiornare elementi con scadenza assoluta

Insert è lo standard NCache API per sincronizzare lo stato dell'applicazione con la cache. Puoi facilmente aggiungere o aggiornare gli elementi della cache per impostare la scadenza utilizzando l'API inserire metodo. Il CacheItem è una classe personalizzata fornita da NCache che può essere utilizzato per aggiungere dati alla cache e consente anche di impostare metadati aggiuntivi associati all'oggetto. Questi metadati definiscono le proprietà dell'elemento, come la scadenza, le dipendenze e altro ancora.

L'esempio seguente imposta il valore di Expiration proprietà a una scadenza assoluta di 5 minuti per un CacheItem. Aggiunge il CacheItem nella cache se la chiave non esiste e la aggiorna se esiste. Questo CacheItem verrà quindi rimosso dalla cache dopo 5 minuti.

Consiglio

Puoi monitorare/verificare la scadenza tramite:

  • Contatore "Conteggio cache" nel file NCache Monitorare or Contatori PerfMon.
  • utilizzando cache.Contains una volta trascorso l'intervallo di scadenza.
  • utilizzando cache.Count prima e dopo aver specificato la scadenza.
try
{
  // Precondition: Cache is already connected
  // Get product from database against given product ID
  Product product = FetchProductFromDB(1001);

  // Generate a unique cache key for this product
  string key = $"Product:{product.ProductID}";

  // Create a new CacheItem for this product
  var cacheItem = new CacheItem(product);

  // Set Expiration TimeSpan
  var expiration = new Expiration(ExpirationType.Absolute, TimeSpan.FromMinutes(5));

  cacheItem.Expiration = expiration;

  // Add/Update item with expiration
  cache.Insert(key, cacheItem);
}
catch (OperationFailedException ex)
{
    // Exception can occur due to:
    // Connection Failures 
    // Operation Timeout
    // Operation performed during state transfer
}
catch (Exception ex)
{
    // Any generic exception like ArgumentNullException or ArgumentException
}
Note:

Per garantire che l'operazione sia a prova di errore, si consiglia di gestire eventuali potenziali eccezioni all'interno dell'applicazione, come spiegato in Gestione dei guasti.

Come aggiungere o aggiornare elementi con scadenze predefinite configurate

utilizzando DefaultAbsolute consente di gestire i dati tramite valori configurati nel NCache Centro Direzionale o config.ncconf senza richiedere ridistribuzioni del codice applicativo. È possibile specificare la scadenza assoluta nell'API utilizzando DefaultAbsolute and DefaultAbsoluteLonger. Ciò offre la flessibilità di modificare il valore esternamente, se necessario, senza modificare il codice.

Il codice seguente associa la Scadenza predefinita configurata (DefaultAbsolute in questo caso) con un elemento e lo aggiunge alla cache se la chiave non esiste, e aggiorna l'elemento con la scadenza se la chiave esiste. Una volta trascorso il tempo configurato, l'elemento scade.

Consigli

Per abilitare la scadenza predefinita, è necessario abilitarla tramite NCache Centro di gestione or config.ncconf.

// Precondition: Cache is already connected
// Get product from database against given product ID
Product product = FetchProductFromDB(1001);

// Generate a unique cache key for this product
string key = $"Product:{product.ProductID}";

// Create a CacheItem instance for the product
var cacheItem = new CacheItem(product);

// Set Expiration type
var expiration = new Expiration(ExpirationType.DefaultAbsolute);

cacheItem.Expiration = expiration;

// Add/Update the item in the cache with default expiration
CacheItemVersion version = cache.Insert(key, cacheItem);

Come impostare la scadenza assoluta per gli elementi della cache esistenti

NCache fornisce inoltre la flessibilità di impostare la scadenza assoluta su un elemento della cache esistente senza doverlo reinserire nella cache. Questo viene fatto tramite CacheItemAttributes classe, che ha il AbsoluteExpiration proprietà da impostare sull'elemento della cache. Questo imposta la data e l'ora esatte in cui l'elemento deve essere invalidato nella cache. L'attributo viene quindi applicato alla chiave esistente dell'elemento, utilizzando il UpdateAttributes metodo di ICache.

L'esempio seguente imposta la scadenza assoluta per un elemento già presente nella cache senza una data di scadenza predefinita. Ciò elimina la necessità di aggiungere o reinserire l'elemento nella cache.

// Precondition: Cache is already connected
// Precondition: Item already exists in cache
string key = "Product:1001";

// Create a CacheItemAttribute for absolute expiration and set its value to 5 seconds
var attr = new CacheItemAttributes();
attr.AbsoluteExpiration = DateTime.Now.AddSeconds(5);

// Set Absolute Expiration of 5 seconds against existing key
cache.UpdateAttributes(key, attr);

Risorse addizionali

NCache fornisce un'applicazione di esempio per Absolute Expiration on GitHub.

Vedere anche

.NETTO: Alachisoft.NCache.Memorizzazione.della.cache spazio dei nomi.
Giava: com.alachisoft.ncache.runtime.caching spazio dei nomi.
Pitone: memorizzazione nella cache di ncache.runtime modulo.
Node.js: Scadenza classe.