com.sun.tv.media.util

Class LoopThread

java.lang.Object

java.lang.Thread

com.sun.tv.media.util.MediaThread

com.sun.tv.media.util.LoopThread

All Implemented Interfaces:

Runnable

public abstract class LoopThread
extends MediaThread

LoopThread A looping thread that implements a safe way of pausing and restarting. Instead of using suspend() and resume() from the thread class, a pause() and restart() method is provided. To use it, you will: - subclass from it; - overwrite the process() callback; - call start() to initiate the thread.

Version:

1.9, 98/09/28

Nested Class Summary

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

Thread.State, Thread.UncaughtExceptionHandler

Field Summary

Fields

Modifier and Type	Field and Description
protected boolean	killed
protected boolean	paused
protected boolean	restarted

Fields inherited from class com.sun.tv.media.util.MediaThread

mediaThreadGroup

Fields inherited from class java.lang.Thread

MAX_PRIORITY, MIN_PRIORITY, NORM_PRIORITY

Constructor Summary

Constructors

Constructor and Description
LoopThread() The pause flag determines the initial state.

Method Summary

Methods

Modifier and Type	Method and Description
void	blockingPause()
void	doKilled() Callback before the thread is killed.
void	doPause() Callback before the thread goes into the pause state.
boolean	isPaused()
void	kill()
void	pause() Set the paused state to true.
abstract boolean	process() process callback function.
void	restart() Resume the loop at the beginning of the loop where waitHereIfPaused() is called.
void	run() The run method for the Thread class.
void	waitHereIfPaused() Put the thread in a wait() if the paused state is on.

Methods inherited from class com.sun.tv.media.util.MediaThread

getMediaThreadGroup, useAudioPriority, useControlPriority, useNetworkPriority, useVideoPriority

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

Field Detail

paused

protected boolean paused

restarted

protected boolean restarted

killed

protected boolean killed

Constructor Detail

LoopThread

public LoopThread()

The pause flag determines the initial state.

Method Detail

pause

public void pause()

Set the paused state to true. The thread will halt at the beginning of the loop at the next iteration. i.e., unlike suspend(), the thread will NOT pause immediately. It will execute until the next waitHereIfPaused() is encountered.

isPaused

public boolean isPaused()

blockingPause

public void blockingPause()

restart

public void restart()

Resume the loop at the beginning of the loop where waitHereIfPaused() is called.

kill

public void kill()

waitHereIfPaused

public void waitHereIfPaused()

Put the thread in a wait() if the paused state is on. Otherwise, it will just proceed.

process

public abstract boolean process()

process callback function.

doPause

public void doPause()

Callback before the thread goes into the pause state. Be careful not to block in this thread.

doKilled

public void doKilled()

Callback before the thread is killed. Be careful not to block in this thread.

run

public void run()

The run method for the Thread class.

Specified by:

run in interface Runnable

Overrides:

run in class Thread