java.lang.Object
java.util.concurrent.ConcurrentHashMap.KeySetView<K,V>
- すべての実装されたインタフェース:
Serializable
,Iterable<K>
,Collection<K>
,Set<K>
- 含まれているクラス:
- ConcurrentHashMap<K,V>
public static classConcurrentHashMap.KeySetView<K,V> extends Object implements Set<K>, Serializable
キーの
Set
としてのConcurrentHashMapのビューです。オプションで、共通の値にマップすることによって追加を有効化できます。 このクラスは直接インスタンス化できません。 keySet()
、keySet(V)
、newKeySet()
、newKeySet(int)
を参照してください。 - 導入されたバージョン:
- 1.8
- 関連項目:
- 直列化された形式
-
メソッドのサマリー
修飾子と型メソッド説明boolean
バッキング・マップ内のデフォルトのマップされた値(定義されている場合)にキーをマップすることにより、指定されたキーをこのセット・ビューに追加します。boolean
addAll(Collection<? extends K> c)
指定されたコレクションのすべての要素をこのセットに追加します。各要素に対してadd(K)
を呼び出した場合と同様です。void
clear()
このビューのバッキング・マップからすべてのマッピングを削除することにより、このビューからすべての要素を削除します。boolean
指定された要素がコレクションに含まれている場合にtrue
を返します。boolean
containsAll(Collection<?> c)
指定されたコレクションのすべての要素がこのコレクション内にある場合はtrue
を返します。boolean
このオブジェクトと他のオブジェクトが等しいかどうかを示します。getMap()
このビューのバッキング・マップを返します。追加に対するデフォルトのマップされた値を返します。追加がサポートされていない場合はnull
を返します。int
hashCode()
オブジェクトのハッシュ・コード値を返します。boolean
isEmpty()
このコレクションに要素がない場合にtrue
を返します。iterator()
コレクションの要素のイテレータを返します。boolean
バッキング・マップからキー(およびそれに対応する値)を削除することで、このマップ・ビューからキーを削除します。boolean
removeAll(Collection<?> c)
指定されたコレクションにも格納されているこのコレクションのすべての要素を削除します(オプションの操作)。boolean
retainAll(Collection<?> c)
このコレクションにおいて、指定されたコレクションに格納されている要素だけを保持します(オプションの操作)。int
size()
このコレクション中の要素の数を返します。Object[]
toArray()
このコレクションの要素がすべて格納されている配列を返します。<T> T[]
toArray(T[] a)
このコレクション内のすべての要素を保持する配列を返します。返される配列の実行時の型は、指定された配列の型です。toString()
このコレクションの文字列表現を返します。クラス java.lang.Objectで宣言されたメソッド
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
インタフェース java.util.Collectionで宣言されたメソッド
parallelStream, removeIf, stream, toArray
インタフェース java.util.Setで宣言されたメソッド
clear, containsAll, isEmpty, removeAll, retainAll, size, spliterator, toArray, toArray
-
メソッドの詳細
-
getMappedValue
public V getMappedValue()追加に対するデフォルトのマップされた値を返します。追加がサポートされていない場合はnull
を返します。- 戻り値:
- 追加に対するデフォルトのマップされた値。サポートされていない場合は
null
-
contains
public boolean contains(Object o)指定された要素がコレクションに含まれている場合にtrue
を返します。 より正式には、true
は、このコレクションに少なくとも1つの要素e
(Objects.equals(o, e)
など)が含まれている場合にのみ返されます。- 定義:
contains
、インタフェース:Collection<K>
- 定義:
contains
、インタフェース:Set<K>
- パラメータ:
o
- このコレクション内にあるかどうかが判定される要素- 戻り値:
- 指定された要素がこのコレクション内にある場合は
true
- 例外:
NullPointerException
- 指定されたキーがnullである場合
-
remove
public boolean remove(Object o)バッキング・マップからキー(およびそれに対応する値)を削除することで、このマップ・ビューからキーを削除します。 そのキーがマップにない場合は、何も行いません。- 定義:
remove
、インタフェース:Collection<K>
- 定義:
remove
、インタフェース:Set<K>
- パラメータ:
o
- バッキング・マップから削除されるキー- 戻り値:
- 指定された要素がバッキング・マップに含まれていた場合は
true
- 例外:
NullPointerException
- 指定されたキーがnullである場合
-
iterator
コレクションの要素のイテレータを返します。返されるイテレータは弱一貫性を保持します。
-
add
public boolean add(K e)バッキング・マップ内のデフォルトのマップされた値(定義されている場合)にキーをマップすることにより、指定されたキーをこのセット・ビューに追加します。- 定義:
add
、インタフェース:Collection<K>
- 定義:
add
、インタフェース:Set<K>
- パラメータ:
e
- 追加されるキー- 戻り値:
- 呼出しの結果としてこのセットが変更された場合は
true
- 例外:
NullPointerException
- 指定されたキーがnullである場合UnsupportedOperationException
- 追加に対するデフォルトのマップされた値が指定されていなかった場合
-
addAll
public boolean addAll(Collection<? extends K> c)指定されたコレクションのすべての要素をこのセットに追加します。各要素に対してadd(K)
を呼び出した場合と同様です。- 定義:
addAll
、インタフェース:Collection<K>
- 定義:
addAll
、インタフェース:Set<K>
- パラメータ:
c
- このセットに挿入される要素- 戻り値:
- 呼出しの結果としてこのセットが変更された場合は
true
- 例外:
NullPointerException
- コレクションまたはそのいずれかの要素がnull
である場合UnsupportedOperationException
- 追加に対するデフォルトのマップされた値が指定されていなかった場合- 関連項目:
Set.add(Object)
-
hashCode
public int hashCode()次のクラスからコピーされた説明:Object
オブジェクトのハッシュ・コード値を返します。 このメソッドは、HashMap
によって提供されるハッシュ表などの、ハッシュ表の利点のためにサポートされています。hashCode
の一般的な規則は次のとおりです。- Javaアプリケーションの実行中に同じオブジェクトに対して複数回呼び出された場合は常に、このオブジェクトに対する
equals
の比較で使用される情報が変更されていなければ、hashCode
メソッドは常に同じ整数を返す必要があります。 ただし、この整数は同じアプリケーションの実行ごとに同じである必要はありません。 equals(Object)
メソッドに従って2つのオブジェクトが等しい場合は、2つの各オブジェクトに対するhashCode
メソッドの呼出しによって同じ整数の結果が生成される必要があります。Object.equals(java.lang.Object)
メソッドに従って2つのオブジェクトが等しくない場合は、2つの各オブジェクトに対するhashCode
メソッドの呼出しによって異なる整数の結果が生成される必要はありません。 ただし、プログラマは、等しくないオブジェクトに対して異なる整数の結果を生成すると、ハッシュ表のパフォーマンスが向上する可能性があることに注意するようにしてください。
- 定義:
hashCode
、インタフェース:Collection<K>
- 定義:
hashCode
、インタフェース:Set<K>
- オーバーライド:
hashCode
、クラス:Object
- 戻り値:
- このオブジェクトのハッシュ・コード値。
- 関連項目:
Object.equals(java.lang.Object)
,System.identityHashCode(java.lang.Object)
- Javaアプリケーションの実行中に同じオブジェクトに対して複数回呼び出された場合は常に、このオブジェクトに対する
-
equals
public boolean equals(Object o)次のクラスからコピーされた説明:Object
このオブジェクトと他のオブジェクトが等しいかどうかを示します。equals
メソッドは、null以外のオブジェクト参照での同値関係を実装します。- 反射性(reflexive): null以外の参照値
x
について、x.equals(x)
はtrue
を返します。 - 対称性(symmetric): null以外の参照値
x
およびy
について、y.equals(x)
がtrue
を返す場合に限り、x.equals(y)
はtrue
を返します。 - 推移性(transitive): null以外の参照値
x
、y
、およびz
について、x.equals(y)
がtrue
を返し、y.equals(z)
がtrue
を返す場合、x.equals(z)
はtrue
を返します。 - 一貫性(consistent): null以外の参照値
x
およびy
について、x.equals(y)
の複数の呼出しは、このオブジェクトに対するequals
による比較で使われた情報が変更されていなければ、一貫してtrue
を返すか、一貫してfalse
を返します。 - null以外の参照値
x
について、x.equals(null)
はfalse
を返します。
Object
クラスのequals
メソッドは、もっとも比較しやすいオブジェクトの同値関係を実装します。つまり、null以外の参照値x
とy
について、このメソッドはx
とy
が同じオブジェクトを参照する(x == y
がtrue
)場合にだけtrue
を返します。通常、このメソッドをオーバーライドする場合は、
hashCode
メソッドを常にオーバーライドして、「等価なオブジェクトは等価なハッシュ・コードを保持する必要がある」というhashCode
メソッドの汎用規約に従う必要があることに留意してください。- 定義:
equals
、インタフェース:Collection<K>
- 定義:
equals
、インタフェース:Set<K>
- オーバーライド:
equals
、クラス:Object
- パラメータ:
o
- 比較対象の参照オブジェクト。- 戻り値:
- このオブジェクトがobj引数と同じである場合は
true
、それ以外の場合はfalse
。 - 関連項目:
Object.hashCode()
、HashMap
- 反射性(reflexive): null以外の参照値
-
getMap
public ConcurrentHashMap<K,V> getMap()このビューのバッキング・マップを返します。- 戻り値:
- このビューのバッキング・マップ
-
clear
public final void clear()このビューのバッキング・マップからすべてのマッピングを削除することにより、このビューからすべての要素を削除します。- 定義:
- インタフェース
Collection<K>
内のclear
-
size
public final int size()次のインタフェースからコピーされた説明:Collection
このコレクション中の要素の数を返します。 このコレクションにInteger.MAX_VALUE
より多くの要素がある場合は、Integer.MAX_VALUE
を返します。- 定義:
- インタフェース
Collection<K>
内のsize
- 戻り値:
- このコレクションの要素数
-
isEmpty
public final boolean isEmpty()次のインタフェースからコピーされた説明:Collection
このコレクションに要素がない場合にtrue
を返します。- 定義:
- インタフェース
Collection<K>
内のisEmpty
- 戻り値:
- このコレクションに要素が含まれていない場合は
true
-
toArray
public final Object[] toArray()次のインタフェースからコピーされた説明:Collection
このコレクションの要素がすべて格納されている配列を返します。 イテレータによって要素が返される順序をコレクションが保証する場合、このメソッドは同じ順序で要素を返さなければなりません。 返される配列「ランタイム・コンポーネント・タイプ」はObject
です。返される配列への参照をコレクションが維持しないという点で、この配列は安全です。 つまり、このメソッドは、コレクションが配列に連動している場合でも新しい配列を割り当てます。 このため、呼出し側は、返された配列を自由に変更できます。
- 定義:
- インタフェース
Collection<K>
内のtoArray
- 戻り値:
- 「ランタイム・コンポーネント・タイプ」が
Object
の配列。このコレクションのすべての要素を含む
-
toArray
public final <T> T[] toArray(T[] a)次のインタフェースからコピーされた説明:Collection
このコレクション内のすべての要素を保持する配列を返します。返される配列の実行時の型は、指定された配列の型です。 コレクションが指定された配列に収まる場合は、その中に返されます。 そうでない場合は、指定された配列の実行時の型とコレクションのサイズを持つ新しい配列が割り当てられます。このコレクションが指定された配列に収まり、その配列にさらに余裕がある場合(つまり、配列がこのコレクションより多くの要素を持つ場合)、その配列内でコレクションの終端よりあとの要素は
null
に設定されます。 このコレクションにnull
要素がないことを呼出し側が知っている場合にだけ、この特性を利用してコレクションの長さを判断できます。イテレータによって要素が返される順序をコレクションが保証する場合、このメソッドは同じ順序で要素を返さなければなりません。
- 定義:
- インタフェース
Collection<K>
内のtoArray
- 型パラメータ:
T
- コレクションを格納する配列のコンポーネント型- パラメータ:
a
- 配列が十分な大きさを持つ場合は、このコレクションの要素の格納先の配列。配列のサイズが十分でない場合は、同じ実行時の型で新しい配列が格納用として割り当てられる。- 戻り値:
- コレクションのすべての要素が格納されている配列
-
toString
public final String toString()このコレクションの文字列表現を返します。 文字列表現は、コレクションの要素の文字列表現をそのイテレータが返した順に角括弧("[]"
)で囲んだもので構成されます。 隣接する要素は、文字", "
(カンマと空白文字)によって区切られます。 要素は、String.valueOf(Object)
により文字列に変換されます。 -
containsAll
public final boolean containsAll(Collection<?> c)次のインタフェースからコピーされた説明:Collection
指定されたコレクションのすべての要素がこのコレクション内にある場合はtrue
を返します。- 定義:
- インタフェース
Collection<K>
内のcontainsAll
- パラメータ:
c
- このコレクションにあるかどうかを調べるコレクション- 戻り値:
- 指定されたコレクションのすべての要素がこのコレクション内にある場合は
true
- 関連項目:
Collection.contains(Object)
-
removeAll
public boolean removeAll(Collection<?> c)次のインタフェースからコピーされた説明:Collection
指定されたコレクションにも格納されているこのコレクションのすべての要素を削除します(オプションの操作)。 この呼出しの結果、このコレクションには指定されたコレクションと共通の要素はなくなります。- 定義:
- インタフェース
Collection<K>
内のremoveAll
- パラメータ:
c
- このコレクションから削除される要素を含むコレクション- 戻り値:
- 呼出しの結果としてこのコレクションが変更された場合は
true
- 関連項目:
Collection.remove(Object)
,Collection.contains(Object)
-
retainAll
public final boolean retainAll(Collection<?> c)次のインタフェースからコピーされた説明:Collection
このコレクションにおいて、指定されたコレクションに格納されている要素だけを保持します(オプションの操作)。 つまり、指定されたコレクションに格納されていないすべての要素をこのコレクションから削除します。- 定義:
- インタフェース
Collection<K>
内のretainAll
- パラメータ:
c
- このコレクションで保持される要素を含むコレクション- 戻り値:
- 呼出しの結果としてこのコレクションが変更された場合は
true
- 関連項目:
Collection.remove(Object)
,Collection.contains(Object)
-