Package ch.tocco.nice2.util

Class UnreachableCodeError

java.lang.Object

java.lang.Throwable

java.lang.Error

java.lang.AssertionError

ch.tocco.nice2.util.UnreachableCodeError

All Implemented Interfaces:

Serializable

public class UnreachableCodeError
extends AssertionError

An exception indicating that some portion of code has been reached that is supposed to be unreachable. Example uses are `switch` statements for loops that should always return a value from within the loop. **Example:** ```java public String asString(MyEnum myEnum) { switch ( myEnum ) { case FOO: return "foo"; case BAR: return "bar"; default: // MyEnum has only FOO and BAR, therefore, this code is unreachable, unless // someone adds another enum constant throw new UnreachableCodeException(); } } ``` It can also be used to catch checked exceptions that cannot be thrown: ```java public static final TOCCO_URL; static { try { new URL("http://www.tocco.ch/") } catch ( MalformedURLException e ) { throw new UnreachableCodeException("Hardcoded URL malformed", e); } } ```

See Also:

• Serialized Form

Constructor Summary

Constructors

Constructor	Description
UnreachableCodeError()
UnreachableCodeError(String message)
UnreachableCodeError(String message, Throwable cause)
UnreachableCodeError(Throwable cause)

Method Summary

Modifier and Type	Method	Description
UnreachableCodeError	initCause(Throwable cause)
static UnreachableCodeError	propagate(Throwable e)
static <E1 extends Throwable> UnreachableCodeError	propagate(Throwable e, Class<E1> e1)
static <E1 extends Throwable, E2 extends Throwable> UnreachableCodeError	propagate(Throwable e, Class<E1> e1, Class<E2> e2)
static <E1 extends Throwable, E2 extends Throwable, E3 extends Throwable> UnreachableCodeError	propagate(Throwable e, Class<E1> e1, Class<E2> e2, Class<E3> e3)
static UnreachableCodeError	unreachableCode()
static UnreachableCodeError	unreachableCode(String msg)
static UnreachableCodeError	unreachableCode(String format, Object... args)
static UnreachableCodeError	unreachableCode(Throwable e)

Methods inherited from class java.lang.Throwable

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

Methods inherited from class java.lang.Object

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

Constructor Details

UnreachableCodeError

public UnreachableCodeError()

UnreachableCodeError

public UnreachableCodeError(String message)

UnreachableCodeError

public UnreachableCodeError(String message,
 Throwable cause)

UnreachableCodeError

public UnreachableCodeError(Throwable cause)

Method Details

initCause

public UnreachableCodeError initCause(Throwable cause)

Overrides:

initCause in class Throwable

unreachableCode

public static UnreachableCodeError unreachableCode()

unreachableCode

public static UnreachableCodeError unreachableCode(Throwable e)

unreachableCode

public static UnreachableCodeError unreachableCode(String msg)

unreachableCode

public static UnreachableCodeError unreachableCode(String format,
 Object... args)

propagate

public static UnreachableCodeError propagate(Throwable e)

propagate

public static <E1 extends Throwable>
UnreachableCodeError propagate(Throwable e,
 Class<E1> e1)
                        throws E1

Throws:

E1

propagate

public static <E1 extends Throwable,
E2 extends Throwable>
UnreachableCodeError propagate(Throwable e,
 Class<E1> e1,
 Class<E2> e2)
                        throws E1,
E2

Throws:

E1

E2

propagate

public static <E1 extends Throwable,
E2 extends Throwable,
E3 extends Throwable>
UnreachableCodeError propagate(Throwable e,
 Class<E1> e1,
 Class<E2> e2,
 Class<E3> e3)
                        throws E1,
E2,
E3

Throws:

E1

E2

E3