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.