com.nitorcreations.junit.runners.parameterized

Class DescriptionMapper

java.lang.Object

com.nitorcreations.junit.runners.parameterized.DescriptionMapper

public class DescriptionMapper
extends Object

This is a helper class for WrappingParameterizedRunner. It rewrites descriptions such that they use the original test class instead of the dynamically created (synthesized) extending test class so that test reports refer back to the original test class. It also remembers the mappings done so they can be re-applied later when the actual test runs report success or failure. The Description.equals(Object) and Description.hashCode() implementations suitably support using the Description objects themselves directly as map keys.

Constructor Summary

Constructors

Constructor and Description
DescriptionMapper(Class<?> testClass)

Method Summary

Methods

Modifier and Type	Method and Description
org.junit.runner.Description	map(org.junit.runner.Description orig) This is used to map "original" descriptions again in the same manner as when they were rewritten earlier using rewriteDescription(String, Description).
org.junit.runner.Description	rewriteDescription(String description, org.junit.runner.Description orig) Rewrites the description of a first-level runner child of the WrappingParameterizedRunner runner, and recursively its children.

Methods inherited from class java.lang.Object

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

Constructor Detail

DescriptionMapper

public DescriptionMapper(Class<?> testClass)

Method Detail

rewriteDescription

public org.junit.runner.Description rewriteDescription(String description,
                                              org.junit.runner.Description orig)

Rewrites the description of a first-level runner child of the WrappingParameterizedRunner runner, and recursively its children. Replaces the original description with the given description identifying the child and the test class with the one given to this class' constructor. The child's children descriptions are just rewritten to use the test class given in constructor instead of direct subclass, where applicable.

Parameters:

description - the new description text to use for this child

orig - the original description object provided by the child runner.

Returns:

the rewritten description object

map

public org.junit.runner.Description map(org.junit.runner.Description orig)

This is used to map "original" descriptions again in the same manner as when they were rewritten earlier using rewriteDescription(String, Description). Any description object given to the rewriteDescription(String, Description) or any child, child's child etc inside it can be supplied to this method.

Parameters:

orig - the original description object

Returns:

the associated description as it was rewritten when calling rewriteDescription(String, Description).