Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / Java

TimeUnit.MILLISECONDS — limity čekání v milisekundách

Konstanta TimeUnit.MILLISECONDS určuje, že časový limit předaný variantám metod poll a offer blokující fronty je vyjádřen v milisekundách.

Verze: Java SE 21

Syntaxe

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 je konstanta výčtového typu java.util.concurrent.TimeUnit. Představuje jednotku rovnou jedné tisícině sekundy, nikoli konkrétní dobu trvání ani časovou značku. Dvojice argumentů 250L, TimeUnit.MILLISECONDS nastavuje limit čekání na 250 milisekund. Operace může uspět dříve; jednotka nezaručuje přesný okamžik návratu z volání.

U BlockingQueue<E> metoda offer(E, long, TimeUnit) v případě potřeby čeká na volné místo. Vrátí true, pokud prvek vloží, nebo false, pokud limit vyprší dříve, než se uvolní místo. poll(long, TimeUnit) v případě potřeby čeká na prvek. Odebere a vrátí první prvek fronty, nebo vrátí null, pokud limit vyprší dříve, než je prvek k dispozici. BlockingQueue nepřijímá prvky null.

Na rozdíl od přetížených variant s časovým limitem metody offer(E) a poll() nečekají na volné místo ani na prvek. Obě varianty s limitem vyhodí InterruptedException, pokud je vlákno během čekání přerušeno. Přerušení není vypršení časového limitu.

Pokud potřebuješ číselný výsledek v milisekundách, TimeUnit.MILLISECONDS.convert(2L, TimeUnit.SECONDS) vrátí 2000L. Konstanta, na které metodu voláš, je cílová jednotka. Při převodu na hrubší jednotku se výsledek ořízne směrem k nule; při hrozícím přetečení se omezí na odpovídající mez typu long.

Příklady

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

Výsledek

true
false
job
null

Jedno vlákno používá frontu s místem pro jeden prvek. První vložení uspěje, druhé vyčerpá časový limit, první odebrání vrátí `job` a druhé po vypršení limitu vrátí `null`. Příklad kontroluje výsledky, nikoli uplynulý čas.

Související lekce

  • Java · Lekce 37 · Pokročilá · Verze: 2

Zdroje