Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / Java

TimeUnit.MILLISECONDS: tempo de espera por um bloqueio em milissegundos

Usa `TimeUnit.MILLISECONDS` para indicar em milissegundos o tempo de espera de `tryLock`. Cada chamada tem o seu próprio limite e pode adquirir o bloqueio imediatamente.

Versão: Java SE 21

Sintaxe

import java.util.concurrent.TimeUnit;

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

TimeUnit.MILLISECONDS é uma constante da enumeração TimeUnit do pacote java.util.concurrent. Um milissegundo é um milésimo de segundo. A constante indica a unidade, não a duração: em lock.tryLock(100L, TimeUnit.MILLISECONDS), 100L é o valor do tipo long e o segundo argumento indica que se trata de 100 ms.

Em ReentrantLock, a versão sobrecarregada tryLock(long, TimeUnit) pode devolver true imediatamente se adquirir o bloqueio, ou false se o tempo limite terminar antes da aquisição. Se a thread já estiver interrompida à entrada no método ou for interrompida durante a tentativa, o método lança InterruptedException; captura ou declara a exceção. A versão tryLock() sem argumentos não espera. Usar milissegundos não garante que o método termine ao fim de exatamente 100 ms.

Passar 100L, TimeUnit.MILLISECONDS às duas chamadas dá a cada tentativa um limite de 100 ms, e não um limite partilhado. Chama unlock() num bloco finally apenas para um bloqueio que tenhas adquirido. No exemplo, se a segunda tentativa devolver false ou lançar uma exceção, o bloco finally exterior liberta na mesma o primeiro bloqueio.

Exemplos

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

Resultado

Both locks acquired

Nenhuma outra thread disputa os bloqueios, pelo que o programa adquire ambos sem esperar. O resultado mostra que foram adquiridos, não que tenham decorrido 100 ms.

Lições relacionadas

  • Java · Lição 58 · Intermédio · Versão: 2

Fontes