org.anc.threads

Class ANCThread

java.lang.Object

java.lang.Thread

org.anc.threads.ANCThread

All Implemented Interfaces:

Runnable, Haltable

public abstract class ANCThread
extends Thread
implements Haltable

Extends the Java Thread call and add a halt() method.

Classes that extend ANCThread must:

• Terminate cleanly when the running flag is set to false, or
• Override the halt() method and terminate cleanly when it is called.

Version:

1.0

Author:

Keith Suderman

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	ANCThread.Event Events sent to listeners.
static class	ANCThread.State State values.

Nested classes/interfaces inherited from class java.lang.Thread

Thread.UncaughtExceptionHandler

Field Summary

Fields inherited from class java.lang.Thread

MAX_PRIORITY, MIN_PRIORITY, NORM_PRIORITY

Constructor Summary

Constructors

Constructor and Description
ANCThread()

Method Summary

Modifier and Type	Method and Description
void	addListener(IANCThreadListener listener)
protected void	fire(ANCThread.Event event)
void	halt() Halts the thread by setting running to false.
void	pause()
void	pause(long millis) Helper method that wraps a call to sleep in a try/catch block.
void	removeListener(IANCThreadListener listener)
void	restart()
boolean	running()
void	start()
ANCThread.State	state()
void	terminate()

Methods inherited from class java.lang.Thread

activeCount, checkAccess, clone, countStackFrames, currentThread, destroy, dumpStack, enumerate, getAllStackTraces, getContextClassLoader, getDefaultUncaughtExceptionHandler, getId, getName, getPriority, getStackTrace, getState, getThreadGroup, getUncaughtExceptionHandler, holdsLock, interrupt, interrupted, isAlive, isDaemon, isInterrupted, join, join, join, resume, run, setContextClassLoader, setDaemon, setDefaultUncaughtExceptionHandler, setName, setPriority, setUncaughtExceptionHandler, sleep, sleep, stop, stop, suspend, toString, yield

Methods inherited from class java.lang.Object

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

Constructor Detail

ANCThread

public ANCThread()

Method Detail

addListener

public void addListener(IANCThreadListener listener)

removeListener

public void removeListener(IANCThreadListener listener)

state

public ANCThread.State state()

running

public boolean running()

halt

public void halt()

Halts the thread by setting running to false. Also calls notifyAll() to wake anything that might be waiting on this thread.

Specified by:

halt in interface Haltable

pause

public void pause(long millis)

Helper method that wraps a call to sleep in a try/catch block.

Parameters:

millis - long The number of milliseconds the thread should sleep.

pause

public void pause()

restart

public void restart()

start

public void start()

Overrides:

start in class Thread

terminate

public void terminate()

fire

protected void fire(ANCThread.Event event)