java.util.concurrent

Класс FutureTask <V>

java.lang. Объект

java.util.concurrent. FutureTask <V>

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

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

Все Реализованные Интерфейсы:

Выполнимый, Будущий <V>, RunnableFuture <V>

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

cancellable асинхронное вычисление. Этот класс обеспечивает основную реализацию Future, с методами, чтобы запуститься и отменить вычисление, запрос, чтобы видеть, полно ли вычисление, и получает результат вычисления. Результат может только быть получен, когда вычисление завершилось; метод get блокирует, если вычисление еще не завершилось. Как только вычисление завершилось, вычисление не может быть перезапущено или отменено.

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

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

С тех пор:

1.5

Сводка конструктора

Конструкторы

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

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

Методы

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

Методы java.lang унаследованный от класса. Объект

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

Деталь конструктора

FutureTask

public FutureTask(Callable<V> callable)

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

Параметры:

callable - вызываемая задача

Броски:

NullPointerException - если вызываемый нуль

FutureTask

public FutureTask(Runnable runnable,
          V result)

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

Параметры:

runnable - выполнимая задача

result - результат возвратиться на успешном завершении. Если Вы не нуждаетесь в определенном результате, рассмотрите использование конструкций формы: Future<?> f = new FutureTask<Void>(runnable, null)

Броски:

NullPointerException - если выполнимый нуль

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

isCancelled

public boolean isCancelled()

Описание скопировало с интерфейса: Future

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

Определенный:

isCancelled в интерфейсе Future<V>

Возвраты:

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

isDone

public boolean isDone()

Описание скопировало с интерфейса: Future

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

Определенный:

isDone в интерфейсе Future<V>

Возвраты:

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

отмена

public boolean cancel(boolean mayInterruptIfRunning)

Описание скопировало с интерфейса: Future

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

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

Определенный:

cancel в интерфейсе Future<V>

Параметры:

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

Возвраты:

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

добраться

public V get()
      throws InterruptedException,
             ExecutionException

Описание скопировало с интерфейса: Future

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

Определенный:

get в интерфейсе Future<V>

Возвраты:

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

Броски:

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

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

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

добраться

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

Описание скопировало с интерфейса: Future

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

Определенный:

get в интерфейсе Future<V>

Параметры:

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

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

Возвраты:

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

Броски:

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

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

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

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

сделанный

protected void done()

Защищенный метод, вызванный, когда эта задача переходы, чтобы утвердить isDone (или обычно или через отмену). Реализация по умолчанию ничего не делает. Подклассы могут переопределить этот метод, чтобы вызвать обратные вызовы завершения или выполнить бухгалтерию. Отметьте, что можно запросить состояние в реализации этого метода, чтобы определить, была ли эта задача отменена.

набор

protected void set(V v)

Устанавливает результат этого Будущего к данному значению, если это будущее не было уже установлено или было отменено. Этот метод вызывается внутренне методом run после успешного завершения вычисления.

Параметры:

v - значение

setException

protected void setException(Throwable t)

Причины это будущее, чтобы сообщить о ExecutionException с данным throwable как его причина, если это Будущее не было уже установлено или было отменено. Этот метод вызывается внутренне методом run на отказ вычисления.

Параметры:

t - причина отказа

выполненный

public void run()

Наборы это Будущее к результату его вычисления, если это не было отменено.

Определенный:

run в интерфейсе Runnable

Определенный:

run в интерфейсе RunnableFuture<V>

См. Также:

Thread.run()

runAndReset

protected boolean runAndReset()

Выполняет вычисление, не устанавливая его результат, и затем сбрасывает это Будущее к начальному состоянию, будучи не в состоянии сделать так, если вычисление встречается с исключением или отменяется. Это разрабатывается для использования с задачами, которые свойственно выполняются не раз.

Возвраты:

истина если успешно выполнено и сброшено