org.cornutum.hamcrest

Class ExpectedFailure<T extends Throwable>

java.lang.Object

org.cornutum.hamcrest.ExpectedFailure<T>

public class ExpectedFailure<T extends Throwable>
extends Object

Reports a failure if an expected Throwable is not thrown by a given action.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static interface	ExpectedFailure.Failable Implements an action that could throw any type of Throwable, including a checked exception.

Constructor Summary

Constructors

Constructor and Description
ExpectedFailure(Class<T> failureType) Creates a new ExpectedFailure instance.

Method Summary

Modifier and Type	Method and Description
static ExpectedFailure<AssertionError>	expectFailure() Returns a new ExpectedFailure instance that expects an AssertionError.
static <F extends Throwable> ExpectedFailure<F>	expectFailure(Class<F> failureType) Returns a new ExpectedFailure instance.
void	then(Consumer<T> failureChecker) After performing an action, apply the given checker to verify details of the expected failure.
String	toString()
ExpectedFailure<T>	when(ExpectedFailure.Failable action) Throws an AssertionError if the expected Throwable is not thrown by the given action.
ExpectedFailure<T>	when(ExpectedFailure.Failable action, Function<Throwable,Throwable> failureMapper) Throws an AssertionError if the expected Throwable is not thrown by the given action.

Methods inherited from class java.lang.Object

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

Constructor Detail

ExpectedFailure

public ExpectedFailure(Class<T> failureType)

Creates a new ExpectedFailure instance.

Method Detail

when

public ExpectedFailure<T> when(ExpectedFailure.Failable action)

Throws an AssertionError if the expected Throwable is not thrown by the given action.

when

public ExpectedFailure<T> when(ExpectedFailure.Failable action,
                               Function<Throwable,Throwable> failureMapper)

Throws an AssertionError if the expected Throwable is not thrown by the given action. The expected Throwable is defined by applying the failureMapper to the Throwable produced by the action.

then

public void then(Consumer<T> failureChecker)

After performing an action, apply the given checker to verify details of the expected failure.

expectFailure

public static <F extends Throwable> ExpectedFailure<F> expectFailure(Class<F> failureType)

Returns a new ExpectedFailure instance.

expectFailure

public static ExpectedFailure<AssertionError> expectFailure()

Returns a new ExpectedFailure instance that expects an AssertionError.

toString

public String toString()

Overrides:

toString in class Object