Assume (JUnit API)
Date: 2011-08-22

Overview | Package | Class | Tree | Deprecated | Index | Help
PREV CLASS NEXT CLASS | FRAMES NO FRAMES
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD

## org.junit
Class Assume

    java.lang.Object
      org.junit.Assume

    public class Assume

extends 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(...);

Constructor Summary
`Assume()`

Method Summary
`static void` | `assumeNoException(Throwable t)` Use to assume that an operation completes normally.
`static void` | `assumeNotNull(Object... objects)` If called with one or more null elements in `objects`, the test will halt and be ignored.
`static
`<T> void`
` | `assumeThat(T actual, Matcher<T> matcher)` Call to assume that `actual` satisfies the condition specified by `matcher`.
`static void` | `assumeTrue(boolean b)` If called with an expression evaluating to `false`, the test will halt and be ignored.

Methods inherited from class java.lang.Object
`clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait`

Constructor Detail

### Assume

    public Assume()

Method Detail

### assumeTrue

    public static void assumeTrue(boolean b)

  If called with an expression evaluating to `false`, the test will halt and be ignored.

  Parameters:
    `b` -

### assumeNotNull

    public static void assumeNotNull(Object... objects)

  If called with one or more null elements in `objects`, the test will halt and be ignored.

  Parameters:
    `objects` -

### assumeThat

    public static <T> void assumeThat(T actual,
                                      Matcher<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 `Matcher`s, specifying allowed values
  See Also:
    `CoreMatchers`, `JUnitMatchers`

### assumeNoException

    public static void assumeNoException(Throwable t)

  Use to assume that an operation completes normally. If `t` is non-null, the test will halt and be ignored. For example:

       \@Test public void parseDataFile() {
         DataFile file;
         try {
           file = DataFile.open("sampledata.txt");
         } catch (IOException e) {
           // stop test and ignore if data can't be opened
           assumeNoException(e);
         }
         // ...
       }

  Parameters:
    `t` - if non-null, the offending exception

Overview | Package | Class | Tree | Deprecated | Index | Help
PREV CLASS NEXT CLASS | FRAMES NO FRAMES
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD