hu.scelightapibase.util

Interface INormalThread

All Known Subinterfaces:

IControlledThread, IJob, IProgressJob

public interface INormalThread

A normal thread interface with some utility methods.

Instances provided by the API extend Thread and do not take the inherited priority but instead set Thread.NORM_PRIORITY and install an Thread.UncaughtExceptionHandler which simply logs any uncaught exceptions.

Example usage of INormalThread:

 

 INormalThread nt; // If your runnable needs the reference: must be instance attribute or else a reference wrapper
 
 nt = factory.newNormalThread( "Example", new Runnable() {
        public void run() {
                nt.checkedSleep( 500 );
                System.out.println( "I am a NormalThread." );
        }
 } );
 
 // Start the normal thread:
 nt.start();
 
 System.out.println( "I am not a NormalThread." );
 // Wait for it to finish:
 nt.waitToFinish();
 
 

Author:

Andras Belicza

See Also:

IFactory.newNormalThread(String, Runnable), IControlledThread

Method Summary

Methods

Modifier and Type	Method and Description
java.lang.Thread	asThread() Casts this instance to Thread.
java.lang.InterruptedException	checkedSleep(long ms) Sleeps for the specified amount of milliseconds.
void	start() Starts the thread.
boolean	waitToFinish() Waits for this thread to finish.

Method Detail

asThread

java.lang.Thread asThread()

Casts this instance to Thread.

Returns:

this as a Thread

waitToFinish

boolean waitToFinish()

Waits for this thread to finish.

Returns:

true if thread finished properly; false otherwise (interrupted)

checkedSleep

java.lang.InterruptedException checkedSleep(long ms)

Sleeps for the specified amount of milliseconds.

Parameters:

ms - milliseconds to sleep

Returns:

the exception that was thrown if sleep was interrupted; null otherwise

start

void start()

Starts the thread. See Thread.start() for details.

See Also:

Thread.start()