モジュール java.base
パッケージ java.util

インタフェースCollection<E>

型パラメータ:
E - このコレクション内の要素の型
すべてのスーパー・インタフェース:
Iterable<E>
既知のすべてのサブインタフェース:
BeanContext, BeanContextServices, BlockingDeque<E>, BlockingQueue<E>, Deque<E>, EventSet, List<E>, NavigableSet<E>, Queue<E>, SequencedCollection<E>, SequencedSet<E>, Set<E>, SortedSet<E>, TransferQueue<E>
既知のすべての実装クラス:
AbstractCollection, AbstractList, AbstractQueue, AbstractSequentialList, AbstractSet, ArrayBlockingQueue, ArrayDeque, ArrayList, AttributeList, BeanContextServicesSupport, BeanContextSupport, ConcurrentHashMap.KeySetView, ConcurrentLinkedDeque, ConcurrentLinkedQueue, ConcurrentSkipListSet, CopyOnWriteArrayList, CopyOnWriteArraySet, DelayQueue, EnumSet, HashSet, JobStateReasons, LinkedBlockingDeque, LinkedBlockingQueue, LinkedHashSet, LinkedList, LinkedTransferQueue, PriorityBlockingQueue, PriorityQueue, RoleList, RoleUnresolvedList, Stack, SynchronousQueue, TreeSet, Vector
public interface Collection<E> extends Iterable<E>
コレクション階層のルート・インタフェースです。 コレクションは、その要素であるオブジェクトのグループを表します。 コレクションによっては要素の重複を許可しますが、許可しないコレクションもあります。 オーダーされたものもあれば、オーダーされなかったものもあります。 「見つける」が定義されているコレクションは、通常、SequencedCollectionインタフェースのサブタイプです。 JDKでは、このインタフェースのdirect実装は提供されません: SetやListなど、より具体的なサブインタフェースの実装を提供します。 このインタフェースは、通常は、最大限の普遍性が求められる場面でコレクションを渡したり、そのコレクションを操作するために使用されます。

Bagまたはマルチセット (重複要素を格納できる、順序付けのないコレクション)は、このインタフェースを直接実装する必要があります。

すべての汎用Collection実装クラス(通常、サブインタフェースの1つを介してCollectionを間接的に実装)は、2つの"standard"コンストラクタを提供する必要があります: 空のコレクションを作成するvoid (引数なし)コンストラクタと、引数と同じ要素を持つ新しいコレクションを作成するCollection型の単一の引数を持つコンストラクタ。 したがって、後者のコンストラクタでは、ユーザーはどのコレクションでもコピーでき、希望の実装型のコレクションと完全に同じコレクションを生成できます。 この規則(インタフェースにコンストラクタを含めることができないため)を強制する方法はありませんが、Javaプラットフォーム・ライブラリのすべての汎用Collection実装が準拠しています。

特定のメソッドは、optionalとして指定されます。 コレクション実装が特定の操作を実装しない場合、対応するメソッドを定義してUnsupportedOperationExceptionをスローする必要があります。 このようなメソッドは、コレクション・インタフェースのメソッド仕様に"オプションの操作"とマークされています。

いくつかのコレクション実装には、要素に含まれる可能性のある制限があります。 たとえば、null要素を禁止する実装や、null要素の型に制限がある実装もあります。 不適格要素を追加しようとすると、チェックされていない例外(通常はNullPointerExceptionまたはClassCastException)がスローされます。 不適格な要素を照会しようとすると、例外がスローされる場合や、ただfalseを返す場合もあります。前者の動作を実行する実装もあれば、後者の動作を実行する実装もあります。 ほとんどの場合、処理が完了しても不適格な要素のコレクションへの挿入が発生しないような不適格な要素の処理を試みると、実装のオプションに応じて例外がスローされるか、または正常に終了します。 このインタフェースの仕様では、そうした例外は「任意」と記載されています。

独自の同期ポリシーを決定するかどうかは、それぞれのコレクションによって異なります。 実装による強い保証がない場合、別のスレッドによって変更されるコレクションでメソッドを呼び出すと、定義されていない動作が発生する可能性があります。これには、直接の呼び出し、呼出しを実行する可能性があるメソッドへのコレクションの引渡し、および既存のイテレータを使用したコレクションの検査が含まれます。

Collections Frameworkインタフェース内の多数のメソッドは、equalsメソッドとの関連で定義されます。 たとえば、contains(Object o)メソッドの指定では次のようになります : "このコレクションに(o==null ? e==null : o.equals(e))のような要素eが少なくとも1つ含まれている場合のみ、trueを返します。" この指定は、null以外の引数oを指定してCollection.containsを呼び出すと、要素eに対してo.equals(e)が呼び出されることを意味するように解釈しないでください。 実装は、2つの要素のハッシュ・コードを最初に比較するなどして、equalsの呼出しを回避する最適化を自由に実装できます。 (Object.hashCode()仕様では、等価ではないハッシュ・コードを保持する2つのオブジェクトは等価ではないことが保証されます。) もう少し一般的に言うと、さまざまなCollections Frameworkインタフェースの実装で、実装者が適切と判断するなら、基本となるObjectメソッドの指定された動作を自由に利用できます。

コレクションの再帰的なトラバーサルを行うコレクション操作の中には、コレクションにそれ自身が直接または間接的に含まれる自己参照型インスタンスの例外によって失敗するものがあります。 これには、clone()、equals()、hashCode()、およびtoString()メソッドが含まれます。 実装ではオプションで自己参照シナリオを処理できますが、最新の実装では行われていません。

コレクションを表示

ほとんどのコレクションでは、格納されている要素のストレージが管理されます。 対照的に、「コレクションを表示」自体は要素を格納しませんが、実際の要素を格納するためにバッキング・コレクションに依存します。 ビュー・コレクション自体で処理されない操作は、バッキング・コレクションに委任されます。 ビュー・コレクションの例には、Collections.checkedCollection、Collections.synchronizedCollection、Collections.unmodifiableCollectionなどのメソッドによって返されるラッパー・コレクションがあります。 ビュー・コレクションのその他の例には、List.subList、NavigableSet.subSet、Map.entrySet、SequencedCollection.reversedなど、同じ要素の異なる表現を提供するコレクションがあります。 バッキング・コレクションに加えられたすべての変更は、ビュー・コレクションに表示されます。 これに対応して、ビュー・コレクションに加えられた変更 - 変更が許可されている場合 - バッキング・コレクションに書き込まれます。 これらは技術的にはコレクションではありませんが、IteratorおよびListIteratorのインスタンスでは、バッキング・コレクションへの変更の書込みも許可され、場合によっては反復中にバッキング・コレクションへの変更が表示されることがあります。

変更不可能なコレクション

このインタフェースの特定のメソッドは"destructive"とみなされ、"mutator"メソッドと呼ばれ、操作対象のコレクション内に含まれるオブジェクトのグループを変更します。 このコレクションの実装が操作をサポートしていない場合、UnsupportedOperationExceptionをスローするように指定することができます。 そのようなメソッドは、呼び出しがコレクションに影響を与えない場合、UnsupportedOperationExceptionをスローする必要があります。 たとえば、add操作をサポートしていないコレクションを考えてみましょう。 addAllメソッドがこのコレクションで呼び出され、引数として空のコレクションがある場合はどうなりますか? ゼロ要素の追加は効果がないため、このコレクションでは何もしないで例外をスローすることはできません。 ただし、このような場合は、例外をスローすると無条件に例外がスローされることが推奨されます。

「変更不可能なコレクション」はコレクションであり、すべてのメソッド(上で定義したように)がUnsupportedOperationExceptionをスローするように指定されています。 したがって、そのようなコレクションは、その上の任意のメソッドを呼び出すことによって変更することはできません。 コレクションを適切に変更できないようにするには、コレクションから派生したビュー・コレクションも変更不可能でなければなりません。 たとえば、Listを変更できない場合、List.subListによって返されたListも変更不可能です。

変更不可能なコレクションは必ずしも変更できません。 含まれている要素が変更可能な場合、コレクション全体が変更不可能であっても、明らかに変更可能です。 たとえば、変更可能な要素を含む2つの変更不可能なリストを考えてみましょう。 両方のリストが変更不可能であっても、要素が変更された場合、list1.equals(list2)を呼び出した結果は、呼び出しごとに異なる場合があります。 ただし、変更不能なコレクションにすべての変更不能な要素が含まれている場合は、効果的に不変であると見なすことができます。

変更不可能なビュー・コレクション

「変更不可能なビュー・コレクション」は変更不可能なコレクションで、バッキング・コレクションのビューです。 そのメソッドは上記のようにUnsupportedOperationExceptionをスローしますが、読み込みメソッドと問合せメソッドはバッキング・コレクションに委譲されます。 その効果は、バッキング・コレクションへの読み取り専用アクセスを提供することです。 これは、内部コレクションへの読み取りアクセスをユーザーに提供し、そのコレクションが予期せず変更されるのを防ぐために役立ちます。 変更不可能なビュー・コレクションの例として、Collections.unmodifiableCollection、Collections.unmodifiableListおよび関連するメソッドによって返されるものがあります。

バッキング・コレクションへの変更は引き続き可能であり、変更が発生した場合は変更不可能なビューで表示されることに注意してください。 したがって、変更不可能なビュー・コレクションは必ずしも不変であるとは限りません。 ただし、変更不可能なビューのバッキング・コレクションが効果的に不変である場合、またはバッキング・コレクションへの参照が変更不可能なビューのみである場合、ビューは効果的に不変であるとみなすことができます。

コレクションの直列化可能性

コレクションの直列化可能性はオプションです。 このため、どのコレクション・インタフェースもSerializableインタフェースを実装するように宣言されていません。 ただし、直列化可能性は一般に有用と考えられるため、ほとんどの収集実装は直列化可能です。

(ArrayListまたはHashMapなどの)のパブリック・クラスであるコレクション実装は、実際に直列化可能なSerializableインタフェースを実装するように宣言されています。 一部のコレクション実装は、「変更不可能なコレクション」などのパブリック・クラスではありません。 このような場合、このようなコレクションの直列化可能性については、そのコレクションを作成するメソッドの指定またはその他の適切な場所で説明されています。 コレクションの直列化可能性が指定されていない場合、このような収集の直列化可能性に関する保証はありません。 特に、元のコレクションが直列化可能であっても、多くの「コレクションを表示」は直列化可能ではありません。

Serializableインタフェースを実装するコレクション実装は、直列化可能であることを保証できません。 その理由は、コレクションには他の型の要素が含まれているため、一部の要素型のインスタンスが実際に直列化可能かどうかを静的に判断できないためです。 たとえば、EがSerializableインタフェースを実装していない直列化可能なCollection<E>について考えてみます。 コレクションは、Eの直列化可能なサブタイプの要素のみが含まれている場合、または空の場合は、直列化可能です。 このため、コレクションは、コレクション全体の直列化可能性として「条件付きで直列化可能」と言われています。これは、コレクション自体が直列化可能かどうか、および含まれるすべての要素も直列化可能かどうかによって異なります。

SortedSetおよびSortedMapのインスタンスでは追加のケースが発生します。 これらのコレクションは、セット要素またはマップ・キーに順序付けを行うComparatorを使用して作成できます。 そのようなコレクションは、Comparatorが直列化可能である場合にのみ直列化可能です。

このインタフェースは、Java Collections Frameworkのメンバーです。

実装要件:
デフォルトのメソッド実装(継承または別の方法によるもの)は、同期プロトコルを適用しません。 Collectionの実装に特定の同期プロトコルが含まれている場合は、デフォルトの実装をオーバーライドしてそのプロトコルを適用する必要があります。
導入されたバージョン:
1.2
関連項目:

  • メソッドのサマリー

    修飾子と型
    メソッド
    説明
    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)
    指定されたオブジェクトとこのコレクションが等しいかどうかを比較します。
    int
    hashCode()
    コレクションのハッシュ・コード値を返します。
    boolean
    isEmpty()
    このコレクションに要素がない場合にtrueを返します。
    Iterator<E>
    iterator()
    コレクションの要素のイテレータを返します。
    default Stream<E>
    parallelStream()
    このコレクションをソースとして、潜在的に並列のStreamを返します。
    boolean
    remove(Object o)
    指定された要素のインスタンスがこのコレクションにあれば、そのインスタンスをコレクションから1つ削除します(オプションの操作)。
    boolean
    removeAll(Collection<?> c)
    指定されたコレクションにも格納されているこのコレクションのすべての要素を削除します(オプションの操作)。
    default boolean
    removeIf(Predicate<? super E> filter)
    指定された述語を満たすこのコレクションの要素をすべて削除します。
    boolean
    retainAll(Collection<?> c)
    このコレクションにおいて、指定されたコレクションに格納されている要素だけを保持します(オプションの操作)。
    int
    size()
    このコレクション中の要素の数を返します。
    default Spliterator<E>
    spliterator()
    このコレクション内の要素に対するSpliteratorを作成します。
    default Stream<E>
    stream()
    このコレクションをソースとして使用して、逐次的なStreamを返します。
    Object[]
    toArray()
    このコレクションの要素がすべて格納されている配列を返します。
    default <T> T[]
    toArray(IntFunction<T[]> generator)
    指定されたgenerator関数を使用してこのコレクションのすべての要素を含む配列を返し、返された配列を割り当てます。
    <T> T[]
    toArray(T[] a)
    このコレクション内のすべての要素を保持する配列を返します。返される配列の実行時の型は、指定された配列の型です。

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

    forEach

  • メソッドの詳細

    • size

      int size()
      このコレクション中の要素の数を返します。 このコレクションに複数のInteger.MAX_VALUE要素が含まれている場合は、Integer.MAX_VALUEを返します。
      戻り値:
      このコレクションの要素数

    • isEmpty

      boolean isEmpty()
      このコレクションに要素がない場合にtrueを返します。
      戻り値:
      このコレクションに要素が含まれていない場合はtrue

    • contains

      boolean contains(Object o)
      このコレクションに指定した要素が含まれている場合は、trueを返します。 より正式には、このコレクションにObjects.equals(o, e)などの要素eが少なくとも1つ含まれている場合にのみ、trueを返します。
      パラメータ:
      o - このコレクション内にあるかどうかが判定される要素
      戻り値:
      このコレクションに指定した要素が含まれている場合はtrue
      スロー:
      ClassCastException - 指定された要素の型が、このコレクションと互換でない場合(オプション)
      NullPointerException - 指定された要素がnullで、このコレクションがnull要素を許可しない場合(オプション)

    • iterator

      Iterator<E> iterator()
      コレクションの要素のイテレータを返します。 要素が返される順序についての保証はありません。ただし、このコレクションが、保証を提供するクラスのインスタンスである場合は例外です。
      定義:
      iterator、インタフェースIterable<E>
      戻り値:
      このコレクションの要素に対するIterator

    • toArray

      Object[] toArray()
      このコレクションの要素がすべて格納されている配列を返します。 イテレータによって要素が返される順序をコレクションが保証する場合、このメソッドは同じ順序で要素を返さなければなりません。 返される配列の「ランタイム・コンポーネント・タイプ」はObjectです。

      返される配列への参照をコレクションが維持しないという点で、この配列は安全です。 つまり、このメソッドは、コレクションが配列に連動している場合でも新しい配列を割り当てます。 このため、呼出し側は、返された配列を自由に変更できます。

      APIのノート:
      このメソッドは、配列ベースおよびコレクションベースのAPIの間のブリッジ渡し役として機能します。 ランタイム・タイプがObject[]の配列を戻します。 toArray(T[])を使用して既存の配列を再利用するか、toArray(IntFunction)を使用して配列の実行時の型を制御します。
      戻り値:
      「ランタイム・コンポーネント・タイプ」がObjectの配列。このコレクションのすべての要素を含む

    • toArray

      <T> T[] toArray(T[] a)
      このコレクション内のすべての要素を保持する配列を返します。返される配列の実行時の型は、指定された配列の型です。 コレクションが指定された配列に収まる場合は、その中に返されます。 そうでない場合は、指定された配列の実行時の型とコレクションのサイズを持つ新しい配列が割り当てられます。

      このコレクションが(つまり、配列にはこのコレクションより多くの要素があります)の余裕のある指定された配列に収まる場合、コレクションの終端の直後の配列の要素はnullに設定されます。 (これは、このコレクションにnull要素が含まれていないことをコール元が認識している場合に、このコレクションonlyの長さを決定する際に役立ちます。)

      イテレータによって要素が返される順序をコレクションが保証する場合、このメソッドは同じ順序で要素を返さなければなりません。

      APIのノート:
      このメソッドは、配列ベースおよびコレクションベースのAPIの間のブリッジ渡し役として機能します。 特定の状況で既存の配列を再利用できます。 toArray()を使用して、実行時タイプがObject[]である配列を作成するか、toArray(IntFunction)を使用して配列の実行時タイプを制御します。

      xが文字列のみを含むことがわかっているコレクションであるとします。 次のコードを使用すると、コレクションを、以前に割り当てられたString配列にダンプできます。 

           String[] y = new String[SIZE];
     ...
     y = x.toArray(y);

      新しい配列が割り当てられ、コレクションxが既存の配列yに格納する要素が多すぎる場合に返されるため、戻り値はy変数に再割当てされます。

      toArray(new Object[0])は、機能の点でtoArray()と同一です。

      型パラメータ:
      T - コレクションを格納する配列のコンポーネント型
      パラメータ:
      a - 配列が十分な大きさを持つ場合は、このコレクションの要素の格納先の配列。配列のサイズが十分でない場合は、同じ実行時の型で新しい配列が格納用として割り当てられる。
      戻り値:
      コレクションのすべての要素が格納されている配列
      スロー:
      ArrayStoreException - このコレクション内の要素の実行時の型が、指定された配列の「ランタイム・コンポーネント・タイプ」に代入可能でない場合
      NullPointerException - 指定された配列がnullである場合

    • toArray

      default <T> T[] toArray(IntFunction<T[]> generator)
      指定されたgenerator関数を使用してこのコレクションのすべての要素を含む配列を返し、返された配列を割り当てます。

      イテレータによって要素が返される順序をコレクションが保証する場合、このメソッドは同じ順序で要素を返さなければなりません。

      APIのノート:
      このメソッドは、配列ベースおよびコレクションベースのAPIの間のブリッジ渡し役として機能します。 これにより、特定の実行時タイプの配列を作成できます。 toArray()を使用して、ランタイム型がObject[]の配列を作成するか、toArray(T[])を使用して既存の配列を再利用します。

      xが文字列のみを含むことがわかっているコレクションであるとします。 次のコードを使用して、新しく割り当てられたStringの配列にコレクションをダンプできます: 

           String[] y = x.toArray(String[]::new);

      実装要件:
      デフォルトの実装では、ゼロのジェネレータ関数をコールしてから、生成された配列をtoArray(T[])に渡します。
      型パラメータ:
      T - コレクションを格納する配列のコンポーネント型
      パラメータ:
      generator - 要求された型と指定された長さを持つ新しい配列を生成する関数
      戻り値:
      コレクションのすべての要素が格納されている配列
      スロー:
      ArrayStoreException - このコレクションのいずれかの要素の実行時タイプが、生成された配列の「ランタイム・コンポーネント・タイプ」に割り当てられない場合
      NullPointerException - ジェネレータ・ファンクションがNullの場合
      導入されたバージョン:
      11

    • add

      boolean add(E e)
      指定された要素がこのコレクションに格納されていることを保証します(オプションの操作)。 このコレクションがコールの結果として変更された場合は、trueを返します。 (このコレクションで重複が許可されず、指定された要素がすでに含まれている場合は、falseを返します。)

      このオペレーションをサポートするコレクションでは、コレクションに追加できる要素について制限がある場合があります。 特に、一部のコレクションではnull要素の追加が拒否され、その他のコレクションでは追加できる要素のタイプに制限が課されます。 追加される要素に関して制限がある場合は、そのCollectionクラスのドキュメントに明示すべきでしょう。

      コレクションにすでに要素が含まれている理由以外で特定の要素の追加が拒否された場合、例外(falseを返すのではなく)をスローする必要があります。 これにより、この呼出しが戻ったあとにコレクションが指定された要素を必ず格納するという不変性を保つことができます。

      パラメータ:
      e - このコレクションにあるかどうかを調べる要素
      戻り値:
      コールの結果としてこのコレクションが変更された場合、true
      スロー:
      UnsupportedOperationException - add操作がこのコレクションでサポートされていない場合
      ClassCastException - 指定された要素のクラスが原因で、このコレクションにその要素を追加できない場合
      NullPointerException - 指定された要素がnullで、このコレクションがnull要素を許可しない場合
      IllegalArgumentException - 要素のあるプロパティが原因で、このコレクションに要素を追加できない場合
      IllegalStateException - 挿入制限のため、この時点で要素を追加できない場合

    • remove

      boolean remove(Object o)
      指定された要素のインスタンスがこのコレクションにあれば、そのインスタンスをコレクションから1つ削除します(オプションの操作)。 より正式には、要素eを削除して、このコレクションにそのような要素が1つ以上含まれている場合はObjects.equals(o, e)にします。 このコレクションに指定した要素(このコレクションがコールの結果として変更された場合、または同等)が含まれている場合は、trueを返します。
      パラメータ:
      o - このコレクションから削除される要素(その要素が存在する場合)
      戻り値:
      この呼出しの結果として要素が削除された場合はtrue
      スロー:
      ClassCastException - 指定された要素の型が、このコレクションと互換でない場合(オプション)
      NullPointerException - 指定された要素がnullで、このコレクションがnull要素を許可しない場合(オプション)
      UnsupportedOperationException - remove操作がこのコレクションでサポートされていない場合

    • containsAll

      boolean containsAll(Collection<?> c)
      指定したコレクションのすべての要素がこのコレクションに含まれている場合、trueを返します。
      パラメータ:
      c - このコレクションにあるかどうかを調べるコレクション
      戻り値:
      このコレクションに指定したコレクションのすべての要素が含まれている場合、true
      スロー:
      ClassCastException - 指定されたコレクションの1つ以上の要素の型が、このコレクションと互換でない場合(オプション)
      NullPointerException - 指定したコレクションに1つ以上のnull要素が含まれ、このコレクションでnull要素(optional)が許可されない場合、または指定されたコレクションがnullの場合。
      関連項目:

    • addAll

      boolean addAll(Collection<? extends E> c)
      指定されたコレクションのすべての要素をこのコレクションに追加します(オプションの操作)。 オペレーションの進行中に、指定されたコレクションが変更された場合の、このオペレーションの動作は定義されていません。 したがって、指定されたコレクションがこのコレクション自身であり、このコレクションが空ではない場合、この呼出しの動作は定義されていません。 指定したコレクションに「見つける」が定義されている場合、その要素の処理は通常、その順序で行われます。
      パラメータ:
      c - このコレクションに追加される要素を含むコレクション
      戻り値:
      コールの結果としてこのコレクションが変更された場合、true
      スロー:
      UnsupportedOperationException - addAll操作がこのコレクションでサポートされていない場合
      ClassCastException - 指定されたコレクションの要素のクラスが原因で、このコレクションにその要素を追加できない場合
      NullPointerException - 指定されたコレクション内にnull要素が含まれ、このコレクションがnull要素を許可しない場合。または指定されたコレクションがnullの場合
      IllegalArgumentException - 指定されたコレクションの要素のあるプロパティが原因で、このコレクションにその要素を追加できない場合
      IllegalStateException - 挿入制限のため、この時点で一部の要素を追加できない場合
      関連項目:

    • removeAll

      boolean removeAll(Collection<?> c)
      指定されたコレクションにも格納されているこのコレクションのすべての要素を削除します(オプションの操作)。 この呼出しの結果、このコレクションには指定されたコレクションと共通の要素はなくなります。
      パラメータ:
      c - このコレクションから削除される要素を含むコレクション
      戻り値:
      コールの結果としてこのコレクションが変更された場合、true
      スロー:
      UnsupportedOperationException - removeAllメソッドがこのコレクションでサポートされていない場合
      ClassCastException - このコレクション内の1つ以上の要素の型が、指定されたコレクションと互換でない場合(オプション)
      NullPointerException - このコレクションに1つ以上のnull要素が含まれ、指定したコレクションがnull要素(optional)をサポートしていない場合、または指定されたコレクションがnullの場合
      関連項目:

    • removeIf

      default boolean removeIf(Predicate<? super E> filter)
      指定された述語を満たすこのコレクションの要素をすべて削除します。 反復中に、または述語によってスローされたエラーまたは実行時例外は、呼出し側に中継されます。
      実装要件:
      デフォルトの実装では、そのiterator()を使用してコレクションのすべての要素をトラバースします。 一致する各要素は、Iterator.remove()を使って削除されます。 コレクションのイテレータが削除をサポートしていない場合は、最初に一致する要素に対してUnsupportedOperationExceptionがスローされます。
      パラメータ:
      filter - 削除される要素に対してtrueを返す述語
      戻り値:
      要素が削除された場合はtrue
      スロー:
      NullPointerException - 指定されたフィルタがnullである場合
      UnsupportedOperationException - このコレクションから要素を削除できない場合。 一致する要素を削除できない場合、または一般的に削除がサポートされていない場合、実装によってこの例外がスローされることがあります。
      導入されたバージョン:
      1.8

    • retainAll

      boolean retainAll(Collection<?> c)
      このコレクションにおいて、指定されたコレクションに格納されている要素だけを保持します(オプションの操作)。 つまり、指定されたコレクションに格納されていないすべての要素をこのコレクションから削除します。
      パラメータ:
      c - このコレクションで保持される要素を含むコレクション
      戻り値:
      コールの結果としてこのコレクションが変更された場合、true
      スロー:
      UnsupportedOperationException - retainAll操作がこのコレクションでサポートされていない場合
      ClassCastException - このコレクション内の1つ以上の要素の型が、指定されたコレクションと互換でない場合(オプション)
      NullPointerException - このコレクションに1つ以上のnull要素が含まれ、指定したコレクションでnull要素(optional)が許可されていない場合、または指定されたコレクションがnullの場合
      関連項目:

    • clear

      void clear()
      このコレクションからすべての要素を削除します(オプションの操作)。 このメソッドが戻ると、コレクションは空になります。
      スロー:
      UnsupportedOperationException - clear操作がこのコレクションでサポートされていない場合

    • equals

      boolean equals(Object o)
      指定されたオブジェクトとこのコレクションが等しいかどうかを比較します。

      Collectionインタフェースは、Object.equalsの一般契約に規定を追加しませんが、Collectionインタフェース"直接" (つまり、Collectionですが、SetまたはListではないクラスを作成)を実装するプログラマは、Object.equalsをオーバーライドするように選択した場合は注意する必要があります。 これを行う必要はありません。最も簡単な操作は、Objectの実装に依存することです。ただし、実装者はデフォルトの"参照比較。"のかわりに"値の比較"を実装する場合があります (ListおよびSetインタフェースでは、このような値の比較が必須です。)

      Object.equalsメソッドの一般的な契約では、等しいことが対称(つまり、b.equals(a)の場合のみa.equals(b))であることが示されます。 リストが他のリストとのみ等しく、他のセットに設定されているList.equalsおよびSet.equals状態の契約。 したがって、ListインタフェースもSetインタフェースも実装しないコレクション・クラスのカスタムequalsメソッドは、このコレクションが任意のリストまたはセットと比較されるときにfalseを返す必要があります。 (同じロジックで、SetインタフェースとListインタフェースの両方を正しく実装するクラスを記述することはできません。)

      オーバーライド:
      equals、クラスObject
      パラメータ:
      o - このコレクションと等しいかどうかが比較されるオブジェクト
      戻り値:
      指定したオブジェクトがこのコレクションと等しい場合はtrue
      関連項目:

    • hashCode

      int hashCode()
      コレクションのハッシュ・コード値を返します。 Collectionインタフェースでは、Object.hashCodeメソッドの一般契約に規定は追加されませんが、Object.equalsメソッドをオーバーライドするクラスは、Object.hashCodeメソッドの一般的な契約を満たすため、Object.hashCodeメソッドもオーバーライドする必要があることに注意してください。 特に、c1.equals(c2)はc1.hashCode()==c2.hashCode()を意味します。
      オーバーライド:
      hashCode、クラスObject
      戻り値:
      このコレクションのハッシュ・コード値
      関連項目:

    • spliterator

      default Spliterator<E> spliterator()
      このコレクション内の要素に対するSpliteratorを作成します。 実装では、このスプリッテレータによって報告された特性値をドキュメント化する必要があります。 スプリッテレータがSpliterator.SIZEDを報告し、このコレクションに要素が1つも含まれていない場合は、そのような特性値が報告される必要はありません。

      デフォルトの実装は、より効率的なスプリッテレータを返すことができるサブクラスによってオーバーライドされるべきです。 stream()およびparallelStream()メソッドで予想される遅延動作を保持するために、スプリッタはIMMUTABLEまたはCONCURRENTの特性を持つか、late-bindingである必要があります。 これらのどれも実現できない場合、オーバーライドするクラスはバインディングおよび構造上の干渉に関するスプリッテレータのドキュメント化されたポリシーを記述し、次にあるようにstream()およびparallelStream()メソッドをオーバーライドして、スプリッテレータのSupplierでストリームを作成するべきです。 

      
     Stream<E> s = StreamSupport.stream(() -> spliterator(), spliteratorCharacteristics)

      これらの要件により、stream()およびparallelStream()メソッドによって作成されたストリームは、ストリーム終端操作の開始以降、コレクションの内容を反映するようになります。

      定義:
      spliterator、インタフェースIterable<E>
      実装要件:
      デフォルトの実装では、コレクションのIteratorからlate-bindingスプリッタが作成されます。 このスプリッテレータは、コレクションのイテレータのフェイルファスト特性を継承します。

      作成されたSpliteratorはSpliterator.SIZEDを報告します。

      実装上のノート:
      作成されたSpliteratorはさらにSpliterator.SUBSIZEDも報告します。

      スプリッテレータの適用される要素がない場合は、SIZEDおよびSUBSIZEDの他に追加の特性値を報告しても、クライアントによる計算の制御、特殊化、または簡素化には役立ちません。 ただし、これによって、不変および空のスプリッテレータ・インスタンス(Spliterators.emptySpliterator()を参照)を空のコレクションに共同利用できるようになり、そのようなスプリッテレータが適用される要素がないかどうかをクライアントが判定できるようになります。

      戻り値:
      このコレクション内の要素に対するSpliterator
      導入されたバージョン:
      1.8

    • stream

      default Stream<E> stream()
      このコレクションをソースとして使用して、逐次的なStreamを返します。

      このメソッドは、IMMUTABLE、CONCURRENT、または遅延バインディングであるスプリッテレータをspliterator()メソッドが返せない場合にオーバーライドされるべきです。 (詳細はspliterator()を参照。)

      実装要件:
      デフォルトの実装では、コレクションのSpliteratorから順次Streamを作成します。
      戻り値:
      このコレクション内の要素に対する順次Stream
      導入されたバージョン:
      1.8

    • parallelStream

      default Stream<E> parallelStream()
      このコレクションをソースとして、潜在的に並列のStreamを返します。 このメソッドは順次ストリームを返すことができます。

      このメソッドは、IMMUTABLE、CONCURRENT、または遅延バインディングであるスプリッテレータをspliterator()メソッドが返せない場合にオーバーライドされるべきです。 (詳細はspliterator()を参照。)

      実装要件:
      デフォルトの実装では、コレクションのSpliteratorから並列Streamを作成します。
      戻り値:
      このコレクション内の要素に対する、並列の可能性のあるStream
      導入されたバージョン:
      1.8