Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

CKTIS / Java

TimeUnit.MILLISECONDS — ograničenja čekanja u milisekundama

Konstanta TimeUnit.MILLISECONDS određuje da se ograničenje čekanja u vremenski ograničenim inačicama metoda poll i offer blokirajućeg reda izražava u milisekundama.

Verzija: Java SE 21

Sintaksa

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 konstanta je enumeracije java.util.concurrent.TimeUnit. Predstavlja jedinicu jednaku jednoj tisućinki sekunde, a ne određeno trajanje ni vremensku oznaku. Argumenti 250L, TimeUnit.MILLISECONDS postavljaju ograničenje čekanja od 250 milisekundi. Operacija može uspjeti ranije; jedinica ne jamči točan trenutak povratka iz poziva.

U BlockingQueue<E> metoda offer(E, long, TimeUnit) po potrebi čeka na slobodno mjesto. Vraća true ako umetne element ili false ako vrijeme istekne prije nego što se oslobodi mjesto. poll(long, TimeUnit) po potrebi čeka na element. Uklanja i vraća prvi element reda ili vraća null ako vrijeme istekne prije nego što element postane dostupan. BlockingQueue ne prihvaća elemente null.

Za razliku od vremenski ograničenih preopterećenja, offer(E) i poll() ne čekaju na slobodno mjesto ni na element. Oba vremenski ograničena preopterećenja bacaju InterruptedException ako se dretva prekine tijekom čekanja. Prekid nije isto što i istek vremena čekanja.

Ako trebaš brojčani rezultat u milisekundama, TimeUnit.MILLISECONDS.convert(2L, TimeUnit.SECONDS) vraća 2000L. Konstanta na kojoj pozivaš metodu određuje ciljnu jedinicu. Pri pretvorbi u krupniju jedinicu rezultat se skraćuje prema nuli; ako bi došlo do preljeva, ograničava se na odgovarajuću granicu tipa long.

Primjeri

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

Rezultat

true
false
job
null

Jedna dretva koristi red s mjestom za jedan element. Prvo umetanje uspijeva, drugo doseže vremensko ograničenje, prvo uklanjanje vraća `job`, a drugo nakon isteka vremena vraća `null`. Primjer provjerava rezultate, a ne proteklo vrijeme.

Povezane lekcije

  • Java · Lekcija 37 · Napredno · Verzija: 2

Izvori