WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / Java

TimeUnit.MILLISECONDS — Wartezeitlimits in Millisekunden

Mit TimeUnit.MILLISECONDS geben Sie bei den zeitbegrenzten Varianten von poll und offer einer blockierenden Warteschlange das Wartezeitlimit in Millisekunden an.

Version: 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 ist eine Enum-Konstante des Typs java.util.concurrent.TimeUnit. Sie steht für eine Tausendstelsekunde als Einheit, nicht für eine konkrete Dauer oder einen Zeitstempel. Das Argumentpaar 250L, TimeUnit.MILLISECONDS legt ein Wartezeitlimit von 250 Millisekunden fest. Die Operation kann früher erfolgreich sein; die Einheit garantiert keinen genauen Rückkehrzeitpunkt.

Bei einer BlockingQueue<E> wartet offer(E, long, TimeUnit) bei Bedarf auf freien Platz. Die Methode liefert true, wenn sie das Element einfügt, oder false, wenn das Limit abläuft, bevor Platz frei wird. poll(long, TimeUnit) wartet bei Bedarf auf ein Element. Die Methode entfernt das erste Element und gibt es zurück oder liefert null, wenn das Limit abläuft, bevor ein Element verfügbar ist. Eine BlockingQueue nimmt keine null-Elemente an.

Anders als die zeitbegrenzten Überladungen warten offer(E) und poll() nicht auf freien Platz oder ein Element. Beide zeitbegrenzten Überladungen werfen InterruptedException, wenn der Thread beim Warten unterbrochen wird. Eine Unterbrechung ist kein Ablauf des Wartezeitlimits.

Für ein numerisches Ergebnis in Millisekunden liefert TimeUnit.MILLISECONDS.convert(2L, TimeUnit.SECONDS) den Wert 2000L. Die Konstante, auf der die Methode aufgerufen wird, ist die Zieleinheit. Beim Umrechnen in eine gröbere Einheit wird in Richtung null abgeschnitten; bei einem drohenden Überlauf wird das Ergebnis auf die entsprechende Grenze von long begrenzt.

Beispiele

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

Ergebnis

true
false
job
null

Ein Thread verwendet eine Warteschlange mit Platz für ein Element. Der erste Einfügeversuch gelingt, der zweite erreicht das Zeitlimit, der erste Abruf liefert `job` und der zweite liefert nach Ablauf des Limits `null`. Das Beispiel prüft Ergebnisse, keine Laufzeiten.

Zugehörige Lektionen

  • Java · Lektion 37 · Fortgeschritten · Version: 2

Quellen