WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / Java

TimeUnit: Millisekunden, Nanosekunden und tryLock mit Zeitlimit

Rechne Millisekunden in Nanosekunden um und verwende bei `tryLock` mit Zeitlimit die zur Zahl passende Einheit.

Version: Java SE 21

Syntax

import java.util.concurrent.TimeUnit;
import java.util.concurrent.locks.ReentrantLock;

long timeoutNanos = TimeUnit.MILLISECONDS.toNanos(timeoutMillis);
// For either timed tryLock call, catch InterruptedException or declare it in the enclosing method's throws clause.
boolean acquired = lock.tryLock(timeoutMillis, TimeUnit.MILLISECONDS);
// Alternative to the preceding call, not a second acquisition:
// boolean acquired = lock.tryLock(timeoutNanos, TimeUnit.NANOSECONDS);

TimeUnit.MILLISECONDS ist eine Konstante des Enum-Typs java.util.concurrent.TimeUnit. Sie steht für eine Einheit (eine Millisekunde), nicht für eine konkrete Dauer oder einen Uhrwert. TimeUnit.toNanos ist eine Instanzmethode: unit.toNanos(duration) nimmt einen long in der Einheit unit entgegen und gibt einen long in Nanosekunden zurück.

Eine Millisekunde entspricht 1.000.000 Nanosekunden. Deshalb liefert TimeUnit.MILLISECONDS.toNanos(250L) den Wert 250000000L. Liegt das exakte Ergebnis außerhalb des long-Wertebereichs, liefert die Methode oberhalb der Obergrenze Long.MAX_VALUE und unterhalb der Untergrenze Long.MIN_VALUE. Sie löst bei einem Überlauf keine Ausnahme aus, und der Wert springt nicht auf die andere Seite des Wertebereichs.

Bei ReentrantLock.tryLock(long, TimeUnit) legt die Einheit fest, wie das erste Argument zu verstehen ist. Verwende direkt lock.tryLock(250L, TimeUnit.MILLISECONDS) oder nach der Umrechnung lock.tryLock(250000000L, TimeUnit.NANOSECONDS). Beide Aufrufe setzen dieselbe Wartefrist für den Erwerb der Sperre. Kombiniere die umgerechnete Zahl nicht mit MILLISECONDS. Nanosekunden als Einheit garantieren keine nanosekundengenaue Wartezeit.

Die Überladung mit Zeitlimit liefert true, wenn der Thread die Sperre erwirbt (auch erneut), und false, wenn die Frist ohne Erwerb abläuft. Bei einem Zeitlimit <= 0 wartet sie nicht. Diese Überladung berücksichtigt die Fairness-Einstellung der Sperre. Ist der Thread beim Aufruf bereits unterbrochen oder wird er während des Erwerbs unterbrochen, löst sie InterruptedException aus und löscht den Unterbrechungsstatus. tryLock() ohne Argumente wartet nicht, kann wartende Threads überholen und löst keine InterruptedException aus. Eine Einheit null führt bei der Überladung mit Zeitlimit zu NullPointerException. Rufe unlock() in finally nur nach erfolgreichem Erwerb auf.

Beispiele

import java.util.concurrent.TimeUnit;
import java.util.concurrent.locks.ReentrantLock;

public class Main {
    public static void main(String[] args) throws InterruptedException {
        long timeoutMillis = 250L;
        long timeoutNanos = TimeUnit.MILLISECONDS.toNanos(timeoutMillis);
        System.out.println(timeoutMillis + " ms = " + timeoutNanos + " ns");

        ReentrantLock lock = new ReentrantLock();
        if (lock.tryLock(timeoutMillis, TimeUnit.MILLISECONDS)) {
            try {
                System.out.println("Lock acquired");
            } finally {
                lock.unlock();
            }
        } else {
            System.out.println("Lock not acquired");
        }
    }
}

Ergebnis

250 ms = 250000000 ns
Lock acquired

Das Programm gibt das Umrechnungsergebnis aus, übergibt aber den ursprünglichen Millisekundenwert an `tryLock`. Die neue Sperre ist frei und kein anderer Thread konkurriert darum. Das Beispiel zeigt daher den erfolgreichen Erwerb, nicht den Ablauf der Wartefrist.

Zugehörige Lektionen

  • Java · Lektion 54 · Mittlere Stufe · Version: 2

Quellen