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