com.prosyst.mprm.backend.monitor

Interface WatchdogService

public interface WatchdogService

The WatchdogService provides Monitorable objects control. It is registered as an OSGi service in the service registry and it takes care of all Monitorable objects that want to be monitored and recovered from an unexpected execution stopping.

See Also:

Monitorable

Method Summary

Modifier and Type	Method and Description
void	registerMonitorable(Monitorable monitorable, long timeout, Action recoveryAction) Registers a Monitorable object to be monitored and recovered from an unexpected execution stopping.
void	reportActive(Monitorable monitorable) Monitorable object calls this method to inform the WatchdogService that it is executed as expected and it is under no unexpected circumstances.
void	unregisterMonitorable(Monitorable monitorable) Stops object monitoring

Method Detail

registerMonitorable

void registerMonitorable(Monitorable monitorable,
                         long timeout,
                         Action recoveryAction)

Registers a Monitorable object to be monitored and recovered from an unexpected execution stopping. The recoveryAction is launch if the object denoted by the monitorable has been irresponsive for a timeout time. Irresponsive time timer is started after the last reportActive(Monitorable) method call.

Parameters:

monitorable - the object to be monitored

timeout - the time in milliseconds to wait before recovery action initiation

recoveryAction - the action to launch to recover the object

See Also:

reportActive(Monitorable)

unregisterMonitorable

void unregisterMonitorable(Monitorable monitorable)

Stops object monitoring

Parameters:

monitorable - the object to stop to monitor

reportActive

void reportActive(Monitorable monitorable)

Monitorable object calls this method to inform the WatchdogService that it is executed as expected and it is under no unexpected circumstances. After this method call the timer measuring the object irresponsive time is reset.

Parameters:

monitorable - the object reported as active