org.imixs.workflow.engine.scheduler

Class SchedulerService

java.lang.Object

org.imixs.workflow.engine.scheduler.SchedulerService

@DeclareRoles(value="org.imixs.ACCESSLEVEL.MANAGERACCESS")
 @RunAs(value="org.imixs.ACCESSLEVEL.MANAGERACCESS")
public class SchedulerService
extends Object

The SchedulerService EJB can be used to start, monitor and stop custom scheduler implementation. A Scheduler Implementation must implement the Interface "org.imixs.workflow.engine.scheduler.Scheduler".

A scheduler definition is stored in a document with the type "scheduler". The document can provide concrete information to process the timer event.

The TimerService can be started using the method start(). The Methods findTimerDescription and findAllTimerDescriptions are used to lookup enabled and running service instances.

Each Method expects or generates a TimerDescription Object. This object is an instance of a ItemCollection. To create a new timer the ItemCollection should contain the following attributes:

• type - fixed to value 'scheduler'
• _scheduler_definition - the chron/calendar definition for the Java EE timer service.
• _scheduler_enabled - boolean indicates if the scheduler is enabled/disabled
• _scheduler_class - class name of the scheduler implementation
• _scheduelr_log - optional log information

the following additional attributes are generated by the finder methods and can be used by an application to verfiy the status of a running instance:

• nextTimeout - Next Timeout - pint of time when the service will be scheduled
• timeRemaining - Timeout in milliseconds
• statusmessage - text message

Version:

1.0

Author:

rsoika

Field Summary

Fields

Modifier and Type	Field and Description
static String	DOCUMENT_TYPE

Constructor Summary

Constructors

Constructor and Description
SchedulerService()

Method Summary

Modifier and Type	Method and Description
javax.ejb.Timer	findTimer(String id) This method returns a timer for a corresponding id if such a timer object exists.
ItemCollection	loadConfiguration(String name) Loads the scheduler configuration entity by name.
ItemCollection	saveConfiguration(ItemCollection configItemCollection) This method saves the scheduler configuration.
ItemCollection	start(ItemCollection configuration) Starts a new Timer for the scheduler defined by the Configuration.
void	startAllSchedulers() This method will start all schedulers which are not yet started.
ItemCollection	stop(ItemCollection configuration) Cancels a running timer instance.
ItemCollection	stop(ItemCollection configuration, javax.ejb.Timer timer)
void	updateTimerDetails(ItemCollection configuration) Updates the timer details of a running timer service.

Methods inherited from class java.lang.Object

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

Field Detail

DOCUMENT_TYPE

public static final String DOCUMENT_TYPE

See Also:

Constant Field Values

Constructor Detail

SchedulerService

public SchedulerService()

Method Detail

loadConfiguration

public ItemCollection loadConfiguration(String name)

Loads the scheduler configuration entity by name. The method returns null if no scheduler configuration exits.

Returns:

saveConfiguration

public ItemCollection saveConfiguration(ItemCollection configItemCollection)

This method saves the scheduler configuration. The method ensures that the following properties are set to default.

• type
• txtName
• $writeAccess
• $readAccess

The method also updates the timer details of a running timer.

Returns:

Throws:

AccessDeniedException

start

public ItemCollection start(ItemCollection configuration)
                     throws AccessDeniedException,
                            ParseException

Starts a new Timer for the scheduler defined by the Configuration.

The Timer can be started based on a Calendar setting stored in the property _scheduler_definition.

The $UniqueID of the configuration entity is the id of the timer to be controlled.

The method throws an exception if the configuration entity contains invalid attributes or values.

After the timer was started the configuration is updated with the latest statusmessage. The item _schedueler_enabled will be set to 'true'.

The method returns the updated configuration. The configuration will not be saved!

Parameters:

configuration - - scheduler configuration

Returns:

updated configuration

Throws:

AccessDeniedException

ParseException

stop

public ItemCollection stop(ItemCollection configuration)

Cancels a running timer instance. After cancel a timer the corresponding timerDescripton (ItemCollection) is no longer valid.

The method returns the current configuration. The configuration will not be saved!

stop

public ItemCollection stop(ItemCollection configuration,
                           javax.ejb.Timer timer)

startAllSchedulers

public void startAllSchedulers()

This method will start all schedulers which are not yet started. The method is called for example by the SchedulerStartupServlet.

findTimer

public javax.ejb.Timer findTimer(String id)

This method returns a timer for a corresponding id if such a timer object exists.

Parameters:

id -

Returns:

Timer

Throws:

Exception

updateTimerDetails

public void updateTimerDetails(ItemCollection configuration)

Updates the timer details of a running timer service. The method updates the properties netxtTimeout and timeRemaining and store them into the timer configuration.

Parameters:

configuration - - the current scheduler configuration to be updated.