CKTIS / Java
TimeUnit.MILLISECONDS — wachttijdlimieten in milliseconden
Met TimeUnit.MILLISECONDS druk je de wachttijdlimiet voor de getimede varianten van poll en offer van een blokkerende wachtrij uit in milliseconden.
Versie: Java SE 21
Syntax
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 is een enumconstante van java.util.concurrent.TimeUnit. Ze staat voor een eenheid van een duizendste seconde, niet voor een bepaalde tijdsduur of een tijdstempel. Het argumentenpaar 250L, TimeUnit.MILLISECONDS stelt een wachttijdlimiet van 250 milliseconden in. De bewerking kan eerder slagen; de eenheid garandeert niet wanneer de aanroep precies terugkeert.
Bij een BlockingQueue<E> wacht offer(E, long, TimeUnit) zo nodig op vrije ruimte. De methode geeft true terug als het element wordt toegevoegd, of false als de wachttijd verstrijkt voordat er ruimte is. poll(long, TimeUnit) wacht zo nodig op een element. De methode verwijdert het eerste element en geeft het terug, of geeft null terug als de wachttijd verstrijkt voordat er een element beschikbaar is. Een BlockingQueue accepteert geen null-elementen.
Anders dan de getimede overloads wachten offer(E) en poll() niet op vrije ruimte of een element. Beide getimede overloads werpen InterruptedException als de thread tijdens het wachten wordt onderbroken. Een onderbreking is niet hetzelfde als het verstrijken van de wachttijd.
Voor een numerieke waarde in milliseconden geeft TimeUnit.MILLISECONDS.convert(2L, TimeUnit.SECONDS) de waarde 2000L terug. De constante waarop je de methode aanroept, bepaalt de doeleenheid. Bij omzetting naar een grovere eenheid wordt naar nul afgekapt; bij dreigende overloop wordt de uitkomst begrensd tot de overeenkomstige grens van long.
Voorbeelden
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));
}
}Resultaat
true false job null
Eén thread gebruikt een wachtrij met ruimte voor één element. De eerste invoeging slaagt, de tweede verloopt, de eerste ophaalpoging geeft `job` terug en de tweede geeft na het verstrijken van de wachttijd `null` terug. Het voorbeeld controleert de resultaten, niet de verstreken tijd.
Gerelateerde lessen
- Java · Les 37 · Gevorderd · Versie: 2