fr.sii.ogham.testing.assertion.util

Class FailAtEndRegistry

java.lang.Object

fr.sii.ogham.testing.assertion.util.FailAtEndRegistry

All Implemented Interfaces:

AssertionRegistry

public class FailAtEndRegistry
extends Object
implements AssertionRegistry

The aim of this registry is to report all errors at once. It registers all functions but doesn't execute them. When execute() method is called, then all functions are executed. All failures/failed assertions are collected and reported using a MultipleAssertionError.

A ComparisonFailure exception is thrown. Therefore Eclipse can handle this exception and provide a comparison view with all differences.

Author:

Aurélien Baudet

Constructor Summary

Constructors

Constructor and Description
FailAtEndRegistry() Initializes an empty registry.
FailAtEndRegistry(boolean convertToComparisonFailure) Initializes an empty registry.

Method Summary

Modifier and Type	Method and Description
void	execute() Execute all registered functions
<E extends Exception> void	register(Executable<E> executable) Register a function that contains assertions.

Methods inherited from class java.lang.Object

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

Constructor Detail

FailAtEndRegistry

public FailAtEndRegistry()

Initializes an empty registry. If the system property "ogham.testing.assertions.fail-at-end.throw-comparison-failure" is set to true (or not set at all), a ComparisonFailure exception is thrown. Using a ComparisonFailure lets Eclipse handle it specifically and provides a comparison view (Eclipse doesn't handle sub-classes of ComparisonFailure). To throw MultipleAssertionError instead of ComparisonFailure, you can set the "ogham.testing.assertions.fail-at-end.throw-comparison-failure" system property to "false". This can be useful if you need to manually handle every failure/failed assertions.

FailAtEndRegistry

public FailAtEndRegistry(boolean convertToComparisonFailure)

Initializes an empty registry. If convertToComparisonFailure parameter is set to true, a ComparisonFailure exception is thrown. Using a ComparisonFailure lets Eclipse handle it specifically and provides a comparison view (Eclipse doesn't handle sub-classes of ComparisonFailure).

Parameters:

convertToComparisonFailure - true to generate a ComparisonFailure to let Eclipse display a comparison view.

Method Detail

register

public <E extends Exception> void register(Executable<E> executable)
                                    throws E extends Exception

Description copied from interface: AssertionRegistry

Register a function that contains assertions. The function may throw exceptions (for example when the function tries to access a value that may fail, typically an IOException).

Specified by:

register in interface AssertionRegistry

Type Parameters:

E - the type of the thrown exception if any

Parameters:

executable - the function to register

Throws:

E - the thrown exception

E extends Exception

execute

public void execute()

Description copied from interface: AssertionRegistry

Execute all registered functions

Specified by:

execute in interface AssertionRegistry