Spec-Zone.ru › OpenJavaFX 21

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

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

Если происходит сбой и restartOnFailure ложно, то ScheduledService перейдёт в состояние FAILED и остановится. Чтобы перезапустить 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 с максимальным значением в миллисекундах. Любой 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

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

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

Свойства, объявленные в классе 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 final Callback<ScheduledService<?>,Duration> EXPONENTIAL_BACKOFF_STRATEGY
Реализация Callback для свойства backoffStrategy, которое будет экспоненциально откладывать период между повторными выполнениями в случае сбоя.
static final Callback<ScheduledService<?>,Duration> LINEAR_BACKOFF_STRATEGY
Реализация Callback для свойства backoffStrategy, которое будет линейно откладывать период между повторными выполнениями в случае сбоя.
static final Callback<ScheduledService<?>,Duration> LOGARITHMIC_BACKOFF_STRATEGY
Реализация Callback для свойства backoffStrategy, которое будет логарифмически откладывать период между повторными выполнениями в случае сбоя.

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

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

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

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

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

addEventFilter, addEventHandler, buildEventDispatchChain, cancelled, createTask, exceptionProperty, executeTask, 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

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

задержка

public final ObjectProperty<Duration> delayProperty
Начальная задержка между моментом запуска ScheduledService и началом его работы. Это количество времени, которое ScheduledService будет оставаться в состоянии SCHEDULED, прежде чем перейти в состояние RUNNING после свежего вызова Service.start() или Service.restart().
См. также:
  • getDelay()
  • setDelay(Duration)
  • delayProperty()

период

public final ObjectProperty<Duration> periodProperty
Минимальное количество времени, которое должно пройти между началом последнего выполнения и началом следующего. Фактический период (также известный как cumulativePeriod) будет зависеть от этого свойства, а также от backoffStrategy и количества ошибок.
См. также:
  • getPeriod()
  • setPeriod(Duration)
  • periodProperty()

стратегия_повторной_попытки

public final ObjectProperty<Callback<ScheduledService<?>,Duration>> backoffStrategyProperty
Вычисляет количество времени, которое нужно добавить к периоду при каждой ошибке. Это кумулятивное значение сбрасывается всякий раз, когда ScheduledService вручную перезапускается.
См. также:
  • getBackoffStrategy()
  • setBackoffStrategy(Callback)
  • backoffStrategyProperty()

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

public final BooleanProperty restartOnFailureProperty
Указывает, должен ли ScheduledService автоматически перезапускаться в случае ошибки в задаче.
См. также:
  • getRestartOnFailure()
  • setRestartOnFailure(boolean)
  • restartOnFailureProperty()

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

public final IntegerProperty maximumFailureCountProperty
Максимальное количество раз, которое ScheduledService может завершиться ошибкой, прежде чем перейти в состояние FAILED. Конечно, вы можете вручную перезапустить ScheduledService, что приведет к сбросу текущего счётчика.
См. также:
  • getMaximumFailureCount()
  • setMaximumFailureCount(int)
  • maximumFailureCountProperty()

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

public final ReadOnlyIntegerProperty currentFailureCountProperty
Текущее количество раз, когда ScheduledService завершился ошибкой. Это сбрасывается всякий раз, когда ScheduledService перезапускается вручную.
См. также:
  • getCurrentFailureCount()
  • currentFailureCountProperty()

кумулятивный_период

public final ReadOnlyObjectProperty<Duration> cumulativePeriodProperty
Текущий кумулятивный период, используемый между итерациями. Он будет таким же, как period, за исключением случаев после ошибки, когда результат backoffStrategy используется как кумулятивный период после каждой ошибки. Он сбрасывается всякий раз, когда ScheduledService перезапускается вручную или итерация завершается успешно. cumulativePeriod изменяется, когда ScheduledService переходит в состояние запланированности. cumulativePeriod может быть ограничен установкой maximumCumulativePeriod.
См. также:
  • getCumulativePeriod()
  • cumulativePeriodProperty()

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

public final ObjectProperty<Duration> maximumCumulativePeriodProperty
Максимально допустимое значение для cumulativePeriod. Установка этого значения поможет гарантировать, что в случае многократных ошибок алгоритм back-off не приведет к неразумно большим значениям для кумулятивного периода. Кумулятивный период гарантированно не будет больше этого значения. Если maximumCumulativePeriod отрицательный, то cumulativePeriod будет ограничен 0. Если maximumCumulativePeriod — NaN или null, то он не повлияет на cumulativePeriod.
См. также:
  • getMaximumCumulativePeriod()
  • setMaximumCumulativePeriod(Duration)
  • maximumCumulativePeriodProperty()

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

public final ReadOnlyObjectProperty<V> lastValueProperty
Последнее успешно вычисленное значение. Во время каждой итерации значение ScheduledService будет сброшено до null, как и в любом другом сервисе. Однако последнее_значение будет установлено на последнее успешно вычисленное значение, даже между итерациями. Однако оно сбрасывается всякий раз, когда вы вручную вызываете сброс или перезапуск.
См. также:
  • getLastValue()
  • lastValueProperty()

Подробности поля

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

LOGARITHMIC_BACKOFF_STRATEGY

public static final Callback<ScheduledService<?>,Duration> LOGARITHMIC_BACKOFF_STRATEGY
Реализация Callback для свойства backoffStrategy, которая будет логарифмически увеличивать период между повторными запусками в случае ошибки. Этот расчет использует исходный период и количество последовательных ошибок для вычисления значения повторной попытки.

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

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

ScheduledService

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

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

getDelay

public final Duration getDelay()
Возвращает значение свойства delay.
Описание свойства:
Начальная задержка между моментом запуска ScheduledService и началом его работы. Это количество времени, которое ScheduledService будет оставаться в состоянии SCHEDULED, прежде чем перейти в состояние RUNNING после свежего вызова Service.start() или Service.restart().
Возвращает:
значение свойства delay
См. также:
  • setDelay(Duration)
  • delayProperty()

setDelay

public final void setDelay(Duration value)
Устанавливает значение свойства delay.
Описание свойства:
Начальная задержка между моментом запуска ScheduledService и началом его работы. Это количество времени, которое ScheduledService будет оставаться в состоянии SCHEDULED, прежде чем перейти в состояние RUNNING после свежего вызова Service.start() или Service.restart().
Параметры:
value - значение для свойства delay
См. также:
  • getDelay()
  • delayProperty()

delayProperty

public final ObjectProperty<Duration> delayProperty()
Начальная задержка между моментом запуска ScheduledService и началом его работы. Это количество времени, которое ScheduledService будет оставаться в состоянии SCHEDULED, прежде чем перейти в состояние RUNNING после свежего вызова Service.start() или Service.restart().
Возвращает:
свойство delay
См. также:
  • getDelay()
  • setDelay(Duration)

getPeriod

public final Duration getPeriod()
Получает значение свойства period.
Описание свойства:
Минимальное количество времени, которое должно пройти между началом последнего запуска и началом следующего запуска. Фактический период (также известный как cumulativePeriod) будет зависеть от этого свойства, а также от backoffStrategy и количества сбоев.
Возвращает:
значение свойства period
См. также:
  • setPeriod(Duration)
  • periodProperty()

setPeriod

public final void setPeriod(Duration value)
Устанавливает значение свойства period.
Описание свойства:
Минимальное количество времени, которое должно пройти между началом последнего запуска и началом следующего запуска. Фактический период (также известный как cumulativePeriod) будет зависеть от этого свойства, а также от backoffStrategy и количества сбоев.
Параметры:
value - значение для свойства period
См. также:
  • getPeriod()
  • periodProperty()

periodProperty

public final ObjectProperty<Duration> periodProperty()
Минимальное количество времени, которое должно пройти между началом последнего запуска и началом следующего запуска. Фактический период (также известный как cumulativePeriod) будет зависеть от этого свойства, а также от backoffStrategy и количества сбоев.
Возвращает:
свойство period
См. также:
  • getPeriod()
  • setPeriod(Duration)

getBackoffStrategy

public final Callback<ScheduledService<?>,Duration> getBackoffStrategy()
Получает значение свойства backoffStrategy.
Описание свойства:
Вычисляет количество времени, добавляемое к периоду при каждом сбое. Это накопительное значение сбрасывается всякий раз, когда ScheduledService перезапускается вручную.
Возвращает:
значение свойства backoffStrategy
См. также:
  • setBackoffStrategy(Callback)
  • backoffStrategyProperty()

setBackoffStrategy

public final void setBackoffStrategy(Callback<ScheduledService<?>,Duration> value)
Устанавливает значение свойства backoffStrategy.
Описание свойства:
Вычисляет количество времени, добавляемое к периоду при каждом сбое. Это накопительное значение сбрасывается всякий раз, когда ScheduledService перезапускается вручную.
Параметры:
value - значение для свойства backoffStrategy
См. также:
  • getBackoffStrategy()
  • backoffStrategyProperty()

backoffStrategyProperty

public final ObjectProperty<Callback<ScheduledService<?>,Duration>> backoffStrategyProperty()
Вычисляет количество времени, добавляемое к периоду при каждом сбое. Это накопительное значение сбрасывается всякий раз, когда ScheduledService перезапускается вручную.
Возвращает:
свойство backoffStrategy
См. также:
  • getBackoffStrategy()
  • setBackoffStrategy(Callback)

getRestartOnFailure

public final boolean getRestartOnFailure()
Получает значение свойства restartOnFailure.
Описание свойства:
Указывает, нужно ли автоматически перезапускать ScheduledService в случае сбоя в задаче.
Возвращает:
значение свойства restartOnFailure
См. также:
  • setRestartOnFailure(boolean)
  • restartOnFailureProperty()

setRestartOnFailure

public final void setRestartOnFailure(boolean value)
Устанавливает значение свойства restartOnFailure.
Описание свойства:
Указывает, нужно ли автоматически перезапускать ScheduledService в случае сбоя в задаче.
Параметры:
value - значение для свойства restartOnFailure
См. также:
  • getRestartOnFailure()
  • restartOnFailureProperty()

restartOnFailureProperty

public final BooleanProperty restartOnFailureProperty()
Указывает, нужно ли автоматически перезапускать ScheduledService в случае сбоя в задаче.
Возвращает:
свойство restartOnFailure
См. также:
  • getRestartOnFailure()
  • setRestartOnFailure(boolean)

getMaximumFailureCount

public final int getMaximumFailureCount()
Получает значение свойства maximumFailureCount.
Описание свойства:
Максимальное количество попыток сбоя ScheduledService перед переходом в состояние FAILED. Конечно, вы можете вручную перезапустить ScheduledService, что приведет к сбросу текущего счётчика.
Возвращает:
значение свойства maximumFailureCount
См. также:
  • setMaximumFailureCount(int)
  • maximumFailureCountProperty()

setMaximumFailureCount

public final void setMaximumFailureCount(int value)
Устанавливает значение свойства maximumFailureCount.
Описание свойства:
Максимальное количество попыток сбоя ScheduledService перед переходом в состояние FAILED. Конечно, вы можете вручную перезапустить ScheduledService, что приведет к сбросу текущего счётчика.
Параметры:
value - значение для свойства maximumFailureCount
См. также:
  • getMaximumFailureCount()
  • maximumFailureCountProperty()

maximumFailureCountProperty

public final IntegerProperty maximumFailureCountProperty()
Максимальное количество попыток сбоя ScheduledService перед переходом в состояние FAILED. Конечно, вы можете вручную перезапустить ScheduledService, что приведет к сбросу текущего счётчика.
Возвращает:
свойство maximumFailureCount
См. также:
  • getMaximumFailureCount()
  • setMaximumFailureCount(int)

getCurrentFailureCount

public final int getCurrentFailureCount()
Получает значение свойства currentFailureCount.
Описание свойства:
Текущее количество сбоев ScheduledService. Сбрасывается всякий раз, когда ScheduledService перезапускается вручную.
Возвращает:
значение свойства currentFailureCount
См. также:
  • currentFailureCountProperty()

currentFailureCountProperty

public final ReadOnlyIntegerProperty currentFailureCountProperty()
Текущее количество сбоев ScheduledService. Сбрасывается всякий раз, когда ScheduledService перезапускается вручную.
Возвращает:
свойство currentFailureCount
См. также:
  • getCurrentFailureCount()

getCumulativePeriod

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

cumulativePeriodProperty

public final ReadOnlyObjectProperty<Duration> cumulativePeriodProperty()
Текущий накопительный период, используемый между итерациями. Будет таким же, как period, за исключением случаев сбоя, в которых результат backoffStrategy будет использоваться как накопительный период после каждого сбоя. Сбрасывается при перезапуске ScheduledService вручную или успешной итерации. cumulativePeriod изменяется, когда ScheduledService переходит в запланированное состояние. cumulativePeriod может быть ограничен настройкой maximumCumulativePeriod.
Возвращает:
свойство cumulativePeriod
См. также:
  • getCumulativePeriod()

getMaximumCumulativePeriod

public final Duration getMaximumCumulativePeriod()
Получение значения свойства maximumCumulativePeriod.
Описание свойства:
Максимально допустимое значение для cumulativePeriod. Установка этого значения поможет гарантировать, что в случае повторяющихся ошибок алгоритм экспоненциального увеличения времени ожидания не приведет к необоснованно большим значениям для cumulativePeriod. Время cumulativePeriod гарантированно не будет больше этого значения. Если maximumCumulativePeriod отрицательно, то cumulativePeriod будет ограничено значением 0. Если maximumCumulativePeriod имеет значение NaN или null, то это не повлияет на cumulativePeriod.
Возвращает:
значение свойства maximumCumulativePeriod
См. также:
  • setMaximumCumulativePeriod(Duration)
  • maximumCumulativePeriodProperty()

setMaximumCumulativePeriod

public final void setMaximumCumulativePeriod(Duration value)
Установка значения свойства maximumCumulativePeriod.
Описание свойства:
Максимально допустимое значение для cumulativePeriod. Установка этого значения поможет гарантировать, что в случае повторяющихся ошибок алгоритм экспоненциального увеличения времени ожидания не приведет к необоснованно большим значениям для cumulativePeriod. Время cumulativePeriod гарантированно не будет больше этого значения. Если maximumCumulativePeriod отрицательно, то cumulativePeriod будет ограничено значением 0. Если maximumCumulativePeriod имеет значение NaN или null, то это не повлияет на cumulativePeriod.
Параметры:
value - значение для свойства maximumCumulativePeriod
См. также:
  • getMaximumCumulativePeriod()
  • maximumCumulativePeriodProperty()

maximumCumulativePeriodProperty

public final ObjectProperty<Duration> maximumCumulativePeriodProperty()
Максимально допустимое значение для cumulativePeriod. Установка этого значения поможет гарантировать, что в случае повторяющихся ошибок алгоритм экспоненциального увеличения времени ожидания не приведет к необоснованно большим значениям для cumulativePeriod. Время cumulativePeriod гарантированно не будет больше этого значения. Если maximumCumulativePeriod отрицательно, то cumulativePeriod будет ограничено значением 0. Если maximumCumulativePeriod имеет значение NaN или null, то это не повлияет на cumulativePeriod.
Возвращает:
свойство maximumCumulativePeriod
См. также:
  • getMaximumCumulativePeriod()
  • setMaximumCumulativePeriod(Duration)

getLastValue

public final V getLastValue()
Получение значения свойства lastValue.
Описание свойства:
Последнее успешно вычисленное значение. Во время каждой итерации значение ScheduledService будет сброшено до null, как и в случае с любым другим Service. Однако lastValue будет устанавливаться в последнее успешно вычисленное значение, даже между итерациями. Он сбрасывается при ручном вызове reset или restart.
Возвращает:
значение свойства lastValue
См. также:
  • lastValueProperty()

lastValueProperty

public final ReadOnlyObjectProperty<V> lastValueProperty()
Последнее успешно вычисленное значение. Во время каждой итерации значение ScheduledService будет сброшено до null, как и в случае с любым другим Service. Однако lastValue будет устанавливаться в последнее успешно вычисленное значение, даже между итерациями. Он сбрасывается при ручном вызове reset или restart.
Возвращает:
свойство lastValue
См. также:
  • 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()
Отменяет текущую задачу и останавливает эту планируемую службу, таким образом, дальнейшие итерации не будут выполняться.
Определяется в:
cancel в интерфейсе Worker<V>
Переопределяет:
cancel в классе Service<V>
Возвращает:
была ли отменена какая-либо выполняемая задача, false, если ни одна задача не была отменена. В любом случае, планируемая служба прекратит итерации.

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

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API