pl.wkr.fluentrule.api

Class CheckExpectedException

java.lang.Object

pl.wkr.fluentrule.api.CheckExpectedException

All Implemented Interfaces:

TestRule

public class CheckExpectedException
extends Object

Implements junit's TestRule and allows to assert thrown exception in callback.

Usage in tests:

 @Rule
 public CheckExpectedException thrown = CheckExpectedException.none();

 @Test
 public void test_state_of_objects_raw_check() throws NotEnoughMoney {
      coffeeMachine.insertCoin(2);

      thrown.check(new Check() {
          public void check(Throwable throwable) {
              assertThat(coffeeMachine.getInsertedMoney()).isEqualTo(2);  //assert state
           }
      });

      coffeeMachine.getCoffee();
 }
 

Author:

Wojciech Krak

See Also:

Project site - more examples

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	CheckExpectedException()

Method Summary

Methods

Modifier and Type	Method and Description
protected void	addCheck(Check check) Add assertion callback to callback list.
Statement	apply(Statement base, Description description) Method required by junit from rules implementations.
CheckExpectedException	check(Check check) Adds callback to assert thrown exception.
protected void	failBecauseExceptionWasNotThrown() Throws AssertionError with info that exception was expected but not thrown.
S	handleAssertionErrors() Starts handling of assertion errors.
S	handleAssumptionViolatedExceptions() Starts handling of AssumptionViolatedException.
protected void	handleException(Throwable e) Handles thrown exception.
boolean	isExceptionExpected() Returns if rule is expecting any exception.
protected S	myself()
static CheckExpectedException	none() Creates and returns new instance of CheckExpectedException rule.

Methods inherited from class java.lang.Object

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

Constructor Detail

CheckExpectedException

protected CheckExpectedException()

Method Detail

none

public static CheckExpectedException none()

Creates and returns new instance of CheckExpectedException rule.

Returns:

new instance

check

public CheckExpectedException check(Check check)

Adds callback to assert thrown exception.

Parameters:

check - callback to assert thrown exception

Returns:

this to allow chaining

addCheck

protected void addCheck(Check check)

Add assertion callback to callback list.

Parameters:

check - callback to assert thrown exception

isExceptionExpected

public boolean isExceptionExpected()

Returns if rule is expecting any exception.

Returns:

true if any exception is expected

handleException

protected void handleException(Throwable e)

Handles thrown exception.

Parameters:

e - thrown exception

failBecauseExceptionWasNotThrown

protected void failBecauseExceptionWasNotThrown()

Throws AssertionError with info that exception was expected but not thrown.

myself

protected S myself()

handleAssertionErrors

public final S handleAssertionErrors()

Starts handling of assertion errors.

Returns:

this to allow chaining

handleAssumptionViolatedExceptions

public final S handleAssumptionViolatedExceptions()

Starts handling of AssumptionViolatedException.

Returns:

this to allow chaining

apply

public final Statement apply(Statement base,
              Description description)

Method required by junit from rules implementations.

Specified by:

apply in interface TestRule