java.lang.Object

java.util.AbstractCollection<E>

java.util.AbstractSet<E>

java.util.concurrent.CopyOnWriteArraySet<E>

型パラメータ:: E - このセットで保持されている要素の型

すべての実装されたインタフェース:: Serializable, Iterable<E>, Collection<E>, Set<E>

public class CopyOnWriteArraySet<E>
extends AbstractSet<E>
implements Serializable

内部のCopyOnWriteArrayListをすべてのオペレーションで使用するSetです。このため、同じ基本プロパティが共有されます。

設定サイズが通常小さく、読取り専用操作が変更操作よりもはるかに多いアプリケーションに最適である。また、トラバーサル中にスレッド間の干渉を防ぐ必要がある。
スレッド・セーフである。
推移的操作(add、set、removeなど)は、通常、基になる配列全体のコピーが必要になるため、負荷が大きい。
イテレータは、推移的removeオペレーションをサポートしていない。
イテレータを使用したトラバーサルは高速であり、ほかのスレッドからの干渉に遭遇することはない。イテレータは、その構築された時点での変更されない配列スナップショットに依存する。

使用例。 次のコード例では、copy-on-writeセットを使用して、状態の更新時に特定のアクションを実行する一連のHandlerオブジェクトを管理します。

 
 class Handler { void handle(); ... }

 class X {
   private final CopyOnWriteArraySet<Handler> handlers
     = new CopyOnWriteArraySet<>();
   public void addHandler(Handler h) { handlers.add(h); }

   private long internalState;
   private synchronized void changeState() { internalState = ...; }

   public void update() {
     changeState();
     for (Handler handler : handlers)
       handler.handle();
   }
 }

このクラスは、Java Collections Frameworkのメンバーです。

導入されたバージョン:: 1.5
関連項目:: CopyOnWriteArrayList, 直列化された形式

コンストラクタのサマリー

コンストラクタ
コンストラクタ	説明
`CopyOnWriteArraySet()`	空のセットを作成します。
`CopyOnWriteArraySet(Collection<? extends E> c)`	指定されたコレクションの要素すべてを含むセットを作成します。

メソッドのサマリー

修飾子と型	メソッド	説明
`boolean`	`add(E e)`	指定された要素がセットの要素として存在しない場合に、その要素をセットに追加します。
`boolean`	`addAll(Collection<? extends E> c)`	指定されたコレクションのすべての要素について、その要素がこのセット内にない場合、セットに追加します。
`void`	`clear()`	すべての要素をセットから削除します。
`boolean`	`contains(Object o)`	指定された要素がセットに含まれている場合に`true`を返します。
`boolean`	`containsAll(Collection<?> c)`	指定されたコレクションのすべての要素がこのセットに含まれている場合に`true`を返します。
`boolean`	`equals(Object o)`	指定されたオブジェクトがセットと同じかどうかを比較します。
`void`	`forEach(Consumer<? super E> action)`	`Iterable`の各要素に対して指定されたアクションを、すべての要素が処理されるか、アクションが例外をスローするまで実行します。
`boolean`	`isEmpty()`	このセットに要素が1つも含まれていない場合に`true`を返します。
`Iterator<E>`	`iterator()`	このセットに含まれる各要素についてのイテレータを、これらの要素が追加された順序で返します。
`boolean`	`remove(Object o)`	指定された要素がこのセットに存在する場合に、要素をセットから削除します。
`boolean`	`removeAll(Collection<?> c)`	セットから、指定されたコレクション内に保持されているすべての要素を削除します。
`boolean`	`removeIf(Predicate<? super E> filter)`	指定された述語を満たすこのコレクションの要素をすべて削除します。
`boolean`	`retainAll(Collection<?> c)`	指定されたコレクション内に保持されている、セット内の要素だけを保持します。
`int`	`size()`	このセット中の要素の数を返します。
`Spliterator<E>`	`spliterator()`	このセット内の要素に対する`Spliterator`を、これらの要素が追加された順序で返します。
`Object[]`	`toArray()`	セット内のすべての要素が格納されている配列を返します。
`<T> T[]`	`toArray(T[] a)`	セット内のすべての要素を格納している配列を返します。返される配列の実行時の型は、指定された配列の型になります。

クラス java.util.AbstractSetで宣言されたメソッド

hashCode

クラス java.util.AbstractCollectionで宣言されたメソッド

toString

クラス java.lang.Objectで宣言されたメソッド

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

インタフェース java.util.Collectionで宣言されたメソッド

parallelStream, stream, toArray

コンストラクタの詳細
- CopyOnWriteArraySet
  
  public CopyOnWriteArraySet()
  
  空のセットを作成します。
- CopyOnWriteArraySet
  
  public CopyOnWriteArraySet(Collection<? extends E> c)
  
  指定されたコレクションの要素すべてを含むセットを作成します。
  
  パラメータ:
  
  c - 初期状態で含む要素のコレクション
  
  例外:
  
  NullPointerException - 指定されたコレクションがnullである場合
メソッドの詳細
- size
  
  public int size()
  
  このセット中の要素の数を返します。
  
  定義:
  
  size、インタフェース: Collection<E>
  
  定義:
  
  size、インタフェース: Set<E>
  
  戻り値:
  
  セットの要素数
- isEmpty
  
  public boolean isEmpty()
  
  このセットに要素が1つも含まれていない場合にtrueを返します。
  
  定義:
  
  isEmpty、インタフェース: Collection<E>
  
  定義:
  
  isEmpty、インタフェース: Set<E>
  
  オーバーライド:
  
  isEmpty、クラス: AbstractCollection<E>
  
  戻り値:
  
  このセットに要素が1つも含まれていない場合はtrue
- contains
  
  public boolean contains(Object o)
  
  指定された要素がこのセットに含まれている場合にtrueを返します。より正式には、このセットにObjects.equals(o, e)のような要素eが含まれている場合に限り、trueを返します。
  
  定義:
  
  contains、インタフェース: Collection<E>
  
  定義:
  
  contains、インタフェース: Set<E>
  
  オーバーライド:
  
  contains、クラス: AbstractCollection<E>
  
  パラメータ:
  
  o - このセット内にあるかどうかが判定される要素
  
  戻り値:
  
  指定された要素がこのセットに含まれている場合はtrue
- toArray
  
  public Object[] toArray()
  
  セット内のすべての要素が格納されている配列を返します。イテレータによって要素が返される順序をセットが保証する場合、このメソッドは同じ順序で要素を返さなければいけません。
  返される配列への参照をセットが維持しないという点で、この配列は安全です。つまり、このメソッドは、セットが配列に連動している場合でも新しい配列を割り当てます。このため、呼出し側は、返された配列を自由に変更できます。
  このメソッドは、配列ベースのAPIとコレクションベースのAPIの間の橋渡し役として機能します。
  
  定義:
  
  toArray、インタフェース: Collection<E>
  
  定義:
  
  toArray、インタフェース: Set<E>
  
  オーバーライド:
  
  toArray、クラス: AbstractCollection<E>
  
  戻り値:
  
  セット内のすべての要素を保持している配列
- toArray
  
  public <T> T[] toArray(T[] a)
  セット内のすべての要素を格納している配列を返します。返される配列の実行時の型は、指定された配列の型になります。セットが指定された配列に収まる場合は、その中に返されます。そうでない場合は、指定された配列の実行時の型とセットのサイズを持つ新しい配列が割り当てられます。
  このセットが指定された配列に収まり、その配列にさらに余裕がある場合(つまり、配列がセットより多くの要素を持つ場合)、その配列内でセットの終端よりあとの要素はnullに設定されます。このセットにnull要素がないことを呼出し側が知っている場合にだけ、この特性を利用してこのセットの長さを判断できます。
  イテレータによって要素が返される順序をセットが保証する場合、このメソッドは同じ順序で要素を返さなければいけません。
  toArray()メソッドと同じように、このメソッドは、配列ベースのAPIとコレクションベースのAPIの間の橋渡し役として機能します。さらに、このメソッドでは出力配列の実行時の型を正確に制御できるため、環境によっては割当ての手間を抑えるために使用できます。
  xが、文字列だけからなるセットであることがわかっていると仮定します。次のコードを使うと、新しく割り当てられたStringの配列内にセットをダンプできます。
  String[] y = x.toArray(new String[0]);
  toArray(new Object[0])は、機能の点でtoArray()と同一です。
  定義:
  
  toArray、インタフェース: Collection<E>
  
  定義:
  
  toArray、インタフェース: Set<E>
  
  オーバーライド:
  
  toArray、クラス: AbstractCollection<E>
  
  型パラメータ:
  
  T - コレクションを格納する配列のコンポーネント型
  
  パラメータ:
  
  a - 配列が十分な大きさを持つ場合は、このセットの要素の格納先の配列。配列のサイズが十分でない場合は、同じ実行時の型で新しい配列が格納用として割り当てられる。
  
  戻り値:
  
  セット内のすべての要素を保持している配列
  
  例外:
  
  ArrayStoreException - 指定された配列の実行時の型が、このセット内のすべての要素の実行時の型のスーパー・タイプでない場合
  
  NullPointerException - 指定された配列がnullである場合
- clear
  
  public void clear()
  
  すべての要素をセットから削除します。この呼出しが戻ると、セットは空になります。
  
  定義:
  
  clear、インタフェース: Collection<E>
  
  定義:
  
  clear、インタフェース: Set<E>
  
  オーバーライド:
  
  clear、クラス: AbstractCollection<E>
- remove
  
  public boolean remove(Object o)
  
  指定された要素がこのセットに存在する場合に、要素をセットから削除します。より正式には、Objects.equals(o, e)(このセットにこのような要素が含まれている場合)のような要素eを削除します。その要素がこのセットに含まれていた場合、つまり、呼出しの結果としてこのセットが変更された場合はtrueを返します。呼出しが復帰したあとは、このセットはその要素を持っていません。
  
  定義:
  
  remove、インタフェース: Collection<E>
  
  定義:
  
  remove、インタフェース: Set<E>
  
  オーバーライド:
  
  remove、クラス: AbstractCollection<E>
  
  パラメータ:
  
  o - このセットから削除されるオブジェクト(そのオブジェクトが存在する場合)
  
  戻り値:
  
  セットが、指定された要素を保持していた場合はtrue
- add
  
  public boolean add(E e)
  
  指定された要素がセットの要素として存在しない場合に、その要素をセットに追加します。より正式には、Objects.equals(e, e2)のような要素e2がセットに含まれていない場合、指定された要素eをこのセットに追加します。このセット内にすでにその要素が含まれている場合、この呼出しはセットを変更せずにfalseを返します。
  
  定義:
  
  add、インタフェース: Collection<E>
  
  定義:
  
  add、インタフェース: Set<E>
  
  オーバーライド:
  
  add、クラス: AbstractCollection<E>
  
  パラメータ:
  
  e - このセットに追加される要素
  
  戻り値:
  
  このセット内に、指定された要素がなかった場合はtrue
- containsAll
  
  public boolean containsAll(Collection<?> c)
  
  指定されたコレクションのすべての要素がこのセットに含まれている場合にtrueを返します。指定されたコレクションもセットである場合、指定されたセットがこのセットのサブセットであれば、このメソッドはtrueを返します。
  
  定義:
  
  containsAll、インタフェース: Collection<E>
  
  定義:
  
  containsAll、インタフェース: Set<E>
  
  オーバーライド:
  
  containsAll、クラス: AbstractCollection<E>
  
  パラメータ:
  
  c - このセットに含まれているかどうかがチェックされるコレクション
  
  戻り値:
  
  指定されたコレクションのすべての要素がこのセットに含まれている場合はtrue
  
  例外:
  
  NullPointerException - 指定されたコレクションがnullである場合
  
  関連項目:
  
  contains(Object)
- addAll
  
  public boolean addAll(Collection<? extends E> c)
  
  指定されたコレクションのすべての要素について、その要素がこのセット内にない場合、セットに追加します。指定されたコレクションもセットである場合、addAllオペレーションは、その値が2つのセットの和集合になるようにこのセットを効率的に変更します。オペレーションの進行中に、指定されたコレクションが変更された場合の、このオペレーションの動作は定義されていません。
  
  定義:
  
  addAll、インタフェース: Collection<E>
  
  定義:
  
  addAll、インタフェース: Set<E>
  
  オーバーライド:
  
  addAll、クラス: AbstractCollection<E>
  
  パラメータ:
  
  c - このセットに追加される要素を含むコレクション
  
  戻り値:
  
  呼出しの結果としてこのセットが変更された場合はtrue
  
  例外:
  
  NullPointerException - 指定されたコレクションがnullである場合
  
  関連項目:
  
  add(Object)
- removeAll
  
  public boolean removeAll(Collection<?> c)
  
  セットから、指定されたコレクション内に保持されているすべての要素を削除します。指定されたコレクションもセットである場合、このオペレーションは、その値が2つのセットの非対称集合差分になるようにこのセットを効率的に変更します。
  
  定義:
  
  removeAll、インタフェース: Collection<E>
  
  定義:
  
  removeAll、インタフェース: Set<E>
  
  オーバーライド:
  
  removeAll、クラス: AbstractSet<E>
  
  パラメータ:
  
  c - このセットから削除される要素を含むコレクション
  
  戻り値:
  
  呼出しの結果としてこのセットが変更された場合はtrue
  
  例外:
  
  ClassCastException - このセットのある要素のクラスが、指定されたコレクションと互換でない場合(オプション)
  
  NullPointerException - このセットにnull要素が含まれており、指定されたコレクションがnull要素を許可しない場合(オプション)、または指定されたコレクションがnullの場合
  
  関連項目:
  
  remove(Object)
- retainAll
  
  public boolean retainAll(Collection<?> c)
  
  指定されたコレクション内に保持されている、セット内の要素だけを保持します。つまり、セットから、指定されたコレクション内にない要素をすべて削除します。指定されたコレクションもセットである場合、このオペレーションは、その値が2つのセットの共通部分になるようにこのセットを効率的に変更します。
  
  定義:
  
  retainAll、インタフェース: Collection<E>
  
  定義:
  
  retainAll、インタフェース: Set<E>
  
  オーバーライド:
  
  retainAll、クラス: AbstractCollection<E>
  
  パラメータ:
  
  c - このセットで保持される要素を含むコレクション
  
  戻り値:
  
  呼出しの結果としてこのセットが変更された場合はtrue
  
  例外:
  
  ClassCastException - このセットのある要素のクラスが、指定されたコレクションと互換でない場合(オプション)
  
  NullPointerException - このセットにnull要素が含まれており、指定されたコレクションがnull要素を許可しない場合(オプション)、または指定されたコレクションがnullの場合
  
  関連項目:
  
  remove(Object)
- iterator
  
  public Iterator<E> iterator()
  
  このセットに含まれる各要素についてのイテレータを、これらの要素が追加された順序で返します。
  返されるイテレータは、イテレータの構築時のセット状態のスナップショットを提供します。イテレータのトラバーサル中に同期化は必要ありません。イテレータは、removeメソッドをサポートしません。
  
  定義:
  
  iterator、インタフェース: Collection<E>
  
  定義:
  
  iterator、インタフェース: Iterable<E>
  
  定義:
  
  iterator、インタフェース: Set<E>
  
  定義:
  
  iterator、クラス: AbstractCollection<E>
  
  戻り値:
  
  セットの要素のイテレータ
- equals
  
  public boolean equals(Object o)
  
  指定されたオブジェクトがセットと同じかどうかを比較します。指定されたオブジェクトがこのオブジェクトと同じオブジェクトである場合、またはそれがSetでもあり、指定されたセットでiteratorによって返された要素が、このセットでイテレータによって返された要素と同じである場合はtrueを返します。より正式には、2つのイテレータは、同じ要素数を返し、指定されたセットでイテレータによって返されるすべての要素e1に対して同じ要素を返すとみなされます。Objects.equals(e1, e2)のように、このセットにイテレータによって返された要素e2があります。
  
  定義:
  
  equals、インタフェース: Collection<E>
  
  定義:
  
  equals、インタフェース: Set<E>
  
  オーバーライド:
  
  equals、クラス: AbstractSet<E>
  
  パラメータ:
  
  o - このセットと等しいかどうかが比較されるオブジェクト
  
  戻り値:
  
  指定されたオブジェクトがこのセットに等しい場合はtrue
  
  関連項目:
  
  Object.hashCode()、HashMap
- removeIf
  
  public boolean removeIf(Predicate<? super E> filter)
  
  次のインタフェースからコピーされた説明: Collection
  
  指定された述語を満たすこのコレクションの要素をすべて削除します。反復中に、または述語によってスローされたエラーまたは実行時例外は、呼出し側に中継されます。
  
  定義:
  
  removeIf、インタフェース: Collection<E>
  
  パラメータ:
  
  filter - 削除される要素に対してtrueを返す述語
  
  戻り値:
  
  要素が削除された場合はtrue
  
  例外:
  
  NullPointerException - 指定されたフィルタがnullである場合
- forEach
  
  public void forEach(Consumer<? super E> action)
  
  インタフェースからコピーされた説明: Iterable
  
  Iterableの各要素に対して指定されたアクションを、すべての要素が処理されるか、アクションが例外をスローするまで実行します。反復の順序でアクションが実行されます(その順序が指定されている場合)。アクションによってスローされた例外は、呼出し側に中継されます。
  オーバーライドするクラスが並行変更ポリシーを指定していない限り、アクションが要素の基本ソースを変更する副作用を実行する場合、このメソッドの動作は指定されていません。
  
  定義:
  
  forEach、インタフェース: Iterable<E>
  
  パラメータ:
  
  action - 各要素に対して実行されるアクション
  
  例外:
  
  NullPointerException - 指定されたアクションがnullである場合
- spliterator
  
  public Spliterator<E> spliterator()
  
  このセット内の要素に対するSpliteratorを、これらの要素が追加された順序で返します。
  Spliteratorは、Spliterator.IMMUTABLE、Spliterator.DISTINCT、Spliterator.SIZEDおよびSpliterator.SUBSIZEDを報告します。
  スプリッテレータは、スプリッテレータが構築されたときのセット状態のスナップショットを提供します。スプリッテレータの操作中に同期化は必要ありません。
  
  定義:
  
  spliterator、インタフェース: Collection<E>
  
  定義:
  
  spliterator、インタフェース: Iterable<E>
  
  定義:
  
  spliterator、インタフェース: Set<E>
  
  戻り値:
  
  このセット内の要素に対するSpliterator
  
  導入されたバージョン:
  
  1.8

クラスCopyOnWriteArraySet<E>

コンストラクタのサマリー

メソッドのサマリー

クラス java.util.AbstractSetで宣言されたメソッド

クラス java.util.AbstractCollectionで宣言されたメソッド

クラス java.lang.Objectで宣言されたメソッド

インタフェース java.util.Collectionで宣言されたメソッド

コンストラクタの詳細

CopyOnWriteArraySet

CopyOnWriteArraySet

メソッドの詳細

size

isEmpty

contains

toArray

toArray

clear

remove

add

containsAll

addAll

removeAll

retainAll

iterator

equals

removeIf

forEach

spliterator