Класс Service<V>
- Параметры типа:
-
V— тип объекта, возвращаемого сервисом
- Все реализованные интерфейсы:
-
Worker<V>,EventTarget
- Непосредственные известные подклассы:
ScheduledService
public abstract class Service<V> extends Object implements Worker<V>, EventTarget
Сервис — это компонент, не связанный с визуальным представлением, который содержит информацию, необходимую для выполнения некоторой работы в одном или нескольких фоновых потоках. Как часть библиотеки пользовательского интерфейса JavaFX, сервис знает о потоке приложения JavaFX и предназначен для освобождения разработчика от необходимости управления многопоточным кодом, взаимодействующим с пользовательским интерфейсом. Таким образом, все методы и состояние сервиса предназначены для вызова только из потока приложения JavaFX. Единственное исключение из этого правила — это начальная настройка сервиса, которую можно безопасно выполнить из любого потока, и первоначальный запуск сервиса, который также можно безопасно выполнить из любого потока. Однако после инициализации и запуска сервиса он может использоваться только из потока FX.
Сервис создает и управляет задачей Task, которая выполняет работу в фоновом потоке. Сервис реализует интерфейс Worker. Таким образом, вы можете наблюдать состояние фоновой задачи и, при необходимости, отменить ее. Сервис является многократно используемой задачей, что означает, что ее можно сбросить и перезапустить. Благодаря этому, сервис можно создавать декларативно и перезапускать по требованию. После запуска сервиса он будет планировать свою работу Task и отслеживать изменения состояния задачи Task. Сервис не хранит ссылку на запустивший его объект, что означает, что запущенный сервис не помешает объекту, его запустившему, быть удаленным из памяти.
Если на сервисе указан Executor, то он будет использован для выполнения сервиса. В противном случае будет создан и запущен демон-поток. Если вы хотите создать не-демон-потоки, укажите пользовательский Executor (например, вы можете использовать ThreadPoolExecutor с пользовательской фабрикой потоков ThreadFactory).
Поскольку сервис предназначен для упрощения декларативных случаев использования, подклассы должны экспонировать в качестве свойств входные параметры выполняемой работы. Например, для создания сервиса, который считывает первую строку из любого URL и возвращает её как String, можно определить одно свойство, 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<String>() {
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;
}
};
}
}
Сервис по умолчанию использует пул потоков ThreadPoolExecutor с каким-то неопределённым значением по умолчанию или максимальным размером пула потоков. Это делается для того, чтобы код по умолчанию не перегружал систему, создавая тысячи потоков.
- С момента:
- JavaFX 2.0
Краткое описание вложенных классов
Вложенные классы/интерфейсы, объявленные в интерфейсе javafx.concurrent.Worker
Worker.State
Краткое описание свойств
| Тип | Свойство | Описание |
|---|---|---|
final ReadOnlyObjectProperty |
exception |
Получает ReadOnlyObjectProperty, представляющий любую произошедшую ошибку. |
final ObjectProperty |
executor |
Исполнитель, который нужно использовать для запуска этого сервиса. |
final ReadOnlyStringProperty |
message |
Получает ReadOnlyStringProperty, представляющий сообщение. |
final ObjectProperty |
onCancelled |
Обработчик события onCancelled вызывается всякий раз, когда состояние задачи переходит в состояние CANCELLED. |
final ObjectProperty |
onFailed |
Обработчик события onFailed вызывается всякий раз, когда состояние задачи переходит в состояние FAILED. |
final ObjectProperty |
onReady |
Обработчик события onReady вызывается всякий раз, когда состояние задачи переходит в состояние READY. |
final ObjectProperty |
onRunning |
Обработчик события onRunning вызывается всякий раз, когда состояние задачи переходит в состояние RUNNING. |
final ObjectProperty |
onScheduled |
Обработчик события onSchedule вызывается всякий раз, когда состояние задачи переходит в состояние SCHEDULED. |
final ObjectProperty |
onSucceeded |
Обработчик события onSucceeded вызывается всякий раз, когда состояние задачи переходит в состояние SUCCEEDED. |
final ReadOnlyDoubleProperty |
progress |
Получает ReadOnlyDoubleProperty, представляющий прогресс. |
final ReadOnlyBooleanProperty |
running |
Получает ReadOnlyBooleanProperty, представляющий, запущен ли сервис. |
final ReadOnlyObjectProperty |
state |
Получает ReadOnlyObjectProperty, представляющий текущее состояние. |
final ReadOnlyStringProperty |
title |
Получает ReadOnlyStringProperty, представляющий заголовок. |
final ReadOnlyDoubleProperty |
totalWork |
Получает ReadOnlyDoubleProperty, представляющий максимальное количество работы, которое нужно сделать. |
final ReadOnlyObjectProperty |
value |
Получает ReadOnlyObjectProperty, представляющий значение. |
final ReadOnlyDoubleProperty |
workDone |
Получает ReadOnlyDoubleProperty, представляющий текущий прогресс. |
Краткое описание конструкторов
| Модификатор | Конструктор | Описание |
|---|---|---|
protected |
Создаёт новый сервис. |
Краткое описание методов
| Modifier and Type | Method | Description |
|---|---|---|
final <T extends Event> |
addEventFilter |
Регистрирует фильтр событий для этого целевого объекта. |
final <T extends Event> |
addEventHandler |
Регистрирует обработчик событий для этого целевого объекта. |
EventDispatchChain |
buildEventDispatchChain |
Создаёт цепочку обработки событий для этого целевого объекта. |
boolean |
cancel() |
Отменяет любой текущий запущенный Task, если таковой имеется. |
protected void |
cancelled() |
Защищённый вспомогательный метод для подклассов, вызываемый всякий раз, когда состояние Service переходит в состояние CANCELLED. |
protected abstract Task |
createTask() |
Вызывается после запуска Service на потоке JavaFX Application. |
final ReadOnlyObjectProperty |
exceptionProperty() |
Получает ReadOnlyObjectProperty, представляющий любую произошедшую ошибку. |
protected void |
executeTask |
Использует executor, определённый для этого Service, для выполнения заданной задачи. |
final ObjectProperty |
executorProperty() |
Исполнитель, используемый для выполнения этого Service. |
protected void |
failed() |
Защищённый вспомогательный метод для подклассов, вызываемый всякий раз, когда состояние Service переходит в состояние FAILED. |
protected final void |
fireEvent |
Вызывает указанное событие. |
final Throwable |
getException() |
Получает значение свойства exception. |
final Executor |
getExecutor() |
Получает значение свойства executor. |
final String |
getMessage() |
Получает значение свойства message. |
final EventHandler |
getOnCancelled() |
Обработчик события onCancelled вызывается всякий раз, когда состояние Task переходит в состояние CANCELLED. |
final EventHandler |
getOnFailed() |
Обработчик события onFailed вызывается всякий раз, когда состояние Task переходит в состояние FAILED. |
final EventHandler |
getOnReady() |
Обработчик события onReady вызывается всякий раз, когда состояние Task переходит в состояние READY. |
final EventHandler |
getOnRunning() |
Обработчик события onRunning вызывается всякий раз, когда состояние Task переходит в состояние RUNNING. |
final EventHandler |
getOnScheduled() |
Обработчик события onSchedule вызывается всякий раз, когда состояние Task переходит в состояние SCHEDULED. |
final EventHandler |
getOnSucceeded() |
Обработчик события onSucceeded вызывается всякий раз, когда состояние Task переходит в состояние SUCCEEDED. |
final double |
getProgress() |
Получает значение свойства progress. |
final Worker.State |
getState() |
Получает значение свойства state. |
final String |
getTitle() |
Получает значение свойства title. |
final double |
getTotalWork() |
Получает значение свойства totalWork. |
final V |
getValue() |
Получает значение свойства value. |
final double |
getWorkDone() |
Получает значение свойства workDone. |
final boolean |
isRunning() |
Получает значение свойства running. |
final ReadOnlyStringProperty |
messageProperty() |
Получает ReadOnlyStringProperty, представляющий сообщение. |
final ObjectProperty |
onCancelledProperty() |
Обработчик события onCancelled вызывается всякий раз, когда состояние Task переходит в состояние CANCELLED. |
final ObjectProperty |
onFailedProperty() |
Обработчик события onFailed вызывается всякий раз, когда состояние Task переходит в состояние FAILED. |
final ObjectProperty |
onReadyProperty() |
Обработчик события onReady вызывается всякий раз, когда состояние Task переходит в состояние READY. |
final ObjectProperty |
onRunningProperty() |
Обработчик события onRunning вызывается всякий раз, когда состояние Task переходит в состояние RUNNING. |
final ObjectProperty |
onScheduledProperty() |
Обработчик события onSchedule вызывается всякий раз, когда состояние Task переходит в состояние SCHEDULED. |
final ObjectProperty |
onSucceededProperty() |
Обработчик события onSucceeded вызывается всякий раз, когда состояние Task переходит в состояние SUCCEEDED. |
final ReadOnlyDoubleProperty |
progressProperty() |
Получает ReadOnlyDoubleProperty, представляющий прогресс. |
protected void |
ready() |
Защищённый вспомогательный метод для подклассов, вызываемый всякий раз, когда состояние Service переходит в состояние READY. |
final <T extends Event> |
removeEventFilter |
Отменяет ранее зарегистрированный фильтр событий для этого целевого объекта. |
final <T extends Event> |
removeEventHandler |
Отменяет ранее зарегистрированный обработчик событий для этого целевого объекта. |
void |
reset() |
Сбрасывает Service. |
void |
restart() |
Отменяет любой текущий запущенный Task, если таковой имеется, и перезапускает этот Service. |
protected void |
running() |
Защищённый вспомогательный метод для подклассов, вызываемый всякий раз, когда состояние Service переходит в состояние RUNNING. |
final ReadOnlyBooleanProperty |
runningProperty() |
Получает ReadOnlyBooleanProperty, представляющий, запущен ли Worker. |
protected void |
scheduled() |
Защищённый вспомогательный метод для подклассов, вызываемый всякий раз, когда состояние Service переходит в состояние SCHEDULED. |
protected final <T extends Event> |
setEventHandler |
Устанавливает обработчик для данного типа события. |
final void |
setExecutor |
Устанавливает значение свойства executor. |
final void |
setOnCancelled |
Обработчик события onCancelled вызывается всякий раз, когда состояние Task переходит в состояние CANCELLED. |
final void |
setOnFailed |
Обработчик события onFailed вызывается всякий раз, когда состояние Task переходит в состояние FAILED. |
final void |
setOnReady |
Обработчик события onReady вызывается всякий раз, когда состояние Task переходит в состояние READY. |
final void |
setOnRunning |
Обработчик события onRunning вызывается всякий раз, когда состояние Task переходит в состояние RUNNING. |
final void |
setOnScheduled |
Обработчик события onSchedule вызывается всякий раз, когда состояние Task переходит в состояние SCHEDULED. |
final void |
setOnSucceeded |
Обработчик события onSucceeded вызывается всякий раз, когда состояние Task переходит в состояние SUCCEEDED. |
void |
start() |
Запускает этот Service. |
final ReadOnlyObjectProperty |
stateProperty() |
Получает ReadOnlyObjectProperty, представляющий текущее состояние. |
protected void |
succeeded() |
Защищённый вспомогательный метод для подклассов, вызываемый всякий раз, когда состояние Service переходит в состояние SUCCEEDED. |
final ReadOnlyStringProperty |
titleProperty() |
Получает ReadOnlyStringProperty, представляющий заголовок. |
final ReadOnlyDoubleProperty |
totalWorkProperty() |
Получает ReadOnlyDoubleProperty, представляющий максимальное количество работы, которое необходимо выполнить. |
final ReadOnlyObjectProperty |
valueProperty() |
Получает ReadOnlyObjectProperty, представляющий значение. |
final ReadOnlyDoubleProperty |
workDoneProperty() |
Получает ReadOnlyDoubleProperty, представляющий текущий прогресс. |
Подробное описание свойств
state
public final ReadOnlyObjectProperty<Worker.State> stateProperty
- Определено:
-
statePropertyв интерфейсеWorker<V> - Возвращает:
- Свойство, представляющее состояние
- См. также:
value
public final ReadOnlyObjectProperty<V> valueProperty
- Определено:
-
valuePropertyв интерфейсеWorker<V> - Возвращает:
- Свойство, представляющее текущее значение
- См. также:
exception
public final ReadOnlyObjectProperty<Throwable> exceptionProperty
- Определено:
-
exceptionPropertyв интерфейсеWorker<V> - Возвращает:
- свойство, представляющее исключение
- См. также:
workDone
public final ReadOnlyDoubleProperty workDoneProperty
- Определено:
-
workDonePropertyв интерфейсеWorker<V> - Возвращает:
- Свойство, представляющее объем проделанной работы
- См. также:
totalWork
public final ReadOnlyDoubleProperty totalWorkProperty
- Определено:
-
totalWorkPropertyв интерфейсеWorker<V> - Возвращает:
- свойство, представляющее общий объем работы
- См. также:
progress
public final ReadOnlyDoubleProperty progressProperty
- Определено:
-
progressPropertyв интерфейсеWorker<V> - Возвращает:
- свойство, представляющее прогресс
- См. также:
running
public final ReadOnlyBooleanProperty runningProperty
- Определено:
-
runningPropertyв интерфейсеWorker<V> - Возвращает:
- свойство, представляющее, запущена ли задача
- См. также:
message
public final ReadOnlyStringProperty messageProperty
- Определено:
-
messagePropertyв интерфейсеWorker<V> - Возвращает:
- свойство, представляющее текущее сообщение
- См. также:
title
public final ReadOnlyStringProperty titleProperty
- Определено:
-
titlePropertyв интерфейсеWorker<V> - Возвращает:
- свойство, представляющее текущий заголовок
- См. также:
executor
public final ObjectProperty<Executor> executorProperty
- См. также:
onReady
public final ObjectProperty<EventHandler<WorkerStateEvent>> onReadyProperty
- С:
- JavaFX 2.1
- См. также:
onScheduled
public final ObjectProperty<EventHandler<WorkerStateEvent>> onScheduledProperty
- С:
- JavaFX 2.1
- См. также:
onRunning
public final ObjectProperty<EventHandler<WorkerStateEvent>> onRunningProperty
- С:
- JavaFX 2.1
- См. также:
onSucceeded
public final ObjectProperty<EventHandler<WorkerStateEvent>> onSucceededProperty
- С:
- JavaFX 2.1
- См. также:
onCancelled
public final ObjectProperty<EventHandler<WorkerStateEvent>> onCancelledProperty
- С:
- JavaFX 2.1
- См. также:
onFailed
public final ObjectProperty<EventHandler<WorkerStateEvent>> onFailedProperty
- С:
- JavaFX 2.1
- См. также:
Подробное описание конструкторов
Service
protected Service()
Подробное описание методов
getState
stateProperty
public final ReadOnlyObjectProperty<Worker.State> stateProperty()
Worker- Определено:
-
statePropertyв интерфейсеWorker<V> - Возвращает:
- свойство
state - См. также:
getValue
Свойство value
public final ReadOnlyObjectProperty<V> valueProperty()
Worker- Определено в:
-
valuePropertyв интерфейсеWorker<V> - Возвращает:
- свойство
value - См. также:
getException
public final Throwable getException()
exception.- Определено в:
-
getExceptionв интерфейсеWorker<V> - Описание свойства:
- Возвращает:
- значение свойства
exception - См. также:
Свойство exception
public final ReadOnlyObjectProperty<Throwable> exceptionProperty()
Worker- Определено в:
-
exceptionPropertyв интерфейсеWorker<V> - Возвращает:
- свойство
exception - См. также:
getWorkDone
public final double getWorkDone()
workDone.- Определено в:
-
getWorkDoneв интерфейсеWorker<V> - Описание свойства:
- Возвращает:
- значение свойства
workDone - См. также:
Свойство workDone
public final ReadOnlyDoubleProperty workDoneProperty()
Worker- Определено в:
-
workDonePropertyв интерфейсеWorker<V> - Возвращает:
- свойство
workDone - См. также:
getTotalWork
public final double getTotalWork()
totalWork.- Определено в:
-
getTotalWorkв интерфейсеWorker<V> - Описание свойства:
- Возвращает:
- значение свойства
totalWork - См. также:
Свойство totalWork
public final ReadOnlyDoubleProperty totalWorkProperty()
Worker- Определено в:
-
totalWorkPropertyв интерфейсеWorker<V> - Возвращает:
- свойство
totalWork - См. также:
getProgress
public final double getProgress()
progress.- Определено в:
-
getProgressв интерфейсеWorker<V> - Описание свойства:
- Возвращает:
- значение свойства
progress - См. также:
Свойство progress
public final ReadOnlyDoubleProperty progressProperty()
Worker- Определено в:
-
progressPropertyв интерфейсеWorker<V> - Возвращает:
- свойство
progress - См. также:
isRunning
Свойство running
public final ReadOnlyBooleanProperty runningProperty()
Worker- Определено в:
-
runningPropertyв интерфейсеWorker<V> - Возвращает:
- свойство
running - См. также:
getMessage
public final String getMessage()
message.- Определено в:
-
getMessageв интерфейсеWorker<V> - Описание свойства:
- Возвращает:
- значение свойства
message - См. также:
Свойство message
public final ReadOnlyStringProperty messageProperty()
Worker- Определено в:
-
messagePropertyв интерфейсеWorker<V> - Возвращает:
- свойство
message - См. также:
getTitle
Свойство title
public final ReadOnlyStringProperty titleProperty()
Worker- Определено в:
-
titlePropertyв интерфейсеWorker<V> - Возвращает:
- свойство
title - См. также:
setExecutor
public final void setExecutor(Executor value)
executor.- Описание свойства:
- Исполнитель, используемый для запуска данного Service. Если исполнитель не указан, то будет создан и использован новый демон-поток для запуска Service с помощью некоторого стандартного исполнителя.
- Параметры:
-
value- значение для свойстваexecutor - См. также:
getExecutor
public final Executor getExecutor()
executor.- Описание свойства:
- Исполнитель, используемый для запуска данного Service. Если исполнитель не указан, то будет создан и использован новый демон-поток для запуска Service с помощью некоторого стандартного исполнителя.
- Возвращает:
- значение свойства
executor - См. также:
executorProperty
public final ObjectProperty<Executor> executorProperty()
- Возвращает:
- свойство
executor - См. также:
onReadyProperty
public final ObjectProperty<EventHandler<WorkerStateEvent>> onReadyProperty()
- Возвращает:
- свойство обработчика события onReady
- С:
- JavaFX 2.1
- См. также:
getOnReady
public final EventHandler<WorkerStateEvent> getOnReady()
- Возвращает:
- обработчик события onReady, если есть
- С:
- JavaFX 2.1
setOnReady
public final void setOnReady(EventHandler<WorkerStateEvent> value)
- Параметры:
-
value- обработчик события, может быть null для очистки - С:
- JavaFX 2.1
ready
protected void ready()
- С:
- JavaFX 2.1
onScheduledProperty
public final ObjectProperty<EventHandler<WorkerStateEvent>> onScheduledProperty()
- Возвращает:
- свойство обработчика события onScheduled
- С:
- JavaFX 2.1
- См. также:
getOnScheduled
public final EventHandler<WorkerStateEvent> getOnScheduled()
- Возвращает:
- обработчик события onScheduled, если есть
- С:
- JavaFX 2.1
setOnScheduled
public final void setOnScheduled(EventHandler<WorkerStateEvent> value)
- Параметры:
-
value- обработчик события, может быть null для очистки - С:
- JavaFX 2.1
scheduled
protected void scheduled()
- С:
- JavaFX 2.1
onRunningProperty
public final ObjectProperty<EventHandler<WorkerStateEvent>> onRunningProperty()
- Возвращает:
- свойство обработчика события onRunning
- С:
- JavaFX 2.1
- См. также:
getOnRunning
public final EventHandler<WorkerStateEvent> getOnRunning()
- Возвращает:
- обработчик события onRunning, если есть
- С:
- JavaFX 2.1
setOnRunning
public final void setOnRunning(EventHandler<WorkerStateEvent> value)
- Параметры:
-
value- обработчик события, может быть null для очистки - С:
- JavaFX 2.1
running
protected void running()
- С:
- JavaFX 2.1
onSucceededProperty
public final ObjectProperty<EventHandler<WorkerStateEvent>> onSucceededProperty()
- Возвращает:
- свойство обработчика события onSucceeded
- С:
- JavaFX 2.1
- См. также:
getOnSucceeded
public final EventHandler<WorkerStateEvent> getOnSucceeded()
- Возвращает:
- обработчик события onSucceeded, если есть
- С:
- JavaFX 2.1
setOnSucceeded
public final void setOnSucceeded(EventHandler<WorkerStateEvent> value)
- Параметры:
-
value- обработчик события, может быть null для очистки - С:
- JavaFX 2.1
succeeded
protected void succeeded()
- С:
- JavaFX 2.1
onCancelledProperty
public final ObjectProperty<EventHandler<WorkerStateEvent>> onCancelledProperty()
- Возвращает:
- свойство обработчика события onCancelled
- С:
- JavaFX 2.1
- См. также:
getOnCancelled
public final EventHandler<WorkerStateEvent> getOnCancelled()
- Возвращает:
- обработчик события onCancelled, если есть
- С:
- JavaFX 2.1
setOnCancelled
public final void setOnCancelled(EventHandler<WorkerStateEvent> value)
- Параметры:
-
value- обработчик события, может быть null для очистки - С:
- JavaFX 2.1
cancelled
protected void cancelled()
- С:
- JavaFX 2.1
onFailedProperty
public final ObjectProperty<EventHandler<WorkerStateEvent>> onFailedProperty()
- Возвращает:
- свойство обработчика события onFailed
- С:
- JavaFX 2.1
- См. также:
getOnFailed
public final EventHandler<WorkerStateEvent> getOnFailed()
- Возвращает:
- обработчик события onFailed, если есть
- С:
- JavaFX 2.1
setOnFailed
public final void setOnFailed(EventHandler<WorkerStateEvent> value)
- Параметры:
-
value- обработчик события, может быть null для очистки - С:
- JavaFX 2.1
failed
protected void failed()
- С тех пор:
- JavaFX 2.1
cancel
restart
public void restart()
reset
public void reset()
start
public void start()
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)
Обработчик вызывается, когда целевой объект получает Event указанного типа во время фазы «подъёма» доставки событий.
- Определено в:
-
addEventHandlerв интерфейсеEventTarget - Параметры типа:
-
T- класс события обработчика - Параметры:
-
eventType- тип событий, получаемых обработчиком -
eventHandler- обработчик событий - С тех пор:
- JavaFX 2.1
removeEventHandler
public final <T extends Event> void removeEventHandler(EventType<T> eventType, EventHandler<? super T> eventHandler)
Поскольку возможно зарегистрировать один экземпляр EventHandler для разных типов событий, вызывающий код должен указать тип события, из которого должен быть удалён обработчик.
- Определено в:
-
removeEventHandlerв интерфейсеEventTarget - Параметры типа:
-
T- класс события обработчика - Параметры:
-
eventType- тип события, из которого нужно удалить -
eventHandler- обработчик событий - С тех пор:
- JavaFX 2.1
addEventFilter
public final <T extends Event> void addEventFilter(EventType<T> eventType, EventHandler<? super T> eventFilter)
Фильтр вызывается, когда целевой объект получает Event указанного типа во время фазы захвата доставки событий.
- Определено в:
-
addEventFilterв интерфейсеEventTarget - Параметры типа:
-
T- класс события фильтра - Параметры:
-
eventType- тип событий, получаемых фильтром -
eventFilter- фильтр событий - С тех пор:
- JavaFX 2.1
removeEventFilter
public final <T extends Event> void removeEventFilter(EventType<T> eventType, EventHandler<? super T> eventFilter)
Поскольку возможно зарегистрировать один экземпляр EventHandler для разных типов событий, вызывающий код должен указать тип события, из которого должен быть удалён фильтр.
- Определено в:
-
removeEventFilterв интерфейсеEventTarget - Параметры типа:
-
T- класс события фильтра - Параметры:
-
eventType- тип события, из которого нужно удалить -
eventFilter- фильтр событий - С тех пор:
- JavaFX 2.1
setEventHandler
protected final <T extends Event> void setEventHandler(EventType<T> eventType, EventHandler<? super T> eventHandler)
- Параметры типа:
-
T- конкретный класс события обработчика - Параметры:
-
eventType- тип события, который нужно связать с данным eventHandler -
eventHandler- обработчик для регистрации, или null для отмены регистрации - Исключения:
-
NullPointerException- если тип события равен null - С тех пор:
- JavaFX 2.1
fireEvent
protected final void fireEvent(Event event)
Этот метод должен вызываться в потоке FX пользователя.
- Параметры:
-
event- событие для вызова - С тех пор:
- JavaFX 2.1
buildEventDispatchChain
public EventDispatchChain buildEventDispatchChain(EventDispatchChain tail)
EventTargetEventTarget. Этот целевой объект не добавляется в цепочку автоматически, поэтому, если он хочет обрабатывать события, ему нужно добавить EventDispatcher для себя в цепочку. В случае, если целевой объект является частью иерархии, цепочка для него обычно строится из диспетчеров событий, собранных от корня иерархии до целевого объекта.
Цепочка маршрутизации событий строится путём модификаций предоставленной начальной цепочки маршрутизации событий. Возвращаемая цепочка должна иметь начальную цепочку в конце, поэтому диспетчеры должны быть добавлены в начало начальной цепочки.
Вызывающий код не должен предполагать, что начальная цепочка останется неизменной, ни то, что возвращаемое значение будет ссылаться на другую цепочку.
- Определено в:
-
buildEventDispatchChainв интерфейсеEventTarget - Параметры:
-
tail- начальная цепочка для построения - Возвращает:
- результирующая цепочка маршрутизации событий для этого целевого объекта
createTask
protected abstract Task<V> createTask()
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());
}
- Возвращает:
- задачу для выполнения
© 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.