javafx.concurrent

Класс ScheduledService<V>

java.lang.Object

javafx.concurrent.Service<V>
- javafx.concurrent.ScheduledService<V>

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

V - Вычисленное значение ScheduledService

Все реализованные интерфейсы:

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

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

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

Если во время выполнения 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 0 и значение по умолчанию delay 0. Это заставит ScheduledService выполнить задачу немедленно при вызове Service.start() и повторно выполнить её немедленно после успешного завершения.

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

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

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

С:

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
exception, executor, message, onCancelled, onFailed, onReady, onRunning, onScheduled, onSucceeded, 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()

Конструкторы
Конструктор и описание
`ScheduledService()`

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

Все методыМетоды экземпляровКонкретные методы
Модификатор и тип	Метод и описание
`ObjectProperty<Callback<ScheduledService<?>,Duration>>`	`backoffStrategyProperty()` Вычисляет время, добавляемое к периоду при каждой ошибке.
`boolean`	`cancel()` Отменяет текущую задачу и останавливает этот запланированный сервис, так что дальнейшие итерации не будут происходить.
`ReadOnlyObjectProperty<Duration>`	`cumulativePeriodProperty()` Текущий суммарный период, используемый между итерациями.
`ReadOnlyIntegerProperty`	`currentFailureCountProperty()` Текущее количество раз, когда ScheduledService завершился ошибкой.
`ObjectProperty<Duration>`	`delayProperty()` Начальная задержка между началом работы ScheduledService и его запуском.
`protected void`	`executeTask(Task<V> task)` Использует `executor`, определенное в этом сервисе, для выполнения заданной задачи.
`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, buildEventDispatchChain, cancelled, createTask, exceptionProperty, executorProperty, fireEvent, getException, getExecutor, getMessage, getOnCancelled, getOnFailed, getOnReady, getOnRunning, getOnScheduled, getOnSucceeded, getProgress, getState, getTitle, getTotalWork, getValue, getWorkDone, isRunning, messageProperty, onCancelledProperty, onFailedProperty, onReadyProperty, onRunningProperty, onScheduledProperty, onSucceededProperty, progressProperty, ready, removeEventFilter, removeEventHandler, restart, running, runningProperty, scheduled, setEventHandler, setExecutor, setOnCancelled, setOnFailed, setOnReady, setOnRunning, setOnScheduled, setOnSucceeded, start, stateProperty, titleProperty, totalWorkProperty, valueProperty, workDoneProperty

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

Подробное описание свойства
- delay
```
public final ObjectProperty<Duration> delayProperty
```
  Начальная задержка между запуском ScheduledService и его началом работы. Это время, в течение которого ScheduledService остаётся в состоянии SCHEDULED, прежде чем перейти в состояние RUNNING после нового вызова Service.start() или Service.restart().
  
  См. также:
  
  getDelay(), setDelay(Duration)
- period
```
public final ObjectProperty<Duration> periodProperty
```
  Минимальное время, которое должно пройти между началом последнего выполнения и началом следующего. Фактическая задержка (также известная как cumulativePeriod) будет зависеть от этого свойства, а также от backoffStrategy и количества ошибок.
  
  См. также:
  
  getPeriod(), setPeriod(Duration)
- backoffStrategy
```
public final ObjectProperty<Callback<ScheduledService<?>,Duration>> backoffStrategyProperty
```
  Вычисляет время, которое нужно добавить к периоду при каждой ошибке. Это накопительное значение сбрасывается всякий раз, когда ScheduledService перезапускается вручную.
  
  См. также:
  
  getBackoffStrategy(), setBackoffStrategy(Callback)
- restartOnFailure
```
public final BooleanProperty restartOnFailureProperty
```
  Указывает, должен ли ScheduledService автоматически перезапускаться в случае ошибки в задаче.
  
  См. также:
  
  getRestartOnFailure(), setRestartOnFailure(boolean)
- maximumFailureCount
```
public final IntegerProperty maximumFailureCountProperty
```
  Максимальное количество попыток, которое ScheduledService может предпринять, прежде чем перейти в состояние FAILED. Конечно, вы можете перезапустить ScheduledService вручную, что приведёт к сбросу текущего счётчика.
  
  См. также:
  
  getMaximumFailureCount(), setMaximumFailureCount(int)
- currentFailureCount
```
public final ReadOnlyIntegerProperty currentFailureCountProperty
```
  Текущее количество неудачных попыток ScheduledService. Это значение сбрасывается всякий раз, когда ScheduledService перезапускается вручную.
  
  См. также:
  
  getCurrentFailureCount()
- cumulativePeriod
```
public final ReadOnlyObjectProperty<Duration> cumulativePeriodProperty
```
  Текущий накопительный период, используемый между итерациями. Он будет таким же, как и period, за исключением случая ошибки, когда результат backoffStrategy используется как накопительный период после каждой ошибки. Это значение сбрасывается всякий раз, когда ScheduledService перезапускается вручную или итерация завершается успешно. cumulativePeriod изменяется, когда ScheduledService переходит в состояние scheduled. Значение cumulativePeriod можно ограничить, установив maximumCumulativePeriod.
  
  См. также:
  
  getCumulativePeriod()
- maximumCumulativePeriod
```
public final ObjectProperty<Duration> maximumCumulativePeriodProperty
```
  Максимальное разрешённое значение для cumulativePeriod. Установка этого значения поможет гарантировать, что в случае многократных ошибок алгоритм экспоненциального увеличения времени ожидания не даст чрезмерно больших значений для накопительного периода. Значение cumulativePeriod гарантированно не будет больше этого значения. Если maximumCumulativePeriod отрицательно, то cumulativePeriod будет ограничено значением 0. Если maximumCumulativePeriod имеет значение NaN или null, то это не повлияет на cumulativePeriod.
  
  См. также:
  
  getMaximumCumulativePeriod(), setMaximumCumulativePeriod(Duration)
- lastValue
```
public final ReadOnlyObjectProperty<V> lastValueProperty
```
  Последнее успешно вычисленное значение. Во время каждой итерации значение ScheduledService сбрасывается до null, как и в любом другом сервисе. Однако "lastValue" устанавливается в последнее успешно вычисленное значение, даже между итерациями. Он также сбрасывается при ручном вызове 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). Во всех других случаях, возвращаемое значение такое же, как {@code period + (period * Math.exp(currentFailureCount))).
- LOGARITHMIC_BACKOFF_STRATEGY
```
public static final Callback<ScheduledService<?>,Duration> LOGARITHMIC_BACKOFF_STRATEGY
```
  Реализация Callback для свойства backoffStrategy, которая будет логарифмически увеличивать период между повторными запусками в случае ошибки. Этот вычисление берёт исходный период и количество последовательных ошибок, чтобы вычислить значение отложенного запуска.
  Если service равно null, возвращается Duration.ZERO. Если период равен 0, результат этого метода будет просто Math.log1p(currentFailureCount). Во всех других случаях, возвращаемое значение такое же, как {@code period + (period * Math.log1p(currentFailureCount))).
- LINEAR_BACKOFF_STRATEGY
```
public static final Callback<ScheduledService<?>,Duration> LINEAR_BACKOFF_STRATEGY
```
  Реализация Callback для свойства backoffStrategy, которая будет линейно увеличивать период между повторными запусками в случае ошибки. Этот вычисление берёт исходный период и количество последовательных ошибок, чтобы вычислить значение отложенного запуска.
  Если service равно null, возвращается Duration.ZERO. Если период равен 0, результат этого метода будет просто currentFailureCount. Во всех других случаях, возвращаемое значение такое же, как {@code period + (period * currentFailureCount).

Подробное описание конструктора
- ScheduledService
```
public ScheduledService()
```

Метод Detail
- 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()
```
  Начальная задержка между запуском ScheduledService и его началом работы. Это время, в течение которого ScheduledService будет находиться в состоянии SCHEDULED, прежде чем перейти в состояние RUNNING после нового вызова Service.start() или Service.restart().
  
  См. также:
  
  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()
```
  Минимальное время, которое должно пройти между запуском последнего выполнения и запуском следующего. Фактический период (также известный как cumulativePeriod) будет зависеть от этого свойства, а также от backoffStrategy и количества неудач.
  
  См. также:
  
  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 автоматически перезапускаться в случае ошибки в задаче.
- setRestartOnFailure
```
public final void setRestartOnFailure(boolean value)
```
  Устанавливает значение свойства restartOnFailure.
  
  Описание свойства:
  
  Указывает, должен ли ScheduledService автоматически перезапускаться в случае ошибки в задаче.
- restartOnFailureProperty
```
public final BooleanProperty restartOnFailureProperty()
```
  Указывает, должен ли ScheduledService автоматически перезапускаться в случае ошибки в задаче.
  
  См. также:
  
  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 в состояние scheduled. cumulativePeriod может быть ограничен настройкой maximumCumulativePeriod.
- cumulativePeriodProperty
```
public final ReadOnlyObjectProperty<Duration> cumulativePeriodProperty()
```
  Текущий накопительный период между итерациями. Он будет таким же, как period, за исключением случаев неудачи, когда результат backoffStrategy используется как накопительный период после каждой неудачи. Сбрасывается при ручном перезапуске ScheduledService или успешной итерации. cumulativePeriod изменяется при переходе ScheduledService в состояние scheduled. 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, как и в случае любого другого сервиса. Однако lastValue будет устанавливаться на последнее успешно вычисленное значение, даже между итерациями. Он сбрасывается при ручном вызове reset или restart.

- lastValueProperty
```
public final ReadOnlyObjectProperty<V> lastValueProperty()
```
  Последнее успешно вычисленное значение. Во время каждой итерации значение ScheduledService будет сброшено в null, как и в случае с любым другим Service. Однако lastValue будет установлено в последнее успешно вычисленное значение, даже между итерациями. Однако оно сбрасывается всякий раз, когда вы вручную вызываете reset или restart.
  
  См. также:
  
  getLastValue()
- executeTask
```
protected void executeTask(Task<V> task)
```
  Описание скопировано из класса: Service
  
  Использует executor, определённое в этом Service, для выполнения заданной задачи. Если executor равно null, используется выполнение по умолчанию, которое создаст новый демон-поток для выполнения этой задачи.
  
  Переопределяет:
  
  executeTask в классе Service<V>
  
  Параметры:
  
  task - непустая задача для выполнения
- succeeded
```
protected void succeeded()
```
  Описание скопировано из класса: Service
  
  Защищенный вспомогательный метод для подклассов, вызываемый всякий раз, когда состояние Service переходит в состояние SUCCEEDED. Этот метод вызывается после того, как Service был полностью переведён в новое состояние.
  
  Переопределяет:
  
  succeeded в классе Service<V>
- failed
```
protected void failed()
```
  Описание скопировано из класса: Service
  
  Защищенный вспомогательный метод для подклассов, вызываемый всякий раз, когда состояние Service переходит в состояние FAILED. Этот метод вызывается после того, как Service был полностью переведён в новое состояние.
  
  Переопределяет:
  
  failed в классе Service<V>
- reset
```
public void reset()
```
  Описание скопировано из класса: Service
  
  Сбрасывает Service. Может быть вызван только в одном из завершающих состояний: SUCCEEDED, FAILED или CANCELLED, или когда READY. Этот метод должен вызываться только в потоке FX-приложения.
  
  Переопределяет:
  
  reset в классе Service<V>
- cancel
```
public boolean cancel()
```
  Отменяет любую текущую задачу и останавливает этот запланированный сервис, так что дополнительные итерации не будут происходить.
  
  Определено в:
  
  cancel в интерфейсе Worker<V>
  
  Переопределяет:
  
  cancel в классе Service<V>
  
  Возвращает:
  
  был ли отменён какой-либо запущенная задача, 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.

Класс ScheduledService<V>

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

Свойства, унаследованные от класса javafx.concurrent.Service

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

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

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

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

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

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

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

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

delay

period

backoffStrategy

restartOnFailure

maximumFailureCount

currentFailureCount

cumulativePeriod

maximumCumulativePeriod

lastValue

Подробное описание поля

EXPONENTIAL_BACKOFF_STRATEGY

LOGARITHMIC_BACKOFF_STRATEGY

LINEAR_BACKOFF_STRATEGY

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

ScheduledService

Метод Detail

getDelay

setDelay

delayProperty

getPeriod

setPeriod

periodProperty

getBackoffStrategy

setBackoffStrategy

backoffStrategyProperty

getRestartOnFailure

setRestartOnFailure

restartOnFailureProperty

getMaximumFailureCount

setMaximumFailureCount

maximumFailureCountProperty

getCurrentFailureCount

currentFailureCountProperty

getCumulativePeriod

cumulativePeriodProperty

getMaximumCumulativePeriod

setMaximumCumulativePeriod

maximumCumulativePeriodProperty

getLastValue

lastValueProperty

executeTask

succeeded

failed

reset

cancel