org.incava.attest

Class ContextMatcher<T>

java.lang.Object

org.hamcrest.BaseMatcher<T>

org.incava.attest.ContextMatcher<T>

All Implemented Interfaces:

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

public class ContextMatcher<T>
extends org.hamcrest.BaseMatcher<T>

Similar to DescribedAsMatcher, ContextMatcher wraps a matcher with context, displayed as "<expected> (context)". This is mainly for use in parameterized tests, such as (from ijdk):

  @Test
  @Parameters
  @TestCaseName("{method} {index} {params}")
 public <T extends Comparable<T>> void compare(int expected, T x, T y) {
     int result = Comp.compare(x, y);
     assertThat(result, withContext(equalTo(expected), "x: " + x + "; y: " + y));
 }
 

Constructor Summary

Constructors

Constructor and Description
ContextMatcher(org.hamcrest.Matcher<T> matcher, java.lang.String context)

Method Summary

Modifier and Type	Method and Description
void	describeMismatch(java.lang.Object item, org.hamcrest.Description description)
void	describeTo(org.hamcrest.Description description)
boolean	matches(java.lang.Object obj)
static <T> ContextMatcher<T>	withContext(org.hamcrest.Matcher<T> matcher, java.lang.String context) Creates a context matcher.
static <T> ContextMatcher<T>	withContext(java.lang.String context, org.hamcrest.Matcher<T> matcher) Creates a context matcher.

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

Constructor Detail

ContextMatcher

public ContextMatcher(org.hamcrest.Matcher<T> matcher,
                      java.lang.String context)

Method Detail

withContext

public static <T> ContextMatcher<T> withContext(java.lang.String context,
                                                org.hamcrest.Matcher<T> matcher)

Creates a context matcher.

withContext

public static <T> ContextMatcher<T> withContext(org.hamcrest.Matcher<T> matcher,
                                                java.lang.String context)

Creates a context matcher.

matches

public boolean matches(java.lang.Object obj)

describeTo

public void describeTo(org.hamcrest.Description description)

describeMismatch

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

Specified by:

describeMismatch in interface org.hamcrest.Matcher<T>

Overrides:

describeMismatch in class org.hamcrest.BaseMatcher<T>