CKTIS / Java
CountDownLatch — attesa una tantum dei segnali
CountDownLatch coordina i thread: await() attende finché le chiamate a countDown() non portano il contatore a zero. Consente di attendere un gruppo di operazioni e garantisce la visibilità delle scritture precedenti.
Versione: Java SE 21; repository runtime, production runtime not attested
Sintassi
new CountDownLatch(count)
void await() throws InterruptedException
boolean await(long timeout, TimeUnit unit) throws InterruptedException
void countDown()CountDownLatch, in java.util.concurrent, consente ai thread di attendere un numero prestabilito di segnali. Il contatore rappresenta le chiamate a countDown(), non necessariamente thread distinti. Il latch è utilizzabile una sola volta: non può essere reimpostato.
CountDownLatch.countDown decrementa un contatore positivo senza attendere; se è già zero, non fa nulla. CountDownLatch.await attende che il contatore arrivi a zero. La variante await(timeout, unit) restituisce false allo scadere del tempo o true quando il contatore arriva a zero. Un’interruzione genera InterruptedException e azzera lo stato di interruzione; propaga l’eccezione oppure gestiscila consapevolmente.
Le scritture precedenti ai segnali che portano il contatore a zero sono in relazione happens-before con le azioni successive a un’attesa riuscita in un altro thread. Per questo l’esempio legge i risultati solo dopo done.await().
La segnalazione in finally impedisce che un’eccezione faccia saltare il segnale, ma non implica che l’attività sia riuscita. Se mancano segnali necessari, un’attesa senza timeout può bloccarsi a tempo indeterminato; un timeout non annulla i worker.
Esempi
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]);
}
}Risultato
30
Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.