CKTIS / Java
TimeUnit.MILLISECONDS — timeout in millisecondi
TimeUnit.MILLISECONDS indica che il limite di attesa passato alle versioni temporizzate di poll e offer di una coda bloccante è espresso in millisecondi.
Versione: Java SE 21
Sintassi
import java.util.concurrent.TimeUnit;
TimeUnit unit = TimeUnit.MILLISECONDS;
// Both timed calls can throw InterruptedException. Catch it or declare it
// in the enclosing method's throws clause.
// Given a BlockingQueue<E> named queue and a non-null E named element:
boolean inserted = queue.offer(element, 250L, TimeUnit.MILLISECONDS);
E head = queue.poll(250L, TimeUnit.MILLISECONDS);TimeUnit.MILLISECONDS è una costante dell’enumerazione java.util.concurrent.TimeUnit. Rappresenta un’unità pari a un millesimo di secondo, non una durata specifica né un timestamp. Gli argomenti 250L, TimeUnit.MILLISECONDS impostano un limite di attesa di 250 millisecondi. L’operazione può riuscire prima; l’unità non garantisce l’istante esatto in cui termina la chiamata.
Su una BlockingQueue<E>, offer(E, long, TimeUnit) attende se necessario che si liberi spazio. Restituisce true se inserisce l’elemento, oppure false se il limite scade prima che ci sia spazio. poll(long, TimeUnit) attende se necessario che sia disponibile un elemento. Rimuove e restituisce l’elemento in testa, oppure restituisce null se il limite scade prima che sia disponibile un elemento. Una BlockingQueue non accetta elementi null.
A differenza degli overload temporizzati, offer(E) e poll() non attendono che si liberi spazio o che arrivi un elemento. Entrambi gli overload temporizzati lanciano InterruptedException se il thread viene interrotto durante l’attesa. Un’interruzione non equivale alla scadenza del timeout.
Per ottenere un risultato numerico in millisecondi, TimeUnit.MILLISECONDS.convert(2L, TimeUnit.SECONDS) restituisce 2000L. La costante su cui si invoca il metodo è l’unità di destinazione. La conversione a un’unità più grande tronca verso zero; se si avrebbe un overflow, il risultato è limitato all’estremo corrispondente di long.
Esempi
import java.util.concurrent.ArrayBlockingQueue;
import java.util.concurrent.BlockingQueue;
import java.util.concurrent.TimeUnit;
public class MillisecondTimeouts {
public static void main(String[] args) throws InterruptedException {
BlockingQueue<String> queue = new ArrayBlockingQueue<>(1);
System.out.println(queue.offer("job", 10L, TimeUnit.MILLISECONDS));
System.out.println(queue.offer("extra", 10L, TimeUnit.MILLISECONDS));
System.out.println(queue.poll(10L, TimeUnit.MILLISECONDS));
System.out.println(queue.poll(10L, TimeUnit.MILLISECONDS));
}
}Risultato
true false job null
Un solo thread usa una coda con spazio per un elemento. Il primo inserimento riesce, il secondo scade, il primo prelievo restituisce `job` e il secondo scade e restituisce `null`. L’esempio verifica i risultati, non il tempo trascorso.
Lezioni correlate
- Java · Lezione 37 · Avanzato · Versione: 2