com.atlassian.confluence.schedule.persistence.dao
Interface ScheduledJobDao

All Known Implementing Classes:
CachedScheduledJobDao

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


Method Summary
 void addHistory(ScheduledJobKey key, ScheduledJobHistory history, Date nextOccurence, boolean persistHistory)
          Adds to an event to the history, and updates the nextOccurence in the ScheduledJobStatus.
 ScheduledJobConfiguration getScheduledJobConfiguration(ScheduledJobKey key)
          Gets the job configuration for the specified job.
 String getScheduledJobDefaultCronExpression(ScheduledJobKey key)
          Gets the default cron expression for the job.
 List<ScheduledJobHistory> getScheduledJobHistory(ScheduledJobKey key)
          The the job history for a specified job.
 ScheduledJobStatus getScheduledJobStatus(ScheduledJobKey key)
          Gets the specified job's status.
 void saveScheduledJobConfiguration(ScheduledJobKey key, ScheduledJobConfiguration jobConfiguration)
          Stores the job configuration.
 void saveScheduledJobDefaultCronExpression(ScheduledJobKey key, String cronExpressionDefault)
          Stores the default cron expression for a job.
 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

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.

Parameters:
key -
status -

addHistory

void addHistory(ScheduledJobKey key,
                ScheduledJobHistory history,
                Date nextOccurence,
                boolean persistHistory)
Adds to an event to the history, and updates the nextOccurence in the ScheduledJobStatus.

Parameters:
key - the job key
history - the event that occurred
nextOccurence - the date that the job is expected to execute next
persistHistory - true the history will be persisted

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

getScheduledJobHistory

List<ScheduledJobHistory> getScheduledJobHistory(ScheduledJobKey key)
The the job history for a specified job.

Parameters:
key - the job key
Returns:
a list of ScheduledJobHistory. Null if no history has been recorded or persisted.

saveScheduledJobConfiguration

void saveScheduledJobConfiguration(ScheduledJobKey key,
                                   ScheduledJobConfiguration jobConfiguration)
Stores the job configuration.

Parameters:
key - the job key
jobConfiguration - the configuration

getScheduledJobConfiguration

ScheduledJobConfiguration getScheduledJobConfiguration(ScheduledJobKey key)
Gets the job configuration for the specified job.

Parameters:
key - the job key
Returns:
null if not found.

saveScheduledJobDefaultCronExpression

void saveScheduledJobDefaultCronExpression(ScheduledJobKey key,
                                           String cronExpressionDefault)
Stores the default cron expression for a job.

Parameters:
key - the job key
cronExpressionDefault -

getScheduledJobDefaultCronExpression

String getScheduledJobDefaultCronExpression(ScheduledJobKey key)
Gets the default cron expression for the job.

Parameters:
key - the job key
Returns:
null if job not found.


Copyright © 2003-2011 Atlassian. All Rights Reserved.