java.util
クラス AbstractQueue<E>

java.lang.Object
  java.util.AbstractCollection<E>
      java.util.AbstractQueue<E>

型パラメータ:

E - コレクション内に存在する要素の型

すべての実装されたインタフェース:

Iterable<E>, Collection<E>, Queue<E>

直系の既知のサブクラス:

ArrayBlockingQueue, ConcurrentLinkedQueue, DelayQueue, LinkedBlockingQueue, PriorityBlockingQueue, PriorityQueue, SynchronousQueue

public abstract class AbstractQueue<E>
extends AbstractCollection<E>
implements Queue<E>

このクラスは、いくつかの Queue オペレーションのスケルトン実装を提供します。このクラス内の実装が適切なのは、ベース実装で null 要素が許可されない場合です。add、remove、および element メソッドは、それぞれ offer、poll、および peek に基づいていますが、false または null を返して失敗を示す代わりに、例外をスローします。

このクラスを拡張する Queue 実装は、Iterator.remove() をサポートする Queue.peek()、Queue.poll()、Collection.size()、および Collection.iterator() とともに、null 要素の挿入を許可しない Queue.offer(E) メソッドを最低限定義する必要があります。通常、追加メソッドもオーバーライドされます。これらの要件を満たすことができない場合、AbstractCollection のサブクラス化を考慮してください。

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

導入されたバージョン:

1.5

コンストラクタの概要

protected

AbstractQueue() サブクラスにより使用されるコンストラクタです。

メソッドの概要

boolean	add(E o) 指定された要素をこのキューに追加します。
boolean	addAll(Collection<? extends E> c) 指定されたコレクション内のすべての要素をこのキューに追加します。
void	clear() このコレクションからすべての要素を削除します。
E	element() このキューのヘッダを取得しますが、削除しません。
E	remove() このキューのヘッダを取得および削除します。

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

contains, containsAll, isEmpty, iterator, remove, removeAll, retainAll, size, toArray, toArray, toString

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

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

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

offer, peek, poll

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

contains, containsAll, equals, hashCode, isEmpty, iterator, remove, removeAll, retainAll, size, toArray, toArray

コンストラクタの詳細

AbstractQueue

protected AbstractQueue()

サブクラスにより使用されるコンストラクタです。

メソッドの詳細

add

public boolean add(E o)

指定された要素をこのキューに追加します。この実装は、offer が成功した場合は true を返し、そうでない場合には IllegalStateException をスローします。

定義:

インタフェース Collection<E> 内の add

オーバーライド:

クラス AbstractCollection<E> 内の add

パラメータ:

o - 要素

戻り値:

true (Collection.add の一般規約に従う)

例外:

NullPointerException - 指定された要素が null である場合

IllegalStateException - 要素を追加できない場合

remove

public E remove()

このキューのヘッダを取得および削除します。キューが空でない限り、この実装は poll の結果を返します。

定義:

インタフェース Queue<E> 内の remove

戻り値:

このキューのヘッダ

例外:

NoSuchElementException - キューが空の場合

element

public E element()

このキューのヘッダを取得しますが、削除しません。キューが空でない限り、この実装は peek の結果を返します。

定義:

インタフェース Queue<E> 内の element

戻り値:

このキューのヘッダ

例外:

NoSuchElementException - キューが空の場合

clear

public void clear()

このコレクションからすべての要素を削除します。この呼び出しが戻ると、コレクションは空になります。

この実装は、null が返されるまで、繰り返し poll を呼び出します。

定義:

インタフェース Collection<E> 内の clear

オーバーライド:

クラス AbstractCollection<E> 内の clear

addAll

public boolean addAll(Collection<? extends E> c)

指定されたコレクション内のすべての要素をこのキューに追加します。キューのすべてをそれ自体に追加しようとすると、IllegalArgumentException がスローされます。また、オペレーションの進行中に指定されたコレクションが変更された場合の、このオペレーションの動作は定義されていません。

この実装は、指定されたコレクションに対して処理を繰り返し実行し、反復子により返される各要素をこのコレクションに順番に追加します。要素 (null 要素を含む) の追加中に実行時例外に遭遇する場合、関連付けられた例外のスロー時に要素の一部だけが追加に成功している可能性があります。

定義:

インタフェース Collection<E> 内の addAll

オーバーライド:

クラス AbstractCollection<E> 内の addAll

パラメータ:

c - 要素がこのコレクションに追加されるコレクション

戻り値:

この呼び出しの結果、このコレクションが変更された場合は true

例外:

NullPointerException - 指定されたコレクションまたは、その要素のどれかが null の場合

IllegalArgumentException - c がこのキューである場合

関連項目:

add(Object)