Spec-Zone .ru
спецификации, руководства, описания, API
|
V
- public abstract class Service<V> extends java.lang.Object implements Worker<V>, EventTarget
Служба является невидимым компонентом, инкапсулирующим информацию, запрошенную, чтобы выполнить некоторую работу над одним или более фоновыми потоками. Поскольку часть JavaFX, который библиотеку UI, Служба знает о Приложении JavaFX, распараллеливает, и разрабатывается, чтобы освободить разработчика приложений от бремени manging многопоточного кода, который взаимодействует с пользовательским интерфейсом. Также, все методы и состояние на Службе предназначаются, чтобы быть вызванными исключительно от потока Приложения JavaFX.
Реализации службы Worker
. Также, можно наблюдать состояние фоновой работы и дополнительно отменить это. Служба является допускающим повторное использование Рабочим, означая, что она может быть сброшена и перезапущена. Из-за этого, Служба может быть создана декларативно и перезапущена по требованию.
Если <код> Исполнитель </код> будет определен на Службе, то это будет использоваться, чтобы фактически выполнить службу. Иначе, поток демона будет создан и выполнен. Если Вы хотите создать потоки недемона, то определите пользовательского Исполнителя (например, Вы могли использовать <код> 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<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;
}
};
}
}
Служба значением по умолчанию использует Исполнителя пула потоков с некоторым неуказанным значением по умолчанию или максимальным размером пула потоков. Это делается так, чтобы наивный код не полностью затопил систему, создавая тысячи Потоков.
Ввести | Свойство и Описание |
---|---|
ReadOnlyObjectProperty<java.lang.Throwable> |
исключение
Получает ReadOnlyObjectProperty, представляющий любое исключение, которое произошло.
|
ObjectProperty<java.util.concurrent.Executor> |
исполнитель
Исполнитель, чтобы использовать для того, чтобы выполнить эту Службу.
|
ReadOnlyStringProperty |
сообщение
Получает ReadOnlyStringProperty, представляющий сообщение.
|
ObjectProperty<EventHandler<WorkerStateEvent>> |
onCancelled
onCancelled обработчик событий вызывают всякий раз, когда переходы Состояния задачи к ОТМЕНЕННОМУ состоянию.
|
ObjectProperty<EventHandler<WorkerStateEvent>> |
onFailed
onFailed обработчик событий вызывают всякий раз, когда переходы Состояния задачи к Состоянию отказа.
|
ObjectProperty<EventHandler<WorkerStateEvent>> |
onReady
onReady обработчик событий вызывают всякий раз, когда переходы Состояния задачи к Состоянию готовности.
|
ObjectProperty<EventHandler<WorkerStateEvent>> |
onRunning
onRunning обработчик событий вызывают всякий раз, когда переходы Состояния задачи к СОСТОЯНИЮ ВЫПОЛНЕНИЯ.
|
ObjectProperty<EventHandler<WorkerStateEvent>> |
onScheduled
onSchedule обработчик событий вызывают всякий раз, когда переходы Состояния задачи к ЗАПЛАНИРОВАННОМУ состоянию.
|
ObjectProperty<EventHandler<WorkerStateEvent>> |
onSucceeded
onSucceeded обработчик событий вызывают всякий раз, когда переходы Состояния задачи к состоянию, за КОТОРЫМ СЛЕДУЮТ.
|
ReadOnlyDoubleProperty |
продвижение
Получает ReadOnlyDoubleProperty, представляющий продвижение.
|
ReadOnlyBooleanProperty |
выполнение
Получает представление ReadOnlyBooleanProperty, работает ли Рабочий.
|
ReadOnlyObjectProperty<Worker.State> |
состояние
Получает ReadOnlyObjectProperty, представляющий текущее состояние.
|
ReadOnlyStringProperty |
title
Получает ReadOnlyStringProperty, представляющий title.
|
ReadOnlyDoubleProperty |
totalWork
Получает ReadOnlyDoubleProperty, представляющий максимальный объем работы, который должен быть сделан.
|
ReadOnlyObjectProperty<V> |
значение
Получает ReadOnlyObjectProperty, представляющий значение.
|
ReadOnlyDoubleProperty |
workDone
Получает ReadOnlyDoubleProperty, представляющий текущее продвижение.
|
Рабочий. Государство
Модификатор | Конструктор и Описание |
---|---|
protected |
Service()
Создайте новую Службу.
|
Модификатор и Тип | Метод и Описание |
---|---|
<T extends Event> |
addEventFilter(EventType<T> eventType, EventHandler<? super T> eventFilter)
Регистрирует фильтр события к этой задаче.
|
<T extends Event> |
addEventHandler(EventType<T> eventType, EventHandler<? super T> eventHandler)
Регистрирует обработчик событий к этой задаче.
|
EventDispatchChain |
buildEventDispatchChain(EventDispatchChain tail)
Конструкция событие диспетчеризирует цепочку для этой цели.
|
boolean |
cancel()
Завершает выполнение этого Рабочего.
|
protected void |
cancelled()
Защищенный метод удобства для подклассов, вызванных всякий раз, когда состояние Задачи перешло к ОТМЕНЕННОМУ состоянию.
|
protected abstract Task<V> |
createTask()
Вызванный после того, как Служба запускается на Потоке Приложения JavaFX.
|
ReadOnlyObjectProperty<java.lang.Throwable> |
exceptionProperty()
Получает ReadOnlyObjectProperty, представляющий любое исключение, которое произошло.
|
protected void |
executeTask(Task<V> task)
Использование
executor определенный на этой Службе, чтобы выполнить данную задачу. |
ObjectProperty<java.util.concurrent.Executor> |
executorProperty()
Исполнитель, чтобы использовать для того, чтобы выполнить эту Службу.
|
protected void |
failed()
Защищенный метод удобства для подклассов, вызванных всякий раз, когда состояние Задачи перешло к Состоянию отказа.
|
protected void |
fireEvent(Event event)
Запускает указанное событие.
|
java.lang.Throwable |
getException()
Получает значение исключения свойства.
|
java.util.concurrent.Executor |
getExecutor()
Получает значение исполнителя свойства.
|
java.lang.String |
getMessage()
Получает значение сообщения свойства.
|
EventHandler<WorkerStateEvent> |
getOnCancelled()
onCancelled обработчик событий вызывают всякий раз, когда переходы Состояния задачи к ОТМЕНЕННОМУ состоянию.
|
EventHandler<WorkerStateEvent> |
getOnFailed()
onFailed обработчик событий вызывают всякий раз, когда переходы Состояния задачи к Состоянию отказа.
|
EventHandler<WorkerStateEvent> |
getOnReady()
onReady обработчик событий вызывают всякий раз, когда переходы Состояния задачи к Состоянию готовности.
|
EventHandler<WorkerStateEvent> |
getOnRunning()
onRunning обработчик событий вызывают всякий раз, когда переходы Состояния задачи к СОСТОЯНИЮ ВЫПОЛНЕНИЯ.
|
EventHandler<WorkerStateEvent> |
getOnScheduled()
onSchedule обработчик событий вызывают всякий раз, когда переходы Состояния задачи к ЗАПЛАНИРОВАННОМУ состоянию.
|
EventHandler<WorkerStateEvent> |
getOnSucceeded()
onSucceeded обработчик событий вызывают всякий раз, когда переходы Состояния задачи к состоянию, за КОТОРЫМ СЛЕДУЮТ.
|
double |
getProgress()
Получает значение продвижения свойства.
|
Рабочий. Государство |
getState()
Получает значение состояния свойства.
|
java.lang.String |
getTitle()
Получает значение свойства title.
|
double |
getTotalWork()
Получает значение свойства totalWork.
|
V |
getValue()
Получает значение значения свойства.
|
double |
getWorkDone()
Получает значение свойства workDone.
|
boolean |
isRunning()
Получает значение выполнения свойства.
|
ReadOnlyStringProperty |
messageProperty()
Получает ReadOnlyStringProperty, представляющий сообщение.
|
ObjectProperty<EventHandler<WorkerStateEvent>> |
onCancelledProperty()
onCancelled обработчик событий вызывают всякий раз, когда переходы Состояния задачи к ОТМЕНЕННОМУ состоянию.
|
ObjectProperty<EventHandler<WorkerStateEvent>> |
onFailedProperty()
onFailed обработчик событий вызывают всякий раз, когда переходы Состояния задачи к Состоянию отказа.
|
ObjectProperty<EventHandler<WorkerStateEvent>> |
onReadyProperty()
onReady обработчик событий вызывают всякий раз, когда переходы Состояния задачи к Состоянию готовности.
|
ObjectProperty<EventHandler<WorkerStateEvent>> |
onRunningProperty()
onRunning обработчик событий вызывают всякий раз, когда переходы Состояния задачи к СОСТОЯНИЮ ВЫПОЛНЕНИЯ.
|
ObjectProperty<EventHandler<WorkerStateEvent>> |
onScheduledProperty()
onSchedule обработчик событий вызывают всякий раз, когда переходы Состояния задачи к ЗАПЛАНИРОВАННОМУ состоянию.
|
ObjectProperty<EventHandler<WorkerStateEvent>> |
onSucceededProperty()
onSucceeded обработчик событий вызывают всякий раз, когда переходы Состояния задачи к состоянию, за КОТОРЫМ СЛЕДУЮТ.
|
ReadOnlyDoubleProperty |
progressProperty()
Получает ReadOnlyDoubleProperty, представляющий продвижение.
|
protected void |
ready()
Защищенный метод удобства для подклассов, вызванных всякий раз, когда состояние Задачи перешло к Состоянию готовности.
|
<T extends Event> |
removeEventFilter(EventType<T> eventType, EventHandler<? super T> eventFilter)
Нерегистрирует ранее зарегистрированный фильтр события от этой задачи.
|
<T extends Event> |
removeEventHandler(EventType<T> eventType, EventHandler<? super T> eventHandler)
Нерегистрирует ранее зарегистрированный обработчик событий от этой задачи.
|
void |
reset()
Сбрасывает Службу.
|
void |
restart()
Отмены любая в настоящий момент выполняющаяся задача, если таковые вообще имеются, и перезапуски эта Служба.
|
protected void |
running()
Защищенный метод удобства для подклассов, вызванных всякий раз, когда состояние Задачи перешло к СОСТОЯНИЮ ВЫПОЛНЕНИЯ.
|
ReadOnlyBooleanProperty |
runningProperty()
Получает представление ReadOnlyBooleanProperty, работает ли Рабочий.
|
protected void |
scheduled()
Защищенный метод удобства для подклассов, вызванных всякий раз, когда состояние Задачи перешло к ЗАПЛАНИРОВАННОМУ состоянию.
|
protected <T extends Event> |
setEventHandler(EventType<T> eventType, EventHandler<? super T> eventHandler)
Устанавливает обработчик, чтобы использовать для этого типа события.
|
void |
setExecutor(java.util.concurrent.Executor value)
Устанавливает значение исполнителя свойства.
|
void |
setOnCancelled(EventHandler<WorkerStateEvent> value)
onCancelled обработчик событий вызывают всякий раз, когда переходы Состояния задачи к ОТМЕНЕННОМУ состоянию.
|
void |
setOnFailed(EventHandler<WorkerStateEvent> value)
onFailed обработчик событий вызывают всякий раз, когда переходы Состояния задачи к Состоянию отказа.
|
void |
setOnReady(EventHandler<WorkerStateEvent> value)
onReady обработчик событий вызывают всякий раз, когда переходы Состояния задачи к Состоянию готовности.
|
void |
setOnRunning(EventHandler<WorkerStateEvent> value)
onRunning обработчик событий вызывают всякий раз, когда переходы Состояния задачи к СОСТОЯНИЮ ВЫПОЛНЕНИЯ.
|
void |
setOnScheduled(EventHandler<WorkerStateEvent> value)
onSchedule обработчик событий вызывают всякий раз, когда переходы Состояния задачи к ЗАПЛАНИРОВАННОМУ состоянию.
|
void |
setOnSucceeded(EventHandler<WorkerStateEvent> value)
onSucceeded обработчик событий вызывают всякий раз, когда переходы Состояния задачи к состоянию, за КОТОРЫМ СЛЕДУЮТ.
|
void |
start()
Запускает эту Службу.
|
ReadOnlyObjectProperty<Worker.State> |
stateProperty()
Получает ReadOnlyObjectProperty, представляющий текущее состояние.
|
protected void |
succeeded()
Защищенный метод удобства для подклассов, вызванных всякий раз, когда состояние Задачи перешло к состоянию, за КОТОРЫМ СЛЕДУЮТ.
|
ReadOnlyStringProperty |
titleProperty()
Получает ReadOnlyStringProperty, представляющий title.
|
ReadOnlyDoubleProperty |
totalWorkProperty()
Получает ReadOnlyDoubleProperty, представляющий максимальный объем работы, который должен быть сделан.
|
ReadOnlyObjectProperty<V> |
valueProperty()
Получает ReadOnlyObjectProperty, представляющий значение.
|
ReadOnlyDoubleProperty |
workDoneProperty()
Получает ReadOnlyDoubleProperty, представляющий текущее продвижение.
|
public final ReadOnlyObjectProperty<Рабочий. Государство> stateProperty
stateProperty
в интерфейсе Worker<V>
getState()
public final ReadOnlyObjectProperty<V> valueProperty
valueProperty
в интерфейсе Worker<V>
getValue()
public final ReadOnlyObjectProperty<java.lang.Throwable> exceptionProperty
exceptionProperty
в интерфейсе Worker<V>
getException()
public final ReadOnlyDoubleProperty workDoneProperty
workDoneProperty
в интерфейсе Worker<V>
getWorkDone()
public final ReadOnlyDoubleProperty totalWorkProperty
totalWorkProperty
в интерфейсе Worker<V>
getTotalWork()
public final ReadOnlyDoubleProperty progressProperty
progressProperty
в интерфейсе Worker<V>
getProgress()
public final ReadOnlyBooleanProperty runningProperty
runningProperty
в интерфейсе Worker<V>
isRunning()
public final ReadOnlyStringProperty messageProperty
messageProperty
в интерфейсе Worker<V>
getMessage()
public final ReadOnlyStringProperty titleProperty
titleProperty
в интерфейсе Worker<V>
getTitle()
public final ObjectProperty<java.util.concurrent.Executor> executorProperty
getExecutor()
, setExecutor(Executor)
public final ObjectProperty<EventHandler<WorkerStateEvent>> onReadyProperty
getOnReady()
, setOnReady(EventHandler)
public final ObjectProperty<EventHandler<WorkerStateEvent>> onScheduledProperty
getOnScheduled()
, setOnScheduled(EventHandler)
public final ObjectProperty<EventHandler<WorkerStateEvent>> onRunningProperty
getOnRunning()
, setOnRunning(EventHandler)
public final ObjectProperty<EventHandler<WorkerStateEvent>> onSucceededProperty
getOnSucceeded()
, setOnSucceeded(EventHandler)
public final ObjectProperty<EventHandler<WorkerStateEvent>> onCancelledProperty
getOnCancelled()
, setOnCancelled(EventHandler)
public final ObjectProperty<EventHandler<WorkerStateEvent>> onFailedProperty
getOnFailed()
, setOnFailed(EventHandler)
protected Service()
public final Рабочий. Государство getState()
public final ReadOnlyObjectProperty<Рабочий. Государство> stateProperty()
Worker
stateProperty
в интерфейсе Worker<V>
getState()
public final ReadOnlyObjectProperty<V> valueProperty()
Worker
valueProperty
в интерфейсе Worker<V>
getValue()
public final java.lang.Throwable getException()
getException
в интерфейсе Worker<V>
public final ReadOnlyObjectProperty<java.lang.Throwable> exceptionProperty()
Worker
exceptionProperty
в интерфейсе Worker<V>
getException()
public final double getWorkDone()
getWorkDone
в интерфейсе Worker<V>
Worker.totalWorkProperty()
, Worker.progressProperty()
public final ReadOnlyDoubleProperty workDoneProperty()
Worker
workDoneProperty
в интерфейсе Worker<V>
getWorkDone()
public final double getTotalWork()
getTotalWork
в интерфейсе Worker<V>
Worker.workDoneProperty()
, Worker.progressProperty()
public final ReadOnlyDoubleProperty totalWorkProperty()
Worker
totalWorkProperty
в интерфейсе Worker<V>
getTotalWork()
public final double getProgress()
getProgress
в интерфейсе Worker<V>
Worker.workDoneProperty()
, Worker.totalWorkProperty()
public final ReadOnlyDoubleProperty progressProperty()
Worker
progressProperty
в интерфейсе Worker<V>
getProgress()
public final boolean isRunning()
public final ReadOnlyBooleanProperty runningProperty()
Worker
runningProperty
в интерфейсе Worker<V>
isRunning()
public final java.lang.String getMessage()
getMessage
в интерфейсе Worker<V>
public final ReadOnlyStringProperty messageProperty()
Worker
messageProperty
в интерфейсе Worker<V>
getMessage()
public final java.lang.String getTitle()
public final ReadOnlyStringProperty titleProperty()
Worker
titleProperty
в интерфейсе Worker<V>
getTitle()
public final void setExecutor(java.util.concurrent.Executor value)
public final java.util.concurrent.Executor getExecutor()
public final ObjectProperty<java.util.concurrent.Executor> executorProperty()
getExecutor()
, setExecutor(Executor)
public final ObjectProperty<EventHandler<WorkerStateEvent>> onReadyProperty()
getOnReady()
, setOnReady(EventHandler)
public final EventHandler<WorkerStateEvent> getOnReady()
public final void setOnReady(EventHandler<WorkerStateEvent> value)
value
- обработчик событий, может быть нуль, чтобы очистить этоprotected void ready()
public final ObjectProperty<EventHandler<WorkerStateEvent>> onScheduledProperty()
getOnScheduled()
, setOnScheduled(EventHandler)
public final EventHandler<WorkerStateEvent> getOnScheduled()
public final void setOnScheduled(EventHandler<WorkerStateEvent> value)
value
- обработчик событий, может быть нуль, чтобы очистить этоprotected void scheduled()
public final ObjectProperty<EventHandler<WorkerStateEvent>> onRunningProperty()
getOnRunning()
, setOnRunning(EventHandler)
public final EventHandler<WorkerStateEvent> getOnRunning()
public final void setOnRunning(EventHandler<WorkerStateEvent> value)
value
- обработчик событий, может быть нуль, чтобы очистить этоprotected void running()
public final ObjectProperty<EventHandler<WorkerStateEvent>> onSucceededProperty()
getOnSucceeded()
, setOnSucceeded(EventHandler)
public final EventHandler<WorkerStateEvent> getOnSucceeded()
public final void setOnSucceeded(EventHandler<WorkerStateEvent> value)
value
- обработчик событий, может быть нуль, чтобы очистить этоprotected void succeeded()
public final ObjectProperty<EventHandler<WorkerStateEvent>> onCancelledProperty()
getOnCancelled()
, setOnCancelled(EventHandler)
public final EventHandler<WorkerStateEvent> getOnCancelled()
public final void setOnCancelled(EventHandler<WorkerStateEvent> value)
value
- обработчик событий, может быть нуль, чтобы очистить этоprotected void cancelled()
public final ObjectProperty<EventHandler<WorkerStateEvent>> onFailedProperty()
getOnFailed()
, setOnFailed(EventHandler)
public final EventHandler<WorkerStateEvent> getOnFailed()
public final void setOnFailed(EventHandler<WorkerStateEvent> value)
value
- обработчик событий, может быть нуль, чтобы очистить этоprotected void failed()
public final boolean cancel()
Worker
public void restart()
public void reset()
public void start()
protected void executeTask(Task<V> task)
Использование executor
определенный на этой Службе, чтобы выполнить данную задачу. Если executor
нуль, затем исполнитель значения по умолчанию используется, который создаст новый поток демона, на котором можно выполнить эту задачу.
Этот метод предназначается только, чтобы быть вызванным реализацией Службы.
task
- ненулевая задача выполнитьсяpublic final <T extends Event> void addEventHandler(EventType<T> eventType, EventHandler<? super T> eventHandler)
T
- определенное событие class обработчикаeventType
- тип событий, чтобы получить обработчикомeventHandler
- обработчик, чтобы зарегистрироватьсяjava.lang.NullPointerException
- если тип события или обработчик являются нулемpublic final <T extends Event> void removeEventHandler(EventType<T> eventType, EventHandler<? super T> eventHandler)
T
- определенное событие class обработчикаeventType
- тип события, от которого можно незарегистрироватьсяeventHandler
- обработчик, чтобы незарегистрироватьсяjava.lang.NullPointerException
- если тип события или обработчик являются нулемpublic final <T extends Event> void addEventFilter(EventType<T> eventType, EventHandler<? super T> eventFilter)
T
- определенное событие class фильтраeventType
- тип событий, чтобы получить фильтромeventFilter
- фильтр, чтобы зарегистрироватьсяjava.lang.NullPointerException
- если тип события или фильтр являются нулемpublic final <T extends Event> void removeEventFilter(EventType<T> eventType, EventHandler<? super T> eventFilter)
T
- определенное событие class фильтраeventType
- тип события, от которого можно незарегистрироватьсяeventFilter
- фильтр, чтобы незарегистрироватьсяjava.lang.NullPointerException
- если тип события или фильтр являются нулемprotected final <T extends Event> void setEventHandler(EventType<T> eventType, EventHandler<? super T> eventHandler)
T
- определенное событие class обработчикаeventType
- тип события, чтобы связаться с данным eventHandlereventHandler
- обработчик, чтобы зарегистрироваться, или обнулить, чтобы незарегистрироватьсяjava.lang.NullPointerException
- если тип события является нулемprotected final void fireEvent(Event event)
Этот метод нужно вызвать на пользовательском потоке FX.
event
- событие, чтобы стрелятьpublic EventDispatchChain buildEventDispatchChain(EventDispatchChain tail)
EventTarget
EventTarget
. Эта цель события автоматически не добавляется к цепочке, так, если это хочет обработать события, это должно добавить EventDispatcher
для себя к цепочке. В случае цель события является частью некоторой иерархии, цепочка для этого обычно создается от диспетчеров события, забранных у корня иерархии к цели события.
Событие диспетчеризирует цепочку, создается модификациями к обеспеченному начальному событию, диспетчеризируют цепочку. У возвращенной цепочки должна быть начальная цепочка в ее конце, таким образом, диспетчеры должны предварительно ожидаться к начальной цепочке.
Вызывающая сторона не должна предположить, что начальная цепочка остается неизменной, ни что возвращенное значение сошлется на различную цепочку.
buildEventDispatchChain
в интерфейсе EventTarget
tail
- начальная цепочка, чтобы создать из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;
}
}
}
Если Задачей является предопределенный class (в противоположность тому, чтобы быть анонимным class), и если она следовала за рекомендуемой передовой практикой, то нет никакой потребности сохранить от состояния до построения Задачи, так как ее состояние полностью обеспечивается в ее конструкторе.
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());
}
Copyright (c) 2008, 2013, Oracle и/или его филиалы. Все права защищены. Использование подвергается