javafx.concurrent

Класс Service<V>

java.lang.Object

javafx.concurrent.Service<V>

Параметры типа:

V -

Все реализуемые интерфейсы:

Worker<V>, EventTarget

Прямые известные подклассы:

ScheduledService

public abstract class Service<V>
extends Object
implements Worker<V>, EventTarget

Сервис — это компонент, не отображаемый визуально, который инкапсулирует информацию, необходимую для выполнения некоторой работы в одном или нескольких фоновых потоках. В качестве части библиотеки пользовательского интерфейса JavaFX, сервис знает о потоке приложения JavaFX и предназначен для освобождения разработчика приложения от необходимости управления многопоточным кодом, взаимодействующим с пользовательским интерфейсом. Таким образом, все методы и состояния сервиса предназначены для вызова исключительно из потока приложения JavaFX. Единственное исключение из этого правила — первоначальная настройка сервиса, которая может безопасно выполняться из любого потока, и первоначальный запуск сервиса, который также может безопасно выполняться из любого потока. Однако после инициализации и запуска сервиса им можно пользоваться только из потока FX.

Сервис создаёт и управляет задачей Task, которая выполняет работу в фоновом потоке. Сервис реализует Worker. Таким образом, можно наблюдать за состоянием фоновой задачи и, при необходимости, отменить её. Сервис является многоразовой задачей, что означает, что его можно сбросить и перезапустить. Благодаря этому, сервис можно создавать декларативно и перезапускать по требованию. После запуска сервиса он запланирует свою задачу и будет отслеживать изменения состояния задачи. Задача не хранит ссылку на сервис, который её запустил, что означает, что выполняющаяся задача не помешает сервису быть удалённым из памяти.

Если для сервиса указан Executor, то он будет использован для фактического выполнения сервиса. В противном случае будет создан и запущен демонический поток. Если вы хотите создать потоки, которые не являются демоническими, укажите пользовательский Executor (например, вы можете использовать ThreadPoolExecutor с пользовательской ThreadFactory).

Поскольку сервис предназначен для упрощения декларативных сценариев использования, подклассы должны предоставлять свойства, являющиеся входными параметрами для выполняемой работы. Например, предположим, что я хочу написать сервис, который считывает первую строку из любого URL и возвращает её в виде строки. Такой сервис можно определить таким образом, чтобы он имел одно свойство, url. Его можно реализовать следующим образом:

public static class FirstLineService extends Service<String> {
         private StringProperty url = new SimpleStringProperty(this, "url");
         public final void setUrl(String value) { url.set(value); }
         public final String getUrl() { return url.get(); }
         public final StringProperty urlProperty() { return url; }

         protected Task createTask() {
             final String _url = getUrl();
             return new Task&ltString>() {
                 protected String call() throws Exception {
                     URL u = new URL(_url);
                     BufferedReader in = new BufferedReader(
                             new InputStreamReader(u.openStream()));
                     String result = in.readLine();
                     in.close();
                     return result;
                 }
             };
         }
     }

По умолчанию сервис использует пул потоков Executor с каким-то неопределённым значением по умолчанию или максимальным размером пула потоков. Это делается для того, чтобы код по умолчанию не перегружал систему, создавая тысячи потоков.

С тех пор:

JavaFX 2.0

Краткое описание свойств

Все методыМетоды экземпляраКонкретные методы
Тип	Свойство и описание
`ReadOnlyObjectProperty<Throwable>`	`exception` Возвращает ReadOnlyObjectProperty, представляющее любую возникшую ошибку.
`ObjectProperty<Executor>`	`executor` Исполнитель, который необходимо использовать для запуска этого сервиса.
`ReadOnlyStringProperty`	`message` Возвращает ReadOnlyStringProperty, представляющую сообщение.
`ObjectProperty<EventHandler<WorkerStateEvent>>`	`onCancelled` Обработчик события onCancelled вызывается всякий раз, когда состояние задачи переходит в состояние CANCELLED.
`ObjectProperty<EventHandler<WorkerStateEvent>>`	`onFailed` Обработчик события onFailed вызывается всякий раз, когда состояние задачи переходит в состояние FAILED.
`ObjectProperty<EventHandler<WorkerStateEvent>>`	`onReady` Обработчик события onReady вызывается всякий раз, когда состояние задачи переходит в состояние READY.
`ObjectProperty<EventHandler<WorkerStateEvent>>`	`onRunning` Обработчик события onRunning вызывается всякий раз, когда состояние задачи переходит в состояние RUNNING.
`ObjectProperty<EventHandler<WorkerStateEvent>>`	`onScheduled` Обработчик события onSchedule вызывается всякий раз, когда состояние задачи переходит в состояние SCHEDULED.
`ObjectProperty<EventHandler<WorkerStateEvent>>`	`onSucceeded` Обработчик события onSucceeded вызывается всякий раз, когда состояние задачи переходит в состояние SUCCEEDED.
`ReadOnlyDoubleProperty`	`progress` Возвращает ReadOnlyDoubleProperty, представляющее прогресс.
`ReadOnlyBooleanProperty`	`running` Возвращает ReadOnlyBooleanProperty, представляющее, работает ли Worker.
`ReadOnlyObjectProperty<Worker.State>`	`state` Возвращает ReadOnlyObjectProperty, представляющее текущее состояние.
`ReadOnlyStringProperty`	`title` Возвращает ReadOnlyStringProperty, представляющее заголовок.
`ReadOnlyDoubleProperty`	`totalWork` Возвращает ReadOnlyDoubleProperty, представляющее максимальное количество работы, которое необходимо выполнить.
`ReadOnlyObjectProperty<V>`	`value` Возвращает ReadOnlyObjectProperty, представляющее значение.
`ReadOnlyDoubleProperty`	`workDone` Возвращает ReadOnlyDoubleProperty, представляющее текущий прогресс.

Краткое описание вложенных классов
- Вложенные классы/интерфейсы, унаследованные от интерфейса javafx.concurrent.Worker
  Worker.State

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

Конструкторы
Модификатор Конструктор и описание

protected Service()
Создаёт новый сервис.

Конструкторы
Модификатор	Конструктор и описание
`protected`	`Service()` Создаёт новый сервис.

Краткое описание методов

Все методыМетоды экземпляровАбстрактные методыКонкретные методы
Модификатор и тип	Метод и описание
`<T extends Event> void`	`addEventFilter(EventType<T> eventType, EventHandler<? super T> eventFilter)` Регистрирует фильтр событий для этой задачи.
`<T extends Event> void`	`addEventHandler(EventType<T> eventType, EventHandler<? super T> eventHandler)` Регистрирует обработчик событий для этой задачи.
`EventDispatchChain`	`buildEventDispatchChain(EventDispatchChain tail)` Создаёт цепочку обработки событий для этой цели.
`boolean`	`cancel()` Отменяет любую текущую выполняющуюся задачу, если таковая есть.
`protected void`	`cancelled()` Защищённый вспомогательный метод для подклассов, вызываемый всякий раз, когда состояние службы переходит в состояние CANCELLED.
`protected abstract Task<V>`	`createTask()` Вызывается после запуска службы в потоке приложения JavaFX.
`ReadOnlyObjectProperty<Throwable>`	`exceptionProperty()` Возвращает ReadOnlyObjectProperty, представляющий любую произошедшую ошибку.
`protected void`	`executeTask(Task<V> task)` Использует `executor`, определённый в этой службе, для выполнения заданной задачи.
`ObjectProperty<Executor>`	`executorProperty()` Исполнитель, используемый для выполнения этой службы.
`protected void`	`failed()` Защищённый вспомогательный метод для подклассов, вызываемый всякий раз, когда состояние службы переходит в состояние FAILED.
`protected void`	`fireEvent(Event event)` Вызывает указанное событие.
`Throwable`	`getException()` Возвращает значение свойства exception.
`Executor`	`getExecutor()` Возвращает значение свойства executor.
`String`	`getMessage()` Возвращает значение свойства message.
`EventHandler<WorkerStateEvent>`	`getOnCancelled()` Обработчик события onCancelled вызывается всякий раз, когда состояние задачи переходит в состояние CANCELLED.
`EventHandler<WorkerStateEvent>`	`getOnFailed()` Обработчик события onFailed вызывается всякий раз, когда состояние задачи переходит в состояние FAILED.
`EventHandler<WorkerStateEvent>`	`getOnReady()` Обработчик события onReady вызывается всякий раз, когда состояние задачи переходит в состояние READY.
`EventHandler<WorkerStateEvent>`	`getOnRunning()` Обработчик события onRunning вызывается всякий раз, когда состояние задачи переходит в состояние RUNNING.
`EventHandler<WorkerStateEvent>`	`getOnScheduled()` Обработчик события onSchedule вызывается всякий раз, когда состояние задачи переходит в состояние SCHEDULED.
`EventHandler<WorkerStateEvent>`	`getOnSucceeded()` Обработчик события onSucceeded вызывается всякий раз, когда состояние задачи переходит в состояние SUCCEEDED.
`double`	`getProgress()` Возвращает значение свойства progress.
`Worker.State`	`getState()` Возвращает значение свойства state.
`String`	`getTitle()` Возвращает значение свойства title.
`double`	`getTotalWork()` Возвращает значение свойства totalWork.
`V`	`getValue()` Возвращает значение свойства value.
`double`	`getWorkDone()` Возвращает значение свойства workDone.
`boolean`	`isRunning()` Возвращает значение свойства running.
`ReadOnlyStringProperty`	`messageProperty()` Возвращает ReadOnlyStringProperty, представляющий сообщение.
`ObjectProperty<EventHandler<WorkerStateEvent>>`	`onCancelledProperty()` Обработчик события onCancelled вызывается всякий раз, когда состояние задачи переходит в состояние CANCELLED.
`ObjectProperty<EventHandler<WorkerStateEvent>>`	`onFailedProperty()` Обработчик события onFailed вызывается всякий раз, когда состояние задачи переходит в состояние FAILED.
`ObjectProperty<EventHandler<WorkerStateEvent>>`	`onReadyProperty()` Обработчик события onReady вызывается всякий раз, когда состояние задачи переходит в состояние READY.
`ObjectProperty<EventHandler<WorkerStateEvent>>`	`onRunningProperty()` Обработчик события onRunning вызывается всякий раз, когда состояние задачи переходит в состояние RUNNING.
`ObjectProperty<EventHandler<WorkerStateEvent>>`	`onScheduledProperty()` Обработчик события onSchedule вызывается всякий раз, когда состояние задачи переходит в состояние SCHEDULED.
`ObjectProperty<EventHandler<WorkerStateEvent>>`	`onSucceededProperty()` Обработчик события onSucceeded вызывается всякий раз, когда состояние задачи переходит в состояние SUCCEEDED.
`ReadOnlyDoubleProperty`	`progressProperty()` Возвращает ReadOnlyDoubleProperty, представляющий прогресс.
`protected void`	`ready()` Защищённый вспомогательный метод для подклассов, вызываемый всякий раз, когда состояние службы переходит в состояние READY.
`<T extends Event> void`	`removeEventFilter(EventType<T> eventType, EventHandler<? super T> eventFilter)` Отменяет ранее зарегистрированный фильтр событий из этой задачи.
`<T extends Event> void`	`removeEventHandler(EventType<T> eventType, EventHandler<? super T> eventHandler)` Отменяет ранее зарегистрированный обработчик событий из этой задачи.
`void`	`reset()` Сбрасывает состояние службы.
`void`	`restart()` Отменяет любую текущую выполняющуюся задачу, если таковая есть, и перезапускает эту службу.
`protected void`	`running()` Защищённый вспомогательный метод для подклассов, вызываемый всякий раз, когда состояние службы переходит в состояние RUNNING.
`ReadOnlyBooleanProperty`	`runningProperty()` Возвращает ReadOnlyBooleanProperty, представляющий, запущена ли задача.
`protected void`	`scheduled()` Защищённый вспомогательный метод для подклассов, вызываемый всякий раз, когда состояние службы переходит в состояние SCHEDULED.
`protected <T extends Event> void`	`setEventHandler(EventType<T> eventType, EventHandler<? super T> eventHandler)` Устанавливает обработчик для использования с этим типом события.
`void`	`setExecutor(Executor value)` Устанавливает значение свойства executor.
`void`	`setOnCancelled(EventHandler<WorkerStateEvent> value)` Обработчик события onCancelled вызывается всякий раз, когда состояние задачи переходит в состояние CANCELLED.
`void`	`setOnFailed(EventHandler<WorkerStateEvent> value)` Обработчик события onFailed вызывается всякий раз, когда состояние задачи переходит в состояние FAILED.
`void`	`setOnReady(EventHandler<WorkerStateEvent> value)` Обработчик события onReady вызывается всякий раз, когда состояние задачи переходит в состояние READY.
`void`	`setOnRunning(EventHandler<WorkerStateEvent> value)` Обработчик события onRunning вызывается всякий раз, когда состояние задачи переходит в состояние RUNNING.
`void`	`setOnScheduled(EventHandler<WorkerStateEvent> value)` Обработчик события onSchedule вызывается всякий раз, когда состояние задачи переходит в состояние SCHEDULED.
`void`	`setOnSucceeded(EventHandler<WorkerStateEvent> value)` Обработчик события onSucceeded вызывается всякий раз, когда состояние задачи переходит в состояние SUCCEEDED.
`void`	`start()` Запускает эту службу.
`ReadOnlyObjectProperty<Worker.State>`	`stateProperty()` Возвращает ReadOnlyObjectProperty, представляющий текущее состояние.
`protected void`	`succeeded()` Защищённый вспомогательный метод для подклассов, вызываемый всякий раз, когда состояние службы переходит в состояние SUCCEEDED.
`ReadOnlyStringProperty`	`titleProperty()` Возвращает ReadOnlyStringProperty, представляющий заголовок.
`ReadOnlyDoubleProperty`	`totalWorkProperty()` Возвращает ReadOnlyDoubleProperty, представляющий максимальное количество работы, которое необходимо выполнить.
`ReadOnlyObjectProperty<V>`	`valueProperty()` Возвращает ReadOnlyObjectProperty, представляющий значение.
`ReadOnlyDoubleProperty`	`workDoneProperty()` Возвращает ReadOnlyDoubleProperty, представляющий текущий прогресс.

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

Подробное описание свойств
- state
```
public final ReadOnlyObjectProperty<Worker.State> stateProperty
```
  Определено:
  
  stateProperty в интерфейсе Worker<V>
  
  Возвращает:
  
  Свойство, представляющее состояние
  
  См. также:
  
  getState()
- value
```
public final ReadOnlyObjectProperty<V> valueProperty
```
  Определено:
  
  valueProperty в интерфейсе Worker<V>
  
  Возвращает:
  
  Свойство, представляющее текущее значение
  
  См. также:
  
  getValue()
- exception
```
public final ReadOnlyObjectProperty<Throwable> exceptionProperty
```
  Определено:
  
  exceptionProperty в интерфейсе Worker<V>
  
  Возвращает:
  
  Свойство, представляющее исключение
  
  См. также:
  
  getException()
- workDone
```
public final ReadOnlyDoubleProperty workDoneProperty
```
  Определено:
  
  workDoneProperty в интерфейсе Worker<V>
  
  Возвращает:
  
  Свойство, представляющее объём выполненной работы
  
  См. также:
  
  getWorkDone()
- totalWork
```
public final ReadOnlyDoubleProperty totalWorkProperty
```
  Определено:
  
  totalWorkProperty в интерфейсе Worker<V>
  
  Возвращает:
  
  Свойство, представляющее общий объём работы
  
  См. также:
  
  getTotalWork()
- progress
```
public final ReadOnlyDoubleProperty progressProperty
```
  Определено:
  
  progressProperty в интерфейсе Worker<V>
  
  Возвращает:
  
  Свойство, представляющее прогресс
  
  См. также:
  
  getProgress()
- running
```
public final ReadOnlyBooleanProperty runningProperty
```
  Определено:
  
  runningProperty в интерфейсе Worker<V>
  
  Возвращает:
  
  Свойство, представляющее, запущен ли рабочий процесс
  
  См. также:
  
  isRunning()
- message
```
public final ReadOnlyStringProperty messageProperty
```
  Определено:
  
  messageProperty в интерфейсе Worker<V>
  
  Возвращает:
  
  Свойство, представляющее текущее сообщение
  
  См. также:
  
  getMessage()
- title
```
public final ReadOnlyStringProperty titleProperty
```
  Определено:
  
  titleProperty в интерфейсе Worker<V>
  
  Возвращает:
  
  Свойство, представляющее текущий заголовок
  
  См. также:
  
  getTitle()
- executor
```
public final ObjectProperty<Executor> executorProperty
```
  Используемый исполняющий механизм для запуска этого сервиса. Если не указан, то будет создан новый демон-поток и использован для запуска сервиса с использованием некоторого стандартного исполняющего механизма.
  
  См. также:
  
  getExecutor(), setExecutor(Executor)
- onReady
```
public final ObjectProperty<EventHandler<WorkerStateEvent>> onReadyProperty
```
  Обработчик события onReady вызывается всякий раз, когда состояние задачи переходит в состояние READY.
  
  С:
  
  JavaFX 2.1
  
  См. также:
  
  getOnReady(), setOnReady(EventHandler)
- onScheduled
```
public final ObjectProperty<EventHandler<WorkerStateEvent>> onScheduledProperty
```
  Обработчик события onSchedule вызывается всякий раз, когда состояние задачи переходит в состояние SCHEDULED.
  
  С:
  
  JavaFX 2.1
  
  См. также:
  
  getOnScheduled(), setOnScheduled(EventHandler)
- onRunning
```
public final ObjectProperty<EventHandler<WorkerStateEvent>> onRunningProperty
```
  Обработчик события onRunning вызывается всякий раз, когда состояние задачи переходит в состояние RUNNING.
  
  С:
  
  JavaFX 2.1
  
  См. также:
  
  getOnRunning(), setOnRunning(EventHandler)
- onSucceeded
```
public final ObjectProperty<EventHandler<WorkerStateEvent>> onSucceededProperty
```
  Обработчик события onSucceeded вызывается всякий раз, когда состояние задачи переходит в состояние SUCCEEDED.
  
  С:
  
  JavaFX 2.1
  
  См. также:
  
  getOnSucceeded(), setOnSucceeded(EventHandler)
- onCancelled
```
public final ObjectProperty<EventHandler<WorkerStateEvent>> onCancelledProperty
```
  Обработчик события onCancelled вызывается всякий раз, когда состояние задачи переходит в состояние CANCELLED.
  
  С:
  
  JavaFX 2.1
  
  См. также:
  
  getOnCancelled(), setOnCancelled(EventHandler)
- onFailed
```
public final ObjectProperty<EventHandler<WorkerStateEvent>> onFailedProperty
```
  Обработчик события onFailed вызывается всякий раз, когда состояние задачи переходит в состояние FAILED.
  
  С:
  
  JavaFX 2.1
  
  См. также:
  
  getOnFailed(), setOnFailed(EventHandler)

Подробное описание конструкторов
- Service
```
protected Service()
```
  Создаёт новый сервис.

Подробное описание метода
- getState
```
public final Worker.State getState()
```
  Получает значение свойства state.
  
  Определено в:
  
  getState в интерфейсе Worker<V>
  
  Возвращает:
  
  Текущее состояние этого Worker
- stateProperty
```
public final ReadOnlyObjectProperty<Worker.State> stateProperty()
```
  Описание скопировано из интерфейса: Worker
  
  Получает ReadOnlyObjectProperty, представляющее текущее состояние.
  
  Определено в:
  
  stateProperty в интерфейсе Worker<V>
  
  Возвращает:
  
  Свойство, представляющее состояние
  
  См. также:
  
  getState()
- getValue
```
public final V getValue()
```
  Получает значение свойства value.
  
  Определено в:
  
  getValue в интерфейсе Worker<V>
  
  Возвращает:
  
  текущее значение этого Worker
- valueProperty
```
public final ReadOnlyObjectProperty<V> valueProperty()
```
  Описание скопировано из интерфейса: Worker
  
  Получает ReadOnlyObjectProperty, представляющее значение.
  
  Определено в:
  
  valueProperty в интерфейсе Worker<V>
  
  Возвращает:
  
  Свойство, представляющее текущее значение
  
  См. также:
  
  getValue()
- getException
```
public final Throwable getException()
```
  Получает значение свойства exception.
  
  Определено в:
  
  getException в интерфейсе Worker<V>
  
  Возвращает:
  
  исключение, если оно возникло
- exceptionProperty
```
public final ReadOnlyObjectProperty<Throwable> exceptionProperty()
```
  Описание скопировано из интерфейса: Worker
  
  Получает ReadOnlyObjectProperty, представляющее любое возникшее исключение.
  
  Определено в:
  
  exceptionProperty в интерфейсе Worker<V>
  
  Возвращает:
  
  свойство, представляющее исключение
  
  См. также:
  
  getException()
- getWorkDone
```
public final double getWorkDone()
```
  Получает значение свойства workDone.
  
  Определено в:
  
  getWorkDone в интерфейсе Worker<V>
  
  Возвращает:
  
  выполненная работа
  
  См. также:
  
  Worker.totalWorkProperty(), Worker.progressProperty()
- workDoneProperty
```
public final ReadOnlyDoubleProperty workDoneProperty()
```
  Описание скопировано из интерфейса: Worker
  
  Получает ReadOnlyDoubleProperty, представляющее текущий прогресс.
  
  Определено в:
  
  workDoneProperty в интерфейсе Worker<V>
  
  Возвращает:
  
  Свойство, представляющее объем выполненной работы
  
  См. также:
  
  getWorkDone()
- getTotalWork
```
public final double getTotalWork()
```
  Получает значение свойства totalWork.
  
  Определено в:
  
  getTotalWork в интерфейсе Worker<V>
  
  Возвращает:
  
  общий объем работы
  
  См. также:
  
  Worker.workDoneProperty(), Worker.progressProperty()
- totalWorkProperty
```
public final ReadOnlyDoubleProperty totalWorkProperty()
```
  Описание скопировано из интерфейса: Worker
  
  Получает ReadOnlyDoubleProperty, представляющее максимальный объем работы, который необходимо выполнить. Эти «единицы работы» имеют значение для реализации Worker, например, количество байтов, которые необходимо загрузить, количество изображений для обработки или какой-либо другой показатель.
  
  Определено в:
  
  totalWorkProperty в интерфейсе Worker<V>
  
  Возвращает:
  
  свойство, представляющее общий объем работы
  
  См. также:
  
  getTotalWork()
- getProgress
```
public final double getProgress()
```
  Получает значение свойства progress.
  
  Определено в:
  
  getProgress в интерфейсе Worker<V>
  
  Возвращает:
  
  текущий прогресс
  
  См. также:
  
  Worker.workDoneProperty(), Worker.totalWorkProperty()
- progressProperty
```
public final ReadOnlyDoubleProperty progressProperty()
```
  Описание скопировано из интерфейса: Worker
  
  Получает ReadOnlyDoubleProperty, представляющее прогресс.
  
  Определено в:
  
  progressProperty в интерфейсе Worker<V>
  
  Возвращает:
  
  свойство, представляющее прогресс
  
  См. также:
  
  getProgress()
- isRunning
```
public final boolean isRunning()
```
  Получает значение свойства running.
  
  Определено в:
  
  isRunning в интерфейсе Worker<V>
  
  Возвращает:
  
  true, если этот Worker запущен
- runningProperty
```
public final ReadOnlyBooleanProperty runningProperty()
```
  Описание скопировано из интерфейса: Worker
  
  Получает ReadOnlyBooleanProperty, представляющее, запущен ли Worker.
  
  Определено в:
  
  runningProperty в интерфейсе Worker<V>
  
  Возвращает:
  
  свойство, представляющее, запущен ли рабочий
  
  См. также:
  
  isRunning()
- getMessage
```
public final String getMessage()
```
  Получает значение свойства message.
  
  Определено в:
  
  getMessage в интерфейсе Worker<V>
  
  Возвращает:
  
  текущее сообщение
- messageProperty
```
public final ReadOnlyStringProperty messageProperty()
```
  Описание скопировано из интерфейса: Worker
  
  Получает ReadOnlyStringProperty, представляющее сообщение.
  
  Определено в:
  
  messageProperty в интерфейсе Worker<V>
  
  Возвращает:
  
  свойство, представляющее текущее сообщение
  
  См. также:
  
  getMessage()
- getTitle
```
public final String getTitle()
```
  Получает значение свойства title.
  
  Определено в:
  
  getTitle в интерфейсе Worker<V>
  
  Возвращает:
  
  текущее название
- titleProperty
```
public final ReadOnlyStringProperty titleProperty()
```
  Описание скопировано из интерфейса: Worker
  
  Получает ReadOnlyStringProperty, представляющее название.
  
  Определено в:
  
  titleProperty в интерфейсе Worker<V>
  
  Возвращает:
  
  свойство, представляющее текущее название
  
  См. также:
  
  getTitle()
- setExecutor
```
public final void setExecutor(Executor value)
```
  Устанавливает значение свойства executor.
  
  Описание свойства:
  
  Исполнитель, используемый для запуска этого сервиса. Если исполнитель не указан, будет создан новый демон-поток и будет использован для запуска сервиса с помощью некоторого стандартного исполнителя.
- getExecutor
```
public final Executor getExecutor()
```
  Получает значение свойства executor.
  
  Описание свойства:
  
  Исполнитель, используемый для запуска этого сервиса. Если исполнитель не указан, будет создан новый демон-поток и будет использован для запуска сервиса с помощью некоторого стандартного исполнителя.
- executorProperty
```
public final ObjectProperty<Executor> executorProperty()
```
  Исполнитель, используемый для запуска этого сервиса. Если исполнитель не указан, будет создан новый демон-поток и будет использован для запуска сервиса с помощью некоторого стандартного исполнителя.
  
  См. также:
  
  getExecutor(), setExecutor(Executor)
- onReadyProperty
```
public final ObjectProperty<EventHandler<WorkerStateEvent>> onReadyProperty()
```
  Обработчик события onReady вызывается всякий раз, когда состояние задачи переходит в состояние READY.
  
  С момента:
  
  JavaFX 2.1
  
  См. также:
  
  getOnReady(), setOnReady(EventHandler)
- getOnReady
```
public final EventHandler<WorkerStateEvent> getOnReady()
```
  Обработчик события onReady вызывается всякий раз, когда состояние задачи переходит в состояние READY.
  
  Возвращает:
  
  обработчик события onReady, если он есть
  
  С момента:
  
  JavaFX 2.1
- setOnReady
```
public final void setOnReady(EventHandler<WorkerStateEvent> value)
```
  Обработчик события onReady вызывается всякий раз, когда состояние задачи переходит в состояние READY.
  
  Параметры:
  
  value - обработчик события, может быть null для его очистки
  
  С момента:
  
  JavaFX 2.1
- ready
```
protected void ready()
```
  Защищенный вспомогательный метод для подклассов, вызываемый всякий раз, когда состояние сервиса переходит в состояние READY. Этот метод вызывается после того, как сервис был полностью переведен в новое состояние.
  
  С момента:
  
  JavaFX 2.1

- onScheduledProperty
```
public final ObjectProperty<EventHandler<WorkerStateEvent>> onScheduledProperty()
```
  Обработчик события onSchedule вызывается всякий раз, когда состояние задачи переходит в состояние SCHEDULED.
  
  С момента:
  
  JavaFX 2.1
  
  См. также:
  
  getOnScheduled(), setOnScheduled(EventHandler)
- getOnScheduled
```
public final EventHandler<WorkerStateEvent> getOnScheduled()
```
  Обработчик события onSchedule вызывается всякий раз, когда состояние задачи переходит в состояние SCHEDULED.
  
  Возвращает:
  
  обработчик события onScheduled, если таковой есть
  
  С момента:
  
  JavaFX 2.1
- setOnScheduled
```
public final void setOnScheduled(EventHandler<WorkerStateEvent> value)
```
  Обработчик события onSchedule вызывается всякий раз, когда состояние задачи переходит в состояние SCHEDULED.
  
  Параметры:
  
  value - обработчик событий, может быть null для его очистки
  
  С момента:
  
  JavaFX 2.1
- scheduled
```
protected void scheduled()
```
  Защищённый вспомогательный метод для подклассов, вызываемый всякий раз, когда состояние службы переходит в состояние SCHEDULED. Этот метод вызывается после того, как служба полностью перешла в новое состояние.
  
  С момента:
  
  JavaFX 2.1
- onRunningProperty
```
public final ObjectProperty<EventHandler<WorkerStateEvent>> onRunningProperty()
```
  Обработчик события onRunning вызывается всякий раз, когда состояние задачи переходит в состояние RUNNING.
  
  С момента:
  
  JavaFX 2.1
  
  См. также:
  
  getOnRunning(), setOnRunning(EventHandler)
- getOnRunning
```
public final EventHandler<WorkerStateEvent> getOnRunning()
```
  Обработчик события onRunning вызывается всякий раз, когда состояние задачи переходит в состояние RUNNING.
  
  Возвращает:
  
  обработчик события onRunning, если таковой есть
  
  С момента:
  
  JavaFX 2.1
- setOnRunning
```
public final void setOnRunning(EventHandler<WorkerStateEvent> value)
```
  Обработчик события onRunning вызывается всякий раз, когда состояние задачи переходит в состояние RUNNING.
  
  Параметры:
  
  value - обработчик событий, может быть null для его очистки
  
  С момента:
  
  JavaFX 2.1
- running
```
protected void running()
```
  Защищённый вспомогательный метод для подклассов, вызываемый всякий раз, когда состояние службы переходит в состояние RUNNING. Этот метод вызывается после того, как служба полностью перешла в новое состояние.
  
  С момента:
  
  JavaFX 2.1
- onSucceededProperty
```
public final ObjectProperty<EventHandler<WorkerStateEvent>> onSucceededProperty()
```
  Обработчик события onSucceeded вызывается всякий раз, когда состояние задачи переходит в состояние SUCCEEDED.
  
  С момента:
  
  JavaFX 2.1
  
  См. также:
  
  getOnSucceeded(), setOnSucceeded(EventHandler)
- getOnSucceeded
```
public final EventHandler<WorkerStateEvent> getOnSucceeded()
```
  Обработчик события onSucceeded вызывается всякий раз, когда состояние задачи переходит в состояние SUCCEEDED.
  
  Возвращает:
  
  обработчик события onSucceeded, если таковой есть
  
  С момента:
  
  JavaFX 2.1
- setOnSucceeded
```
public final void setOnSucceeded(EventHandler<WorkerStateEvent> value)
```
  Обработчик события onSucceeded вызывается всякий раз, когда состояние задачи переходит в состояние SUCCEEDED.
  
  Параметры:
  
  value - обработчик событий, может быть null для его очистки
  
  С момента:
  
  JavaFX 2.1
- succeeded
```
protected void succeeded()
```
  Защищённый вспомогательный метод для подклассов, вызываемый всякий раз, когда состояние службы переходит в состояние SUCCEEDED. Этот метод вызывается после того, как служба полностью перешла в новое состояние.
  
  С момента:
  
  JavaFX 2.1
- onCancelledProperty
```
public final ObjectProperty<EventHandler<WorkerStateEvent>> onCancelledProperty()
```
  Обработчик события onCancelled вызывается всякий раз, когда состояние задачи переходит в состояние CANCELLED.
  
  С момента:
  
  JavaFX 2.1
  
  См. также:
  
  getOnCancelled(), setOnCancelled(EventHandler)
- getOnCancelled
```
public final EventHandler<WorkerStateEvent> getOnCancelled()
```
  Обработчик события onCancelled вызывается всякий раз, когда состояние задачи переходит в состояние CANCELLED.
  
  Возвращает:
  
  обработчик события onCancelled, если таковой есть
  
  С момента:
  
  JavaFX 2.1
- setOnCancelled
```
public final void setOnCancelled(EventHandler<WorkerStateEvent> value)
```
  Обработчик события onCancelled вызывается всякий раз, когда состояние задачи переходит в состояние CANCELLED.
  
  Параметры:
  
  value - обработчик событий, может быть null для его очистки
  
  С момента:
  
  JavaFX 2.1
- cancelled
```
protected void cancelled()
```
  Защищённый вспомогательный метод для подклассов, вызываемый всякий раз, когда состояние службы переходит в состояние CANCELLED. Этот метод вызывается после того, как служба полностью перешла в новое состояние.
  
  С момента:
  
  JavaFX 2.1
- onFailedProperty
```
public final ObjectProperty<EventHandler<WorkerStateEvent>> onFailedProperty()
```
  Обработчик события onFailed вызывается всякий раз, когда состояние задачи переходит в состояние FAILED.
  
  С момента:
  
  JavaFX 2.1
  
  См. также:
  
  getOnFailed(), setOnFailed(EventHandler)
- getOnFailed
```
public final EventHandler<WorkerStateEvent> getOnFailed()
```
  Обработчик события onFailed вызывается всякий раз, когда состояние задачи переходит в состояние FAILED.
  
  Возвращает:
  
  обработчик события onFailed, если таковой есть
  
  С момента:
  
  JavaFX 2.1
- setOnFailed
```
public final void setOnFailed(EventHandler<WorkerStateEvent> value)
```
  Обработчик события onFailed вызывается всякий раз, когда состояние задачи переходит в состояние FAILED.
  
  Параметры:
  
  value - обработчик событий, может быть null для его очистки
  
  С момента:
  
  JavaFX 2.1
- failed
```
protected void failed()
```
  Защищённый вспомогательный метод для подклассов, вызываемый всякий раз, когда состояние службы переходит в состояние FAILED. Этот метод вызывается после того, как служба полностью перешла в новое состояние.
  
  С момента:
  
  JavaFX 2.1
- cancel
```
public boolean cancel()
```
  Отменяет любую текущую выполняющуюся задачу, если она есть. Состояние будет установлено в CANCELLED.
  
  Указано в:
  
  cancel в интерфейсе Worker<V>
  
  Возвращает:
  
  возвращает true, если отмена прошла успешно
- restart
```
public void restart()
```
  Отменяет любую текущую выполняющуюся задачу, если она есть, и перезапускает эту службу. Состояние будет сброшено в READY перед выполнением. Этот метод должен вызываться только в потоке FX-приложения.
- reset
```
public void reset()
```
  Сбрасывает состояние службы. Может быть вызван только в одном из конечных состояний, то есть SUCCEEDED, FAILED или CANCELLED, или когда READY. Этот метод должен вызываться только в потоке FX-приложения.
- start
```
public void start()
```
  Запускает эту службу. Служба должна быть в состоянии READY, чтобы этот вызов был успешным. Этот метод должен вызываться только в потоке FX-приложения.
- executeTask
```
protected void executeTask(Task<V> task)
```
  Использует executor, определённый в этой службе, для выполнения заданной задачи. Если executor равно null, то используется исполняющий механизм по умолчанию, который создаст новый демон-поток для выполнения этой задачи.
  
  Этот метод предназначен только для вызова реализацией службы.
  
  Параметры:
  
  task - непустая задача для выполнения
  
  С момента:
  
  JavaFX 2.1
- addEventHandler
```
public final <T extends Event> void addEventHandler(EventType<T> eventType,
                                                    EventHandler<? super T> eventHandler)
```
  Регистрирует обработчик событий в этой задаче. Сначала обрабатываются любые фильтры событий, затем указанные обработчики событий onFoo, а затем любые обработчики событий, зарегистрированные этим методом. Как и в случае с другими событиями в графическом представлении сцены, если событие потребляется, оно не будет продолжать распространение.
  
  Параметры типа:
  
  T - конкретный класс событий обработчика
  
  Параметры:
  
  eventType - тип событий, которые должен получать обработчик
  
  Исключения:
  
  NullPointerException - если тип события или обработчик равны null
  
  С момента:
  
  JavaFX 2.1
- removeEventHandler
```
public final <T extends Event> void removeEventHandler(EventType<T> eventType,
                                                       EventHandler<? super T> eventHandler)
```
  Удаляет ранее зарегистрированный обработчик событий из этой задачи. Один обработчик может быть зарегистрирован для разных типов событий, поэтому вызывающая сторона должна указать конкретный тип события, из которого нужно удалить обработчик.
  
  Параметры типа:
  
  T - конкретный класс событий обработчика
  
  Параметры:
  
  eventType - тип события, из которого нужно удалить обработчик
  
  Исключения:
  
  NullPointerException - если тип события или обработчик равны null
  
  С момента:
  
  JavaFX 2.1
- addEventFilter
```
public final <T extends Event> void addEventFilter(EventType<T> eventType,
                                                   EventHandler<? super T> eventFilter)
```
  Регистрирует фильтр событий в этой задаче. Зарегистрированные фильтры событий получают событие до любого связанного обработчика событий.
  
  Параметры типа:
  
  T - конкретный класс событий фильтра
  
  Параметры:
  
  eventType - тип событий, которые должен получать фильтр
  
  Исключения:
  
  NullPointerException - если тип события или фильтр равны null
  
  С момента:
  
  JavaFX 2.1

- removeEventFilter
```
public final <T extends Event> void removeEventFilter(EventType<T> eventType,
                                                      EventHandler<? super T> eventFilter)
```
  Отменяет регистрацию ранее зарегистрированного фильтра событий для этой задачи. Один фильтр может быть зарегистрирован для разных типов событий, поэтому вызывающий код должен указать конкретный тип события, из которого нужно снять регистрацию фильтра.
  
  Type Parameters:
  
  T - конкретный класс события фильтра
  
  Parameters:
  
  eventType - тип события, из которого нужно снять регистрацию
  
  Throws:
  
  NullPointerException - если тип события или фильтр равен null
  
  Since:
  
  JavaFX 2.1
- setEventHandler
```
protected final <T extends Event> void setEventHandler(EventType<T> eventType,
                                                       EventHandler<? super T> eventHandler)
```
  Устанавливает обработчик для этого типа события. Одновременно можно указать только один такой обработчик. Этот обработчик гарантированно вызывается первым. Используется для регистрации пользовательских обработчиков событий onFoo.
  
  Type Parameters:
  
  T - конкретный класс события обработчика
  
  Parameters:
  
  eventType - тип события, который нужно связать с данным eventHandler
  
  Throws:
  
  NullPointerException - если тип события равен null
  
  Since:
  
  JavaFX 2.1
- fireEvent
```
protected final void fireEvent(Event event)
```
  Возбуждает указанное событие. Любой встреченный фильтр событий будет уведомлён и сможет потреблять событие. Если событие не будет потреблено фильтрами, будут уведомлены обработчики событий в этой задаче. Если и они не потребят событие, то будут вызваны все обработчики событий и смогут потреблять событие.
  Этот метод должен вызываться в потоке FX пользователя.
  
  Parameters:
  
  event - событие для возбуждения
  
  Since:
  
  JavaFX 2.1
- buildEventDispatchChain
```
public EventDispatchChain buildEventDispatchChain(EventDispatchChain tail)
```
  Описание скопировано из интерфейса: EventTarget
  
  Создаёт цепочку обработки событий для этого целевого объекта. Цепочка обработки событий содержит диспетчеры событий, которые могут быть заинтересованы в обработке событий, направленных на этот EventTarget. Этот целевой объект событий не добавляется в цепочку автоматически, поэтому, если он хочет обрабатывать события, ему нужно добавить свой EventDispatcher в цепочку.
  В случае, если целевой объект событий является частью иерархии, цепочка для него обычно строится из диспетчеров событий, собранных от корня иерархии до целевого объекта событий.
  
  Цепочка обработки событий строится путём модификации предоставленной начальной цепочки обработки событий. Возвращаемая цепочка должна содержать начальную цепочку в конце, поэтому диспетчеры должны быть добавлены перед начальной цепочкой.
  
  Вызывающий код не должен предполагать, что начальная цепочка останется неизменной, а также, что возвращаемое значение будет ссылаться на другую цепочку.
  
  Specified by:
  
  buildEventDispatchChain в интерфейсе EventTarget
  
  Parameters:
  
  tail - начальная цепочка для построения
  
  Returns:
  
  результирующая цепочка обработки событий для этого целевого объекта
- createTask
```
protected abstract Task<V> createTask()
```
  Вызывается после запуска службы в потоке JavaFX Application. Реализации должны сохранить любые состояния в постоянные переменные перед созданием задачи, так как доступ к свойствам службы внутри кода задачи в фоновом потоке приведет к исключениям. Например:
```
protected Task createTask() {
         final String url = myService.getUrl();
         return new Task<String>() {
             protected String call() {
                 URL u = new URL("http://www.oracle.com");
                 BufferedReader in = new BufferedReader(
                         new InputStreamReader(u.openStream()));
                 String result = in.readLine();
                 in.close();
                 return result;
             }
         }
     }
```
  Если задача является предопределенным классом (в отличие от анонимного класса) и если она следует рекомендуемой лучшей практике, то сохранять состояние перед построением задачи нет необходимости, так как её состояние полностью предоставляется в её конструкторе.
```
protected Task createTask() {
         // This is safe because getUrl is called on the FX Application
         // Thread and the FirstLineReaderTasks stores it as an
         // immutable property
         return new FirstLineReaderTask(myService.getUrl());
     }
```
  Returns:
  
  задача для выполнения

© 2008, 2025, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from JavaFX API Documentation.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Java, JavaFX and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.

Класс Service<V>

Краткое описание свойств

Краткое описание вложенных классов

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

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

Краткое описание методов

Методы, унаследованные от класса java.lang.Object

Подробное описание свойств

state

value

exception

workDone

totalWork

progress

running

message

title

executor

onReady

onScheduled

onRunning

onSucceeded

onCancelled

onFailed

Подробное описание конструкторов

Service

Подробное описание метода

getState

stateProperty

getValue

valueProperty

getException

exceptionProperty

getWorkDone

workDoneProperty

getTotalWork

totalWorkProperty

getProgress

progressProperty

isRunning

runningProperty

getMessage

messageProperty

getTitle

titleProperty

setExecutor

getExecutor

executorProperty

onReadyProperty

getOnReady

setOnReady

ready

onScheduledProperty

getOnScheduled

setOnScheduled

scheduled

onRunningProperty

getOnRunning

setOnRunning

running

onSucceededProperty

getOnSucceeded

setOnSucceeded

succeeded

onCancelledProperty

getOnCancelled

setOnCancelled

cancelled

onFailedProperty

getOnFailed

setOnFailed

failed

cancel

restart

reset

start

executeTask

addEventHandler

removeEventHandler

addEventFilter