CacheItem

NCache verwendet eine „Schlüssel“- und „Wert“-Struktur zum Speichern von Objekten im Cache. Wenn ein Objekt zum Cache hinzugefügt wird, wird es als Wert und Metadaten für den angegebenen Schlüssel gespeichert. Diese Kombination aus Wert und Metadaten wird in als CacheItem definiert NCache. Der Wert der im Cache gespeicherten Objekte kann von einfachen Zeichenfolgetypen bis hin zu komplexen Objekten reichen. CacheItem-Klasse in NCache verfügt über Eigenschaften, mit denen Sie Metadaten für das Element festlegen können, das auf organisierte Weise zum Cache hinzugefügt werden soll. In Szenarien, in denen beim Hinzufügen eines Elements zum Cache mehrere Attribute festgelegt werden müssen, wird die Verwendung von CacheItem bevorzugt. Durch die Verwendung des CacheItem-Klassenobjekts entfällt das Problem der Verwendung mehrerer API-Überladungen beim Hinzufügen/Aktualisieren von Daten im Cache. Mit CacheItem können Sie problemlos die grundlegende API-Überladung verwenden und Daten problemlos hinzufügen/aktualisieren.

Bauherr

# neues CacheItem(Werttyp)

Initialisieren Sie eine neue Instanz des Cache-Elements.

Parameter:

Name und Vorname	Typ	Standard	Beschreibung
`value`	Jedes	null	Tatsächliches Objekt, das im Cache gespeichert werden soll.
`type`	JsonDataType	null

Beispiel

const ncache  = require('ncache-client');

//Initialize the Cache Cluster 
let cache = await ncache.CacheManager.getCache("test-Cache");

//Create new CacheItem
let cacheItem = new ncache.CacheItem("Value");

//set cache item expiration
let timeSpan = new ncache.TimeSpan(0, 0, 0, 1, 0, 0);
let expiration = new ncache.Expiration(ExpirationType.Absolute, timeSpan);
cacheItem.setExpiration(expiration);

//set cacahe item Priority
cacheItem.setCacheItemPriority(CacheItemPriority.High);

//Add cache item in Cache 
await cache.add('key', cacheItem);

//close the cache
await cache.close();

Methoden

# addCacheDataNotificationListener(Listener, EventType, Datenfilter)

Damit können Sie Anwendungen benachrichtigen, wenn ihre Objekte aktualisiert oder aus dem Cache entfernt werden. Listener können für den/die Ereignistyp(en) für den Schlüssel registriert werden, in den die Elemente eingefügt werden. Listener werden bei erneutem Aufruf für denselben/dieselben Ereignistyp/-typen überschrieben.

Parameter:

Name und Vorname	Typ	Beschreibung
`listener`	CacheDataModificationListener	Rückruf, der ausgelöst wird, wenn ein Element aktualisiert oder entfernt wird.
`eventType`	Feld	EventType, für den der Rückruf registriert ist
`datafilter`	Anzahl	Gibt an, ob Metadaten, Daten mit Metadaten oder keine empfangen werden sollen, wenn eine Benachrichtigung ausgelöst wird.

# getCacheItemPriority() → {CacheItemPriority}

Ruft die relative Priorität für Cache-Elemente ab, die immer dann berücksichtigt wird, wenn der Cache beginnt, Speicherplatz freizugeben und Elemente zu entfernen.

Rücksendung:

CacheItemPriority, die dem Cache-Element zugeordnet ist.

Typ: CacheItemPriority

# getCacheItemVersion() → {CacheItemVersion}

Ruft die mit dem Cache-Element verknüpfte Version ab. Version ist im Grunde ein numerischer Wert, der zur Darstellung der Version des zwischengespeicherten Elements verwendet wird, die sich bei jeder Aktualisierung eines Elements ändert.

Rücksendung:

Die mit dem Cache-Element verknüpfte Version.

Typ: CacheItemVersion

# GetCreationTime() → {Datum}

Ruft die Zeit ab, zu der das Element zum ersten Mal zum Cache hinzugefügt wurde.

Rücksendung:

Das Erstellungsdatum des Cache-Elements.

Typ: Datum

# getAbhängigkeit() → {Cache-Abhängigkeit}

Ruft die Cache-Abhängigkeitsinstanz ab, die alle mit dem Cache-Element verknüpften Abhängigkeiten enthält.

Rücksendung:

Die Cache-Abhängigkeitsinstanz, die dem Cache-Element zugeordnet ist.

Typ: Cache-Abhängigkeit

# getExpiration() → {Ablauf}

Ruft den Ablaufmechanismus für das Cache-Element ab.

Rücksendung:

Instanz, die Informationen zum Ablaufmechanismus für Cache-Elemente enthält.

Typ: Ablauf

# getGroup() → {Zeichenfolge}

Ruft die dem Cache-Element zugeordnete Gruppe ab. Es kann auf Basis von Gruppen abgefragt werden.

Rücksendung:

Die dem Cache-Element zugeordnete Gruppe.

Typ: Schnur

# getLastModifiedTime() → {Datum}

Ruft die lastModifiedTime des Cache-Elements ab. CacheItem speichert die letzte Änderungszeit des Cache-Elements. Wenn ein Element im Cache aktualisiert wird, wird auch seine letzte Änderungszeit aktualisiert. Der Zeitpunkt der letzten Änderung wird überprüft, wenn die Räumung auf der Basis der „Letztstens zuletzt verwendet“ ausgelöst wird.

Rücksendung:

Die letzte Änderungszeit des Cache-Elements.

Typ: Datum

# getNamedTags() → {NamedTagsWörterbuch}

Ruft die NamedTags-Informationen ab, die dem Cache-Element zugeordnet sind. Sie können auf der Grundlage der bereitgestellten NamedTags abgefragt werden.

Rücksendung:

NamedTags, die dem Cache-Element zugeordnet sind.

Typ: NamedTagsWörterbuch

# getResyncOptions() → {ResyncOptions}

Ruft die für das Cache-Element spezifischen ResyncOptions ab.

Rücksendung:

Für das Cache-Element spezifische ResyncOptions.

Typ: ResyncOptions

# getTags() → {Array.Etikett>}

Ruft die mit dem Cache-Element verknüpften Tag-Informationen ab und kann auf Basis der bereitgestellten Tags abgefragt werden.

Rücksendung:

Liste der mit dem Cache-Element verknüpften Tags.

Typ: Array.Etikett>

# Wert erhalten(classOb)

Gibt den im Cache-Element gespeicherten Wert zurück.

Parameter:

Name und Vorname	Typ	Beschreibung
`classOb`	JsonDataType	Gibt den Typ des vom CacheItem erhaltenen Werts an.

Rücksendung:

Betreff

# RemoveCacheDataNotificationListener(Listener, eventEnumSet)

Hebt die Registrierung des Benutzers für Benachrichtigungen über Cache-Datenänderungen auf.

Parameter:

Name und Vorname	Typ	Beschreibung
`listener`	CacheDataModificationListener	Der Listener, der für Benachrichtigungen registriert ist.
`eventEnumSet`	Feld	Ereignistyp/-typen, für die der Listener nicht registriert ist.

# setCacheItemPriority(Wert)

Legt die CacheItemPriority des Cache-Elements fest.

Parameter:

Name und Vorname	Typ	Beschreibung
`value`	Anzahl	Legt die CacheItemPriority des Cache-Elements fest.

# setCacheItemVersion(Wert)

Legt die CacheItemVersion des Cache-Elements fest.

Parameter:

Name und Vorname	Typ	Beschreibung
`value`	CacheItemVersion	Dabei handelt es sich grundsätzlich um einen numerischen Wert, der zur Darstellung der Version des zwischengespeicherten Elements verwendet wird und sich bei jeder Aktualisierung eines Elements ändert.

# setAbhängigkeit(Wert)

legt die CacheDependency von CacheItem fest

Parameter:

Name und Vorname	Typ	Beschreibung
`value`	Cache-Abhängigkeit	legt die CacheDependency von CacheItem fest

# setExpiration(Wert)

Legt den Ablauf des Cache-Elements fest.

Parameter:

Name und Vorname	Typ	Beschreibung
`value`	Ablauf	Diese Eigenschaft legt den Ablauf für das Cache-Element fest. Nach der angegebenen Zeitspanne läuft das Element aus dem Cache ab.

# setGroup(Wert)

Legt die mit dem Cache-Element verknüpfte Gruppe fest. Es kann auf Basis von Gruppen abgefragt werden.

Parameter:

Name und Vorname	Typ	Beschreibung
`value`	Schnur	Die Gruppe, die dem Cache-Element zugeordnet werden soll.

# setNamedTags(Wert)

legt NamedTags von CacheItem fest

Parameter:

Name und Vorname	Typ	Beschreibung
`value`	NamedTagsWörterbuch	NCache Anschließend können Sie Ihre Objekte anhand dieser benannten Tags durchsuchen. Benannte Tags können mithilfe dieser Eigenschaft von CacheItem angegeben werden.

# setResyncOptions(Wert)

legt ResyncOption von CacheItem fest

Parameter:

Name und Vorname	Typ	Beschreibung
`value`	ResyncOptions	legt ResyncOptions eines Cache-Elements fest

# setTags(Wert)

Legt die mit dem Cache-Element verknüpften Tag-Informationen fest. Es kann auf der Grundlage der bereitgestellten Tags abgefragt werden.

Parameter:

Name und Vorname	Typ	Beschreibung
`value`	Array.Etikett>	Liste der Tags, die dem Cache-Element zugeordnet werden sollen.

# setValue(Werttyp)

Legt den Wert des Cache-Elements fest.

Parameter:

Name und Vorname	Typ	Standard	Beschreibung
`value`	Jedes		Tatsächliches Objekt, das im Cache gespeichert werden soll.
`type`	Schnur	null