Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / Java

TimeUnit.MILLISECONDS — limit oczekiwania w milisekundach

Stała TimeUnit.MILLISECONDS określa, że limit oczekiwania przekazany do metod poll i offer kolejki blokującej jest wyrażony w milisekundach.

Wersja: Java SE 21

Składnia

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 to stała typu wyliczeniowego java.util.concurrent.TimeUnit. Oznacza jednostkę równą jednej tysięcznej sekundy, a nie konkretny czas trwania ani znacznik czasu. Para argumentów 250L, TimeUnit.MILLISECONDS oznacza limit oczekiwania wynoszący 250 milisekund. Operacja może zakończyć się wcześniej; jednostka nie gwarantuje dokładnego momentu powrotu z metody.

W BlockingQueue<E> metoda offer(E, long, TimeUnit) czeka w razie potrzeby na wolne miejsce: zwraca true, jeśli wstawi element, albo false, jeśli limit upłynie, zanim zwolni się miejsce. Metoda poll(long, TimeUnit) czeka w razie potrzeby na element: usuwa i zwraca pierwszy element kolejki albo zwraca null, jeśli limit upłynie, zanim element będzie dostępny. Kolejka BlockingQueue nie przyjmuje elementów null.

W przeciwieństwie do tych przeciążeń offer(E) i poll() nie czekają na wolne miejsce ani na element. Oba warianty z limitem zgłaszają InterruptedException, jeśli wątek zostanie przerwany podczas oczekiwania. Przerwanie to nie to samo co upływ limitu.

Gdy potrzebujesz wyniku liczbowego w milisekundach, użyj TimeUnit.MILLISECONDS.convert(2L, TimeUnit.SECONDS): wynik to 2000L. Odbiorca wywołania jest jednostką docelową. Przy konwersji na większą jednostkę część ułamkowa jest odrzucana w kierunku zera; przy przepełnieniu wynik jest ograniczany do odpowiedniej granicy typu long.

Przykłady

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

Wynik

true
false
job
null

Kolejka mieści jeden element i korzysta z niej tylko jeden wątek. Pierwsze wstawienie się udaje, drugie kończy się po upływie limitu, pierwsze pobranie zwraca `job`, a drugie po upływie limitu zwraca `null`. Przykład sprawdza wyniki, nie czas wykonania.

Powiązane lekcje

  • Java · Lekcja 37 · Zaawansowany · Wersja: 2

Źródła