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