Интерфейс Worker<V>

Объект Worker выполняет некоторую работу в одном или нескольких фоновых потоках, состояние которого наблюдаемо и доступно приложениям JavaFX, а также используется из основного потока приложения JavaFX. Этот интерфейс в первую очередь реализуется как Task, так и Service, предоставляя общий API между обоими классами, что упрощает библиотекам и фреймворкам предоставление работников, которые хорошо работают при разработке пользовательских интерфейсов.

Работник может быть или не быть повторно используемым в зависимости от реализации. Например, Task не является повторно используемым, в то время как Service является.

Работник имеет четко определённый жизненный цикл. Каждый Работник начинается в состоянии Worker.State.READY. Когда Работник запланирован для работы (например, когда метод Service.start() сервиса Service вызывается), он переходит в состояние 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 устанавливается в значение true, когда состояние равно Worker.State.SCHEDULED или Worker.State.RUNNING.

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

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