Задача (Java FX 2.0)

java.lang. Объект
- java.util.concurrent. FutureTask <V>
- - javafx.concurrent. Задача <V>

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

java.lang. Выполнимый, java.util.concurrent. Будущее <V>, java.util.concurrent. RunnableFuture <V>, Рабочий <V>
```
public abstract class Task<V>
extends java.util.concurrent.FutureTask<V>
implements Worker<V>
```
Полностью заметная реализация a FutureTask. Задачи представляют дополнительное состояние и заметные свойства, полезные для программирования асинхронных задач в JavaFX, как определено в Worker интерфейс. Реализация Задачи должна переопределить call() метод. Этот метод вызывается на фоновый поток. Любое состояние, которое используется в этом методе, должно быть безопасно читать и записать из фонового потока. Например, управление живым графиком сцены от этого метода опасно и приведет к исключениям на этапе выполнения.

Задачи гибки и чрезвычайно полезны для инкапсуляции "работы". Поскольку Service разрабатывается, чтобы выполнить Задачу, любые Задачи, определенные приложением или кодом библиотеки, могут легко использоваться со Службой. Аналогично, так как Задача расширяется от FutureTask, это является очень легким и естественным использовать Задачу с параллелизмом java Executor API. Наконец, так как Задача Выполнима, можно также вызвать ее непосредственно (вызывая FutureTask.run() метод) от другого фонового потока. Это учитывает состав работы, или передайте это к новому потоку, созданному и выполняемому вручную.

Хотя ExecutorService определяет несколько методов, которые берут Выполнимое, следует обычно ограничить себя использованием execute метод, наследованный от Executor.

Как с FutureTask, Задача является class с одним выстрелом и не может быть снова использована. См. Service для допускающего повторное использование Worker.

Поскольку Задача разрабатывается для использования с приложениями GUI JavaFX, это гарантирует, что каждое изменение к его общедоступным свойствам, так же как уведомления об изменении для состояния, ошибок, и для обработчиков событий, все происходят на основном потоке приложения JavaFX. Доступ к этим свойствам от фонового потока (включая call() метод), приведет к повышаемым исключениям на этапе выполнения.

Это строго поощряется, что все Задачи инициализируются с неизменным состоянием, на которое будет работать Задача. Это должно быть сделано, предоставляя конструктору Задачи, который берет параметры, необходимые для выполнения Задачи. Неизменное состояние облегчает и безопасный использовать от любого потока и гарантирует правильность в присутствии многократных потоков.

Сводка свойства

Свойства
Ввести	Свойство и Описание
`ReadOnlyObjectProperty<java.lang.Throwable>`	`исключение` Получает ReadOnlyObjectProperty, представляющий любое исключение, которое произошло.
`ReadOnlyStringProperty`	`сообщение` Получает ReadOnlyStringProperty, представляющий сообщение.
`ReadOnlyDoubleProperty`	`продвижение` Получает ReadOnlyLongProperty, представляющий продвижение.
`ReadOnlyBooleanProperty`	`выполнение` Получает представление ReadOnlyBooleanProperty, работает ли Рабочий.
`ReadOnlyObjectProperty<Worker.State>`	`состояние` Получает ReadOnlyObjectProperty, представляющий текущее состояние.
`ReadOnlyStringProperty`	`title` Получает ReadOnlyStringProperty, представляющий title.
`ReadOnlyDoubleProperty`	`totalWork` Получает ReadOnlyLongProperty, представляющий максимальный объем работы, который должен быть сделан.
`ReadOnlyObjectProperty<V>`	`значение` Получает ReadOnlyObjectProperty, представляющий значение.
`ReadOnlyDoubleProperty`	`workDone` Получает ReadOnlyLongProperty, представляющий текущее продвижение.

Вложенная Сводка Класса
- Вложенные классы/интерфейсы, наследованные от интерфейса javafx.concurrent. Рабочий
  Рабочий. Государство

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

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

Task()
Создает новую Задачу.

Конструкторы
Конструктор и Описание
`Task()` Создает новую Задачу.

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

Методы
Модификатор и Тип	Метод и Описание
`protected abstract V`	`call()` Вызванный, когда Задача выполняется, метод вызова должен быть переопределен и реализован подклассами.
`boolean`	`cancel()` Завершает выполнение этого Рабочего.
`boolean`	`cancel(boolean mayInterruptIfRunning)`
`ReadOnlyObjectProperty<java.lang.Throwable>`	`exceptionProperty()` Получает ReadOnlyObjectProperty, представляющий любое исключение, которое произошло.
`java.lang.Throwable`	`getException()` Указывает на исключение, которое произошло, в то время как Рабочий работал, если любой.
`java.lang.String`	`getMessage()` Связали сообщение с текущим состоянием этого Рабочего.
`double`	`getProgress()` Указывает на текущее продвижение этого Рабочего с точки зрения полного процента.
`Рабочий. Государство`	`getState()` Определяет текущее состояние этого Рабочего.
`java.lang.String`	`getTitle()` Дополнительный title, который должен быть связан с этим Рабочим.
`double`	`getTotalWork()` Указывает на максимальное значение для `Worker.workDoneProperty()` свойство.
`V`	`getValue()` Определяет значение, или результат, этого Рабочего.
`double`	`getWorkDone()` Указывает на текущий объем работы, который был завершен.
`boolean`	`isRunning()` Истина, если состояние или ПЛАНИРУЕТСЯ или ВЫПОЛНЕНИЕ.
`ReadOnlyStringProperty`	`messageProperty()` Получает ReadOnlyStringProperty, представляющий сообщение.
`ReadOnlyDoubleProperty`	`progressProperty()` Получает ReadOnlyLongProperty, представляющий продвижение.
`ReadOnlyBooleanProperty`	`runningProperty()` Получает представление ReadOnlyBooleanProperty, работает ли Рабочий.
`ReadOnlyObjectProperty<Worker.State>`	`stateProperty()` Получает ReadOnlyObjectProperty, представляющий текущее состояние.
`ReadOnlyStringProperty`	`titleProperty()` Получает ReadOnlyStringProperty, представляющий title.
`ReadOnlyDoubleProperty`	`totalWorkProperty()` Получает ReadOnlyLongProperty, представляющий максимальный объем работы, который должен быть сделан.
`protected void`	`updateMessage(java.lang.String message)` Обновления `message` свойство.
`protected void`	`updateProgress(long workDone, long max)` Обновления `workDone`, `totalWork`, и `progress` свойства.
`protected void`	`updateTitle(java.lang.String title)` Обновления `title` свойство.
`ReadOnlyObjectProperty<V>`	`valueProperty()` Получает ReadOnlyObjectProperty, представляющий значение.
`ReadOnlyDoubleProperty`	`workDoneProperty()` Получает ReadOnlyLongProperty, представляющий текущее продвижение.

Методы, наследованные от class java.util.concurrent. FutureTask
done, get, get, isCancelled, isDone, run, runAndReset, set, setException

Методы, наследованные от class java.lang. Объект
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Деталь свойства
  - состояние
    
    Определенный:
    
    stateProperty в интерфейсе Worker<V>
    
    Возвраты:
    См. Также:
    getState()
  - значение
    
    Определенный:
    
    valueProperty в интерфейсе Worker<V>
    
    Возвраты:
    См. Также:
    getValue()
  - исключение
    
    Определенный:
    
    exceptionProperty в интерфейсе Worker<V>
    
    Возвраты:
    См. Также:
    getException()
  - workDone
    
    Определенный:
    
    workDoneProperty в интерфейсе Worker<V>
    
    Возвраты:
    См. Также:
    getWorkDone()
  - totalWork
    
    Определенный:
    
    totalWorkProperty в интерфейсе Worker<V>
    
    Возвраты:
    См. Также:
    getTotalWork()
  - продвижение
    
    Определенный:
    
    progressProperty в интерфейсе Worker<V>
    
    Возвраты:
    См. Также:
    getProgress()
  - выполнение
    
    Определенный:
    
    runningProperty в интерфейсе Worker<V>
    
    Возвраты:
    См. Также:
    isRunning()
  - сообщение
    
    Определенный:
    
    messageProperty в интерфейсе Worker<V>
    
    Возвраты:
    См. Также:
    getMessage()
  - title
    
    Определенный:
    
    titleProperty в интерфейсе Worker<V>
    
    Возвраты:
    См. Также:
    getTitle()
- Деталь конструктора
  - Задача
```
public Task()
```
    Создает новую Задачу.
- Деталь метода
  - вызвать
```
protected abstract V call()
                   throws java.lang.Exception
```
    Вызванный, когда Задача выполняется, метод вызова должен быть переопределен и реализован подклассами. Метод вызова фактически выполняет логику фонового потока. Только updateProgress, updateMessage, и updateTitle методы Задачи можно вызвать от кода в пределах этого метода. Любое другое взаимодействие с Задачей от фонового потока приведет к исключениям на этапе выполнения.
    
    Возвраты:
    Результат фоновой работы, если любой.
    
    Броски:
    
    java.lang.Exception
  - getState
```
public final Worker.State getState()
```
    Описание скопировало с интерфейса: Worker
    
    Определяет текущее состояние этого Рабочего. Начальное значение является государством. ГОТОВЫЙ. Задача может быть перезапущена, когда она будет прогрессировать от одного из этого конечного состояния (СЛЕДОВАВШИЙ, ОТМЕНЕННЫЙ, или ОТКАЗАВШИЙ) назад к ГОТОВОМУ и затем сразу к ЗАПЛАНИРОВАННОМУ и РАБОЧЕМУ. Эти изменения состояния могут произойти сразу один за другим, но будут всегда происходить в предписанном порядке.
    
    Определенный:
    
    getState в интерфейсе Worker<V>
  - stateProperty
```
public final ReadOnlyObjectProperty<Worker.State> stateProperty()
```
    Описание скопировало с интерфейса: Worker
    
    Получает ReadOnlyObjectProperty, представляющий текущее состояние.
    
    Определенный:
    
    stateProperty в интерфейсе Worker<V>
    
    Возвраты:
    См. Также:
    getState()
  - getValue
```
public final V getValue()
```
    Описание скопировало с интерфейса: Worker
    
    Определяет значение, или результат, этого Рабочего. Это устанавливается после ввода состояния, за КОТОРЫМ СЛЕДУЮТ, и очищается (устанавливают в NULL), если Рабочий повторно инициализируется (то есть, если Рабочий является допускающим повторное использование Рабочим и сбрасывается или перезапускается).
    
    Определенный:
    
    getValue в интерфейсе Worker<V>
  - valueProperty
```
public final ReadOnlyObjectProperty<V> valueProperty()
```
    Описание скопировало с интерфейса: Worker
    
    Получает ReadOnlyObjectProperty, представляющий значение.
    
    Определенный:
    
    valueProperty в интерфейсе Worker<V>
    
    Возвраты:
    См. Также:
    getValue()
  - getException
```
public final java.lang.Throwable getException()
```
    Описание скопировало с интерфейса: Worker
    
    Указывает на исключение, которое произошло, в то время как Рабочий работал, если любой. Если это значение свойства null, нет никакого известного исключения, даже если состояние является ОТКАЗАВШИМ. Если это свойство не null, это будет наиболее вероятно содержать исключение, которое описывает причину отказа.
    
    Определенный:
    
    getException в интерфейсе Worker<V>
  - exceptionProperty
```
public final ReadOnlyObjectProperty<java.lang.Throwable> exceptionProperty()
```
    Описание скопировало с интерфейса: Worker
    
    Получает ReadOnlyObjectProperty, представляющий любое исключение, которое произошло.
    
    Определенный:
    
    exceptionProperty в интерфейсе Worker<V>
    
    Возвраты:
    См. Также:
    getException()
  - getWorkDone
```
public final double getWorkDone()
```
    Описание скопировало с интерфейса: Worker
    
    Указывает на текущий объем работы, который был завершен. Нуль или положительное значение указывают на продвижение к завершению. Значение этой переменной может или, возможно, не изменяется от его значения по умолчанию в зависимости от определенной реализации Рабочего. Значение-1 средства, что текущий сделанный объем работы не может быть определен (то есть: это неопределенно). Значение этого свойства всегда меньше чем или равно totalWork.
    
    Определенный:
    
    getWorkDone в интерфейсе Worker<V>
    
    См. Также:
    Worker.totalWorkProperty(), Worker.progressProperty()
  - workDoneProperty
```
public final ReadOnlyDoubleProperty workDoneProperty()
```
    Описание скопировало с интерфейса: Worker
    
    Получает ReadOnlyLongProperty, представляющий текущее продвижение.
    
    Определенный:
    
    workDoneProperty в интерфейсе Worker<V>
    
    Возвраты:
    См. Также:
    getWorkDone()
  - getTotalWork
```
public final double getTotalWork()
```
    Описание скопировало с интерфейса: Worker
    
    Указывает на максимальное значение для Worker.workDoneProperty() свойство. totalWork или будет-1 (указание, что объем работы, чтобы сделать неопределенен), или это будет ненулевое значение, меньше чем или равное Лонгу. MAX_VALUE.
    
    Определенный:
    
    getTotalWork в интерфейсе Worker<V>
    
    См. Также:
    Worker.workDoneProperty(), Worker.progressProperty()
  - totalWorkProperty
```
public final ReadOnlyDoubleProperty totalWorkProperty()
```
    Описание скопировало с интерфейса: Worker
    
    Получает ReadOnlyLongProperty, представляющий максимальный объем работы, который должен быть сделан. У этих "единиц работы" есть значение к реализации Рабочего, такой как число байтов, которые должны быть загружены или число изображений, чтобы обработать или некоторая другая такая метрика.
    
    Определенный:
    
    totalWorkProperty в интерфейсе Worker<V>
    
    Возвраты:
    См. Также:
    getTotalWork()
  - getProgress
```
public final double getProgress()
```
    Описание скопировало с интерфейса: Worker
    
    Указывает на текущее продвижение этого Рабочего с точки зрения полного процента. Значение между нулем и каждый указывает на продвижение к завершению. Значение-1 средства, что текущее продвижение не может быть определено (то есть, это неопределенно). Это свойство может или, возможно, не изменяется от его значения по умолчанию-1 в зависимости от определенной реализации Рабочего.
    
    Определенный:
    
    getProgress в интерфейсе Worker<V>
    
    См. Также:
    Worker.workDoneProperty(), Worker.totalWorkProperty()
  - progressProperty
```
public final ReadOnlyDoubleProperty progressProperty()
```
    Описание скопировало с интерфейса: Worker
    
    Получает ReadOnlyLongProperty, представляющий продвижение.
    
    Определенный:
    
    progressProperty в интерфейсе Worker<V>
    
    Возвраты:
    См. Также:
    getProgress()
  - isRunning
```
public final boolean isRunning()
```
    Описание скопировало с интерфейса: Worker
    
    Истина, если состояние или ПЛАНИРУЕТСЯ или ВЫПОЛНЕНИЕ. Связывая Рабочего с a ProgressIndicator, Вы будете обычно связывать видимость ProgressIndicator к рабочему свойству Рабочего, и продвижение ProgressIndicator к свойству продвижения Рабочего.
    
    Определенный:
    
    isRunning в интерфейсе Worker<V>
  - runningProperty
```
public final ReadOnlyBooleanProperty runningProperty()
```
    Описание скопировало с интерфейса: Worker
    
    Получает представление ReadOnlyBooleanProperty, работает ли Рабочий.
    
    Определенный:
    
    runningProperty в интерфейсе Worker<V>
    
    Возвраты:
    См. Также:
    isRunning()
  - getMessage
```
public final java.lang.String getMessage()
```
    Описание скопировало с интерфейса: Worker
    
    Связали сообщение с текущим состоянием этого Рабочего. Это может быть чем-то, таким как "Обработка изображения 1 из 3", например.
    
    Определенный:
    
    getMessage в интерфейсе Worker<V>
    
    Возвраты:
  - messageProperty
```
public final ReadOnlyStringProperty messageProperty()
```
    Описание скопировало с интерфейса: Worker
    
    Получает ReadOnlyStringProperty, представляющий сообщение.
    
    Определенный:
    
    messageProperty в интерфейсе Worker<V>
    
    Возвраты:
    См. Также:
    getMessage()
  - getTitle
```
public final java.lang.String getTitle()
```
    Описание скопировало с интерфейса: Worker
    
    Дополнительный title, который должен быть связан с этим Рабочим. Это может быть чем-то, таким как "Изменение Изображений".
    
    Определенный:
    
    getTitle в интерфейсе Worker<V>
    
    Возвраты:
  - titleProperty
```
public final ReadOnlyStringProperty titleProperty()
```
    Описание скопировало с интерфейса: Worker
    
    Получает ReadOnlyStringProperty, представляющий title.
    
    Определенный:
    
    titleProperty в интерфейсе Worker<V>
    
    Возвраты:
    См. Также:
    getTitle()
  - отмена
```
public final boolean cancel()
```
    Описание скопировало с интерфейса: Worker
    
    Завершает выполнение этого Рабочего. Вызов этого метода или удалит этого Рабочего из очереди выполнения или остановит выполнение.
    
    Определенный:
    
    cancel в интерфейсе Worker<V>
  - отмена
```
public boolean cancel(boolean mayInterruptIfRunning)
```
    Определенный:
    
    cancel в интерфейсе java.util.concurrent.Future<V>
    
    Переопределения:
    
    cancel в class java.util.concurrent.FutureTask<V>
  - updateProgress
```
protected void updateProgress(long workDone,
                  long max)
```
    Обновления workDone, totalWork, и progress свойства. Звонки updateProgress объединяются и выполняются позже поток приложения FX, и звонки updateProgress, даже от потока Приложения FX, возможно, не обязательно приводят к незамедлительным обновлениям до этих свойств, и промежуточное звено workDone значения может быть объединено, чтобы экономить на уведомлениях о событии. max становится новым значением для totalWork.
    Этим методом безопасно быть вызванным от любого потока.
    
    Параметры:
    workDone - Значение от-1 до максимального. Если значение больше чем максимальный, недопустимое исключение параметра выдается. Если значение, которое передают, будет-1, то получающийся сделанный процент будет-1 (таким образом, неопределенен).
    max - Значение от-1 до Лонга. MAX_VALUE. Любое значение вне этого диапазона приводит к IllegalArgumentException.
  - updateMessage
```
protected void updateMessage(java.lang.String message)
```
    Обновления message свойство. Звонки updateMessage объединяются и выполняются позже поток приложения FX, таким образом, звонки updateMessage, даже от потока Приложения FX, возможно, не обязательно приводят к незамедлительным обновлениям до этого свойства, и промежуточные значения сообщения могут быть объединены, чтобы экономить на уведомлениях о событии.
    Этим методом безопасно быть вызванным от любого потока.
    
    Параметры:
    message - новое сообщение
  - updateTitle
```
protected void updateTitle(java.lang.String title)
```
    Обновления title свойство. Звонки updateTitle объединяются и выполняются позже поток приложения FX, таким образом, звонки updateTitle, даже от потока Приложения FX, возможно, не обязательно приводят к незамедлительным обновлениям до этого свойства, и промежуточные значения title могут быть объединены, чтобы экономить на уведомлениях о событии.
    Этим методом безопасно быть вызванным от любого потока.
    
    Параметры:
    title - новый title

Задача <V> класса

Сводка свойства

Вложенная Сводка Класса

Вложенные классы/интерфейсы, наследованные от интерфейса javafx.concurrent. Рабочий

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

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

Методы, наследованные от class java.util.concurrent. FutureTask

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

Деталь свойства

состояние

значение

исключение

workDone

totalWork

продвижение

выполнение

сообщение

title

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

Задача

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

вызвать

getState

stateProperty

getValue

valueProperty

getException

exceptionProperty

getWorkDone

workDoneProperty

getTotalWork

totalWorkProperty

getProgress

progressProperty

isRunning

runningProperty

getMessage

messageProperty

getTitle

titleProperty

отмена

отмена

updateProgress

updateMessage

updateTitle