org.apache.commons.httpclient.util
Class TimeoutController

java.lang.Object
  org.apache.commons.httpclient.util.TimeoutController

public final class TimeoutController
extends Object

Executes a task with a specified timeout.

Since:

2.0

Version:

$Revision$

Author:

Ortwin Glueck, Mike Bowler

Nested Class Summary

static class

TimeoutController.TimeoutException Signals that the task timed out.

Method Summary

static void	execute(Runnable task, long timeout) Executes task in a new deamon Thread and waits for the timeout.
static void	execute(Thread task, long timeout) Executes task.

Methods inherited from class java.lang.Object

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

Method Detail

execute

public static void execute(Thread task,
                           long timeout)
                    throws TimeoutController.TimeoutException

Executes task. Waits for timeout milliseconds for the task to end and returns. If the task does not return in time, the thread is interrupted and an Exception is thrown. The caller should override the Thread.interrupt() method to something that quickly makes the thread die or use Thread.isInterrupted().

Parameters:

task - The thread to execute

timeout - The timeout in milliseconds. 0 means to wait forever.

Throws:

TimeoutController.TimeoutException - if the timeout passes and the thread does not return.

execute

public static void execute(Runnable task,
                           long timeout)
                    throws TimeoutController.TimeoutException

Executes task in a new deamon Thread and waits for the timeout.

Parameters:

task - The task to execute

timeout - The timeout in milliseconds. 0 means to wait forever.

Throws:

TimeoutController.TimeoutException - if the timeout passes and the thread does not return.