Package de.cuioss.test.jsf.converter

Class AbstractConverterTest<C extends Converter,T>

java.lang.Object

de.cuioss.test.jsf.junit5.JsfEnabledTestEnvironment

de.cuioss.test.jsf.converter.AbstractConverterTest<C,T>

Type Parameters:

C - identifying the concrete Converter to be tested.

T - identifying the type of elements to be used for values to be given to the Converter

All Implemented Interfaces:

ComponentConfigurator, JsfTestContextConfigurator, JsfEnvironmentConsumer, de.cuioss.test.valueobjects.objects.ConfigurationCallBackHandler<C>

Direct Known Subclasses:

AbstractSanitizingConverterTest

public abstract class AbstractConverterTest<C extends Converter,T>
extends JsfEnabledTestEnvironment
implements de.cuioss.test.valueobjects.objects.ConfigurationCallBackHandler<C>, ComponentConfigurator

Base class for testing implementations of Converter within a Junit 5 context

Setup

The actual test must provide EnableJsfEnvironment, for the basic test-infrastructure. See the class-documentation for details.

initConverter(): Instantiates the concrete Converter using reflection. After this the method calls ConfigurationCallBackHandler.configure(Object) that can be used for further configuration of the Converter

In case you want you want to create the Converter yourself you can overwrite getConverter()

In case you want a pass another UIComponent as parameter to the Converter you can overwrite getComponent()

Test-Methods

The core test-methods are:

• shouldFailOnInvalidObjects()
• shouldFailOnInvalidStrings()
• shouldPassOnValidObjects()
• shouldPassOnValidStrings()
• shouldRoundTripValidData()

They call populate(TestItems) in oder to create corresponding test-data. The implementation is in the actual test-class.

API-Test

The api as defined within Converter is tested with the methods

• shouldFailOnNullComponentOnGetAsObject()
• shouldFailOnNullComponentOnGetAsString()
• shouldFailOnNullFacesContextOnGetAsObject()
• shouldFailOnNullFacesContextOnGetAsString()
• shouldReturnEmptyStringOnNullValue()

Example

Shows all variants of dealing with TestItems

 
 @EnableJsfEnvironment
 class IntegerConverterTest extends AbstractConverterTest<IntegerConverter, Integer> {

 @Override
 public void populate(final TestItems<Integer> testItems) {
 testItems.addRoundtripValues("1", "122", "2132121").addInvalidString("a")
 .addInvalidStringWithMessage("a", "javax.faces.converter.IntegerConverter.INTEGER")
 .addInvalidObject(Boolean.TRUE)
 .addInvalidObjectWithMessage(Boolean.FALSE, "javax.faces.converter.STRING")
 .addValidString("13").addValidStringWithObjectResult("17", Integer.valueOf(17))
 .addValidObject(Integer.valueOf(2))
 .addValidObjectWithStringResult(Integer.valueOf(14), "14");
 }
 
 

Author:

Oliver Wolff

Constructor Summary

Constructors

Constructor	Description
AbstractConverterTest()

Method Summary

Modifier and Type	Method	Description
void	configureComponents(ComponentConfigDecorator decorator)	Callback method for interacting with the ComponentConfigDecorator at the correct time. This method provide extension point to prepare needed test environment for your converter test.
UIComponent	getComponent()
C	getConverter()
protected TestItems<T>	getTestItems()
protected void	initConverter()	Instantiates and initially configures a concrete Converter
abstract void	populate(TestItems<T> testItems)	Populates the test-items
void	setComponent(UIComponent component)

Methods inherited from class de.cuioss.test.jsf.junit5.JsfEnabledTestEnvironment

getEnvironmentHolder, setEnvironmentHolder

Methods inherited from class java.lang.Object

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

Methods inherited from interface de.cuioss.test.valueobjects.objects.ConfigurationCallBackHandler

configure

Methods inherited from interface de.cuioss.test.jsf.util.JsfEnvironmentConsumer

assertNavigatedWithOutcome, assertRedirect, getApplication, getApplicationConfigDecorator, getBeanConfigDecorator, getComponentConfigDecorator, getExternalContext, getFacesContext, getRequestConfigDecorator, getResponse

Constructor Detail

AbstractConverterTest

public AbstractConverterTest()

Method Detail

initConverter

@BeforeEach
protected void initConverter()

Instantiates and initially configures a concrete Converter

populate

public abstract void populate(TestItems<T> testItems)

Populates the test-items

Parameters:

testItems - to be populated, is never null

configureComponents

public void configureComponents(ComponentConfigDecorator decorator)

Callback method for interacting with the ComponentConfigDecorator at the correct time.
This method provide extension point to prepare needed test environment for your converter test. For example :

    // register some converter
    decorator.registerConverter(MyRequiredConverter.class);
    // register UIComponent
      ...
 

Specified by:

configureComponents in interface ComponentConfigurator

Parameters:

decorator - ComponentConfigDecorator is never null

getComponent

public UIComponent getComponent()

setComponent

public void setComponent(UIComponent component)

getConverter

public C getConverter()

getTestItems

protected TestItems<T> getTestItems()