- 型パラメータ:
E- このキューに保持されている要素の型
- すべての実装されたインタフェース:
Serializable,Iterable<E>,Collection<E>,BlockingQueue<E>,Queue<E>
これは旧来のバウンド・バッファであり、その内部では固定サイズの配列が要素を保持し、これらの要素はプロデューサにより挿入され、コンシューマにより抽出されます。 作成後に、容量を変更することはできません。 キューが埋まっているときに要素をputしようとすると、putオペレーションがブロックされます。空のキューから要素をputしようとした場合も、同様にブロックされます。
このクラスでは、待機中のプロデューサおよびコンシューマ・スレッドの順序付けのためのオプションの公平性ポリシーをサポートします。 デフォルトでは、この順序付けは保証されていません。 ただし、公平性をtrueに設定して構築されたキューでは、スレッドがFIFOの順序でアクセスすることが許可されます。 通常は、公平性によりスループットが低下しますが、変動性も低下するため、枯渇状態になることはありません。
このクラスとそのイテレータは、CollectionおよびIteratorインタフェースのオプション・メソッドすべてを実装します。
このクラスは、Java Collections Frameworkのメンバーです。
- 導入されたバージョン:
- 1.5
- 関連項目:
-
コンストラクタのサマリー
コンストラクタコンストラクタ説明ArrayBlockingQueue(int capacity) 指定された(固定)容量とデフォルトのアクセス・ポリシーを持つArrayBlockingQueueを作成します。ArrayBlockingQueue(int capacity, boolean fair) 指定された(固定)容量と指定されたアクセス・ポリシーを持つArrayBlockingQueueを作成します。ArrayBlockingQueue(int capacity, boolean fair, Collection<? extends E> c) 指定された(固定)容量と指定されたアクセス・ポリシーを持ち、指定されたコレクションの要素を初期状態で含む(要素はコレクションのイテレータのトラバーサル順に追加)ArrayBlockingQueueを作成します。 -
メソッドのサマリー
修飾子と型メソッド説明booleanキューの容量を超えずにすぐ実行できる場合は、指定された要素をこのキューの末尾に挿入します。成功した場合はtrueを返し、キューがいっぱいの場合はIllegalStateExceptionをスローします。voidclear()すべての要素をこのキューから原子的に削除します。boolean指定された要素がキューに含まれている場合にtrueを返します。intdrainTo(Collection<? super E> c) このキューから利用可能なすべての要素を削除し、それらを指定されたコレクションに追加します。intdrainTo(Collection<? super E> c, int maxElements) 指定された数以内の利用可能な要素をこのキューから削除し、指定されたコレクションに追加します。voidIterableの各要素に対して指定されたアクションを、すべての要素が処理されるか、アクションが例外をスローするまで実行します。iterator()このキュー内の要素を適切な順序で反復処理するイテレータを返します。booleanキューの容量を超えずに指定された要素をこのキューの末尾にすぐ挿入できる場合は、そうします。成功した場合はtrueを返し、キューがいっぱいの場合はfalseを返します。boolean指定された要素をこのキューの末尾に挿入します。このキューがいっぱいである場合は、指定された時間まで空きが生じるのを待機します。peek()キューの先頭を取得しますが、削除しません。キューが空の場合はnullを返します。poll()キューの先頭を取得および削除します。キューが空の場合はnullを返します。このキューの先頭を取得して削除します。必要に応じて、指定された待機時間まで要素が利用可能になるのを待機します。void指定された要素をこのキューの末尾に挿入します。このキューがいっぱいの場合は、空きが生じるまで待機します。int理想的な状態(メモリーやリソースの制限がない状態)で、このキューがブロックせずに受け入れることができる追加要素の数を返します。boolean指定された要素の単一のインスタンスがこのキューに存在する場合は、キューから削除します。booleanremoveAll(Collection<?> c) 指定されたコレクションにも格納されているこのコレクションのすべての要素を削除します(オプションの操作)。boolean指定された述語(オプションの操作)を満たす、このコレクションのすべての要素を削除します。booleanretainAll(Collection<?> c) このコレクションにおいて、指定されたコレクションに格納されている要素だけを保持します(オプションの操作)。intsize()キュー内にある要素の数を返します。このキュー内の要素に対するSpliteratorを返します。take()このキューの先頭を取得して削除します。必要に応じて、要素が利用可能になるまで待機します。Object[]toArray()キュー内のすべての要素を適切な順序で含む配列を返します。<T> T[]toArray(T[] a) キュー内のすべての要素を適切な順序で含む配列を返します。返される配列の実行時の型は、指定された配列の型になります。クラスjava.util.AbstractQueueで宣言されたメソッド
addAll, element, removeクラスjava.util.AbstractCollectionで宣言されたメソッド
containsAll, isEmpty, toStringクラスjava.lang.Objectで宣言されたメソッド
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, waitインタフェースjava.util.Collectionで宣言されたメソッド
addAll, containsAll, equals, hashCode, isEmpty, parallelStream, stream, toArray
-
コンストラクタの詳細
-
ArrayBlockingQueue
public ArrayBlockingQueue(int capacity) 指定された(固定)容量とデフォルトのアクセス・ポリシーを持つArrayBlockingQueueを作成します。- パラメータ:
capacity- このキューの容量- 例外:
IllegalArgumentException-capacity < 1の場合
-
ArrayBlockingQueue
public ArrayBlockingQueue(int capacity, boolean fair) 指定された(固定)容量と指定されたアクセス・ポリシーを持つArrayBlockingQueueを作成します。- パラメータ:
capacity- このキューの容量fair-trueの場合、挿入または削除でブロックされたスレッドに対するキュー・アクセスがFIFOの順序で処理される。falseの場合、アクセス順は指定されない。- 例外:
IllegalArgumentException-capacity < 1の場合
-
ArrayBlockingQueue
public ArrayBlockingQueue(int capacity, boolean fair, Collection<? extends E> c) 指定された(固定)容量と指定されたアクセス・ポリシーを持ち、指定されたコレクションの要素を初期状態で含む(要素はコレクションのイテレータのトラバーサル順に追加)ArrayBlockingQueueを作成します。- パラメータ:
capacity- このキューの容量fair-trueの場合、挿入または削除でブロックされたスレッドに対するキュー・アクセスがFIFOの順序で処理される。falseの場合、アクセス順は指定されない。c- 初期状態で含む要素のコレクション- 例外:
IllegalArgumentException-capacityがc.size()より小さいか、または1より小さい場合。NullPointerException- 指定されたコレクションまたはそのいずれかの要素がnullである場合
-
-
メソッドの詳細
-
add
public boolean add(E e) キューの容量を超えずにすぐ実行できる場合は、指定された要素をこのキューの末尾に挿入します。成功した場合はtrueを返し、キューがいっぱいの場合はIllegalStateExceptionをスローします。- 定義:
add、インタフェースBlockingQueue<E>- 定義:
add、インタフェースCollection<E>- 定義:
add、インタフェースQueue<E>- オーバーライド:
add、クラスAbstractQueue<E>- パラメータ:
e- 追加する要素- 戻り値:
true(Collection.add(E)で指定されているとおり)- 例外:
IllegalStateException- このキューがいっぱいの場合NullPointerException- 指定された要素がnullである場合
-
offer
public boolean offer(E e) キューの容量を超えずに指定された要素をこのキューの末尾にすぐ挿入できる場合は、そうします。成功した場合はtrueを返し、キューがいっぱいの場合はfalseを返します。 通常は、要素の挿入に失敗した場合に例外をスローするのみのadd(E)メソッドよりもこのメソッドを使用することをお薦めします。- 定義:
offer、インタフェースBlockingQueue<E>- 定義:
offer、インタフェースQueue<E>- パラメータ:
e- 追加する要素- 戻り値:
- このキューに要素が追加された場合は
true、それ以外の場合はfalse - 例外:
NullPointerException- 指定された要素がnullである場合
-
put
public void put(E e) throws InterruptedException 指定された要素をこのキューの末尾に挿入します。このキューがいっぱいの場合は、空きが生じるまで待機します。- 定義:
put、インタフェースBlockingQueue<E>- パラメータ:
e- 追加する要素- 例外:
InterruptedException- 待機中に割込みが発生した場合NullPointerException- 指定された要素がnullである場合
-
offer
public boolean offer(E e, long timeout, TimeUnit unit) throws InterruptedException 指定された要素をこのキューの末尾に挿入します。このキューがいっぱいである場合は、指定された時間まで空きが生じるのを待機します。- 定義:
offer、インタフェースBlockingQueue<E>- パラメータ:
e- 追加する要素timeout- 処理を中止するまでの待機時間。単位はunitunit-timeoutパラメータの解釈方法を決定するTimeUnit- 戻り値:
- 成功した場合は
true、空きが生じる前に指定された待機時間が経過した場合はfalse - 例外:
InterruptedException- 待機中に割込みが発生した場合NullPointerException- 指定された要素がnullである場合
-
poll
-
take
public E take() throws InterruptedExceptionインタフェースからコピーされた説明:BlockingQueueこのキューの先頭を取得して削除します。必要に応じて、要素が利用可能になるまで待機します。- 定義:
take、インタフェースBlockingQueue<E>- 戻り値:
- キューの先頭
- 例外:
InterruptedException- 待機中に割込みが発生した場合
-
poll
public E poll(long timeout, TimeUnit unit) throws InterruptedException インタフェースからコピーされた説明:BlockingQueueこのキューの先頭を取得して削除します。必要に応じて、指定された待機時間まで要素が利用可能になるのを待機します。- 定義:
poll、インタフェースBlockingQueue<E>- パラメータ:
timeout- 処理を中止するまでの待機時間。単位はunitunit-timeoutパラメータの解釈方法を決定するTimeUnit- 戻り値:
- このキューの先頭。空きが生じる前に指定された待機時間が経過した場合は
null - 例外:
InterruptedException- 待機中に割込みが発生した場合
-
peek
-
size
-
remainingCapacity
public int remainingCapacity()理想的な状態(メモリーやリソースの制限がない状態)で、このキューがブロックせずに受け入れることができる追加要素の数を返します。 このキューの初期容量から現在のsizeを引いた値と常に同じです。remainingCapacityを調べても要素の挿入試行が成功するかどうかがわかるとはかぎりません。これは別のスレッドが要素を挿入または削除しようとしている可能性があるためです。- 定義:
remainingCapacity、インタフェースBlockingQueue<E>- 戻り値:
- 残りの容量
-
remove
public boolean remove(Object o) 指定された要素の単一のインスタンスがこのキューに存在する場合は、キューから削除します。 つまり、キュー内に、o.equals(e)に該当する要素eが1つ以上含まれている場合は、そのような要素を削除します。 指定された要素がこのキューに含まれていた場合、つまり、呼出しの結果としてこのキューが変更された場合にtrueを返します。巡回配列ベースのキューにある内部要素の削除は本質的に遅く、しかも破壊的な操作であるため、例外的な状況でのみ、理想的には、ほかのスレッドからそのキューにアクセスできないことがわかっている場合にのみ実行するようにしてください。
- 定義:
remove、インタフェースBlockingQueue<E>- 定義:
remove、インタフェースCollection<E>- オーバーライド:
remove、クラスAbstractCollection<E>- パラメータ:
o- キューから削除される要素(その要素が存在する場合)- 戻り値:
- この呼出しの結果、このキューが変更された場合は
true
-
contains
public boolean contains(Object o) 指定された要素がキューに含まれている場合にtrueを返します。 つまり、このキュー内にo.equals(e)のような1つ以上の要素eが含まれている場合、trueを返します。- 定義:
contains、インタフェースBlockingQueue<E>- 定義:
contains、インタフェースCollection<E>- オーバーライド:
contains、クラスAbstractCollection<E>- パラメータ:
o- このキューに含まれているかどうかを調べるオブジェクト- 戻り値:
- 指定された要素がこのキューに含まれている場合は
true
-
toArray
public Object[] toArray()キュー内のすべての要素を適切な順序で含む配列を返します。返される配列は、それへの参照がこのキューで保持されない場合に、安全になります。 (つまり、このメソッドは新しい配列を割り当てます)。 このため、呼出し側は、返された配列を自由に変更できます。
このメソッドは、配列ベースのAPIとコレクションベースのAPIの間の橋渡し役として機能します。
- 定義:
toArray、インタフェースCollection<E>- オーバーライド:
toArray、クラスAbstractCollection<E>- 戻り値:
- このキューのすべての要素が含まれている配列
-
toArray
public <T> T[] toArray(T[] a) キュー内のすべての要素を適切な順序で含む配列を返します。返される配列の実行時の型は、指定された配列の型になります。 キューが指定された配列に収まる場合は、その中に返されます。 そうでない場合は、指定された配列の実行時の型とキューのサイズを持つ新しい配列が割り当てられます。キューが指定された配列に収まり、その配列にさらに余裕がある場合(つまり、配列がキューより多くの要素を持つ場合)、その配列内でキューの終端よりあとの要素は
nullに設定されます。toArray()メソッドと同じように、このメソッドは、配列ベースのAPIとコレクションベースのAPIの間の橋渡し役として機能します。 さらに、このメソッドでは出力配列の実行時の型を正確に制御できるため、環境によっては割当ての手間を抑えるために使用できます。xが、文字列だけからなるキューであることがわかっていると仮定します。 次のコードを使うと、新しく割り当てられたStringの配列にキューをダンプできます。String[] y = x.toArray(new String[0]);toArray(new Object[0])は、機能の点でtoArray()と同一です。- 定義:
toArray、インタフェースCollection<E>- オーバーライド:
toArray、クラスAbstractCollection<E>- 型パラメータ:
T- コレクションを格納する配列のコンポーネント型- パラメータ:
a- 配列が十分な大きさを持つ場合は、キューの要素が格納される配列。そうでない場合は、要素を格納するために同じ実行時の型の新しい配列が割り当てられる- 戻り値:
- このキューのすべての要素が含まれている配列
- 例外:
ArrayStoreException- 指定された配列の実行時の型が、このキュー内の各要素の実行時の型のスーパー・タイプでない場合NullPointerException- 指定された配列がnullである場合
-
clear
public void clear()すべての要素をこのキューから原子的に削除します。 この呼出しが戻ると、キューは空になります。- 定義:
clear、インタフェースCollection<E>- オーバーライド:
clear、クラスAbstractQueue<E>
-
drainTo
public int drainTo(Collection<? super E> c) インタフェースからコピーされた説明:BlockingQueueこのキューから利用可能なすべての要素を削除し、それらを指定されたコレクションに追加します。 このオペレーションは、このキューを繰返しポーリングする場合よりも効率的な場合があります。 コレクションcに要素を追加しようとしたときに障害が発生すると、関連する例外のスロー時に、要素がこのキューとコレクションのいずれにも存在しない場合と、一方または両方に存在する場合があります。 キューをそれ自体に排出しようとすると、IllegalArgumentExceptionがスローされます。 また、オペレーションの進行中に指定されたコレクションが変更された場合の、このオペレーションの動作は定義されていません。- 定義:
drainTo、インタフェースBlockingQueue<E>- パラメータ:
c- 要素の転送先のコレクション- 戻り値:
- 転送された要素の数
- 例外:
UnsupportedOperationException- 指定されたコレクションで追加の要素がサポートされていない場合ClassCastException- このキューの要素のクラスが原因で、その要素を指定されたコレクションに追加できない場合NullPointerException- 指定されたコレクションがnullである場合IllegalArgumentException- 指定されたコレクションがこのキューである場合、またはこのキューの要素のあるプロパティが原因で指定されたコレクションに追加できない場合
-
drainTo
public int drainTo(Collection<? super E> c, int maxElements) インタフェースからコピーされた説明:BlockingQueue指定された数以内の利用可能な要素をこのキューから削除し、指定されたコレクションに追加します。 コレクションcに要素を追加しようとしたときに障害が発生すると、関連する例外のスロー時に、要素がこのキューとコレクションのいずれにも存在しない場合と、一方または両方に存在する場合があります。 キューをそれ自体に排出しようとすると、IllegalArgumentExceptionがスローされます。 また、オペレーションの進行中に指定されたコレクションが変更された場合の、このオペレーションの動作は定義されていません。- 定義:
drainTo、インタフェースBlockingQueue<E>- パラメータ:
c- 要素の転送先のコレクションmaxElements- 転送する要素の最大数- 戻り値:
- 転送された要素の数
- 例外:
UnsupportedOperationException- 指定されたコレクションで追加の要素がサポートされていない場合ClassCastException- このキューの要素のクラスが原因で、その要素を指定されたコレクションに追加できない場合NullPointerException- 指定されたコレクションがnullである場合IllegalArgumentException- 指定されたコレクションがこのキューである場合、またはこのキューの要素のあるプロパティが原因で指定されたコレクションに追加できない場合
-
iterator
-
spliterator
public Spliterator<E> spliterator()このキュー内の要素に対するSpliteratorを返します。返されるスプリッテレータは弱一貫性を保持します。
Spliteratorは、Spliterator.CONCURRENT、Spliterator.ORDEREDおよびSpliterator.NONNULLを報告します。- 定義:
spliterator、インタフェースCollection<E>- 定義:
spliterator、インタフェースIterable<E>- 実装上のノート:
Spliteratorは、制限付きの並列処理を許可するためにtrySplitを実装します。- 戻り値:
- このキュー内の要素に対する
Spliterator - 導入されたバージョン:
- 1.8
-
forEach
インタフェースからコピーされた説明:IterableIterableの各要素に対して指定されたアクションを、すべての要素が処理されるか、アクションが例外をスローするまで実行します。 反復の順序でアクションが実行されます(その順序が指定されている場合)。 アクションによってスローされた例外は、呼出し側に中継されます。このメソッドの動作は、オーバーライドするクラスが同時変更ポリシーを指定していないかぎり、要素の基礎となるソースを変更する副作用をアクションが実行する場合には指定されません。
- 定義:
forEach、インタフェースIterable<E>- パラメータ:
action- 各要素に対して実行されるアクション- 例外:
NullPointerException- 指定されたアクションがnullである場合
-
removeIf
次のインタフェースからコピーされた説明:Collection指定された述語(オプションの操作)を満たす、このコレクションのすべての要素を削除します。 反復中に、または述語によってスローされたエラーまたは実行時例外は、呼出し側に中継されます。- 定義:
removeIf、インタフェースCollection<E>- パラメータ:
filter- 削除される要素に対してtrueを返す述語- 戻り値:
- 要素が削除された場合は
true - 例外:
NullPointerException- 指定されたフィルタがnullである場合
-
removeAll
public boolean removeAll(Collection<?> c) 次のクラスからコピーされた説明:AbstractCollection指定されたコレクションにも格納されているこのコレクションのすべての要素を削除します(オプションの操作)。 この呼出しの結果、このコレクションには指定されたコレクションと共通の要素はなくなります。- 定義:
removeAll、インタフェースCollection<E>- オーバーライド:
removeAll、クラスAbstractCollection<E>- パラメータ:
c- このコレクションから削除される要素を含むコレクション- 戻り値:
- コールの結果としてこのコレクションが変更された場合、
true - 例外:
NullPointerException- このコレクションに1つ以上のnull要素が含まれ、指定したコレクションがnull要素(optional)をサポートしていない場合、または指定されたコレクションがnullの場合- 関連項目:
-
retainAll
public boolean retainAll(Collection<?> c) 次のクラスからコピーされた説明:AbstractCollectionこのコレクションにおいて、指定されたコレクションに格納されている要素だけを保持します(オプションの操作)。 つまり、指定されたコレクションに格納されていないすべての要素をこのコレクションから削除します。- 定義:
retainAll、インタフェースCollection<E>- オーバーライド:
retainAll、クラスAbstractCollection<E>- パラメータ:
c- このコレクションで保持される要素を含むコレクション- 戻り値:
- コールの結果としてこのコレクションが変更された場合、
true - 例外:
NullPointerException- このコレクションに1つ以上のnull要素が含まれ、指定したコレクションでnull要素(optional)が許可されていない場合、または指定されたコレクションがnullの場合- 関連項目:
-