キャッシュ項目

NCache オブジェクトをキャッシュに格納するために「キー」および「値」構造を使用します。オブジェクトがキャッシュに追加されると、指定されたキーに対する値およびメタデータとして保存されます。この値とメタデータの組み合わせは、のCacheItemとして定義されています。 NCache。キャッシュに格納されるオブジェクトの値は、単純な文字列タイプから複雑なオブジェクトまでさまざまです。のCacheItemクラス NCache 整理された方法でキャッシュに追加されるアイテムのメタデータを設定できるプロパティがあります。 CacheItemを使用してキャッシュにアイテムを追加するときに複数の属性を設定する必要があるシナリオでは、推奨されます。 CacheItemクラスオブジェクトを使用すると、キャッシュ内のデータを追加/更新するときに複数のAPIオーバーロードを使用する問題がなくなります。基本的なAPIオーバーロードを簡単に使用し、CacheItemを使用してデータを簡単に追加/更新できます。

コンストラクタ

# 新しいCacheItem（値、タイプ）

キャッシュアイテムの新しいインスタンスを初期化します。

パラメーター：

名前	タイプ	デフォルト	詳細説明
`value`	任意	ヌル	キャッシュに保存される実際のオブジェクト。
`type`	JsonDataType	ヌル

例:

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();

メソッド

# addCacheDataNotificationListener（リスナー、eventType、datafilter）

これを使用して、オブジェクトがキャッシュで更新または削除されたときにアプリケーションに通知できます。リスナーは、アイテムが挿入されるキーのイベントタイプに対して登録できます。リスナーは、再度呼び出された場合、同じイベントタイプに対してオーバーライドされます。

パラメーター：

名前	タイプ	詳細説明
`listener`	CacheDataModificationListener	アイテムが更新または削除されたときに発生するコールバック。
`eventType`	配列	コールバックが登録されているEventType
`datafilter`	数	通知がトリガーされたときに、メタデータ、メタデータを含むデータを受信するか、受信しないかを指示します。

# getCacheItemPriority() →{キャッシュアイテムの優先度}

キャッシュがスペースを解放し始めてアイテムを削除し始めるたびに考慮されているキャッシュアイテムの相対的な優先度を取得します。

戻り値：

キャッシュアイテムに関連付けられたCacheItemPriority。

タイプ: キャッシュアイテムの優先度

# getCacheItemVersion() →{キャッシュアイテムのバージョン}

キャッシュアイテムに関連付けられているバージョンを取得します。バージョンは基本的に、アイテムが更新されるたびに変化するキャッシュアイテムのバージョンを表すために使用される数値です。

戻り値：

キャッシュアイテムに関連付けられているバージョン。

タイプ: キャッシュアイテムのバージョン

# getCreationTime() →{日付}

アイテムが初めてキャッシュに追加された時刻を取得します。

戻り値：

キャッシュアイテムの作成日。

タイプ: 日付

# getDependency() →{キャッシュ依存性}

キャッシュアイテムに関連付けられているすべての依存関係を含むキャッシュ依存関係インスタンスを取得します。

戻り値：

キャッシュアイテムに関連付けられたキャッシュ依存関係インスタンス。

タイプ: キャッシュ依存性

# get期限切れ() →{満了}

キャッシュアイテムの有効期限メカニズムを取得します。

戻り値：

キャッシュアイテムの有効期限メカニズムに関する情報を含むインスタンス。

タイプ: 満了

# グループの取得() →{文字列}

キャッシュアイテムに関連付けられているグループを取得します。グループに基づいてクエリを実行できます。

戻り値：

キャッシュアイテムに関連付けられているグループ。

タイプ: string

# getLastModifiedTime() →{日付}

キャッシュアイテムのlastModifiedTimeを取得します。CacheItemは、キャッシュアイテムの最終変更時刻を格納します。アイテムがキャッシュで更新されると、最後に変更された時刻も更新されます。最終変更時刻は、最近使用されていないベースのエビクションがトリガーされたときにチェックされます。

戻り値：

キャッシュアイテムの最終変更時刻。

タイプ: 日付

# getNamedTags() →{名前付きタグ辞書}

キャッシュアイテムに関連付けられたNamedTags情報を取得します。これは、提供されたNamedTagsに基づいて照会できます。

戻り値：

キャッシュアイテムに関連付けられたNamedTags。

タイプ: 名前付きタグ辞書

# getResyncOptions() →{再同期オプション}

キャッシュアイテムに固有のResyncOptionsを取得します。

戻り値：

キャッシュアイテムに固有のResyncOptions。

タイプ: 再同期オプション

# タグを取得する() →{配列。タグ>}

キャッシュアイテムに関連付けられたタグ情報を取得します。提供されたタグに基づいてクエリを実行できます。

戻り値：

キャッシュアイテムに関連付けられているタグのリスト。

タイプ: 配列。タグ>

# getValue（classOb）

キャッシュアイテムに保存されている値を返します。

パラメーター：

名前	タイプ	詳細説明
`classOb`	JsonDataType	cacheItemから取得する値のタイプを指定します。

戻り値：

オブジェクト

# RemoveCacheDataNotificationListener（リスナー、eventEnumSet）

キャッシュデータ変更通知からユーザーの登録を解除します。

パラメーター：

名前	タイプ	詳細説明
`listener`	CacheDataModificationListener	通知用に登録されているリスナー。
`eventEnumSet`	配列	イベントタイプ/リスナーが登録解除されているタイプ。

# setCacheItemPriority（価値）

キャッシュアイテムのCacheItemPriorityを設定します。

パラメーター：

名前	タイプ	詳細説明
`value`	数	キャッシュアイテムのCacheItemPriorityを設定します。

# setCacheItemVersion（価値）

キャッシュアイテムのCacheItemVersionを設定します。

パラメーター：

名前	タイプ	詳細説明
`value`	キャッシュアイテムのバージョン	これは基本的に、アイテムが更新されるたびに変化するキャッシュされたアイテムのバージョンを表すために使用される数値です。

# setDependency（価値）

CacheItemのCacheDependencyを設定します

パラメーター：

名前	タイプ	詳細説明
`value`	キャッシュ依存性	CacheItemのCacheDependencyを設定します

# setExpiration（価値）

キャッシュアイテムの有効期限を設定します。

パラメーター：

名前	タイプ	詳細説明
`value`	満了	このプロパティは、キャッシュitmeの有効期限を設定します。指定された期間が経過すると、アイテムはキャッシュから期限切れになります。

# セットグループ（価値）

キャッシュアイテムに関連付けられたグループを設定します。グループに基づいてクエリを実行できます。

パラメーター：

名前	タイプ	詳細説明
`value`	string	キャッシュアイテムに関連付けられるグループ。

# setNamedTags（価値）

CacheItemのNamedTagsを設定します

パラメーター：

名前	タイプ	詳細説明
`value`	名前付きタグ辞書	NCache 次に、これらの名前付きタグを使用してオブジェクトを検索できます。名前付きタグは、CacheItemのこのプロパティを使用して指定できます。

# setResyncOptions（価値）

CacheItemのResyncOptionを設定します

パラメーター：

名前	タイプ	詳細説明
`value`	再同期オプション	キャッシュアイテムのResyncOptionsを設定します

# セットタグ（価値）

キャッシュアイテムに関連付けられたタグ情報を設定します。提供されたタグに基づいてクエリを実行できます。

パラメーター：

名前	タイプ	詳細説明
`value`	配列。タグ>	キャッシュアイテムに関連付けるタグのリスト。

# セット値（値、タイプ）

キャッシュアイテムの値を設定します。

パラメーター：

名前	タイプ	デフォルト	詳細説明
`value`	任意		キャッシュに保存される実際のオブジェクト。
`type`	string	ヌル