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

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

Работник может быть или не быть повторно используемым в зависимости от реализации. Например, Task не является повторно используемым, а 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 устанавливается в true, когда состояние либо Worker.State.SCHEDULED, либо Worker.State.RUNNING.

Прогресс Работника можно отслеживать через три разных свойства, totalWork, workDone и progress. Эти свойства устанавливаются фактической реализацией интерфейса Работника, но могут быть просмотрены любым пользователем. 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. В любом другом состоянии значения этих свойств могут быть любыми значениями в их соответствующих допустимых диапазонах.