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

CKTIS / Java

TimeUnit.MILLISECONDS — délais d’attente en millisecondes

Avec TimeUnit.MILLISECONDS, le délai des surcharges temporisées de poll et offer d’une file bloquante s’exprime en millisecondes.

Version : Java SE 21

Syntaxe

import java.util.concurrent.TimeUnit;

TimeUnit unit = TimeUnit.MILLISECONDS;

// Both timed calls can throw InterruptedException. Catch it or declare it
// in the enclosing method's throws clause.
// Given a BlockingQueue<E> named queue and a non-null E named element:
boolean inserted = queue.offer(element, 250L, TimeUnit.MILLISECONDS);
E head = queue.poll(250L, TimeUnit.MILLISECONDS);

TimeUnit.MILLISECONDS est une constante de l’énumération java.util.concurrent.TimeUnit. Elle représente une unité égale à un millième de seconde, et non une durée précise ni un horodatage. Les arguments 250L, TimeUnit.MILLISECONDS fixent une limite d’attente de 250 millisecondes. L’opération peut réussir plus tôt ; l’unité ne garantit pas l’instant exact du retour de l’appel.

Sur une BlockingQueue<E>, offer(E, long, TimeUnit) attend si nécessaire qu’une place se libère. La méthode renvoie true si elle insère l’élément, ou false si le délai expire avant qu’une place soit disponible. poll(long, TimeUnit) attend si nécessaire qu’un élément soit disponible. La méthode retire et renvoie l’élément en tête, ou renvoie null si le délai expire avant qu’un élément soit disponible. Une BlockingQueue n’accepte pas les éléments null.

Contrairement aux surcharges temporisées, offer(E) et poll() n’attendent ni qu’une place se libère ni qu’un élément arrive. Les deux surcharges temporisées lèvent InterruptedException si le thread est interrompu pendant l’attente. Une interruption n’est pas une expiration du délai.

Pour obtenir une valeur numérique en millisecondes, TimeUnit.MILLISECONDS.convert(2L, TimeUnit.SECONDS) renvoie 2000L. La constante sur laquelle on appelle la méthode indique l’unité cible. La conversion vers une unité plus grossière tronque vers zéro ; en cas de dépassement, le résultat est borné à la limite correspondante du type long.

Exemples

import java.util.concurrent.ArrayBlockingQueue;
import java.util.concurrent.BlockingQueue;
import java.util.concurrent.TimeUnit;

public class MillisecondTimeouts {
    public static void main(String[] args) throws InterruptedException {
        BlockingQueue<String> queue = new ArrayBlockingQueue<>(1);

        System.out.println(queue.offer("job", 10L, TimeUnit.MILLISECONDS));
        System.out.println(queue.offer("extra", 10L, TimeUnit.MILLISECONDS));
        System.out.println(queue.poll(10L, TimeUnit.MILLISECONDS));
        System.out.println(queue.poll(10L, TimeUnit.MILLISECONDS));
    }
}

Résultat

true
false
job
null

Un seul thread utilise une file d’une place. La première insertion réussit, la deuxième expire, le premier retrait renvoie `job` et le second renvoie `null` à l’expiration du délai. L’exemple vérifie les résultats, pas le temps écoulé.

Leçons associées

  • Java · Leçon 37 · Avancé · Version : 2

Sources