org.iplass.mtp.impl.cache.store

インタフェース CacheStore

既知の実装クラスのリスト:

FineGrainedLockIndexedConcurrentHashMapCacheStore, MapBaseCacheStore, NullCacheStore, RdbCacheStoreFactory.RdbCacheStore, SimpleCacheStoreBase, SimpleCacheStoreFactory.ConcurrentHashMapCacheStore, SimpleCacheStoreFactory.IndexedConcurrentHashMapCacheStore, SyncServerCacheStoreFactory.SyncServerCacheStore, TransactionLocalCacheStoreFactory.TransactionLocalCacheStore

public interface CacheStore

ローレベルのキャッシュ機能を実装するキャッシュストアのインタフェース。

メソッドのサマリー

修飾子とタイプ	メソッドと説明
void	addCacheEventListenner(CacheEventListener listener)
default CacheEntry	compute(java.lang.Object key, java.util.function.BiFunction<java.lang.Object,CacheEntry,CacheEntry> remappingFunction) ConcurrentMapが提供するcomputeと同等の機能性を提供するメソッド。
default CacheEntry	computeIfAbsent(java.lang.Object key, java.util.function.Function<java.lang.Object,CacheEntry> mappingFunction) ConcurrentMapが提供するcomputeIfAbsentと同等の機能性を提供するメソッド。
default CacheEntry	computeIfAbsentWithAutoReload(java.lang.Object key, java.util.function.BiFunction<java.lang.Object,CacheEntry,CacheEntry> reloadFunction) 自動リロードするキャッシュエントリをputする。
void	destroy()
CacheEntry	get(java.lang.Object key)
CacheEntry	getByIndex(int indexKey, java.lang.Object indexValue)
CacheStoreFactory	getFactory()
java.util.List<CacheEntry>	getListByIndex(int indexKey, java.lang.Object indexValue)
java.util.List<CacheEventListener>	getListeners()
java.lang.String	getNamespace()
int	getSize()
java.util.List<java.lang.Object>	keySet()
CacheEntry	put(CacheEntry entry, boolean clean)
CacheEntry	putIfAbsent(CacheEntry entry)
boolean	remove(CacheEntry entry)
CacheEntry	remove(java.lang.Object key)
void	removeAll()
java.util.List<CacheEntry>	removeByIndex(int indexKey, java.lang.Object indexValue)
void	removeCacheEventListenner(CacheEventListener listener)
CacheEntry	replace(CacheEntry entry)
boolean	replace(CacheEntry oldEntry, CacheEntry newEntry)
java.lang.String	trace()

メソッドの詳細

getNamespace

java.lang.String getNamespace()

getFactory

CacheStoreFactory getFactory()

getSize

int getSize()

computeIfAbsentWithAutoReload

default CacheEntry computeIfAbsentWithAutoReload(java.lang.Object key,
                                                 java.util.function.BiFunction<java.lang.Object,CacheEntry,CacheEntry> reloadFunction)

自動リロードするキャッシュエントリをputする。 まだkeyに紐づいたエントリがない場合にreloadFunctionによって取得されたエントリをputする。 既にkeyに紐づいたエントリがある場合はそのエントリを返却する。 reloadFunctionが返却するキャッシュエントリのtimeToLiveの時間経過後reloadFunctionを利用してCacheEntryを再取得する。 リロードは非同期で実行され、リロード完了するまでの間は古いCacheEntryを返す。 デフォルト実装では、JVMローカルでのみリロードされる。 リロード対象のキャッシュエントリが他の更新系メソッド（put, remove, replace）により更新された場合、リロードはキャンセルされる。

パラメータ:

key - キャッシュエントリのキー

reloadFunction - キャッシュエントリが存在しない場合、リロード時に呼び出される関数。初回のロード時はapplyの引数CacheEntryはnullが渡される。また、リロード時はreloadFunctionは非同期にユーザ未特定で特権状態で実行される。

戻り値:

初回ロード、もしくはリロードされたキャッシュエントリ

computeIfAbsent

default CacheEntry computeIfAbsent(java.lang.Object key,
                                   java.util.function.Function<java.lang.Object,CacheEntry> mappingFunction)

ConcurrentMapが提供するcomputeIfAbsentと同等の機能性を提供するメソッド。 デフォルト実装ではmappingFunctionが複数回呼び出される可能性はある。 厳密にmappingFunctionが1度しか呼び出されないか否かは各CacheStore実装クラスによる。

パラメータ:

key -

mappingFunction -

戻り値:

compute

default CacheEntry compute(java.lang.Object key,
                           java.util.function.BiFunction<java.lang.Object,CacheEntry,CacheEntry> remappingFunction)

ConcurrentMapが提供するcomputeと同等の機能性を提供するメソッド。 デフォルト実装ではremappingFunctionが複数回呼び出される可能性はある。 厳密にremappingFunctionが1度しか呼び出されないか否かは各CacheStore実装クラスによる。

パラメータ:

key -

remappingFunction -

戻り値:

put

CacheEntry put(CacheEntry entry,
               boolean clean)

パラメータ:

entry -

clean - putするentryが更新されたものでない場合（他のNodeで読み込まれていても問題ない場合）ture

putIfAbsent

CacheEntry putIfAbsent(CacheEntry entry)

get

CacheEntry get(java.lang.Object key)

remove

CacheEntry remove(java.lang.Object key)

remove

boolean remove(CacheEntry entry)

replace

CacheEntry replace(CacheEntry entry)

replace

boolean replace(CacheEntry oldEntry,
                CacheEntry newEntry)

removeAll

void removeAll()

keySet

java.util.List<java.lang.Object> keySet()

getByIndex

CacheEntry getByIndex(int indexKey,
                      java.lang.Object indexValue)

getListByIndex

java.util.List<CacheEntry> getListByIndex(int indexKey,
                                          java.lang.Object indexValue)

removeByIndex

java.util.List<CacheEntry> removeByIndex(int indexKey,
                                         java.lang.Object indexValue)

addCacheEventListenner

void addCacheEventListenner(CacheEventListener listener)

removeCacheEventListenner

void removeCacheEventListenner(CacheEventListener listener)

getListeners

java.util.List<CacheEventListener> getListeners()

trace

java.lang.String trace()

destroy

void destroy()