Package org.junit.matchers
Class JUnitMatchers
- java.lang.Object
- org.junit.matchers.JUnitMatchers
public class JUnitMatchers extends Object
Convenience import class: these are useful matchers for use with the assertThat method, but they are not currently included in the basic CoreMatchers class from hamcrest.- Since:
- 4.4
Constructor Summary
Constructors Constructor Description JUnitMatchers()
Method Summary
All Methods Static Methods Concrete Methods Deprecated Methods Modifier and Type Method Description static <T> CombinableMatcher.CombinableBothMatcher<T>both(Matcher<? super T> matcher)Deprecated.Please useCoreMatchers.both(Matcher)instead.static Matcher<String>containsString(String substring)Deprecated.Please useCoreMatchers.containsString(String)instead.static <T> CombinableMatcher.CombinableEitherMatcher<T>either(Matcher<? super T> matcher)Deprecated.Please useCoreMatchers.either(Matcher)instead.static <T> Matcher<Iterable<T>>everyItem(Matcher<T> elementMatcher)Deprecated.Please useCoreMatchers.everyItem(Matcher)instead.static <T> Matcher<Iterable<? super T>>hasItem(Matcher<? super T> elementMatcher)Deprecated.Please useCoreMatchers.hasItem(Matcher)instead.static <T> Matcher<Iterable<? super T>>hasItem(T element)Deprecated.Please useCoreMatchers.hasItem(Object)instead.static <T> Matcher<Iterable<T>>hasItems(Matcher<? super T>... elementMatchers)Deprecated.Please useCoreMatchers.hasItems(Matcher...)instead.static <T> Matcher<Iterable<T>>hasItems(T... elements)Deprecated.Please useCoreMatchers.hasItems(Object...)instead.static <T extends Exception>
Matcher<T>isException(Matcher<T> exceptionMatcher)static <T extends Throwable>
Matcher<T>isThrowable(Matcher<T> throwableMatcher)
Constructor Detail
JUnitMatchers
public JUnitMatchers()
Method Detail
hasItem
@Deprecated public static <T> Matcher<Iterable<? super T>> hasItem(T element)
Deprecated.Please useCoreMatchers.hasItem(Object)instead.- Returns:
- A matcher matching any collection containing element
hasItem
@Deprecated public static <T> Matcher<Iterable<? super T>> hasItem(Matcher<? super T> elementMatcher)
Deprecated.Please useCoreMatchers.hasItem(Matcher)instead.- Returns:
- A matcher matching any collection containing an element matching elementMatcher
hasItems
@Deprecated public static <T> Matcher<Iterable<T>> hasItems(T... elements)
Deprecated.Please useCoreMatchers.hasItems(Object...)instead.- Returns:
- A matcher matching any collection containing every element in elements
hasItems
@Deprecated public static <T> Matcher<Iterable<T>> hasItems(Matcher<? super T>... elementMatchers)
Deprecated.Please useCoreMatchers.hasItems(Matcher...)instead.- Returns:
- A matcher matching any collection containing at least one element that matches each matcher in elementMatcher (this may be one element matching all matchers, or different elements matching each matcher)
everyItem
@Deprecated public static <T> Matcher<Iterable<T>> everyItem(Matcher<T> elementMatcher)
Deprecated.Please useCoreMatchers.everyItem(Matcher)instead.- Returns:
- A matcher matching any collection in which every element matches elementMatcher
containsString
@Deprecated public static Matcher<String> containsString(String substring)
Deprecated.Please useCoreMatchers.containsString(String)instead.- Returns:
- a matcher matching any string that contains substring
both
@Deprecated public static <T> CombinableMatcher.CombinableBothMatcher<T> both(Matcher<? super T> matcher)
Deprecated.Please useCoreMatchers.both(Matcher)instead.This is useful for fluently combining matchers that must both pass. For example:assertThat(string, both(containsString("a")).and(containsString("b")));
either
@Deprecated public static <T> CombinableMatcher.CombinableEitherMatcher<T> either(Matcher<? super T> matcher)
Deprecated.Please useCoreMatchers.either(Matcher)instead.This is useful for fluently combining matchers where either may pass, for example:assertThat(string, either(containsString("a")).or(containsString("b")));
isThrowable
public static <T extends Throwable> Matcher<T> isThrowable(Matcher<T> throwableMatcher)
- Returns:
- A matcher that delegates to throwableMatcher and in addition appends the stacktrace of the actual Throwable in case of a mismatch.
isException
public static <T extends Exception> Matcher<T> isException(Matcher<T> exceptionMatcher)
- Returns:
- A matcher that delegates to exceptionMatcher and in addition appends the stacktrace of the actual Exception in case of a mismatch.