CKTIS / Java
ArrayBlockingQueue — una coda bloccante a capacità fissa
ArrayBlockingQueue è una coda FIFO thread-safe basata su un array a capacità fissa. Trasferisce elementi tra produttori e consumatori e permette di scegliere tra l’attesa e la restituzione immediata del risultato di un’operazione.
Versione: Java SE 21; repository runtime, production runtime not attested
Sintassi
new ArrayBlockingQueue<E>(capacity)java.util.concurrent.ArrayBlockingQueue<E> implementa BlockingQueue<E>. Memorizza gli elementi in un array e li recupera in ordine FIFO: l’elemento inserito per primo è il primo a essere recuperato. Il costruttore ArrayBlockingQueue(int) crea una coda vuota con capacità non modificabile; per capacity < 1 genera IllegalArgumentException.
put(e) attende che si liberi spazio in una coda piena, mentre take() attende un elemento in una coda vuota. offer(e) e poll() non attendono spazio o elementi: restituiscono rispettivamente false se la coda è piena e null se è vuota. add(e) genera IllegalStateException quando la coda è piena. Le varianti temporizzate di offer e poll limitano l’attesa. I metodi che attendono possono generare InterruptedException; non ignorare le interruzioni.
La coda non accetta null: tentare di inserirlo genera NullPointerException. La sicurezza dei singoli metodi rispetto ai thread non rende atomica una sequenza di controllo e azione; invece di verificare che la coda sia piena prima dell’inserimento, usa il risultato di offer(e).
L’ordine FIFO degli elementi non implica un servizio equo dei thread in attesa. Il costruttore con un argomento non ne garantisce l’ordine; ArrayBlockingQueue(int, boolean) con true abilita il servizio FIFO dei thread in attesa. Questa voce descrive Java SE 21; né l’ambiente di esecuzione del repository né quello di produzione è stato attestato.
Esempi
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());
}
}Risultato
false A B null
Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.