com.ochafik.lang
Class Threads

java.lang.Object
  com.ochafik.lang.Threads

public final class Threads
extends Object

Group of coordinated Runnable instances that can be started, interrupted and waited for together.

Once you added as many runnable tasks as needed through the add(Runnable) method, there are two ways of waiting for the tasks to finish :

• call join() in some thread. This will implicitely start the threads if start() was not called yet, and the join() method will not return until all the thread finished their execution
• call start() and register some ActionListener instances. Whenever all threads finished their execution, the actionPerformed method of all the listeners will be called.

Author:

Olivier Chafik

Nested Class Summary

static class

Threads.State

Constructor Summary

Threads()


Method Summary

<T extends Runnable> T	add(T runnable) Add a task that is to be executed in its own thread.
void	addActionListener(ActionListener actionListener) Adds a listener that will be notified upon completion of all of the running threads.
Threads.State	getState()
void	interrupt() Calls interrupt() on each of the running threads.
void	join() Waits for all runnable to have finished their execution.
void	start() Starts all the threads.

Methods inherited from class java.lang.Object

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

Constructor Detail

Threads

public Threads()

Method Detail

add

public <T extends Runnable> T add(T runnable)

Add a task that is to be executed in its own thread.

Parameters:

runnable - task to be executed in its own thread

Returns:

the runnable argument unchanged

start

public void start()

Starts all the threads.

Throws:

IllegalThreadStateException - if the threads were already started.

NoSuchElementException - if no runnable were added to this Threads instance.

interrupt

public void interrupt()

Calls interrupt() on each of the running threads.

Throws:

IllegalThreadStateException - if threads were not started

join

public void join()
          throws InterruptedException

Waits for all runnable to have finished their execution. Can be called multiple times : after the first time, this method always returns immediately. If the Threads is not started yet, this method will start it implicitely.

Throws:

InterruptedException - if method interrupt() was called on the thread that is calling this method.

getState

public Threads.State getState()

addActionListener

public void addActionListener(ActionListener actionListener)

Adds a listener that will be notified upon completion of all of the running threads. Its actionPerformed method will be called immediately if the threads already finished.

Parameters:

actionListener -