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

CKTIS / Java

TimeUnit.MILLISECONDS : délai d’acquisition d’un verrou en millisecondes

Utilisez `TimeUnit.MILLISECONDS` pour exprimer en millisecondes le délai de `tryLock`. Chaque appel a son propre délai et peut acquérir le verrou immédiatement.

Version : Java SE 21

Syntaxe

import java.util.concurrent.TimeUnit;

// In a method that catches or declares InterruptedException:
boolean acquired = lock.tryLock(100L, TimeUnit.MILLISECONDS);

TimeUnit.MILLISECONDS est une constante de l’énumération TimeUnit du paquet java.util.concurrent. Une milliseconde vaut un millième de seconde. La constante indique une unité, pas une durée : dans lock.tryLock(100L, TimeUnit.MILLISECONDS), 100L est la valeur de type long et le deuxième argument indique qu’il s’agit de 100 ms.

Pour ReentrantLock, la version surchargée tryLock(long, TimeUnit) peut renvoyer true immédiatement si elle acquiert le verrou, ou false si le délai expire avant l’acquisition. Si le thread est déjà interrompu à l’entrée de la méthode ou s’il est interrompu pendant la tentative, la méthode lève InterruptedException ; interceptez ou déclarez cette exception. tryLock() sans argument n’attend pas. Choisir les millisecondes ne garantit pas que la méthode se termine au bout d’exactement 100 ms.

Passer 100L, TimeUnit.MILLISECONDS aux deux appels donne à chaque tentative son propre délai de 100 ms, et non un délai commun. Appelez unlock() dans un bloc finally uniquement pour un verrou effectivement acquis. Dans l’exemple, si la seconde tentative renvoie false ou lève une exception, le bloc finally externe libère quand même le premier verrou.

Exemples

import java.util.concurrent.TimeUnit;
import java.util.concurrent.locks.ReentrantLock;

public class MillisecondTryLock {
    public static void main(String[] args) throws InterruptedException {
        var first = new ReentrantLock();
        var second = new ReentrantLock();

        if (!first.tryLock(100L, TimeUnit.MILLISECONDS)) {
            System.out.println("First lock unavailable");
            return;
        }
        try {
            if (!second.tryLock(100L, TimeUnit.MILLISECONDS)) {
                System.out.println("Second lock unavailable");
                return;
            }
            try {
                System.out.println("Both locks acquired");
            } finally {
                second.unlock();
            }
        } finally {
            first.unlock();
        }
    }
}

Résultat

Both locks acquired

Aucun autre thread ne se dispute les verrous : le programme acquiert donc les deux sans attendre. La sortie confirme l’acquisition, pas l’écoulement de 100 ms.

Leçons associées

  • Java · Leçon 58 · Intermédiaire · Version : 2

Sources