org.openeai.afa
Class Schedule

java.lang.Object

  |

  +--org.openeai.OpenEaiObject

        |

        +--org.openeai.afa.Schedule

public class Schedule

extends OpenEaiObject

This is a class that wraps the execution details of a set of commands. It keeps track of when a particular command(s) should execute. The ScheduledApp class will use these objects to determine when commands associated to this Schedule should run. Then the ScheduledApp will execute the command(s) associated with this Schedule.

The Schedule object allows a flexible mechanism to associate certain times, days or intervals at which the ScheduledCommands associated to this schedule should run. By querying this information the ScheduledApp component can determine if the ScheduledCommands associated to this Schedule should run and if so, execute them.

Version:

3.0 beta2 - 28 January 2003

Author:

Tod Jackson (tod@openeai.org), Steve Wheat (steve@openeai.org)

Field Summary

Fields inherited from class org.openeai.OpenEaiObject

logger

Constructor Summary

Schedule(ScheduleConfig sConfig)
Constructs the Schedule object with a ScheduleConfig object which wraps the Schedules information found in the ScheduledApp's deployment document.

Method Summary

void	addCommand(java.lang.String name, CommandConfig cConfig) Adds a command to this schedule.
ScheduledCommand	getCommand(java.lang.String name) Returns a ScheduledCommand associated to this schedule by name.
java.util.HashMap	getCommands() Returns all ScheduledCommands associated to this schedule.
java.lang.String	getName() Returns the Schedule name according to information found in the config document for the application being configured.
java.util.List	getScheduleRuntimes() Returns an ArrayList that contains ScheduleRuntime objects associated to this Schedule.
boolean	isImmediate() Tells the caller if this Schedule is suppose to run immediately.
void	setCommands(java.util.HashMap commands) Sets all ScheduledCommands associated to this schedule.
void	setName(java.lang.String name) Sets the Schedule name according to information found in the config document for the application being configured.
boolean	shouldRun() Determines if the ScheduledCommands associated to this Schedule should run.

Methods inherited from class org.openeai.OpenEaiObject

addLog4jProperty, getAppName, getDebug, getFromAddr, getLog4jProperties, getMailHost, getMailService, getProperties, getToAddr, initializeLog4j, initializeLog4j, initializeLog4j, setAppName, setDebug, setFromAddr, setMailHost, setMailService, setProperties, setToAddr

Methods inherited from class java.lang.Object

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

Constructor Detail

Schedule

public Schedule(ScheduleConfig sConfig)

Constructs the Schedule object with a ScheduleConfig object which wraps the Schedules information found in the ScheduledApp's deployment document.

Method Detail

addCommand

public final void addCommand(java.lang.String name,
                             CommandConfig cConfig)

Adds a command to this schedule. This will be performed when AppConfig is instantiating and configuring the ScheduledApp that contains this schedule. This method will instantiate the command by passing the CommandConfig object and link that command to a name. Then when it is determined that the Schedule is suppose to run, it will be able to return the command(s) associated to this Schedule for execution.

getCommand

public final ScheduledCommand getCommand(java.lang.String name)

Returns a ScheduledCommand associated to this schedule by name. This will be called by the ScheduledApp when it determines that this schedule should execute. It will retrieve command(s) from this Schedule and call their 'execute' methods.

Returns:

ScheduledCommand an implementation of the ScheduledCommand interface.

setCommands

public final void setCommands(java.util.HashMap commands)

Sets all ScheduledCommands associated to this schedule. This is called when the Schedule is initialized.

getCommands

public final java.util.HashMap getCommands()

Returns all ScheduledCommands associated to this schedule.

Returns:

HashMap of ScheduledCommands.

setName

public final void setName(java.lang.String name)

Sets the Schedule name according to information found in the config document for the application being configured.

getName

public final java.lang.String getName()

Returns the Schedule name according to information found in the config document for the application being configured.

Returns:

String the Schedule name

getScheduleRuntimes

public final java.util.List getScheduleRuntimes()

Returns an ArrayList that contains ScheduleRuntime objects associated to this Schedule. These will be used to determine if it's time to run this schedule.

shouldRun

public final boolean shouldRun()
                        throws ScheduleIdStoreException

Determines if the ScheduledCommands associated to this Schedule should run. This is determined by a number of factors all configured via the ScheduledApp's deployment document.

Factors that determine when a Schedule should be ran include the Schedule's 'runtime'. The Schedule object contains a list of 'runtimes' associated to this Schedule that tell it the Days and Times that this Schedule should be ran. When a Schedule has been executed, it will update its ScheduleIdStore indicating that the Schedule has been run. This store is checked to ensure a Schedule is not executed more than once in a given day. This store is persisted to a configurable location to survive the application stopping and starting. When the day changes (midnight is reached) the Schedule will remove any Schedule id's from the store for the new day so they will again be executed.

Returns:

boolean, true if the ScheduledCommands associated to this Schedule should run, false if not.

Throws:

ScheduleIdStoreException - if errors occur determining if the Schedule should be ran.

See Also:

ScheduleRuntime, ScheduleIdStore

isImmediate

public final boolean isImmediate()

Tells the caller if this Schedule is suppose to run immediately.

Returns:

boolean