Package com.github.kagkarlsson.scheduler

Class Scheduler

java.lang.Object

com.github.kagkarlsson.scheduler.Scheduler

All Implemented Interfaces:

SchedulerClient

Direct Known Subclasses:

ManualScheduler

public class Scheduler
extends Object
implements SchedulerClient

Nested Class Summary

Nested classes/interfaces inherited from interface com.github.kagkarlsson.scheduler.SchedulerClient

SchedulerClient.Builder, SchedulerClient.SchedulerClientName, SchedulerClient.StandardSchedulerClient

Field Summary

Fields

Modifier and Type	Field	Description
protected final PollStrategy	executeDueStrategy
protected final Executor	executor
protected final List<OnStartup>	onStartup
static final String	THREAD_PREFIX
static final double	TRIGGER_NEXT_BATCH_WHEN_AVAILABLE_THREADS_RATIO

Constructor Summary

Constructors

Modifier	Constructor	Description
protected	Scheduler(Clock clock, TaskRepository schedulerTaskRepository, TaskRepository clientTaskRepository, TaskResolver taskResolver, int threadpoolSize, ExecutorService executorService, SchedulerName schedulerName, Waiter executeDueWaiter, Duration heartbeatInterval, boolean enableImmediateExecution, StatsRegistry statsRegistry, PollingStrategyConfig pollingStrategyConfig, Duration deleteUnresolvedAfter, Duration shutdownMaxWait, LogLevel logLevel, boolean logStackTrace, List<OnStartup> onStartup)

Method Summary

Modifier and Type	Method	Description
void	cancel(TaskInstanceId taskInstanceId)	Removes/Cancels an execution.
static SchedulerBuilder	create(DataSource dataSource, Task<?>... knownTasks)
static SchedulerBuilder	create(DataSource dataSource, List<Task<?>> knownTasks)
protected void	detectDeadExecutions()
protected void	executeDue()
protected void	executeOnStartup()
void	fetchScheduledExecutions(ScheduledExecutionsFilter filter, Consumer<ScheduledExecution<Object>> consumer)
void	fetchScheduledExecutions(Consumer<ScheduledExecution<Object>> consumer)	Gets all scheduled executions and supplies them to the provided Consumer.
<T> void	fetchScheduledExecutionsForTask(String taskName, Class<T> dataClass, ScheduledExecutionsFilter filter, Consumer<ScheduledExecution<T>> consumer)
<T> void	fetchScheduledExecutionsForTask(String taskName, Class<T> dataClass, Consumer<ScheduledExecution<T>> consumer)	Gets all scheduled executions for a task and supplies them to the provided Consumer.
List<CurrentlyExecuting>	getCurrentlyExecuting()
List<Execution>	getFailingExecutions(Duration failingAtLeastFor)
Optional<ScheduledExecution<Object>>	getScheduledExecution(TaskInstanceId taskInstanceId)	Gets the details for a specific scheduled execution.
SchedulerState	getSchedulerState()
void	pause()
<T> void	reschedule(SchedulableInstance<T> schedulableInstance)	Update an existing execution with a new execution-time and new task-data.
void	reschedule(TaskInstanceId taskInstanceId, Instant newExecutionTime)	Update an existing execution to a new execution-time.
<T> void	reschedule(TaskInstanceId taskInstanceId, Instant newExecutionTime, T newData)	Update an existing execution with a new execution-time and new task-data.
void	resume()
<T> void	schedule(SchedulableInstance<T> schedulableInstance)
<T> void	schedule(TaskInstance<T> taskInstance, Instant executionTime)	Schedule a new execution.
void	start()
void	stop()
void	triggerCheckForDueExecutions()

Methods inherited from class java.lang.Object

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

Methods inherited from interface com.github.kagkarlsson.scheduler.SchedulerClient

getScheduledExecutions, getScheduledExecutions, getScheduledExecutionsForTask, getScheduledExecutionsForTask

Field Details

TRIGGER_NEXT_BATCH_WHEN_AVAILABLE_THREADS_RATIO

public static final double TRIGGER_NEXT_BATCH_WHEN_AVAILABLE_THREADS_RATIO

See Also:

• Constant Field Values

THREAD_PREFIX

public static final String THREAD_PREFIX

See Also:

• Constant Field Values

executeDueStrategy

protected final PollStrategy executeDueStrategy

executor

protected final Executor executor

onStartup

protected final List<OnStartup> onStartup

Constructor Details

Scheduler

protected Scheduler(Clock clock,
 TaskRepository schedulerTaskRepository,
 TaskRepository clientTaskRepository,
 TaskResolver taskResolver,
 int threadpoolSize,
 ExecutorService executorService,
 SchedulerName schedulerName,
 Waiter executeDueWaiter,
 Duration heartbeatInterval,
 boolean enableImmediateExecution,
 StatsRegistry statsRegistry,
 PollingStrategyConfig pollingStrategyConfig,
 Duration deleteUnresolvedAfter,
 Duration shutdownMaxWait,
 LogLevel logLevel,
 boolean logStackTrace,
 List<OnStartup> onStartup)

Method Details

start

public void start()

executeDue

protected void executeDue()

executeOnStartup

protected void executeOnStartup()

stop

public void stop()

pause

public void pause()

resume

public void resume()

getSchedulerState

public SchedulerState getSchedulerState()

schedule

public <T> void schedule(SchedulableInstance<T> schedulableInstance)

Specified by:

schedule in interface SchedulerClient

schedule

public <T> void schedule(TaskInstance<T> taskInstance,
 Instant executionTime)

Description copied from interface: SchedulerClient

Schedule a new execution.

Specified by:

schedule in interface SchedulerClient

Parameters:

taskInstance - Task-instance, optionally with data

executionTime - Instant it should run

See Also:

• Instant
• TaskInstance

reschedule

public void reschedule(TaskInstanceId taskInstanceId,
 Instant newExecutionTime)

Description copied from interface: SchedulerClient

Update an existing execution to a new execution-time. If the execution does not exist or if it is currently running, an exception is thrown.

Specified by:

reschedule in interface SchedulerClient

newExecutionTime - the new execution-time

See Also:

• Instant
• TaskInstanceId

reschedule

public <T> void reschedule(SchedulableInstance<T> schedulableInstance)

Description copied from interface: SchedulerClient

Update an existing execution with a new execution-time and new task-data. If the execution does not exist or if it is currently running, an exception is thrown.

Specified by:

reschedule in interface SchedulerClient

Parameters:

schedulableInstance - the updated instance

reschedule

public <T> void reschedule(TaskInstanceId taskInstanceId,
 Instant newExecutionTime,
 T newData)

Description copied from interface: SchedulerClient

Update an existing execution with a new execution-time and new task-data. If the execution does not exist or if it is currently running, an exception is thrown.

Specified by:

reschedule in interface SchedulerClient

newExecutionTime - the new execution-time

newData - the new task-data

See Also:

• Instant
• TaskInstanceId

cancel

public void cancel(TaskInstanceId taskInstanceId)

Description copied from interface: SchedulerClient

Removes/Cancels an execution.

Specified by:

cancel in interface SchedulerClient

See Also:

• TaskInstanceId

fetchScheduledExecutions

public void fetchScheduledExecutions(Consumer<ScheduledExecution<Object>> consumer)

Description copied from interface: SchedulerClient

Gets all scheduled executions and supplies them to the provided Consumer. A Consumer is used to avoid forcing the SchedulerClient to load all executions in memory. Currently running executions are not returned.

Specified by:

fetchScheduledExecutions in interface SchedulerClient

Parameters:

consumer - Consumer for the executions

fetchScheduledExecutions

public void fetchScheduledExecutions(ScheduledExecutionsFilter filter,
 Consumer<ScheduledExecution<Object>> consumer)

Specified by:

fetchScheduledExecutions in interface SchedulerClient

fetchScheduledExecutionsForTask

public <T> void fetchScheduledExecutionsForTask(String taskName,
 Class<T> dataClass,
 Consumer<ScheduledExecution<T>> consumer)

Description copied from interface: SchedulerClient

Gets all scheduled executions for a task and supplies them to the provided Consumer. A Consumer is used to avoid forcing the SchedulerClient to load all executions in memory. Currently running executions are not returned.

Specified by:

fetchScheduledExecutionsForTask in interface SchedulerClient

Parameters:

taskName - the name of the task to get scheduled-executions for

dataClass - the task data-class the data will be serialized and cast to

consumer - Consumer for the executions

fetchScheduledExecutionsForTask

public <T> void fetchScheduledExecutionsForTask(String taskName,
 Class<T> dataClass,
 ScheduledExecutionsFilter filter,
 Consumer<ScheduledExecution<T>> consumer)

Specified by:

fetchScheduledExecutionsForTask in interface SchedulerClient

getScheduledExecution

public Optional<ScheduledExecution<Object>> getScheduledExecution(TaskInstanceId taskInstanceId)

Description copied from interface: SchedulerClient

Gets the details for a specific scheduled execution. Currently running executions are also returned.

Specified by:

getScheduledExecution in interface SchedulerClient

Returns:

Optional.empty() if no matching execution found

See Also:

• TaskInstanceId
• ScheduledExecution

getFailingExecutions

public List<Execution> getFailingExecutions(Duration failingAtLeastFor)

triggerCheckForDueExecutions

public void triggerCheckForDueExecutions()

getCurrentlyExecuting

public List<CurrentlyExecuting> getCurrentlyExecuting()

detectDeadExecutions

protected void detectDeadExecutions()

create

public static SchedulerBuilder create(DataSource dataSource,
 Task<?>... knownTasks)

create

public static SchedulerBuilder create(DataSource dataSource,
 List<Task<?>> knownTasks)