Класс ScheduledService<V>

java.lang.Object

javafx.concurrent.Service<V>

javafx.concurrent.ScheduledService<V>

Параметры типа:: V - Вычисленное значение ScheduledService

Все реализованные интерфейсы:: Worker<V>, EventTarget

public abstract class ScheduledService<V>
extends Service<V>

ScheduledService — это Service, который автоматически перезапускается после успешного выполнения и при определенных условиях перезапускается даже в случае ошибки. Новый ScheduledService начинает работу в состоянии READY, как и обычный Service. После вызова start или restart, ScheduledService переходит в состояние SCHEDULED на срок, указанный в delay.

После перехода в состояние RUNNING ScheduledService выполняет свою задачу Task. При успешном завершении ScheduledService переходит в состояние SUCCEEDED, а затем в состояние READY и обратно в SCHEDULED. Время пребывания ScheduledService в этом состоянии зависит от времени между последним переходом в состояние RUNNING и текущим временем, а также от period. Короче говоря, period определяет минимальное время между началом одного выполнения и началом следующего. Если предыдущее выполнение завершилось до истечения period, то ScheduledService останется в состоянии SCHEDULED до истечения этого периода. Если же выполнение заняло больше времени, чем указанный период, то ScheduledService сразу переходит обратно в состояние RUNNING.

Если во время выполнения в состоянии RUNNING Task ScheduledService вызывает ошибку или каким-либо другим образом переходит в состояние FAILED, то ScheduledService либо перезапустится, либо остановится, в зависимости от значений backoffStrategy, restartOnFailure и maximumFailureCount.

Если происходит ошибка и restartOnFailure ложно, то ScheduledService переходит в состояние FAILED и останавливается. Чтобы перезапустить ScheduledService, вызвавший ошибку, необходимо вручную вызвать метод restart.

Если происходит ошибка и restartOnFailure истинно, то ScheduledService может перезапуститься автоматически. Сначала результат вызова backoffStrategy станет новым cumulativePeriod. Таким образом, после каждой ошибки вы можете заставить службу ожидать все большего времени перед перезапуском. После успешного завершения задачи cumulativePeriod сбрасывается до значения period.

ScheduledService определяет статические реализации стратегий экспоненциального и логарифмического отката EXPONENTIAL_BACKOFF_STRATEGY и LOGARITHMIC_BACKOFF_STRATEGY, из которых LOGARITHMIC_BACKOFF_STRATEGY является значением по умолчанию для backoffStrategy. После достижения maximumFailureCount ScheduledService переходит в состояние FAILED точно так же, как если бы restartOnFailure было ложным.

Если period или delay изменяются во время работы ScheduledService, новые значения будут учтены при следующей итерации. Например, если period увеличивается, то при следующем переходе ScheduledService в состояние SCHEDULED будет использоваться новое значение period. Аналогично, если delay изменяется, новое значение будет учтено при следующем перезапуске или сбросе/начале.

ScheduledService обычно используется для случаев, связанных с опросом. Например, вы можете регулярно отправлять запрос на сервер, чтобы узнать о каких-либо обновлениях. ScheduledService может быть реализован следующим образом:


 ScheduledService<Document> svc = new ScheduledService<Document>() {
     protected Task<Document> createTask() {
         return new Task<Document>() {
             protected Document call() {
                 // Connect to a Server
                 // Get the XML document
                 // Parse it into a document
                 return document;
             }
         };
     }
 };
 svc.setPeriod(Duration.seconds(1));

Этот пример будет отправлять запрос на удаленный сервер каждые 1 секунду.

Временные характеристики этого класса не являются абсолютно надежными. Очень загруженный поток событий может ввести некоторую задержку в начало выполнения фоновой задачи, поэтому очень маленькие значения для периода или задержки, скорее всего, будут неточными. Задержка или период в сотни миллисекунд или больше должны быть довольно надежными.

ScheduledService в своей конфигурации по умолчанию имеет значения по умолчанию period и delay, равные 0. Это заставит ScheduledService выполнить задачу немедленно после Service.start() и повторно выполнить ее немедленно после успешного завершения.

Для целей этого класса любая продолжительность, возвращающая true для Duration.isUnknown(), будет обрабатываться как Duration.ZERO. Аналогично, любая продолжительность, возвращающая true для Duration.isIndefinite(), будет обрабатываться как продолжительность Double.MAX_VALUE миллисекунд. Любой null Duration обрабатывается как Duration.ZERO. Любая пользовательская реализация обратного вызова стратегии отката должна быть готова обрабатывать эти различные возможные значения.

ScheduledService вводит новое свойство lastValue. lastValue — это значение, которое было вычислено в последнюю очередь успешно. Поскольку Service очищает свойство value при каждом выполнении, а ScheduledService будет перепланировать выполнение сразу после завершения (если он не переходит в состояния cancelled или failed), свойство value не очень полезно для ScheduledService. В большинстве случаев вы захотите использовать значение, возвращаемое lastValue.

Примечание для разработчика: Методы Service.ready(), Service.scheduled(), Service.running(), succeeded(), Service.cancelled() и failed() реализованы в этом классе. Подклассы, которые также переопределяют эти методы, должны позаботиться о вызове реализации super.

С момента:: JavaFX 8.0

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

Свойства
Тип	Свойство	Описание
`ObjectProperty<Callback<ScheduledService<?>,Duration>>`	`backoffStrategy`	Вычисляет количество времени, которое нужно добавить к периоду при каждой неудаче.
`ReadOnlyObjectProperty<Duration>`	`cumulativePeriod`	Текущий кумулятивный период, используемый между итерациями.
`ReadOnlyIntegerProperty`	`currentFailureCount`	Текущее количество раз, когда ScheduledService потерпел неудачу.
`ObjectProperty<Duration>`	`delay`	Первоначальная задержка между началом работы ScheduledService и началом его выполнения.
`ReadOnlyObjectProperty<V>`	`lastValue`	Последнее успешно вычисленное значение.
`ObjectProperty<Duration>`	`maximumCumulativePeriod`	Максимально допустимое значение для cumulativePeriod.
`IntegerProperty`	`maximumFailureCount`	Максимальное количество раз, когда ScheduledService может потерпеть неудачу, прежде чем перейдет в состояние FAILED.
`ObjectProperty<Duration>`	`period`	Минимальное время, которое должно пройти между завершением последнего запуска и началом следующего запуска.
`BooleanProperty`	`restartOnFailure`	Указывает, должен ли ScheduledService автоматически перезапускаться в случае ошибки в задаче.

Свойства, объявленные в классе javafx.concurrent.Service

executor, onCancelled, onFailed, onReady, onRunning, onScheduled, onSucceeded

Свойства, объявленные в интерфейсе javafx.concurrent.Worker

exception, message, progress, running, state, title, totalWork, value, workDone

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

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

Worker.State

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

Поля
Модификатор и тип	Поле	Описание
`static Callback<ScheduledService<?>,Duration>`	`EXPONENTIAL_BACKOFF_STRATEGY`	Реализация Callback для свойства `backoffStrategy`, которая обеспечит экспоненциальное уменьшение периода между повторными запусками в случае неудачи.
`static Callback<ScheduledService<?>,Duration>`	`LINEAR_BACKOFF_STRATEGY`	Реализация Callback для свойства `backoffStrategy`, которая обеспечит линейное уменьшение периода между повторными запусками в случае неудачи.
`static Callback<ScheduledService<?>,Duration>`	`LOGARITHMIC_BACKOFF_STRATEGY`	Реализация Callback для свойства `backoffStrategy`, которая обеспечит логарифмическое уменьшение периода между повторными запусками в случае неудачи.

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

Конструкторы
Конструктор	Описание
`ScheduledService()`	Конструктор для вызова подклассами.

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

Модификатор и тип	Метод	Описание
`ObjectProperty<Callback<ScheduledService<?>,Duration>>`	`backoffStrategyProperty()`	Вычисляет количество времени, которое необходимо добавить к периоду при каждой неудаче.
`boolean`	`cancel()`	Отменяет любые текущие выполняемые задачи и останавливает эту запланированную службу, так что дополнительные итерации не будут происходить.
`ReadOnlyObjectProperty<Duration>`	`cumulativePeriodProperty()`	Текущий кумулятивный период, используемый между итерациями.
`ReadOnlyIntegerProperty`	`currentFailureCountProperty()`	Текущее количество раз, когда ScheduledService потерпел неудачу.
`ObjectProperty<Duration>`	`delayProperty()`	Начальная задержка между моментом начала работы ScheduledService и началом выполнения.
`protected void`	`failed()`	Защищенный вспомогательный метод для подклассов, вызываемый всякий раз, когда состояние службы переходит в состояние FAILED.
`Callback<ScheduledService<?>,Duration>`	`getBackoffStrategy()`	Получает значение свойства backoffStrategy.
`Duration`	`getCumulativePeriod()`	Получает значение свойства cumulativePeriod.
`int`	`getCurrentFailureCount()`	Получает значение свойства currentFailureCount.
`Duration`	`getDelay()`	Получает значение свойства delay.
`V`	`getLastValue()`	Получает значение свойства lastValue.
`Duration`	`getMaximumCumulativePeriod()`	Получает значение свойства maximumCumulativePeriod.
`int`	`getMaximumFailureCount()`	Получает значение свойства maximumFailureCount.
`Duration`	`getPeriod()`	Получает значение свойства period.
`boolean`	`getRestartOnFailure()`	Получает значение свойства restartOnFailure.
`ReadOnlyObjectProperty<V>`	`lastValueProperty()`	Последнее успешно вычисленное значение.
`ObjectProperty<Duration>`	`maximumCumulativePeriodProperty()`	Максимально допустимое значение для cumulativePeriod.
`IntegerProperty`	`maximumFailureCountProperty()`	Максимальное количество раз, когда ScheduledService может потерпеть неудачу, прежде чем просто перейдет в состояние FAILED.
`ObjectProperty<Duration>`	`periodProperty()`	Минимальное количество времени, которое должно пройти между завершением последнего запуска и началом следующего запуска.
`void`	`reset()`	Сбрасывает службу.
`BooleanProperty`	`restartOnFailureProperty()`	Указывает, должна ли ScheduledService автоматически перезапускаться в случае сбоя в задаче.
`void`	`setBackoffStrategy(Callback<ScheduledService<?>,Duration> value)`	Устанавливает значение свойства backoffStrategy.
`void`	`setDelay(Duration value)`	Устанавливает значение свойства delay.
`void`	`setMaximumCumulativePeriod(Duration value)`	Устанавливает значение свойства maximumCumulativePeriod.
`void`	`setMaximumFailureCount(int value)`	Устанавливает значение свойства maximumFailureCount.
`void`	`setPeriod(Duration value)`	Устанавливает значение свойства period.
`void`	`setRestartOnFailure(boolean value)`	Устанавливает значение свойства restartOnFailure.
`protected void`	`succeeded()`	Защищенный вспомогательный метод для подклассов, вызываемый всякий раз, когда состояние службы переходит в состояние SUCCEEDED.

Методы, объявленные в классе javafx.concurrent.Service

addEventFilter, addEventHandler, cancelled, createTask, executeTask, executorProperty, fireEvent, getExecutor, getOnCancelled, getOnFailed, getOnReady, getOnRunning, getOnScheduled, getOnSucceeded, onCancelledProperty, onFailedProperty, onReadyProperty, onRunningProperty, onScheduledProperty, onSucceededProperty, ready, removeEventFilter, removeEventHandler, restart, running, scheduled, setEventHandler, setExecutor, setOnCancelled, setOnFailed, setOnReady, setOnRunning, setOnScheduled, setOnSucceeded, start

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

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Методы, объявленные в интерфейсе javafx.event.EventTarget

buildEventDispatchChain

Методы, объявленные в интерфейсе javafx.concurrent.Worker

exceptionProperty, getException, getMessage, getProgress, getState, getTitle, getTotalWork, getValue, getWorkDone, isRunning, messageProperty, progressProperty, runningProperty, stateProperty, titleProperty, totalWorkProperty, valueProperty, workDoneProperty

Подробности свойств

задержка

public final ObjectProperty<Duration> delayProperty

Начальная задержка между запуском ScheduledService и началом его работы. Это время, в течение которого ScheduledService останется в состоянии SCHEDULED, прежде чем перейти в состояние RUNNING после нового вызова Service.start() или Service.restart().

См. также:: getDelay(), setDelay(Duration)

период

public final ObjectProperty<Duration> periodProperty

Минимальное время, которое должно пройти между окончанием последнего выполнения и началом следующего. Фактический период (также известный как cumulativePeriod) будет зависеть от этого свойства, а также от backoffStrategy и количества ошибок.

См. также:: getPeriod(), setPeriod(Duration)

стратегия_обратного_отката

public final ObjectProperty<Callback<ScheduledService<?>,Duration>> backoffStrategyProperty

Вычисляет время, которое нужно добавить к периоду при каждой ошибке. Это накопительное значение сбрасывается каждый раз, когда ScheduledService перезапускается вручную.

См. также:: getBackoffStrategy(), setBackoffStrategy(Callback)

перезапуск_при_ошибке

public final BooleanProperty restartOnFailureProperty

Указывает, должен ли ScheduledService автоматически перезапускаться в случае ошибки в задаче.

См. также:: getRestartOnFailure(), setRestartOnFailure(boolean)

максимальное_количество_ошибок

public final IntegerProperty maximumFailureCountProperty

Максимальное количество раз, когда ScheduledService может потерпеть неудачу, прежде чем просто перейти в состояние FAILED. Конечно, вы можете вручную перезапустить ScheduledService, что приведет к сбросу текущего значения.

См. также:: getMaximumFailureCount(), setMaximumFailureCount(int)

текущее_количество_ошибок

public final ReadOnlyIntegerProperty currentFailureCountProperty

Текущее количество раз, когда ScheduledService потерпел неудачу. Сбрасывается при каждом ручном перезапуске ScheduledService.

См. также:: getCurrentFailureCount()

накопленный_период

public final ReadOnlyObjectProperty<Duration> cumulativePeriodProperty

Текущий накопленный период, используемый между итерациями. Будет таким же, как period, за исключением случаев ошибки, когда результат backoffStrategy используется как накопленный период после каждой ошибки. Сбрасывается при каждом ручном перезапуске ScheduledService или успешной итерации. cumulativePeriod изменяется, когда ScheduledService переходит в состояние scheduled. cumulativePeriod может быть ограничен путем установки maximumCumulativePeriod.

См. также:: getCumulativePeriod()

максимальный_накопленный_период

public final ObjectProperty<Duration> maximumCumulativePeriodProperty

Максимально допустимое значение для cumulativePeriod. Установка этого значения поможет гарантировать, что в случае многократных ошибок алгоритм обратного отката не приведет к необоснованно большим значениям для накопленного периода. Накопленный период гарантированно не будет больше этого значения. Если maximumCumulativePeriod отрицательный, то cumulativePeriod будет ограничен 0. Если maximumCumulativePeriod - NaN или null, то он не повлияет на cumulativePeriod.

См. также:: getMaximumCumulativePeriod(), setMaximumCumulativePeriod(Duration)

последнее_значение

public final ReadOnlyObjectProperty<V> lastValueProperty

Последнее успешно вычисленное значение. Во время каждой итерации значение ScheduledService будет сброшено до null, как и в случае с любым другим сервисом. Однако последнее значение будет установлено в самое последнее успешно вычисленное значение, даже через итерации. Однако оно сбрасывается при каждом ручном вызове reset или restart.

См. также:: getLastValue()

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

EXPONENTIAL_BACKOFF_STRATEGY

public static final Callback<ScheduledService<?>,Duration> EXPONENTIAL_BACKOFF_STRATEGY

Реализация Callback для свойства backoffStrategy, которая будет экспоненциально увеличивать период между повторными выполнениями в случае ошибки. Этот расчет использует исходный период и количество последовательных ошибок для вычисления значения обратного отката.

Если service равно null, возвращается Duration.ZERO. Если период равен 0, результат этого метода будет просто Math.exp(currentFailureCount). Во всех остальных случаях возвращаемое значение совпадает с period + (period * Math.exp(currentFailureCount)).

ЛОГАРИФМИЧЕСКАЯ_СТРАТЕГИЯ_ОБРАТНОГО_ОТКАТА

public static final Callback<ScheduledService<?>,Duration> LOGARITHMIC_BACKOFF_STRATEGY

Реализация Callback для свойства backoffStrategy, которая будет логарифмически увеличивать период между повторными выполнениями в случае ошибки. Этот расчет использует исходный период и количество последовательных ошибок для вычисления значения обратного отката.

Если service равно null, возвращается Duration.ZERO. Если период равен 0, результат этого метода будет просто Math.log1p(currentFailureCount). Во всех остальных случаях возвращаемое значение совпадает с period + (period * Math.log1p(currentFailureCount)).

ЛИНЕЙНАЯ_СТРАТЕГИЯ_ОБРАТНОГО_ОТКАТА

public static final Callback<ScheduledService<?>,Duration> LINEAR_BACKOFF_STRATEGY

Реализация Callback для свойства backoffStrategy, которая будет линейно увеличивать период между повторными выполнениями в случае ошибки. Этот расчет использует исходный период и количество последовательных ошибок для вычисления значения обратного отката.

Если service равно null, возвращается Duration.ZERO. Если период равен 0, результат этого метода будет просто currentFailureCount. Во всех остальных случаях возвращаемое значение совпадает с period + (period * currentFailureCount).

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

ScheduledService

public ScheduledService()

Конструктор для вызова подклассами.

Подробности методов

getDelay

public final Duration getDelay()

Получает значение свойства delay.

Описание свойства:: Начальная задержка между запуском ScheduledService и началом его работы. Это время, в течение которого ScheduledService останется в состоянии SCHEDULED, прежде чем перейти в состояние RUNNING после нового вызова Service.start() или Service.restart().

setDelay

public final void setDelay(Duration value)

Устанавливает значение свойства delay.

Описание свойства:: Начальная задержка между запуском ScheduledService и началом его работы. Это время, в течение которого ScheduledService останется в состоянии SCHEDULED, прежде чем перейти в состояние RUNNING после нового вызова Service.start() или Service.restart().

delayProperty

public final ObjectProperty<Duration> delayProperty()

См. также:: getDelay(), setDelay(Duration)

getPeriod

public final Duration getPeriod()

Получает значение свойства period.

Описание свойства:: Минимальное время, которое должно пройти между окончанием последнего выполнения и началом следующего. Фактический период (также известный как cumulativePeriod) будет зависеть от этого свойства, а также от backoffStrategy и количества ошибок.

setPeriod

public final void setPeriod(Duration value)

Устанавливает значение свойства period.

Описание свойства:: Минимальное время, которое должно пройти между окончанием последнего выполнения и началом следующего. Фактический период (также известный как cumulativePeriod) будет зависеть от этого свойства, а также от backoffStrategy и количества ошибок.

periodProperty

public final ObjectProperty<Duration> periodProperty()

См. также:: getPeriod(), setPeriod(Duration)

getBackoffStrategy

public final Callback<ScheduledService<?>,Duration> getBackoffStrategy()

Получает значение свойства backoffStrategy.

Описание свойства:: Вычисляет время, которое нужно добавить к периоду при каждой ошибке. Это накопительное значение сбрасывается каждый раз, когда ScheduledService перезапускается вручную.

setBackoffStrategy

public final void setBackoffStrategy(Callback<ScheduledService<?>,Duration> value)

Устанавливает значение свойства backoffStrategy.

Описание свойства:: Вычисляет количество времени, добавляемое к периоду при каждой ошибке. Это накопительное значение сбрасывается всякий раз, когда ScheduledService вручную перезапускается.

backoffStrategyProperty

public final ObjectProperty<Callback<ScheduledService<?>,Duration>> backoffStrategyProperty()

Вычисляет количество времени, добавляемое к периоду при каждой ошибке. Это накопительное значение сбрасывается всякий раз, когда ScheduledService вручную перезапускается.

См. также:: getBackoffStrategy(), setBackoffStrategy(Callback)

getRestartOnFailure

public final boolean getRestartOnFailure()

Возвращает значение свойства restartOnFailure.

Описание свойства:: Указывает, должен ли ScheduledService автоматически перезапускаться в случае ошибки в задаче (Task).

setRestartOnFailure

public final void setRestartOnFailure(boolean value)

Устанавливает значение свойства restartOnFailure.

Описание свойства:: Указывает, должен ли ScheduledService автоматически перезапускаться в случае ошибки в задаче (Task).

restartOnFailureProperty

public final BooleanProperty restartOnFailureProperty()

Указывает, должен ли ScheduledService автоматически перезапускаться в случае ошибки в задаче (Task).

См. также:: getRestartOnFailure(), setRestartOnFailure(boolean)

getMaximumFailureCount

public final int getMaximumFailureCount()

Возвращает значение свойства maximumFailureCount.

Описание свойства:: Максимальное количество попыток, которое ScheduledService может предпринять, прежде чем перейдет в состояние FAILED. Конечно, ScheduledService можно перезапустить вручную, что сбросит текущий счетчик.

setMaximumFailureCount

public final void setMaximumFailureCount(int value)

Устанавливает значение свойства maximumFailureCount.

Описание свойства:: Максимальное количество попыток, которое ScheduledService может предпринять, прежде чем перейдет в состояние FAILED. Конечно, ScheduledService можно перезапустить вручную, что сбросит текущий счетчик.

maximumFailureCountProperty

public final IntegerProperty maximumFailureCountProperty()

Максимальное количество попыток, которое ScheduledService может предпринять, прежде чем перейдет в состояние FAILED. Конечно, ScheduledService можно перезапустить вручную, что сбросит текущий счетчик.

См. также:: getMaximumFailureCount(), setMaximumFailureCount(int)

getCurrentFailureCount

public final int getCurrentFailureCount()

Возвращает значение свойства currentFailureCount.

Описание свойства:: Текущее количество попыток, предпринятых ScheduledService. Сбрасывается при каждом ручном перезапуске ScheduledService.

currentFailureCountProperty

public final ReadOnlyIntegerProperty currentFailureCountProperty()

Текущее количество попыток, предпринятых ScheduledService. Сбрасывается при каждом ручном перезапуске ScheduledService.

См. также:: getCurrentFailureCount()

getCumulativePeriod

public final Duration getCumulativePeriod()

Возвращает значение свойства cumulativePeriod.

Описание свойства:: Текущий накопительный период, используемый между итерациями. Будет таким же, как period, за исключением случаев ошибки, когда результат backoffStrategy используется в качестве накопительного периода после каждой ошибки. Сбрасывается при каждом ручном перезапуске ScheduledService или успешной итерации. cumulativePeriod изменяется, когда ScheduledService переходит в запланированное состояние. cumulativePeriod может быть ограничен установкой maximumCumulativePeriod.

cumulativePeriodProperty

public final ReadOnlyObjectProperty<Duration> cumulativePeriodProperty()

Текущий накопительный период, используемый между итерациями. Будет таким же, как period, за исключением случаев ошибки, когда результат backoffStrategy используется в качестве накопительного периода после каждой ошибки. Сбрасывается при каждом ручном перезапуске ScheduledService или успешной итерации. cumulativePeriod изменяется, когда ScheduledService переходит в запланированное состояние. cumulativePeriod может быть ограничен установкой maximumCumulativePeriod.

См. также:: getCumulativePeriod()

getMaximumCumulativePeriod

public final Duration getMaximumCumulativePeriod()

Возвращает значение свойства maximumCumulativePeriod.

Описание свойства:: Максимально допустимое значение для cumulativePeriod. Установка этого значения поможет гарантировать, что в случае многократных ошибок алгоритм экспоненциального возврата не приведет к неразумно большим значениям для накопительного периода. Накопительный период гарантированно не будет больше этого значения. Если maximumCumulativePeriod отрицательный, то cumulativePeriod будет ограничен 0. Если maximumCumulativePeriod NaN или null, то он не повлияет на cumulativePeriod.

setMaximumCumulativePeriod

public final void setMaximumCumulativePeriod(Duration value)

Устанавливает значение свойства maximumCumulativePeriod.

Описание свойства:: Максимально допустимое значение для cumulativePeriod. Установка этого значения поможет гарантировать, что в случае многократных ошибок алгоритм экспоненциального возврата не приведет к неразумно большим значениям для накопительного периода. Накопительный период гарантированно не будет больше этого значения. Если maximumCumulativePeriod отрицательный, то cumulativePeriod будет ограничен 0. Если maximumCumulativePeriod NaN или null, то он не повлияет на cumulativePeriod.

maximumCumulativePeriodProperty

public final ObjectProperty<Duration> maximumCumulativePeriodProperty()

Максимально допустимое значение для cumulativePeriod. Установка этого значения поможет гарантировать, что в случае многократных ошибок алгоритм экспоненциального возврата не приведет к неразумно большим значениям для накопительного периода. Накопительный период гарантированно не будет больше этого значения. Если maximumCumulativePeriod отрицательный, то cumulativePeriod будет ограничен 0. Если maximumCumulativePeriod NaN или null, то он не повлияет на cumulativePeriod.

См. также:: getMaximumCumulativePeriod(), setMaximumCumulativePeriod(Duration)

getLastValue

public final V getLastValue()

Возвращает значение свойства lastValue.

Описание свойства:: Последнее успешно вычисленное значение. Во время каждой итерации значение ScheduledService будет сброшено до null, как и в любом другом Service. Однако lastValue будет установлено в последнее успешно вычисленное значение, даже между итерациями. Сбрасывается при ручном вызове reset или restart.

lastValueProperty

public final ReadOnlyObjectProperty<V> lastValueProperty()

Последнее успешно вычисленное значение. Во время каждой итерации значение ScheduledService будет сброшено до null, как и в любом другом Service. Однако lastValue будет установлено в последнее успешно вычисленное значение, даже между итерациями. Сбрасывается при ручном вызове reset или restart.

См. также:: getLastValue()

succeeded

protected void succeeded()

Защищенный вспомогательный метод для подклассов, вызываемый при переходе состояния Service в состояние SUCCEEDED. Этот метод вызывается после того, как Service полностью перешел в новое состояние. Примечание к реализации: подклассы, переопределяющие этот метод, должны вызывать эту реализацию суперкласса.

Переопределяет:: succeeded в классе Service<V>

failed

protected void failed()

Защищенный вспомогательный метод для подклассов, вызываемый при переходе состояния Service в состояние FAILED. Этот метод вызывается после того, как Service полностью перешел в новое состояние. Примечание к реализации: подклассы, переопределяющие этот метод, должны вызывать эту реализацию суперкласса.

Переопределяет:: failed в классе Service<V>

reset

public void reset()

Сбрасывает Service. Может вызываться только при нахождении в одном из завершающих состояний (SUCCEEDED, FAILED, или CANCELLED) или в состоянии READY. Этот метод должен вызываться только в потоке FX-приложения. Примечание к реализации: подклассы, переопределяющие этот метод, должны вызывать эту реализацию суперкласса.

Переопределяет:: reset в классе Service<V>

cancel

public boolean cancel()

Отменяет текущую задачу и останавливает планируемую службу (ScheduledService), предотвращая дополнительные итерации.

Определяет:: cancel в интерфейсе Worker<V>
Переопределяет:: cancel в классе Service<V>
Возвращает:: true, если текущая задача была отменена; false, если задача не была отменена. В любом случае ScheduledService прекратит итерации.

© 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.