ConcurrentMapCache (Spring Framework 4.3.23.RELEASE API)

java.lang.ObjectSE
- org.springframework.cache.support.AbstractValueAdaptingCache
- - org.springframework.cache.concurrent.ConcurrentMapCache

実装されているすべてのインターフェース:
Cache
```
public class ConcurrentMapCache
extends AbstractValueAdaptingCache
```
コア JDK java.util.concurrent パッケージに基づく単純な Cache 実装。
通常は SimpleCacheManager と組み合わせて、または ConcurrentMapCacheManager を介して動的にテストまたは単純なキャッシングシナリオに役立ちます。
注意 : ConcurrentHashMapSE（使用されるデフォルトの実装）は null 値の格納を許可しないため、このクラスはそれらを事前定義された内部オブジェクトで置き換えます。この動作は、ConcurrentMapCache(String, ConcurrentMap, boolean) コンストラクターを使用して変更できます。
導入:
3.1
作成者:
Costin Leau, Juergen Hoeller, Stephane Nicoll

ネストされたクラスの要約
- インターフェース org.springframework.cache.Cache から継承されたネストクラス / インターフェース
  Cache.ValueRetrievalException, Cache.ValueWrapper

コンストラクターの概要

コンストラクター
修飾子	コンストラクターと説明
	`ConcurrentMapCache(StringSE name)` 指定された名前で新しい ConcurrentMapCache を作成します。
	`ConcurrentMapCache(StringSE name, boolean allowNullValues)` 指定された名前で新しい ConcurrentMapCache を作成します。
	`ConcurrentMapCache(StringSE name, ConcurrentMapSE<ObjectSE, ObjectSE> store, boolean allowNullValues)` 指定された名前と指定された内部 `ConcurrentMap`SE を使用して新しい ConcurrentMapCache を作成します。
`protected`	`ConcurrentMapCache(StringSE name, ConcurrentMapSE<ObjectSE, ObjectSE> store, boolean allowNullValues, SerializationDelegate serialization)` 指定された名前と指定された内部 `ConcurrentMap`SE を使用して新しい ConcurrentMapCache を作成します。

メソッドのサマリー

すべてのメソッドインスタンスメソッド具象メソッド
修飾子と型	メソッドと説明
`void`	`clear()` キャッシュからすべてのマッピングを削除します。
`void`	`evict(ObjectSE key)` このキーが存在する場合、このキャッシュからこのキーのマッピングを削除します。
`protected ObjectSE`	`fromStoreValue(ObjectSE storeValue)` 指定された値を内部ストアから get メソッドから返されたユーザー値に変換します（`null` を適応）。
`<T> T`	`get(ObjectSE key, CallableSE<T> valueLoader)` このキャッシュが指定されたキーをマップする値を返し、必要に応じて `valueLoader` からその値を取得します。
`StringSE`	`getName()` キャッシュ名を返します。
`ConcurrentMapSE<ObjectSE, ObjectSE>`	`getNativeCache()` 基になるネイティブキャッシュプロバイダーを返します。
`boolean`	`isStoreByValue()` このキャッシュに各エントリのコピー（`true`）または参照（`false`、デフォルト）のどちらが格納されているかを返します。
`protected ObjectSE`	`lookup(ObjectSE key)` 基になるストアで実際のルックアップを実行します。
`void`	`put(ObjectSE key, ObjectSE value)` 指定された値をこのキャッシュ内の指定されたキーに関連付けます。
`Cache.ValueWrapper`	`putIfAbsent(ObjectSE key, ObjectSE value)` 指定された値が設定されていない場合、指定された値をこのキャッシュ内の指定されたキーと原子的に関連付けます。
`protected ObjectSE`	`toStoreValue(ObjectSE userValue)` put メソッドに渡された指定のユーザー値を内部ストアの値に変換します（`null` を適応）。

クラス org.springframework.cache.support.AbstractValueAdaptingCache から継承されたメソッド
get, get, isAllowNullValues, toValueWrapper

クラス java.lang.ObjectSE から継承されたメソッド
cloneSE, equalsSE, finalizeSE, getClassSE, hashCodeSE, notifySE, notifyAllSE, toStringSE, waitSE, waitSE, waitSE

- コンストラクターの詳細
  - ConcurrentMapCache
```
public ConcurrentMapCache(StringSE name)
```
    指定された名前で新しい ConcurrentMapCache を作成します。
    パラメーター:
    name - キャッシュの名前
  - ConcurrentMapCache
```
public ConcurrentMapCache(StringSE name,
                          boolean allowNullValues)
```
    指定された名前で新しい ConcurrentMapCache を作成します。
    パラメーター:
    name - キャッシュの名前
    allowNullValues - このキャッシュの null 値を受け入れて変換するかどうか
  - ConcurrentMapCache
```
public ConcurrentMapCache(StringSE name,
                          ConcurrentMapSE<ObjectSE,ObjectSE> store,
                          boolean allowNullValues)
```
    指定された名前と指定された内部 ConcurrentMapSE を使用して新しい ConcurrentMapCache を作成します。
    パラメーター:
    name - キャッシュの名前
    store - 内部ストアとして使用する ConcurrentMap
    allowNullValues - null 値を許可するかどうか (それらを内部の null ホルダー値に適合させる)
  - ConcurrentMapCache
```
protected ConcurrentMapCache(StringSE name,
                             ConcurrentMapSE<ObjectSE,ObjectSE> store,
                             boolean allowNullValues,
                             SerializationDelegate serialization)
```
    指定された名前と指定された内部 ConcurrentMapSE を使用して新しい ConcurrentMapCache を作成します。SerializationDelegate を指定すると、store-by-value が有効になります
    パラメーター:
    name - キャッシュの名前
    store - 内部ストアとして使用する ConcurrentMap
    allowNullValues - null 値を許可するかどうか (それらを内部の null ホルダー値に適合させる)
    serialization - キャッシュエントリの直列化に使用する SerializationDelegate または参照を格納する null
    導入:
    4.3
- メソッドの詳細
  - isStoreByValue
```
public final boolean isStoreByValue()
```
    このキャッシュに各エントリのコピー（true）または参照（false、デフォルト）のどちらが格納されているかを返します。値による保管が有効になっている場合、キャッシュ内の各エントリはシリアライズ可能でなければなりません。
    導入:
    4.3
  - getName
```
public final StringSE getName()
```
    インターフェースからコピーされた説明: Cache
    キャッシュ名を返します。
  - getNativeCache
```
public final ConcurrentMapSE<ObjectSE,ObjectSE> getNativeCache()
```
    インターフェースからコピーされた説明: Cache
    基になるネイティブキャッシュプロバイダーを返します。
  - lookup
```
protected ObjectSE lookup(ObjectSE key)
```
    クラスからコピーされた説明: AbstractValueAdaptingCache
    基になるストアで実際のルックアップを実行します。
    次で指定:
    クラス AbstractValueAdaptingCache の lookup
    パラメーター:
    key - 関連する値が返されるキー
    戻り値:
    キーの生のストア値、ない場合は null
  - get
```
public <T> T get(ObjectSE key,
                 CallableSE<T> valueLoader)
```
    インターフェースからコピーされた説明: Cache
    このキャッシュが指定されたキーをマップする値を返し、必要に応じて valueLoader からその値を取得します。このメソッドは、従来の「キャッシュされている場合は返す、そうでない場合は作成、キャッシュして返す」パターンの単純な代替を提供します。
    可能な場合、実装は、同じキーへの同時アクセスの場合に指定された valueLoader が 1 回だけ呼び出されるように、ロード操作が同期されることを確認する必要があります。
    valueLoader が例外をスローした場合、Cache.ValueRetrievalException にラップされます
    パラメーター:
    key - 関連する値が返されるキー
    戻り値:
    このキャッシュが指定されたキーをマップする値
  - put
```
public void put(ObjectSE key,
                ObjectSE value)
```
    インターフェースからコピーされた説明: Cache
    指定された値をこのキャッシュ内の指定されたキーに関連付けます。
    キャッシュに以前にこのキーのマッピングが含まれていた場合、古い値は指定された値に置き換えられます。
    パラメーター:
    key - 指定された値が関連付けられるキー
    value - 指定されたキーに関連付けられる値
  - putIfAbsent
```
public Cache.ValueWrapper putIfAbsent(ObjectSE key,
                                      ObjectSE value)
```
    インターフェースからコピーされた説明: Cache
    指定された値が設定されていない場合、指定された値をこのキャッシュ内の指定されたキーと原子的に関連付けます。
    これは次と同等です:
```
 Object existingValue = cache.get(key);
 if (existingValue == null) {
     cache.put(key, value);
     return null;
 } else {
     return existingValue;
 }
 
```
    ただし、アクションはアトミックに実行されます。すべての初期状態の CacheManager 実装は、put をアトミックに実行することができるが、オペレーションは、たとえば、非アトミックな方法で、存在のチェックと後続の put との 2 つのステップで実装することもできます。詳細については、使用しているネイティブキャッシュ実装のドキュメントを参照してください。
    パラメーター:
    key - 指定された値が関連付けられるキー
    value - 指定されたキーに関連付けられる値
    戻り値:
    このキャッシュが指定されたキー（null 自体の場合もある）をマップする値、またはこの呼び出しの前にキャッシュにそのキーのマッピングが含まれていなかった場合は null したがって、null を返すことは、指定された value がキーに関連付けられていることを示すインジケーターです。
  - evict
```
public void evict(ObjectSE key)
```
    インターフェースからコピーされた説明: Cache
    このキーが存在する場合、このキャッシュからこのキーのマッピングを削除します。
    パラメーター:
    key - マッピングがキャッシュから削除されるキー
  - clear
```
public void clear()
```
    インターフェースからコピーされた説明: Cache
    キャッシュからすべてのマッピングを削除します。
  - toStoreValue
```
protected ObjectSE toStoreValue(ObjectSE userValue)
```
    クラスからコピーされた説明: AbstractValueAdaptingCache
    put メソッドに渡された指定のユーザー値を内部ストアの値に変換します（null を適応）。
    オーバーライド:
    クラス AbstractValueAdaptingCache の toStoreValue
    パラメーター:
    userValue - 指定されたユーザー値
    戻り値:
    保存する値
  - fromStoreValue
```
protected ObjectSE fromStoreValue(ObjectSE storeValue)
```
    クラスからコピーされた説明: AbstractValueAdaptingCache
    指定された値を内部ストアから get メソッドから返されたユーザー値に変換します（null を適応）。
    オーバーライド:
    クラス AbstractValueAdaptingCache の fromStoreValue
    パラメーター:
    storeValue - ストアの値
    戻り値:
    ユーザーに返す値

クラス ConcurrentMapCache

ネストされたクラスの要約

インターフェース org.springframework.cache.Cache から継承されたネストクラス / インターフェース

コンストラクターの概要

メソッドのサマリー

クラス org.springframework.cache.support.AbstractValueAdaptingCache から継承されたメソッド

クラス java.lang.ObjectSE から継承されたメソッド

コンストラクターの詳細

ConcurrentMapCache

ConcurrentMapCache

ConcurrentMapCache

ConcurrentMapCache

メソッドの詳細

isStoreByValue

getName

getNativeCache

lookup

get

put

putIfAbsent

evict

clear

toStoreValue

fromStoreValue