CKTIS / Java
ArrayBlockingQueue — una cola bloqueante de capacidad fija
ArrayBlockingQueue es una cola FIFO segura para subprocesos, respaldada por un array de capacidad fija. Transfiere elementos entre productores y consumidores y permite elegir entre esperar y obtener el resultado inmediato de una operación.
Versión: Java SE 21; repository runtime, production runtime not attested
Sintaxis
new ArrayBlockingQueue<E>(capacity)java.util.concurrent.ArrayBlockingQueue<E> implementa BlockingQueue<E>. Almacena elementos en un array y los recupera en orden FIFO: el elemento que se insertó primero se recupera primero. El constructor ArrayBlockingQueue(int) crea una cola vacía de capacidad invariable; si capacity < 1, lanza IllegalArgumentException.
put(e) espera a que haya espacio en una cola llena, mientras que take() espera a que haya un elemento en una cola vacía. offer(e) y poll() no esperan a que haya espacio ni elementos: devuelven false si la cola está llena y null si está vacía, respectivamente. add(e) lanza IllegalStateException cuando la cola está llena. Las variantes temporizadas de offer y poll limitan la espera. Los métodos de espera pueden lanzar InterruptedException; no ignore las interrupciones.
La cola no admite null: intentar insertarlo lanza NullPointerException. La seguridad de cada operación frente a varios subprocesos no convierte en atómica una secuencia de comprobación y acción; use el resultado de offer(e) en vez de comprobar si la cola está llena antes de insertar.
El orden FIFO de los elementos no implica que se atienda de forma justa a los subprocesos que esperan. El constructor de un argumento no garantiza su orden; ArrayBlockingQueue(int, boolean) con true activa la atención FIFO de los subprocesos en espera. Esta entrada describe Java SE 21; no se ha confirmado ni el entorno de ejecución del repositorio ni el de producción.
Ejemplos
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
El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.