org.mapsforge.map.util

Class PausableThread

java.lang.Object

java.lang.Thread

org.mapsforge.map.util.PausableThread

All Implemented Interfaces:

Runnable

Direct Known Subclasses:

LayerManager, MapWorker

public abstract class PausableThread
extends Thread

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

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
protected static class	PausableThread.ThreadPriority Specifies the scheduling priority of a Thread.

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

Thread.State, 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

Methods

Modifier and Type	Method and Description
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.
protected abstract PausableThread.ThreadPriority	getThreadPriority()
protected abstract boolean	hasWork()
void	interrupt()
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, 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.

interrupt

public void interrupt()

Overrides:

interrupt in class Thread

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.

run

public final void run()

Specified by:

run in interface Runnable

Overrides:

run in class Thread

afterRun

protected void afterRun()

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

doWork

protected abstract void doWork()
                        throws InterruptedException

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

Throws:

InterruptedException - if the thread has been interrupted.

getThreadPriority

protected abstract PausableThread.ThreadPriority getThreadPriority()

Returns:

the priority which will be set for this thread.

hasWork

protected abstract boolean hasWork()

Returns:

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