ch.powerunit.rules

Interface TestListenerRule

All Superinterfaces:

TestRule

All Known Subinterfaces:

ExternalResource, TemporaryFolder

All Known Implementing Classes:

SystemPropertiesRule, TestContextRule

public interface TestListenerRule
extends TestRule

This can be use to support taking action depending on the issue of the test.

The purpose is here to provide an interface that can be implemented by rule implementor to do action, before, after and on some condition.

Rule implementer should implements this interface and then implement the required methods (which are do-nothing method by default). The order of execution is the following :

• Before the test, the method onStart(TestContext) is executed.
• Then the test is executed.
• In case of error/failure, one (and only one) of the next methods is executed
  1. onFailure(TestContext, AssertionError) in case of test failure.
  2. onError(TestContext, Throwable) in case of test error.
  3. onAssumptionSkip(TestContext, AssumptionError) in case of test skip.
• In all case, after the test, and after the previous method in case of error/failure, the method onEnd(TestContext) is executed.

The ExternalResource rule implements this interface to provide simple use case (action before and always after test).

Author:

borettim

See Also:

ExternalResource

Method Summary

Modifier and Type	Method and Description
default Statement<TestContext<Object>,Throwable>	computeStatement(Statement<TestContext<Object>,Throwable> inner) The default implementation of test rule.
default void	onAssumptionSkip(TestContext<Object> context, AssumptionError error) Method used when an assumption error happened.
default void	onEnd(TestContext<Object> context) Method used at the end of the test.
default void	onError(TestContext<Object> context, Throwable error) Method used when an error happened.
default void	onFailure(TestContext<Object> context, AssertionError af) Method used when a failure happened.
default void	onStart(TestContext<Object> context) Method used at the start of the test.

Methods inherited from interface ch.powerunit.TestRule

after, around, around, before, mockitoRule

Method Detail

onStart

default void onStart(TestContext<Object> context)

Method used at the start of the test.

Default implementation is to do nothing.

Parameters:

context - the test context

onFailure

default void onFailure(TestContext<Object> context,
                       AssertionError af)

Method used when a failure happened.

Default implementation is to do nothing.

Parameters:

context - the test context

af - the failure

onError

default void onError(TestContext<Object> context,
                     Throwable error)

Method used when an error happened.

Default implementation is to do nothing.

Parameters:

context - the test context

error - the error

onAssumptionSkip

default void onAssumptionSkip(TestContext<Object> context,
                              AssumptionError error)

Method used when an assumption error happened.

Default implementation is to do nothing.

Parameters:

context - the test context

error - the assumption error

onEnd

default void onEnd(TestContext<Object> context)

Method used at the end of the test.

Default implementation is to do nothing.

Parameters:

context - the test context

computeStatement

default Statement<TestContext<Object>,Throwable> computeStatement(Statement<TestContext<Object>,Throwable> inner)

Description copied from interface: TestRule

The default implementation of test rule.

The goal of this method is to compute another test statement that will be the one to be runned.

Specified by:

computeStatement in interface TestRule

Parameters:

inner - the inner statement

Returns:

the new statement, as modified by this rule.