Controlling Daemon Execution

The AdministrationService provides the following options to handle daemons:

• Retrieving a Specified Daemon
• Starting a Daemon
• Stopping a Daemon
• Retrieving a List of All Available Daemons

Please refer to the section AdministrationService of the chapter Stardust Services for information on this service or the according Javadoc of the AdministrationService for detailed information on its methods and their parameter usage.

Retrieving a Specified Daemon

To retrieve information on a daemon with a specified daemon type, use the method getDaemon:

Daemon getDaemon(String daemonType, boolean acknowledge)
    throws ObjectNotFoundException;

The following daemon types are provided:

• event.daemon for the event daemon
• mail.trigger for the mail trigger daemon
• timer.trigger for the timer trigger daemon.
• system.daemon for the notification daemon.
• criticality.daemon for the prioritization daemon.

The parameter acknowledge determines whether the daemon information should be acknowledged. If no daemon with the specified type is found, an ObjectNotFoundException is thrown.

Starting a Daemon

To start a daemon with a specified daemon type, use the method startDaemon:

Daemon startDaemon(String daemonType, boolean acknowledge)
    throws ObjectNotFoundException;

The parameter acknowledge determines whether the start operation should be acknowledged. If started with acknowledgment, then each new request first checks that previous requests have been acknowledged and are not still in response-requested state. When started without acknowledgment, these checks will not be made.

If no daemon with the specified type is found, an ObjectNotFoundException is thrown.

Stopping a Daemon

To stop a daemon with a specified daemon type, use the method stopDaemon:

Daemon stopDaemon(String daemonType, boolean acknowledge)
    throws ObjectNotFoundException;

The parameter acknowledge determines whether the stop operation should be acknowledged. If no daemon with the specified type is found, an ObjectNotFoundException is thrown.

Retrieving a List of All Available Daemons

To retrieve a list of all the available daemons, use the method getAllDeamons:

List<Daemon> getAllDaemons(boolean acknowledge) throws AccessForbiddenException;

This method returns a list with the available Daemon objects. The parameter acknowledge determines whether the daemon information should be acknowledged. If you have no permission to manage daemons, an AccessForbiddenException is thrown.