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

CKTIS / Java

CountDownLatch — espera única por sinais

CountDownLatch coordena threads: await() espera até que as chamadas a countDown() reduzam o contador a zero. Permite esperar por um grupo de operações e garante a visibilidade de escritas anteriores.

Versão: Java SE 21; repository runtime, production runtime not attested

Sintaxe

new CountDownLatch(count)
void await() throws InterruptedException
boolean await(long timeout, TimeUnit unit) throws InterruptedException
void countDown()

CountDownLatch, de java.util.concurrent, permite que as threads esperem por um número fixo de sinais. O contador representa chamadas a countDown(), não necessariamente threads distintas. O latch só pode ser usado uma vez: não pode ser reiniciado.

CountDownLatch.countDown decrementa um contador positivo sem esperar; se estiver a zero, não faz nada. CountDownLatch.await espera que o contador chegue a zero. A variante await(timeout, unit) devolve false se o tempo limite expirar ou true quando o contador chegar a zero. Uma interrupção lança InterruptedException e limpa o estado de interrupção; propague a exceção ou trate-a de forma deliberada.

As escritas anteriores aos sinais que reduzem o contador a zero estão numa relação happens-before com as ações posteriores a uma espera bem-sucedida noutra thread. Por isso, o exemplo só lê os resultados depois de done.await().

Sinalizar em finally impede que uma exceção faça com que o sinal seja ignorado, mas não significa que a tarefa tenha sido bem-sucedida. A falta de sinais necessários pode bloquear indefinidamente uma espera sem limite de tempo; um tempo limite não cancela os workers.

Exemplos

import java.util.concurrent.CountDownLatch;

public class LatchDemo {
    public static void main(String[] args) throws InterruptedException {
        CountDownLatch done = new CountDownLatch(2);
        int[] results = new int[2];

        for (int i = 0; i < results.length; i++) {
            final int index = i;
            new Thread(() -> {
                try {
                    results[index] = (index + 1) * 10;
                } finally {
                    done.countDown();
                }
            }).start();
        }

        done.await();
        System.out.println(results[0] + results[1]);
    }
}

Resultado

30

O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.

Fontes