java.util.concurrent

Соедините интерфейсом с Будущим <V>

Введите Параметры:

V - Тип результата возвратился методом get этого Будущего

Все Известные Подынтерфейсы:

Ответ <T>, RunnableFuture <V>, RunnableScheduledFuture <V>, ScheduledFuture <V>

Все Известные Классы с реализацией:

ForkJoinTask, FutureTask, RecursiveAction, RecursiveTask, SwingWorker

public interface Future<V>

Future представляет результат асинхронного вычисления. Методы обеспечиваются для проверки, если вычисление полно, чтобы ожидать его завершения, и получить результат вычисления. Результат может только быть получен, используя метод get, когда вычисление завершилось, блокируя в случае необходимости, пока это не готово. Отмена выполняется методом cancel. Дополнительные методы обеспечиваются, чтобы определить, была ли задача, завершаемая обычно или, отменена. Как только вычисление завершилось, вычисление не может быть отменено. Если требуется использовать Future ради cancellability, но не обеспечить применимый результат, можно объявить типы формы Future<?> и возвратите null в результате базовой задачи.

Демонстрационное Использование (Отмечают, что следующие классы являются все искусственными.)

 interface ArchiveSearcher { String search(String target); }
 class App {
   ExecutorService executor = ...
   ArchiveSearcher searcher = ...
   void showSearch(final String target)
       throws InterruptedException {
     Future<String> future
       = executor.submit(new Callable<String>() {
         public String call() {
             return searcher.search(target);
         }});
     displayOtherThings(); // do other things while searching
     try {
       displayText(future.get()); // use future
     } catch (ExecutionException ex) { cleanup(); return; }
   }
 }

FutureTask класс является реализацией Future, который реализует Runnable, и так может быть выполнен Executor. Например, вышеупомянутая конструкция с submit могла быть заменена:

 FutureTask<String> future =
       new FutureTask<String>(new Callable<String>() {
         public String call() {
           return searcher.search(target);
       }});
     executor.execute(future);

Эффекты непротиворечивости памяти: Меры, предпринятые асинхронным вычислением, происходят - перед действиями после соответствия Future.get() в другом потоке.

С тех пор:

1.5

См. Также:

FutureTask, Executor

Сводка метода

Методы

Модификатор и Тип	Метод и Описание
boolean	cancel(boolean mayInterruptIfRunning) Попытки отменить выполнение этой задачи.
V	get() Ожидает в случае необходимости вычисления, чтобы завершиться, и затем получает его результат.
V	get(long timeout, TimeUnit unit) Ожидает в случае необходимости в течение самое большее данного времени для вычисления, чтобы завершиться, и затем получает его результат, при наличии.
boolean	isCancelled() true возвратов, если эта задача была отменена прежде, чем это обычно завершалось.
boolean	isDone() true возвратов, если эта задача завершалась.

Деталь метода

отмена

boolean cancel(boolean mayInterruptIfRunning)

Попытки отменить выполнение этой задачи. Эта попытка перестанет работать, если задача уже завершилась, была уже отменена, или не могла бы быть отменена по некоторой другой причине. В случае успеха, и эта задача не запустилась, когда cancel вызывают, эта задача никогда не должна работать. Если задача уже запустилась, то параметр mayInterruptIfRunning определяет, должен ли поток, выполняющий эту задачу, быть прерван в попытке остановить задачу.

После этого метода возвраты, последующие звонки isDone() будет всегда возвращать true. Последующие звонки isCancelled() будет всегда возвращать true если этот метод возвращенный true.

Параметры:

mayInterruptIfRunning - true, если поток, выполняющий эту задачу, должен быть прерван; иначе, происходящим задачам позволяют завершиться

Возвраты:

false, если задача не могла бы быть отменена, обычно потому что это уже обычно завершалось; true иначе

isCancelled

boolean isCancelled()

true возвратов, если эта задача была отменена прежде, чем это обычно завершалось.

Возвраты:

true, если эта задача была отменена прежде, чем это завершалось

isDone

boolean isDone()

true возвратов, если эта задача завершалась. Завершение может произойти из-за нормального завершения, исключения, или отмены - во всех этих случаях, этот метод возвратит true.

Возвраты:

true, если эта задача завершалась

добраться

V get()
      throws InterruptedException,
             ExecutionException

Ожидает в случае необходимости вычисления, чтобы завершиться, и затем получает его результат.

Возвраты:

вычисленный результат

Броски:

CancellationException - если вычисление было отменено

ExecutionException - если вычисление выдавало исключение

InterruptedException - если текущий поток был прерван, ожидая

добраться

V get(long timeout,
    TimeUnit unit)
      throws InterruptedException,
             ExecutionException,
             TimeoutException

Ожидает в случае необходимости в течение самое большее данного времени для вычисления, чтобы завершиться, и затем получает его результат, при наличии.

Параметры:

timeout - максимальное время, чтобы ожидать

unit - единица измерения времени параметра тайм-аута

Возвраты:

вычисленный результат

Броски:

CancellationException - если вычисление было отменено

ExecutionException - если вычисление выдавало исключение

InterruptedException - если текущий поток был прерван, ожидая

TimeoutException - если ожидание синхронизированного