Класс FutureTask<V>

java.lang.Object

java.util.concurrent.FutureTask<V>

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

Все реализованные интерфейсы:: 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

Краткое описание вложенных классов

Вложенные классы/интерфейсы, объявленные в интерфейсе java.util.concurrent.Future

Future.State

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

Конструктор	Описание
`FutureTask(Runnable runnable, V result)`	Создает `FutureTask`, который при запуске выполнит заданный `Runnable`, и организует, чтобы `get` вернул заданный результат при успешном завершении.
`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()`	Устанавливает этот Future в результат его вычисления, если он не был отменен.
`protected boolean`	`runAndReset()`	Выполняет вычисление без установки его результата, а затем сбрасывает этот future в начальное состояние, не делая этого, если вычисление столкнулось с исключением или было отменено.
`protected void`	`set(V v)`	Устанавливает результат этого future в заданное значение, если этот future еще не был установлен или отменен.
`protected void`	`setException(Throwable t)`	Приводит к тому, что этот future сообщает об `ExecutionException` с заданным исключением в качестве причины, если этот future уже был установлен или отменен.
`String`	`toString()`	Возвращает строковое представление этого FutureTask.

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

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

Методы, объявленные в интерфейсе java.util.concurrent.Future

exceptionNow, resultNow, state

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

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