uk.org.lidalia.lang

Class Exceptions

java.lang.Object

uk.org.lidalia.lang.Exceptions

public final class Exceptions
extends Object

Static utility functions around Exception management.

Method Summary

Methods

Modifier and Type	Method and Description
static void	throwUnchecked(Throwable toThrow)
static <T> T	throwUnchecked(Throwable toThrow, T returnType) Because this method throws an unchecked exception, when it is called in a method with a return type the compiler does not know the method is exiting, requiring a further line to return null or throw an unchecked exception directly.

Methods inherited from class java.lang.Object

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

Method Detail

throwUnchecked

public static <T> T throwUnchecked(Throwable toThrow,
                   T returnType)

Because this method throws an unchecked exception, when it is called in a method with a return type the compiler does not know the method is exiting, requiring a further line to return null or throw an unchecked exception directly. This generified method allows this to be avoided by tricking the compiler by adding a return statement as so:

     String someMethod() {
         try {
             somethingThatThrowsException();
         } catch (Exception e) {
             return throwUnchecked(e, null); // does not actually return, throws the exception
         }
     }
 

Parameters:

toThrow - The throwable that will be thrown, unwrapped and unchecked; must not be null

returnType - trick to persuade the compiler that a method returns appropriately - always pass null here

Returns:

Never returns, always throws the passed in exception

Throws:

NullPointerException - if toThrow is null

throwUnchecked

public static void throwUnchecked(Throwable toThrow)

Parameters:

toThrow - The throwable that will be thrown, unwrapped and unchecked; must not be null

Throws:

NullPointerException - if toThrow is null