Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

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.

Fontes