Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

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

Sources