com.atlassian.confluence.schedule.persistence.dao

Interface ScheduledJobDao

All Known Implementing Classes:

CachedScheduledJobDao, ClusterSafeScheduledJobDao

public interface ScheduledJobDao

Provides the DAO for storing the various scheduled job objects.

Persistence may be in memory, local cache, clustered cache or to a persistent store.

Intended storage (see implementations):

• ScheduledJobStatus - memory / cache (runtime only)
• ExecutionStatus - memory / cache (runtime only)
• ScheduledJobHistory - peristent store and memory / cache
• ScheduledJobConfiguration - memory / cache (runtime only)
• Default Cron Configuration - (sourced from spring/plugin) - memory / cache (runtime only)

Method Summary

Modifier and Type	Method and Description
void	addHistory(ScheduledJobKey key, @Nullable ScheduledJobHistory history, Date nextOccurrence) Adds to an event to the history to the cache, and updates the nextOccurrence in the ScheduledJobStatus.
@Nullable ScheduledJobConfiguration	getScheduledJobConfiguration(ScheduledJobKey key) Gets the job configuration for the specified job.
@Nullable ScheduledJobStatus	getScheduledJobStatus(ScheduledJobKey key) Gets the specified job's status.
void	saveScheduledJobConfiguration(ScheduledJobKey key, ScheduledJobConfiguration jobConfiguration) Stores the job configuration.
void	saveScheduledJobStatus(ScheduledJobKey key, ScheduledJobStatus status) Stores the status for the specified job.
void	updateNextOccurence(ScheduledJobKey key, Date nextOccurence) Updates the nextOccurence in the ScheduledJobStatus.
void	updateStatus(ScheduledJobKey key, ExecutionStatus status) Updates the status in the corresponding ScheduledJobStatus for the job.

Method Detail

getScheduledJobStatus

@Nullable ScheduledJobStatus getScheduledJobStatus(ScheduledJobKey key)

Gets the specified job's status.

It's recommended that ScheduleJobStatusManager be used for access to a job's status, rather than this call directly. The manager handles cache expiry automatically.

Parameters:

key - the job key

Returns:

null if the job does not exist, or the status has expired from the cache.

saveScheduledJobStatus

void saveScheduledJobStatus(ScheduledJobKey key,
                            ScheduledJobStatus status)

Stores the status for the specified job.

Parameters:

key - the job key

status - stores the job status.

updateStatus

void updateStatus(ScheduledJobKey key,
                  ExecutionStatus status)

Updates the status in the corresponding ScheduledJobStatus for the job.

{link #saveScheduledJobStatus} should be called first, otherwise the update will be ignored.

addHistory

void addHistory(ScheduledJobKey key,
                @Nullable ScheduledJobHistory history,
                Date nextOccurrence)

Adds to an event to the history to the cache, and updates the nextOccurrence in the ScheduledJobStatus.

Parameters:

key - the job key

history - the event that occurred

nextOccurrence - the date that the job is expected to execute next

updateNextOccurence

void updateNextOccurence(ScheduledJobKey key,
                         Date nextOccurence)

Updates the nextOccurence in the ScheduledJobStatus.

Parameters:

key - the job key

nextOccurence - the date that the job is expected to execute next

saveScheduledJobConfiguration

void saveScheduledJobConfiguration(ScheduledJobKey key,
                                   ScheduledJobConfiguration jobConfiguration)

Stores the job configuration.

Parameters:

key - the job key

jobConfiguration - the configuration

getScheduledJobConfiguration

@Nullable ScheduledJobConfiguration getScheduledJobConfiguration(ScheduledJobKey key)

Gets the job configuration for the specified job.

Parameters:

key - the job key

Returns:

null if not found.