All Packages  Class Hierarchy  This Package  Previous  Next  Index

Class Acme.Task

java.lang.Object
   |
   +----Acme.Task

public class Task

extends Object

implements Runnable

A Task represents a bit of code that you want to run repeatedly at equally-timed intervals. Doing the timing yourself via sleeps is either inaccurate, since it depends on how long the task takes to run, or else complicated. Well, this class does the timing accurately but hides the complexity from you.

Tasks use the Runnable interface, just like Threads. This means that just like with Threads, there are two different ways you can create a Task:

• You can have your class implement the Runnable interface and add a run() method:

   class Anim implements Runnable
       {
       public void run()
           {
           // do an animation frame
           }
       }
   

  To start this task you would use something like this:

   Anim a = new Anim();
   Acme.Task t = new Acme.Task( a, 1000 );
   

  Or if, as is likely, your class starts the task in its constructor:

   Acme.Task t = new Acme.Task( this, 1000 );
   

• The other way to create a Task is to make a subclass of Task and override the run() method:

   class AnimTask extends Acme.Task
       {
       public void run()
           {
           // do an animation frame
           }
       }
   

  Then you would start it like so:

   Acme.Task t = new AnimTask( 1000 );
   

Fetch the software.
Fetch the entire Acme package.

msPeriod

nextRun

runnable

runner

Task(long)

Constructor for subclasses that override run().

Task(Runnable, long)

Constructor with a Runnable specified.

deschedule()

Stops a Task from running in the future.

run()

The body of the Task.

 protected Runnable runnable

 protected long msPeriod

 protected TaskRunner runner

 protected long nextRun

 public Task(long msPeriod)

Constructor for subclasses that override run().

 public Task(Runnable runnable,
             long msPeriod)

Constructor with a Runnable specified.

 public void run()

The body of the Task. You must either override this method by subclassing class Task, or you must create the Task with a Runnable target.

 public synchronized void deschedule()

Stops a Task from running in the future.

All Packages  Class Hierarchy  This Package  Previous  Next  Index

ACME Java  ACME Labs