Класс FutureTask<V>

java.lang.Object

java.util.concurrent.FutureTask<V>

Type Parameters:: V - Тип результата, возвращаемый методами этого FutureTask

All Implemented Interfaces:: Runnable, Future<V>, RunnableFuture<V>

public class FutureTask<V> extends Object implements RunnableFuture<V>

Асинхронное вычисление, которое можно отменить. Этот класс предоставляет базовую реализацию интерфейса Future с методами для запуска и отмены вычисления, запроса о завершении вычисления и получения результата вычисления. Результат можно получить только после завершения вычисления; методы, get будут блокировать, пока вычисление не завершится. После завершения вычисления его нельзя перезапустить или отменить (за исключением вызова с помощью runAndReset()).

Класс FutureTask может использоваться для обертывания объекта типа Callable или Runnable. Поскольку FutureTask реализует интерфейс Runnable, FutureTask можно отправить на выполнение в Executor.

Помимо использования в качестве самостоятельного класса, этот класс предоставляет функциональность protected, которая может быть полезна при создании пользовательских классов задач.

Since:: 1.5

Краткое описание конструкторов

Конструктор	Описание
`FutureTask(Runnable runnable, V result)`	Создаёт FutureTask, который при запуске выполнит указанный `Runnable`, и организует возврат указанного результата при успешном завершении.
`FutureTask(Callable<V> callable)`	Создаёт FutureTask, который при запуске выполнит указанный `Callable`.

Краткое описание методов

Модификатор и тип	Метод	Описание
`boolean`	`cancel(boolean mayInterruptIfRunning)`	Попытка отменить выполнение задачи.
`protected void`	`done()`	Защищённый метод, вызываемый при переходе этой задачи в состояние `isDone` (как нормальным путём, так и через отмену).
`V`	`get()`	Ожидает завершения вычисления и затем возвращает его результат.
`V`	`get(long timeout, TimeUnit unit)`	Ожидает завершения вычисления в течение заданного времени и возвращает его результат, если он доступен.
`boolean`	`isCancelled()`	Возвращает значение `true`, если задача была отменена до нормального завершения.
`boolean`	`isDone()`	Возвращает значение `true`, если задача завершилась.
`void`	`run()`	Устанавливает результат этой FutureTask в результат её вычисления, если она не была отменена.
`protected boolean`	`runAndReset()`	Выполняет вычисление без установки результата, а затем сбрасывает эту FutureTask в начальное состояние, если при этом вычисление не встретило исключение или не было отменено.
`protected void`	`set(V v)`	Устанавливает результат этой FutureTask в заданное значение, если эта FutureTask ещё не была установлена или отменена.
`protected void`	`setException(Throwable t)`	Устанавливает для этой FutureTask исключение `ExecutionException` с указанным исключением в качестве причины, если эта FutureTask ещё не была установлена или отменена.
`String`	`toString()`	Возвращает строковое представление этой FutureTask.

Методы, унаследованные от класса java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Подробное описание конструкторов

FutureTask

public FutureTask(Callable<V> callable)

Создаёт FutureTask, который при выполнении будет выполнять заданный Callable.

Параметры:: callable - выполнимая задача
Исключения:: NullPointerException - если выполнимая задача равна null

FutureTask

public FutureTask(Runnable runnable, V result)

Создаёт FutureTask, который при выполнении будет выполнять заданный Runnable, и гарантирует, что get вернёт заданный результат при успешном завершении.

Параметры:: runnable - выполнимая задача; result - результат, который должен быть возвращён при успешном завершении. Если вам не нужен конкретный результат, рассмотрите конструкции вида: Future<?> f = new FutureTask<Void>(runnable, null)
Исключения:: NullPointerException - если выполнимая задача равна null