Рабочий (JavaFX 2.2)

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

Служба, Задача
```
public interface Worker<V>
```
Рабочий является объектом, который выполняет некоторую работу в одном или более фоновых потоках, и кто состояние, заметно и доступен приложениям JavaFX и применим от основного потока Приложения JavaFX. Этот интерфейс прежде всего реализуется обоими Task и Service, обеспечение общего API и среди классов, который облегчает для библиотек и платформ предоставлять рабочим, которые работают хорошо, разрабатывая пользовательские интерфейсы.

Рабочий может или, возможно, не является допускающим повторное использование в зависимости от реализации. A Task, например, не является допускающим повторное использование в то время как a Service .

У Рабочего есть четко определенный жизненный цикл. Каждый Рабочий начинает в Worker.State.READY состояние. Когда Рабочий был запланирован для работы (например, когда Служба Service.start() метод вызывают), он переходится к Worker.State.SCHEDULED. Даже Рабочие, которые технически не планируются, но сразу запускаются (такой как с FutureTask.run()) перейдет через Worker.State.SCHEDULED продвигающийся к Worker.State.RUNNING состояние.

Когда Рабочий фактически выполнит его работу, состояние перейдется к Worker.State.RUNNING. Если Рабочий будет обычно завершаться, то это закончится в Worker.State.SUCCEEDED состояние, и результат Рабочего будут установлены как value свойство. Если однако Исключение произойдет во время выполнения Рабочего, то состояние будет установлено в Worker.State.FAILED и exception свойство будет установлено в Исключение, которое произошло.

В любое время до заключения Рабочего (то есть, если состояние уже не Worker.State.SUCCEEDED или Worker.State.FAILED) разработчик может вызвать cancel() метод. Если вызвано, Рабочий прекратит выполнение (если возможный, включая использование Thread.interrupt) и состояние, измененное на Worker.State.CANCELLED.

Единственное допустимое состояние начала для Рабочего Worker.State.READY, и допустимые конечные состояния Worker.State.CANCELLED, Worker.State.SUCCEEDED, и Worker.State.FAILED. running свойство устанавливается в истину, когда состояние также Worker.State.SCHEDULED или Worker.State.RUNNING.

Продвижение Рабочего может контролироваться через три различных свойства, totalWork, workDone, и progress. Эти свойства устанавливаются фактической реализацией интерфейса Рабочего, но могут наблюдаться любым. workDone число между-1 (значение неопределенного продвижения) и totalWork, включительно. Когда workDone == totalWork progress будут 100 % (или 1). totalWork будет число между-1 и Лонг. MAX_VALUE, включительно. Продвижение будет любой-1 (значение неопределенного), или значение между 0 и 1, включительно, представляя 0 % через 100 %.

Рабочий, который находится в Worker.State.READY или Worker.State.SCHEDULED состояния будут всегда иметь workDone и progress набор к-1. Рабочий, который находится в Worker.State.SUCCEEDED состояние будет всегда иметь workDone == totalWork и progress == 1. В любом другом состоянии значения для этих свойств могут быть любым значением в своих соответствующих допустимых диапазонах.

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

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

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

Вложенные Классы
Модификатор и Тип	Интерфейс и Описание
`static class`	`Рабочий. Государство` Состояние Рабочего.

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

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

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

Соедините интерфейсом с Рабочим <V>

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

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

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

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

состояние

значение

исключение

workDone

totalWork

продвижение

выполнение

сообщение

title

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

getState

stateProperty

getValue

valueProperty

getException

exceptionProperty

getWorkDone

workDoneProperty

getTotalWork

totalWorkProperty

getProgress

progressProperty

isRunning

runningProperty

getMessage

messageProperty

getTitle

titleProperty

отмена