org.cthul.matchers.diagnose.safe

Class TypesafeNestedMatcher<T>

java.lang.Object

org.hamcrest.BaseMatcher<T>

org.cthul.matchers.diagnose.QuickDiagnosingMatcherBase<T>

org.cthul.matchers.diagnose.nested.NestedMatcher<T>

org.cthul.matchers.diagnose.safe.TypesafeNestedMatcher<T>

Type Parameters:

T -

All Implemented Interfaces:

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

Direct Known Subclasses:

TypesafeNestedResultMatcher

public abstract class TypesafeNestedMatcher<T>
extends NestedMatcher<T>

Combines multiple matchers. When creating a (mismatch) description, PrecedencedSelfDescribing.getDescriptionPrecedence() is used to determine if parantheses should be inserted to resolve ambiguities.

Nested Class Summary

Nested classes/interfaces inherited from class org.cthul.matchers.diagnose.nested.NestedMatcher

NestedMatcher.NestedMatch<T,M extends org.hamcrest.Matcher<?>>, NestedMatcher.NestedMismatch<T,M extends org.hamcrest.Matcher<?>>, NestedMatcher.NestedResult<T,M extends org.hamcrest.Matcher<?>>

Field Summary

Fields inherited from interface org.cthul.matchers.diagnose.nested.PrecedencedSelfDescribing

P_AND, P_ATOMIC, P_COMPLEX, P_NONE, P_OR, P_UNARY, P_UNARY_NO_PAREN

Constructor Summary

Constructors

Constructor and Description
TypesafeNestedMatcher()
TypesafeNestedMatcher(Class<?> expectedType)
TypesafeNestedMatcher(org.hamcrest.internal.ReflectiveTypeFinder typeFinder)

Method Summary

Modifier and Type	Method and Description
void	describeMismatch(Object item, org.hamcrest.Description description)
protected void	describeMismatchSafely(T item, org.hamcrest.Description mismatch)
boolean	matches(Object item)
boolean	matches(Object item, org.hamcrest.Description description) Evaluates the matcher for argument item.
protected boolean	matchesSafely(T item)
protected abstract boolean	matchesSafely(T item, org.hamcrest.Description mismatch)
<I> MatchResult<I>	matchResult(I item) Returns a MatchResult that caches the mismatch descripton.
protected <I extends T> MatchResult<I>	matchResultSafely(I item)

Methods inherited from class org.cthul.matchers.diagnose.nested.NestedMatcher

nestedDescribe, nestedDescribeTo, nestedMatch, nestedMatch

Methods inherited from class org.cthul.matchers.diagnose.QuickDiagnosingMatcherBase

quickMatch, quickMatch, quickMatchResult

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

Methods inherited from interface org.cthul.matchers.diagnose.nested.PrecedencedSelfDescribing

getDescriptionPrecedence

Methods inherited from interface org.hamcrest.SelfDescribing

describeTo

Methods inherited from interface org.hamcrest.Matcher

_dont_implement_Matcher___instead_extend_BaseMatcher_

Constructor Detail

TypesafeNestedMatcher

public TypesafeNestedMatcher(Class<?> expectedType)

TypesafeNestedMatcher

public TypesafeNestedMatcher(org.hamcrest.internal.ReflectiveTypeFinder typeFinder)

TypesafeNestedMatcher

public TypesafeNestedMatcher()

Method Detail

matchesSafely

protected boolean matchesSafely(T item)

describeMismatchSafely

protected void describeMismatchSafely(T item,
                                      org.hamcrest.Description mismatch)

matchesSafely

protected abstract boolean matchesSafely(T item,
                                         org.hamcrest.Description mismatch)

matchResultSafely

protected <I extends T> MatchResult<I> matchResultSafely(I item)

matches

public boolean matches(Object item)

Description copied from class: QuickDiagnosingMatcherBase

Specified by:

matches in interface org.hamcrest.Matcher<T>

Overrides:

matches in class QuickDiagnosingMatcherBase<T>

matches

public final boolean matches(Object item,
                             org.hamcrest.Description description)

Description copied from class: QuickDiagnosingMatcherBase

Evaluates the matcher for argument item.

A mismatch description is appended to mismatch if and only if the match fails.

Specified by:

matches in interface QuickDiagnosingMatcher<T>

Specified by:

matches in class QuickDiagnosingMatcherBase<T>

Parameters:

item - The object against which the matcher is evaluated.

description - The description to be built or appended to.

Returns:

true if item matches, otherwise false.

describeMismatch

public void describeMismatch(Object item,
                             org.hamcrest.Description description)

Description copied from class: QuickDiagnosingMatcherBase

Specified by:

describeMismatch in interface org.hamcrest.Matcher<T>

Overrides:

describeMismatch in class QuickDiagnosingMatcherBase<T>

matchResult

public <I> MatchResult<I> matchResult(I item)

Description copied from class: QuickDiagnosingMatcherBase

Returns a MatchResult that caches the mismatch descripton.

Specified by:

matchResult in interface QuickDiagnosingMatcher<T>

Overrides:

matchResult in class QuickDiagnosingMatcherBase<T>

Returns:

match result