ConcurrentReferenceHashMap (Spring Framework 5.1.5.RELEASE API)

java.lang.Object
- java.util.AbstractMap<K,V>
- - org.springframework.util.ConcurrentReferenceHashMap<K,V>

型パラメーター:
K - キー型
V - 値の型
実装済みのインターフェース一覧:
java.util.concurrent.ConcurrentMap<K,V>, java.util.Map<K,V>
```
public class ConcurrentReferenceHashMap<K,V>
extends java.util.AbstractMap<K,V>
implements java.util.concurrent.ConcurrentMap<K,V>
```
keys と values の両方に soft または弱い参照を使用する ConcurrentHashMap。
このクラスは、同時にアクセスした場合のパフォーマンスを向上させるために、Collections.synchronizedMap(new WeakHashMap<K, Reference<V>>()) の代わりに使用できます。この実装は、null 値と null キーがサポートされていることを除いて、ConcurrentHashMap と同じ設計上の制約に従います。
注意 : 参照の使用は、マップに配置されたアイテムが後で利用可能になるという保証がないことを意味します。ガベージコレクターはいつでも参照を破棄する可能性があるため、不明なスレッドが静かにエントリを削除しているように見えることがあります。
明示的に指定されていない場合、この実装はソフトエントリ参照を使用します。
導入:
3.2
作成者:
Phillip Webb, Juergen Hoeller

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

ネストされたクラス
修飾子と型	クラスと説明
`protected static class`	`ConcurrentReferenceHashMap.Entry<K, V>` 単一のマップエントリ。
`protected static interface`	`ConcurrentReferenceHashMap.Reference<K, V>` マップに含まれる `ConcurrentReferenceHashMap.Entry` への参照。
`protected class`	`ConcurrentReferenceHashMap.ReferenceManager` `References` を管理するために使用される戦略クラス。
`static class`	`ConcurrentReferenceHashMap.ReferenceType` このマップでサポートされるさまざまな参照型。
`protected static class`	`ConcurrentReferenceHashMap.Restructure` 実行できる再構築の種類。
`protected class`	`ConcurrentReferenceHashMap.Segment` 同時パフォーマンスを向上させるためにマップを分割するために使用される単一のセグメント。

クラス java.util.AbstractMap から継承されたネストクラス / インターフェース
java.util.AbstractMap.SimpleEntry<K,V>, java.util.AbstractMap.SimpleImmutableEntry<K,V>

コンストラクター概要

コンストラクター
コンストラクターと説明
`ConcurrentReferenceHashMap()` 新しい `ConcurrentReferenceHashMap` インスタンスを作成します。
`ConcurrentReferenceHashMap(int initialCapacity)` 新しい `ConcurrentReferenceHashMap` インスタンスを作成します。
`ConcurrentReferenceHashMap(int initialCapacity, ConcurrentReferenceHashMap.ReferenceType referenceType)` 新しい `ConcurrentReferenceHashMap` インスタンスを作成します。
`ConcurrentReferenceHashMap(int initialCapacity, float loadFactor)` 新しい `ConcurrentReferenceHashMap` インスタンスを作成します。
`ConcurrentReferenceHashMap(int initialCapacity, float loadFactor, int concurrencyLevel)` 新しい `ConcurrentReferenceHashMap` インスタンスを作成します。
`ConcurrentReferenceHashMap(int initialCapacity, float loadFactor, int concurrencyLevel, ConcurrentReferenceHashMap.ReferenceType referenceType)` 新しい `ConcurrentReferenceHashMap` インスタンスを作成します。
`ConcurrentReferenceHashMap(int initialCapacity, int concurrencyLevel)` 新しい `ConcurrentReferenceHashMap` インスタンスを作成します。

方法の概要

すべてのメソッド静的メソッドインスタンスメソッド具象メソッド
修飾子と型	メソッドと説明
`protected static int`	`calculateShift(int minimumValue, int maximumValue)` 指定された最大値と最小値の間の 2 のべき乗値を作成するために使用できるシフト値を計算します。
`void`	`clear()`
`boolean`	`containsKey(java.lang.Object key)`
`protected ConcurrentReferenceHashMap.ReferenceManager`	`createReferenceManager()` `ConcurrentReferenceHashMap.ReferenceManager` を返すファクトリメソッド。
`java.util.Set<java.util.Map.Entry<K, V>>`	`entrySet()`
`V`	`get(java.lang.Object key)`
`protected int`	`getHash(java.lang.Object o)` 特定のオブジェクトのハッシュを取得し、追加のハッシュ関数を適用して衝突を減らします。
`protected float`	`getLoadFactor()`
`V`	`getOrDefault(java.lang.Object key, V defaultValue)`
`protected ConcurrentReferenceHashMap.Reference<K, V>`	`getReference(java.lang.Object key, ConcurrentReferenceHashMap.Restructure restructure)` 指定された `key` の `ConcurrentReferenceHashMap.Reference` を `ConcurrentReferenceHashMap.Entry` に返します。見つからない場合は `null` を返します。
`protected ConcurrentReferenceHashMap.Segment`	`getSegment(int index)`
`protected int`	`getSegmentsSize()`
`boolean`	`isEmpty()`
`void`	`purgeUnreferencedEntries()` ガベージコレクションされ、参照されなくなったエントリを削除します。
`V`	`put(K key, V value)`
`V`	`putIfAbsent(K key, V value)`
`V`	`remove(java.lang.Object key)`
`boolean`	`remove(java.lang.Object key, java.lang.Object value)`
`V`	`replace(K key, V value)`
`boolean`	`replace(K key, V oldValue, V newValue)`
`int`	`size()`

クラス java.util.AbstractMap から継承されたメソッド
clone, containsValue, equals, hashCode, keySet, putAll, toString, values

クラス java.lang.Object から継承されたメソッド
finalize, getClass, notify, notifyAll, wait, wait, wait

インターフェース java.util.concurrent.ConcurrentMap から継承されたメソッド
compute, computeIfAbsent, computeIfPresent, forEach, merge, replaceAll

インターフェース java.util.Map から継承されたメソッド
containsValue, equals, hashCode, keySet, putAll, values

- コンストラクターの詳細
  - ConcurrentReferenceHashMap
```
public ConcurrentReferenceHashMap()
```
    新しい ConcurrentReferenceHashMap インスタンスを作成します。
  - ConcurrentReferenceHashMap
```
public ConcurrentReferenceHashMap(int initialCapacity)
```
    新しい ConcurrentReferenceHashMap インスタンスを作成します。
    パラメーター:
    initialCapacity - マップの初期容量
  - ConcurrentReferenceHashMap
```
public ConcurrentReferenceHashMap(int initialCapacity,
                                  float loadFactor)
```
    新しい ConcurrentReferenceHashMap インスタンスを作成します。
    パラメーター:
    initialCapacity - マップの初期容量
    loadFactor - 負荷率。テーブルごとの平均参照数がこの値を超えると、サイズ変更が試行されます
  - ConcurrentReferenceHashMap
```
public ConcurrentReferenceHashMap(int initialCapacity,
                                  int concurrencyLevel)
```
    新しい ConcurrentReferenceHashMap インスタンスを作成します。
    パラメーター:
    initialCapacity - マップの初期容量
    concurrencyLevel - 同時にマップに書き込むスレッドの予想数
  - ConcurrentReferenceHashMap
```
public ConcurrentReferenceHashMap(int initialCapacity,
                                  ConcurrentReferenceHashMap.ReferenceType referenceType)
```
    新しい ConcurrentReferenceHashMap インスタンスを作成します。
    パラメーター:
    initialCapacity - マップの初期容量
    referenceType - エントリに使用される参照型 (柔らかいか弱い)
  - ConcurrentReferenceHashMap
```
public ConcurrentReferenceHashMap(int initialCapacity,
                                  float loadFactor,
                                  int concurrencyLevel)
```
    新しい ConcurrentReferenceHashMap インスタンスを作成します。
    パラメーター:
    initialCapacity - マップの初期容量
    loadFactor - 負荷率。テーブルごとの平均参照数がこの値を超えると、サイズ変更が試行されます。
    concurrencyLevel - 同時にマップに書き込むスレッドの予想数
  - ConcurrentReferenceHashMap
```
public ConcurrentReferenceHashMap(int initialCapacity,
                                  float loadFactor,
                                  int concurrencyLevel,
                                  ConcurrentReferenceHashMap.ReferenceType referenceType)
```
    新しい ConcurrentReferenceHashMap インスタンスを作成します。
    パラメーター:
    initialCapacity - マップの初期容量
    loadFactor - 負荷率。テーブルごとの平均参照数がこの値を超えると、サイズ変更が試行されます。
    concurrencyLevel - 同時にマップに書き込むスレッドの予想数
    referenceType - エントリに使用される参照型 (柔らかいか弱い)
- メソッドの詳細
  - getLoadFactor
```
protected final float getLoadFactor()
```
  - getSegmentsSize
```
protected final int getSegmentsSize()
```
  - getSegment
```
protected final ConcurrentReferenceHashMap.Segment getSegment(int index)
```
  - createReferenceManager
```
protected ConcurrentReferenceHashMap.ReferenceManager createReferenceManager()
```
    ConcurrentReferenceHashMap.ReferenceManager を返すファクトリメソッド。このメソッドは、各 ConcurrentReferenceHashMap.Segment に対して 1 回呼び出されます。
    戻り値:
    新しい参照マネージャー
  - getHash
```
protected int getHash(@Nullable
                      java.lang.Object o)
```
    特定のオブジェクトのハッシュを取得し、追加のハッシュ関数を適用して衝突を減らします。この実装では、ConcurrentHashMap と同じ Wang/Jenkins アルゴリズムを使用します。サブクラスをオーバーライドして、代替ハッシュを提供できます。
    パラメーター:
    o - ハッシュするオブジェクト (null の可能性があります)
    戻り値:
    結果のハッシュコード
  - get
```
@Nullable
public V get(@Nullable
                       java.lang.Object key)
```
    次で指定:
    インターフェース java.util.Map<K, V> の get
    オーバーライド:
    クラス java.util.AbstractMap<K, V> の get
  - getOrDefault
```
@Nullable
public V getOrDefault(@Nullable
                                java.lang.Object key,
                                @Nullable
                                V defaultValue)
```
    次で指定:
    インターフェース java.util.concurrent.ConcurrentMap<K, V> の getOrDefault
    次で指定:
    インターフェース java.util.Map<K, V> の getOrDefault
  - containsKey
```
public boolean containsKey(@Nullable
                           java.lang.Object key)
```
    次で指定:
    インターフェース java.util.Map<K, V> の containsKey
    オーバーライド:
    クラス java.util.AbstractMap<K, V> の containsKey
  - getReference
```
@Nullable
protected final ConcurrentReferenceHashMap.Reference<K,V> getReference(@Nullable
                                                                                 java.lang.Object key,
                                                                                 ConcurrentReferenceHashMap.Restructure restructure)
```
    指定された key の ConcurrentReferenceHashMap.Reference を ConcurrentReferenceHashMap.Entry に返します。見つからない場合は null を返します。
    パラメーター:
    key - キー (null にすることができます)
    restructure - この呼び出し中に許可される再構築の型
    戻り値:
    参照。見つからない場合は null
  - put
```
@Nullable
public V put(@Nullable
                       K key,
                       @Nullable
                       V value)
```
    次で指定:
    インターフェース java.util.Map<K, V> の put
    オーバーライド:
    クラス java.util.AbstractMap<K, V> の put
  - putIfAbsent
```
@Nullable
public V putIfAbsent(@Nullable
                               K key,
                               @Nullable
                               V value)
```
    次で指定:
    インターフェース java.util.concurrent.ConcurrentMap<K, V> の putIfAbsent
    次で指定:
    インターフェース java.util.Map<K, V> の putIfAbsent
  - remove
```
@Nullable
public V remove(java.lang.Object key)
```
    次で指定:
    インターフェース java.util.Map<K, V> の remove
    オーバーライド:
    クラス java.util.AbstractMap<K, V> の remove
  - remove
```
public boolean remove(java.lang.Object key,
                      java.lang.Object value)
```
    次で指定:
    インターフェース java.util.concurrent.ConcurrentMap<K, V> の remove
    次で指定:
    インターフェース java.util.Map<K, V> の remove
  - replace
```
public boolean replace(K key,
                       V oldValue,
                       V newValue)
```
    次で指定:
    インターフェース java.util.concurrent.ConcurrentMap<K, V> の replace
    次で指定:
    インターフェース java.util.Map<K, V> の replace
  - replace
```
@Nullable
public V replace(K key,
                           V value)
```
    次で指定:
    インターフェース java.util.concurrent.ConcurrentMap<K, V> の replace
    次で指定:
    インターフェース java.util.Map<K, V> の replace
  - clear
```
public void clear()
```
    次で指定:
    インターフェース java.util.Map<K, V> の clear
    オーバーライド:
    クラス java.util.AbstractMap<K, V> の clear
  - purgeUnreferencedEntries
```
public void purgeUnreferencedEntries()
```
    ガベージコレクションされ、参照されなくなったエントリを削除します。通常の状況では、マップにアイテムが追加または削除されると、ガベージコレクションのエントリが自動的に削除されます。このメソッドはパージを強制するために使用でき、マップが頻繁に読み取られるが更新頻度が低い場合に役立ちます。
  - size
```
public int size()
```
    次で指定:
    インターフェース java.util.Map<K, V> の size
    オーバーライド:
    クラス java.util.AbstractMap<K, V> の size
  - isEmpty
```
public boolean isEmpty()
```
    次で指定:
    インターフェース java.util.Map<K, V> の isEmpty
    オーバーライド:
    クラス java.util.AbstractMap<K, V> の isEmpty
  - entrySet
```
public java.util.Set<java.util.Map.Entry<K,V>> entrySet()
```
    次で指定:
    インターフェース java.util.Map<K, V> の entrySet
    次で指定:
    クラス java.util.AbstractMap<K, V> の entrySet
  - calculateShift
```
protected static int calculateShift(int minimumValue,
                                    int maximumValue)
```
    指定された最大値と最小値の間の 2 のべき乗値を作成するために使用できるシフト値を計算します。
    パラメーター:
    minimumValue - 最小値
    maximumValue - 最大値
    戻り値:
    計算されたシフト (1 << shift を使用して値を取得する)

クラス ConcurrentReferenceHashMap<K,V>

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

クラス java.util.AbstractMap から継承されたネストクラス / インターフェース

コンストラクター概要

方法の概要

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

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

インターフェース java.util.concurrent.ConcurrentMap から継承されたメソッド

インターフェース java.util.Map から継承されたメソッド

コンストラクターの詳細

ConcurrentReferenceHashMap

ConcurrentReferenceHashMap

ConcurrentReferenceHashMap

ConcurrentReferenceHashMap

ConcurrentReferenceHashMap

ConcurrentReferenceHashMap

ConcurrentReferenceHashMap

メソッドの詳細

getLoadFactor

getSegmentsSize

getSegment

createReferenceManager

getHash

get

getOrDefault

containsKey

getReference

put

putIfAbsent

remove

remove

replace

replace

clear

purgeUnreferencedEntries

size

isEmpty

entrySet

calculateShift