com.whizzosoftware.hobson.api.executor

Interface ExecutorManager

public interface ExecutorManager

A manager interface for both scheduled and immediate tasks. This will be backed by a thread pool and is intended for short-running, asynchronous tasks. This is primarily used by the manager implementations to perform device availability monitoring and housekeeping tasks and prevents the individual managers from creating their own threads and consuming more resources than necessary.

Author:

Dan Noguerol

Method Summary

Modifier and Type	Method and Description
void	cancel(java.util.concurrent.Future f) Cancel a previously scheduled task.
java.util.concurrent.Future	schedule(java.lang.Runnable r, long initialDelay, long delay, java.util.concurrent.TimeUnit unit) Schedule a task to run in the future at a recurring interval.
java.util.concurrent.Future	submit(java.lang.Runnable r) Submit a task for immediate execution.

Method Detail

schedule

java.util.concurrent.Future schedule(java.lang.Runnable r,
                                     long initialDelay,
                                     long delay,
                                     java.util.concurrent.TimeUnit unit)

Schedule a task to run in the future at a recurring interval.

Parameters:

r - the Runnable task to execute

initialDelay - the initial delay in time units

delay - the delay between iterations in time units

unit - the unit of time

Returns:

a Future that can be used to get the status of and cancel the task

submit

java.util.concurrent.Future submit(java.lang.Runnable r)

Submit a task for immediate execution.

Parameters:

r - the Runnable task to execute

Returns:

a Future that can be used to get the status of the task

cancel

void cancel(java.util.concurrent.Future f)

Cancel a previously scheduled task.

Parameters:

f - a Future returned from a call to schedule()