CKTIS / Java
TimeUnit.MILLISECONDS — limity čakania v milisekundách
Konštanta TimeUnit.MILLISECONDS určuje, že časový limit variantov metód poll a offer blokujúceho frontu sa udáva v milisekundách.
Verzia: Java SE 21
Syntax
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 konštanta výčtového typu java.util.concurrent.TimeUnit. Predstavuje jednotku rovnú jednej tisícine sekundy, nie konkrétne trvanie ani časovú značku. Dvojica argumentov 250L, TimeUnit.MILLISECONDS nastaví limit čakania na 250 milisekúnd. Operácia môže uspieť skôr; jednotka nezaručuje presný okamih návratu z volania.
V BlockingQueue<E> metóda offer(E, long, TimeUnit) v prípade potreby čaká na voľné miesto. Vráti true, ak prvok vloží, alebo false, ak limit uplynie skôr, než sa uvoľní miesto. poll(long, TimeUnit) v prípade potreby čaká na prvok. Odoberie a vráti prvý prvok frontu alebo vráti null, ak limit uplynie skôr, než je prvok k dispozícii. BlockingQueue neprijíma prvky null.
Na rozdiel od preťažených variantov s časovým limitom metódy offer(E) a poll() nečakajú na voľné miesto ani na prvok. Oba varianty s limitom vyhodia InterruptedException, ak je vlákno počas čakania prerušené. Prerušenie nie je uplynutie časového limitu.
Ak potrebuješ číselný výsledok v milisekundách, TimeUnit.MILLISECONDS.convert(2L, TimeUnit.SECONDS) vráti 2000L. Konštanta, na ktorej metódu voláš, určuje cieľovú jednotku. Pri prevode na hrubšiu jednotku sa výsledok skráti smerom k nule; ak by pretiekol, obmedzí sa na zodpovedajúcu hranicu typu long.
Prí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ýsledok
true false job null
Jedno vlákno používa front s miestom pre jeden prvok. Prvé vloženie uspeje, druhé vyčerpá časový limit, prvé odobratie vráti `job` a druhé po uplynutí limitu vráti `null`. Príklad kontroluje výsledky, nie uplynutý čas.
Súvisiace lekcie
- Java · Lekcia 37 · Pokročilá · Verzia: 2