com.github.marschall.junitlambda

Class HasCause<T extends Throwable>

java.lang.Object

org.hamcrest.BaseMatcher<T>

org.hamcrest.TypeSafeMatcher<T>

com.github.marschall.junitlambda.HasCause<T>

All Implemented Interfaces:

org.hamcrest.Matcher<T>, org.hamcrest.SelfDescribing

public final class HasCause<T extends Throwable>
extends org.hamcrest.TypeSafeMatcher<T>

Tests if the argument is an exception that has a cause.

Method Summary

Modifier and Type	Method and Description
void	describeTo(org.hamcrest.Description description)
static <T extends Throwable> org.hamcrest.Matcher<T>	hasCause(Class<? extends Throwable> causeClass) Creates a matcher that matches if the examined Throwable has a cause that is an instance of the given causeClass.
static <T extends Throwable,C extends Throwable> org.hamcrest.Matcher<T>	hasCause(org.hamcrest.Matcher<C> causeMatcher) Creates a matcher that matches if the examined Throwable has a cause that is matched by the specified causeMatcher.
protected boolean	matchesSafely(T item)

Methods inherited from class org.hamcrest.TypeSafeMatcher

describeMismatch, describeMismatchSafely, matches

Methods inherited from class org.hamcrest.BaseMatcher

_dont_implement_Matcher___instead_extend_BaseMatcher_, toString

Methods inherited from class java.lang.Object

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

Method Detail

hasCause

public static <T extends Throwable,C extends Throwable> org.hamcrest.Matcher<T> hasCause(org.hamcrest.Matcher<C> causeMatcher)

Creates a matcher that matches if the examined Throwable has a cause that is matched by the specified causeMatcher.

For example:

assertThat(anException, hasCause(instanceOf(IOException.class)));

Type Parameters:

T - the expected throwable type

C - the expected cause type

Parameters:

causeMatcher - the matcher to apply to the examined exception cause

Returns:

the matcher

hasCause

public static <T extends Throwable> org.hamcrest.Matcher<T> hasCause(Class<? extends Throwable> causeClass)

Creates a matcher that matches if the examined Throwable has a cause that is an instance of the given causeClass.

For example:

assertThat(anException, hasCause(IOException.class)));

Type Parameters:

T - the expected throwable type

Parameters:

causeClass - the class the exception cause has to be an instance of

Returns:

the matcher

describeTo

public void describeTo(org.hamcrest.Description description)

matchesSafely

protected boolean matchesSafely(T item)

Specified by:

matchesSafely in class org.hamcrest.TypeSafeMatcher<T extends Throwable>