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