Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / Java

ArrayBlockingQueue — blokující fronta s pevnou kapacitou

ArrayBlockingQueue je vláknově bezpečná FIFO fronta založená na poli s pevnou kapacitou. Předává prvky mezi producenty a konzumenty a umožňuje zvolit mezi čekáním a okamžitým výsledkem operace.

Verze: Java SE 21; repository runtime, production runtime not attested

Syntaxe

new ArrayBlockingQueue<E>(capacity)

java.util.concurrent.ArrayBlockingQueue<E> implementuje BlockingQueue<E>. Ukládá prvky do pole a odebírá je v pořadí FIFO: nejdříve vložený prvek se odebere jako první. Konstruktor ArrayBlockingQueue(int) vytvoří prázdnou frontu s neměnnou kapacitou; při capacity < 1 vyvolá IllegalArgumentException.

put(e) čeká na místo v plné frontě, zatímco take() čeká na prvek v prázdné frontě. offer(e) a poll() na místo ani prvek nečekají: při plné frontě vracejí false, respektive při prázdné null. Pokud je fronta plná, add(e) vyvolá IllegalStateException. Časově omezené varianty offer a poll omezují čekání. Čekající metody mohou vyvolat InterruptedException; přerušení neignorujte.

Fronta nepřijímá null: pokus o jeho vložení vyvolá NullPointerException. Vláknová bezpečnost jednotlivých operací nezajišťuje atomické provedení posloupnosti kontroly a následné akce; místo kontroly plné fronty před vložením použijte výsledek offer(e).

FIFO pořadí prvků neznamená spravedlivé obsloužení čekajících vláken. Konstruktor s jedním argumentem jejich pořadí nezaručuje; ArrayBlockingQueue(int, boolean) s hodnotou true zapne FIFO obsluhu čekajících vláken. Tento záznam popisuje Java SE 21; běhové prostředí repozitáře ani produkční prostředí nebylo potvrzeno.

Příklady

import java.util.concurrent.ArrayBlockingQueue;

public class Main {
    public static void main(String[] args) throws InterruptedException {
        ArrayBlockingQueue<String> queue = new ArrayBlockingQueue<>(2);
        queue.put("A");
        queue.put("B");
        System.out.println(queue.offer("C"));
        System.out.println(queue.take());
        System.out.println(queue.take());
        System.out.println(queue.poll());
    }
}

Výsledek

false
A
B
null

Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.

Zdroje