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

UncheckedInterruptedException(InterruptedException e)
Constructor.

Method Summary

static void

ioException(IOException e) InterruptedIOExceptions are a pain to handle as they extend IOException.

Methods inherited from class java.lang.Throwable

fillInStackTrace, getCause, getLocalizedMessage, getMessage, getStackTrace, 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.