Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

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.

Izvori