CKTIS / Java
TimeUnit.MILLISECONDS — ограничение за изчакване в милисекунди
TimeUnit.MILLISECONDS задава милисекунди като единица за ограничението на изчакване при вариантите на poll и offer с времеви лимит в блокираща опашка.
Версия: Java SE 21
Синтаксис
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 е константа на изброимия тип java.util.concurrent.TimeUnit. Тя означава единица, равна на една хилядна от секундата, а не конкретна продължителност или времеви печат. Аргументите 250L, TimeUnit.MILLISECONDS задават ограничение за изчакване от 250 милисекунди. Операцията може да успее по-рано; единицата не гарантира точния момент на връщане от извикването.
При BlockingQueue<E> методът offer(E, long, TimeUnit) изчаква при нужда да се освободи място. Връща true, ако добави елемента, или false, ако времето изтече, преди да се освободи място. poll(long, TimeUnit) изчаква при нужда да има елемент. Премахва и връща първия елемент или връща null, ако времето изтече, преди да има наличен елемент. BlockingQueue не приема елементи със стойност null.
За разлика от претоварените варианти с времеви лимит, offer(E) и poll() не изчакват за свободно място или елемент. И двата варианта с времеви лимит хвърлят InterruptedException, ако нишката бъде прекъсната по време на изчакването. Прекъсването не е изтичане на времето за изчакване.
За числов резултат в милисекунди TimeUnit.MILLISECONDS.convert(2L, TimeUnit.SECONDS) връща 2000L. Константата, върху която се извиква методът, определя целевата единица. При преобразуване към по-едра единица дробната част се отрязва в посока към нулата; ако резултатът би препълнил типа long, той се ограничава до съответната му граница.
Примери
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));
}
}Резултат
true false job null
Една нишка използва опашка с място за един елемент. Първото добавяне успява, при второто времето изтича, първото извличане връща `job`, а второто след изтичане на времето връща `null`. Примерът проверява резултатите, а не изминалото време.
Свързани уроци
- Java · Урок 37 · Напреднало · Версия: 2