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

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

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

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

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

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

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

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

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