CKTIS / Java
ArrayBlockingQueue — uma fila bloqueante de capacidade fixa
ArrayBlockingQueue é uma fila FIFO segura para utilização por várias threads, suportada por um array de capacidade fixa. Transfere elementos entre produtores e consumidores e permite escolher entre esperar e obter imediatamente o resultado de uma operação.
Versão: Java SE 21; repository runtime, production runtime not attested
Sintaxe
new ArrayBlockingQueue<E>(capacity)java.util.concurrent.ArrayBlockingQueue<E> implementa BlockingQueue<E>. Guarda elementos num array e recupera-os por ordem FIFO: o elemento inserido primeiro é recuperado primeiro. O construtor ArrayBlockingQueue(int) cria uma fila vazia com capacidade inalterável; se capacity < 1, lança IllegalArgumentException.
put(e) espera que haja espaço numa fila cheia, enquanto take() espera por um elemento numa fila vazia. offer(e) e poll() não esperam por espaço nem por elementos: devolvem, respetivamente, false quando a fila está cheia e null quando está vazia. add(e) lança IllegalStateException quando a fila está cheia. As variantes temporizadas de offer e poll limitam o tempo de espera. Os métodos que esperam podem lançar InterruptedException; não ignore as interrupções.
A fila não aceita null: tentar inseri-lo lança NullPointerException. A segurança das operações individuais para várias threads não torna atómica uma sequência de verificação e ação; use o resultado de offer(e) em vez de verificar se a fila está cheia antes de inserir.
A ordem FIFO dos elementos não implica um atendimento justo das threads em espera. O construtor de um argumento não garante a ordem destas; ArrayBlockingQueue(int, boolean) com true ativa o atendimento FIFO das threads em espera. Esta entrada descreve Java SE 21; nem o ambiente de execução do repositório nem o de produção foi atestado.
Exemplos
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());
}
}Resultado
false A B null
O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.