psl

Class AsyncDispatcher

java.lang.Object

psl.AsyncDispatcher

public class AsyncDispatcher
extends Object

Dispatcher used to run asynchronous requests. A dispatcher runs several threads that execute tasks submitted. It is commonly used to register AsyncDispatchRunnable tasks but any runnable task may be registered.

Constructor Summary

Constructors

Constructor and Description
AsyncDispatcher(String name, ExceptionHandler handler, int threads) Creates a new dispatcher.

Method Summary

Modifier and Type	Method and Description
boolean	alive() Checks whether the dispatcher is still alive.
void	shutdown() Shuts down the dispatcher.
void	submit(Runnable r) Submits a task for execution.
void	wait_clear() Waits until there are no more tasks to process.

Methods inherited from class java.lang.Object

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

Constructor Detail

AsyncDispatcher

public AsyncDispatcher(String name,
                       ExceptionHandler handler,
                       int threads)

Creates a new dispatcher.

Parameters:

name - the dispatcher name

handler - the exception handler; may be null in which case the default handler will be used

threads - number of threads to use in the dispatcher

Method Detail

alive

public boolean alive()

Checks whether the dispatcher is still alive.

Returns:

is the dispatcher alive?

shutdown

public void shutdown()

Shuts down the dispatcher.

submit

public void submit(Runnable r)

Submits a task for execution.

Parameters:

r - the task, cannot be null

wait_clear

public void wait_clear()

Waits until there are no more tasks to process. Because this method is unsafe as tasks can be submitted right after the method has returned, it is usually only useful in tightly-controlled environments such as unit tests.