org.hamcrest.junit

Class MatcherAssume

java.lang.Object

org.hamcrest.junit.MatcherAssume

public class MatcherAssume
extends java.lang.Object

A set of methods useful for stating assumptions about the conditions in which a test is meaningful. A failed assumption does not mean the code is broken, but that the test provides no useful information. The default JUnit runner treats tests with failing assumptions as ignored. Custom runners may behave differently. For example:

 // only provides information if database is reachable.
 \@Test public void calculateTotalSalary() {
    DBConnection dbc = Database.connect();
    assumeNotNull(dbc);
    // ...
 }
 

These methods can be used directly: Assume.assumeTrue(...), however, they read better if they are referenced through static import:

 import static org.junit.Assume.*;
    ...
    assumeTrue(...);
 

Since:

4.4

Constructor Summary

Constructors

Constructor and Description
MatcherAssume()

Method Summary

Methods

Modifier and Type	Method and Description
static <T> void	assumeThat(java.lang.String message, T actual, org.hamcrest.Matcher<? super T> matcher) Call to assume that actual satisfies the condition specified by matcher.
static <T> void	assumeThat(T actual, org.hamcrest.Matcher<? super T> matcher) Call to assume that actual satisfies the condition specified by matcher.

Methods inherited from class java.lang.Object

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

Constructor Detail

MatcherAssume

public MatcherAssume()

Method Detail

assumeThat

public static <T> void assumeThat(T actual,
                  org.hamcrest.Matcher<? super T> matcher)

Call to assume that actual satisfies the condition specified by matcher. If not, the test halts and is ignored. Example:

:
   assumeThat(1, equalTo(1)); // passes
   foo(); // will execute
   assumeThat(0, equalTo(1)); // assumption failure! test halts
   int x = 1 / 0; // will never execute
 

Type Parameters:

T - the static type accepted by the matcher (this can flag obvious compile-time problems such as assumeThat(1, is("a"))}

Parameters:

actual - the computed value being compared

matcher - an expression, built of Matchers, specifying allowed values

See Also:

Matcher, JUnitMatchers

assumeThat

public static <T> void assumeThat(java.lang.String message,
                  T actual,
                  org.hamcrest.Matcher<? super T> matcher)

Call to assume that actual satisfies the condition specified by matcher. If not, the test halts and is ignored. Example:

:
   assumeThat(1, is(1)); // passes
   foo(); // will execute
   assumeThat(0, is(1)); // assumption failure! test halts
   int x = 1 / 0; // will never execute
 

Type Parameters:

T - the static type accepted by the matcher (this can flag obvious compile-time problems such as assumeThat(1, is("a"))

Parameters:

actual - the computed value being compared

matcher - an expression, built of Matchers, specifying allowed values

See Also:

CoreMatchers, JUnitMatchers