net.grinder.common

Class UncheckedInterruptedException

java.lang.Object

java.lang.Throwable

java.lang.Exception

java.lang.RuntimeException

net.grinder.common.UncheckedGrinderException

net.grinder.common.UncheckedInterruptedException

All Implemented Interfaces:

Serializable

public class UncheckedInterruptedException
extends UncheckedGrinderException

Make InterruptedExceptions and InterruptedIOExceptions easier to propagate.

Our policy on interrupt handling:

• Thread.interrupt() and ThreadGroup.interrupt() are used in shut down code. We can't simply swallow InterruptedExceptions.
• Whenever core code catches an InterruptedException which it doesn't know how to handle, it rethrows it in an UncheckedInterruptedException.
• InterruptibleRunnable.interruptibleRun() implementations are carefully reviewed to ensure that they do not ignore the interrupt condition and will exit whenever InterruptedException and InterruptedIOExceptions are received. We only interrupt code that implements InterruptibleRunnable.interruptibleRun().
• The InterruptibleRunnable's are invoked by wrapping then in an InterruptibleRunnableAdapter. This exits cleanly, silently handling UncheckedInterruptedExceptions.
• Whenever core code outside an InterruptibleRunnable catches an IOException, it calls ioException(IOException), which will throw an UncheckedInterruptedException if necessary.
• Other code may exit cleanly or may ignore the interrupt condition due to third-party libraries swallowing InterruptedExceptions. This doesn't matter as we should never interrupt this code.

Author:

Philip Aston

See Also:

Serialized Form

Constructor Summary

Constructors

Constructor and Description
UncheckedInterruptedException(InterruptedException e) Constructor.

Method Summary

Methods

Modifier and Type	Method and Description
static void	ioException(IOException e) InterruptedIOExceptions are a pain to handle as they extend IOException.

Methods inherited from class java.lang.Throwable

addSuppressed, fillInStackTrace, getCause, getLocalizedMessage, getMessage, getStackTrace, getSuppressed, initCause, printStackTrace, printStackTrace, printStackTrace, setStackTrace, toString

Methods inherited from class java.lang.Object

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

Constructor Detail

UncheckedInterruptedException

public UncheckedInterruptedException(InterruptedException e)

Constructor.

Parameters:

e - The original InterruptedException.

Method Detail

ioException

public static void ioException(IOException e)

InterruptedIOExceptions are a pain to handle as they extend IOException. IOException handlers should call this, unless they are part of an InterruptibleRunnable and know what they're doing.

Parameters:

e - An IOException.