CKTIS / Java
Constructeurs de LinkedBlockingQueue : capacité par défaut et capacité explicite
Comparez le constructeur sans argument à celui qui prend une capacité. Voyez ce que signifie `Integer.MAX_VALUE` et ce que fait `offer(E)` quand une file de capacité 2 est pleine.
Version : Java SE 21
Syntaxe
import java.util.concurrent.LinkedBlockingQueue;
// Constructor declarations in LinkedBlockingQueue<E>:
public LinkedBlockingQueue()
public LinkedBlockingQueue(int capacity)
// Example calls:
new LinkedBlockingQueue<String>()
new LinkedBlockingQueue<String>(2)Dans Java SE 21, les deux constructeurs de java.util.concurrent.LinkedBlockingQueue<E> présentés ici créent une file vide. LinkedBlockingQueue() fixe sa capacité à Integer.MAX_VALUE (2 147 483 647 éléments). LinkedBlockingQueue(int) lui donne la capacité fixe indiquée par l’argument capacity. Cet argument doit être strictement positif ; zéro ou une valeur négative déclenche une IllegalArgumentException.
La capacité limite le nombre d’éléments ; elle ne réserve pas de mémoire. Les nœuds chaînés sont alloués à mesure que les éléments sont insérés, si bien que la mémoire du tas peut s’épuiser bien avant d’atteindre la limite par défaut. Une limite explicite comme 2 borne le nombre d’éléments en attente dans la file, pas la mémoire qu’ils occupent en octets.
Lorsque la file est pleine, offer(E) renvoie false sans attendre qu’une place se libère, tandis que put(E) attend une place et peut lancer une InterruptedException si l’attente est interrompue. remainingCapacity() renvoie la capacité moins le nombre actuel d’éléments, mais ne réserve aucune place : un autre thread peut modifier la file avant la prochaine tentative d’insertion.
Exemples
import java.util.concurrent.LinkedBlockingQueue;
public class Main {
public static void main(String[] args) {
LinkedBlockingQueue<String> defaultQueue = new LinkedBlockingQueue<>();
LinkedBlockingQueue<String> boundedQueue = new LinkedBlockingQueue<>(2);
System.out.println(defaultQueue.remainingCapacity());
System.out.println(boundedQueue.remainingCapacity());
System.out.println(boundedQueue.offer("A"));
System.out.println(boundedQueue.offer("B"));
System.out.println(boundedQueue.offer("C"));
System.out.println(boundedQueue.remainingCapacity());
}
}Résultat
2147483647 2 true true false 0
Les deux premières lignes montrent les places disponibles dans les files vides. `A` et `B` entrent dans la file de capacité `2`, mais `offer("C")` renvoie `false`. Le `0` final indique qu’il ne reste aucune place.
Leçons associées
- Java · Leçon 37 · Avancé · Version : 2