Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / Java

TimeUnit.MILLISECONDS: timeout dei lock in millisecondi

Usa `TimeUnit.MILLISECONDS` per esprimere in millisecondi il timeout di `tryLock`. Ogni chiamata ha il proprio timeout e può acquisire subito il lock.

Versione: Java SE 21

Sintassi

import java.util.concurrent.TimeUnit;

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

TimeUnit.MILLISECONDS è una costante dell’enumerazione TimeUnit del package java.util.concurrent. Un millisecondo è un millesimo di secondo. La costante indica l’unità di misura, non la durata: in lock.tryLock(100L, TimeUnit.MILLISECONDS), 100L è il valore di tipo long e il secondo argomento indica che si tratta di 100 ms.

Per ReentrantLock, l’overload tryLock(long, TimeUnit) può restituire subito true se acquisisce il lock, oppure false se il timeout scade prima dell’acquisizione. Se il thread è già interrotto all’ingresso nel metodo o viene interrotto durante il tentativo, il metodo lancia InterruptedException: intercetta o dichiara l’eccezione. La versione tryLock() senza argomenti non attende. Usare i millisecondi non garantisce che il metodo termini dopo esattamente 100 ms.

Passando 100L, TimeUnit.MILLISECONDS a entrambe le chiamate, ogni tentativo ha un timeout di 100 ms, non un limite condiviso. Chiama unlock() in un blocco finally solo per un lock che hai acquisito. Nell’esempio, se il secondo tentativo restituisce false o lancia un’eccezione, il blocco finally esterno rilascia comunque il primo lock.

Esempi

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();
        }
    }
}

Risultato

Both locks acquired

Nessun altro thread contende i lock, quindi il programma li acquisisce entrambi senza attendere. L’output mostra che l’acquisizione è riuscita, non che siano trascorsi 100 ms.

Lezioni correlate

  • Java · Lezione 58 · Intermedio · Versione: 2

Fonti