org.oscim.utils

Class PausableThread

java.lang.Object

java.lang.Thread

org.oscim.utils.PausableThread

All Implemented Interfaces:

java.lang.Runnable

Direct Known Subclasses:

TileLoader

public abstract class PausableThread
extends java.lang.Thread

An abstract base class for threads which support pausing and resuming.

Nested Class Summary

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

java.lang.Thread.State, java.lang.Thread.UncaughtExceptionHandler

Field Summary

Fields inherited from class java.lang.Thread

MAX_PRIORITY, MIN_PRIORITY, NORM_PRIORITY

Constructor Summary

Constructors

Constructor and Description
PausableThread()

Method Summary

Modifier and Type	Method and Description
protected void	afterPause() Called once when this thread continues to work after a pause.
protected void	afterRun() Called once at the end of the run() method.
void	awaitPausing() Causes the current thread to wait until this thread is pausing.
protected abstract void	doWork() Called when this thread is not paused and should do its work.
void	finish()
protected abstract java.lang.String	getThreadName()
protected int	getThreadPriority()
protected abstract boolean	hasWork()
boolean	isCanceled()
boolean	isPausing()
void	pause() The thread should stop its work temporarily.
void	proceed() The paused thread should continue with its work.
void	run()

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, setContextClassLoader, setDaemon, setDefaultUncaughtExceptionHandler, setName, setPriority, setUncaughtExceptionHandler, sleep, sleep, start, stop, stop, suspend, toString, yield

Methods inherited from class java.lang.Object

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

Constructor Detail

PausableThread

public PausableThread()

Method Detail

awaitPausing

public final void awaitPausing()

Causes the current thread to wait until this thread is pausing.

finish

public void finish()

isPausing

public final boolean isPausing()

Returns:

true if this thread is currently pausing, false otherwise.

pause

public final void pause()

The thread should stop its work temporarily.

proceed

public final void proceed()

The paused thread should continue with its work.

isCanceled

public final boolean isCanceled()

run

public final void run()

Specified by:

run in interface java.lang.Runnable

Overrides:

run in class java.lang.Thread

afterPause

protected void afterPause()

Called once when this thread continues to work after a pause. The default implementation is empty.

afterRun

protected void afterRun()

Called once at the end of the run() method. The default implementation is empty.

doWork

protected abstract void doWork()
                        throws java.lang.InterruptedException

Called when this thread is not paused and should do its work.

Throws:

java.lang.InterruptedException - if the thread has been interrupted.

getThreadName

protected abstract java.lang.String getThreadName()

Returns:

the name of this thread.

getThreadPriority

protected int getThreadPriority()

Returns:

the priority of this thread. The default value is Thread.NORM_PRIORITY.

hasWork

protected abstract boolean hasWork()

Returns:

true if this thread has some work to do, false otherwise.