uk.kludje

Class Exceptions

java.lang.Object

uk.kludje.Exceptions

public final class Exceptions
extends java.lang.Object

Methods for translating checked exceptions to unchecked exceptions and back.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	Exceptions.ExceptionDeclarer A utility type for declaring exceptions.
static class	Exceptions.UncheckedMarker This error type cannot be thrown; it exists to allow callers of throwChecked(Throwable) to express intent with the throw keyword.

Method Summary

Modifier and Type	Method and Description
static <T extends java.lang.Throwable> Exceptions.ExceptionDeclarer	expected() Declares checked the scope expects a checked exception.
static Exceptions.UncheckedMarker	throwChecked(java.lang.Throwable t) Throws any type of Throwable as an unchecked type.

Methods inherited from class java.lang.Object

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

Method Detail

throwChecked

public static Exceptions.UncheckedMarker throwChecked(java.lang.Throwable t)

Throws any type of Throwable as an unchecked type.

Usage:

   void foo(Closeable c) {
     try {
       c.close();
     } catch(IOException e) {
       throw Exceptions.throwChecked(e);
     }
   }
 

Parameters:

t - the (non-null) type to throw

Returns:

an unchecked throwable type for syntax reasons

expected

public static <T extends java.lang.Throwable> Exceptions.ExceptionDeclarer expected()
                                                                             throws T extends java.lang.Throwable

Declares checked the scope expects a checked exception. Use this method to catch a checked exception checked is not detected by the compiler.

Usage:

   abstract void bar();

   void foo() {
      try {
        Exceptions
            .<IOException>expected()
            .<MethodNotFoundException>expected();

        bar();

      } catch(IOException|MethodNotFoundException e) {
        // handle error
      }
   }
 

Type Parameters:

T - the type of exception expected

Returns:

a fluent instance

Throws:

T - the exception

T extends java.lang.Throwable