CKTIS / Java
TimeUnit.MILLISECONDS — časovne omejitve v milisekundah
Konstanta TimeUnit.MILLISECONDS določa, da je omejitev čakanja pri časovno omejenih različicah metod poll in offer blokirne čakalne vrste izražena v milisekundah.
Različica: 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 je konstanta naštevnega tipa java.util.concurrent.TimeUnit. Predstavlja enoto, ki je enaka tisočinki sekunde, ne pa določenega trajanja ali časovnega žiga. Argumenta 250L, TimeUnit.MILLISECONDS določata omejitev čakanja 250 milisekund. Operacija lahko uspe prej; enota ne zagotavlja točnega trenutka, ko se klic konča.
Pri BlockingQueue<E> metoda offer(E, long, TimeUnit) po potrebi počaka na prostor. Vrne true, če vstavi element, ali false, če se čas izteče, preden je na voljo prostor. poll(long, TimeUnit) po potrebi počaka na element. Odstrani in vrne prvi element vrste ali vrne null, če se čas izteče, preden je na voljo element. BlockingQueue ne sprejema elementov null.
V nasprotju s časovno omejenima različicama offer(E) in poll() ne čakata na prostor ali element. Obe časovno omejeni različici sprožita InterruptedException, če je nit med čakanjem prekinjena. Prekinitev ni isto kot iztek čakalnega časa.
Če potrebuješ številski rezultat v milisekundah, TimeUnit.MILLISECONDS.convert(2L, TimeUnit.SECONDS) vrne 2000L. Konstanta, na kateri pokličeš metodo, določa ciljno enoto. Pri pretvorbi v bolj grobo enoto se rezultat odreže proti ničli; če bi prišlo do prekoračitve, se omeji na ustrezno mejo tipa long.
Primeri
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
Ena nit uporablja vrsto s prostorom za en element. Prvo vstavljanje uspe, pri drugem se čas izteče, prvo odstranjevanje vrne `job`, drugo pa po izteku časa vrne `null`. Primer preverja rezultate, ne pretečenega časa.
Povezane lekcije
- Java · Lekcija 37 · Napredna · Različica: 2