Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

CKTIS / Java

ArrayBlockingQueue — blokujúci front s pevnou kapacitou

ArrayBlockingQueue je vláknovo bezpečný FIFO front založený na poli s pevnou kapacitou. Prenáša prvky medzi producentmi a konzumentmi a umožňuje vybrať si medzi čakaním a okamžitým výsledkom operácie.

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

Syntax

new ArrayBlockingQueue<E>(capacity)

java.util.concurrent.ArrayBlockingQueue<E> implementuje BlockingQueue<E>. Ukladá prvky do poľa a odoberá ich v poradí FIFO: prvok vložený najskôr sa odoberie ako prvý. Konštruktor ArrayBlockingQueue(int) vytvorí prázdny front s nemennou kapacitou; pri capacity < 1 vyvolá IllegalArgumentException.

put(e) čaká na voľné miesto v plnom fronte, zatiaľ čo take() čaká na prvok v prázdnom fronte. offer(e) a poll() nečakajú na miesto ani na prvok: pri plnom fronte vracajú false, respektíve pri prázdnom null. Ak je front plný, add(e) vyvolá IllegalStateException. Časovo obmedzené varianty offer a poll obmedzujú čakanie. Čakajúce metódy môžu vyvolať InterruptedException; prerušenie neignorujte.

Front neprijíma null: pokus o jeho vloženie vyvolá NullPointerException. Vláknová bezpečnosť jednotlivých operácií neznamená, že postupnosť kontroly a následnej akcie je atomická; namiesto kontroly plného frontu pred vložením použite výsledok offer(e).

FIFO poradie prvkov neznamená spravodlivé obsluhovanie čakajúcich vlákien. Konštruktor s jedným argumentom ich poradie nezaručuje; ArrayBlockingQueue(int, boolean) s hodnotou true zapne FIFO obsluhu čakajúcich vlákien. Tento záznam opisuje Java SE 21; behové prostredie repozitára ani produkčné prostredie nebolo potvrdené.

Prí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ýsledok

false
A
B
null

Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.

Zdroje