CKTIS / Java
ArrayBlockingQueue — blokirajući red fiksnog kapaciteta
ArrayBlockingQueue je dretveno siguran FIFO red temeljen na polju fiksnog kapaciteta. Prenosi elemente između proizvođača i potrošača te omogućuje odabir između čekanja i trenutačnog rezultata operacije.
Verzija: Java SE 21; repository runtime, production runtime not attested
Sintaksa
new ArrayBlockingQueue<E>(capacity)java.util.concurrent.ArrayBlockingQueue<E> implementira BlockingQueue<E>. Pohranjuje elemente u polje i dohvaća ih FIFO redoslijedom: prvi umetnuti element dohvaća se prvi. Konstruktor ArrayBlockingQueue(int) stvara prazan red nepromjenjivog kapaciteta; za capacity < 1 izbacuje IllegalArgumentException.
put(e) čeka na slobodno mjesto u punom redu, dok take() čeka na element u praznom redu. offer(e) i poll() ne čekaju na mjesto ni na element: vraćaju false kada je red pun, odnosno null kada je prazan. add(e) izbacuje IllegalStateException kada je red pun. Vremenski ograničene inačice offer i poll ograničavaju čekanje. Metode koje čekaju mogu izbaciti InterruptedException; nemojte zanemariti prekid.
Red ne prihvaća null: pokušaj umetanja te vrijednosti izbacuje NullPointerException. Sigurnost pojedinačnih operacija za više dretvi ne čini niz provjere i djelovanja atomskim; umjesto provjere je li red pun prije umetanja, upotrijebite rezultat offer(e).
FIFO redoslijed elemenata ne podrazumijeva pravednu uslugu dretvi koje čekaju. Konstruktor s jednim argumentom ne jamči njihov redoslijed; ArrayBlockingQueue(int, boolean) s vrijednošću true uključuje FIFO uslugu dretvi na čekanju. Ovaj zapis opisuje Java SE 21; ni izvršno okruženje repozitorija ni produkcijsko okruženje nisu potvrđeni.
Primjeri
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());
}
}Rezultat
false A B null
Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.