org.springframework.webflow.test.execution
Class AbstractXmlFlowExecutionTests

java.lang.Object
  junit.framework.Assert
      junit.framework.TestCase
          org.springframework.webflow.test.execution.AbstractFlowExecutionTests
              org.springframework.webflow.test.execution.AbstractExternalizedFlowExecutionTests
                  org.springframework.webflow.test.execution.AbstractXmlFlowExecutionTests

All Implemented Interfaces:

junit.framework.Test

public abstract class AbstractXmlFlowExecutionTests
extends AbstractExternalizedFlowExecutionTests

Base class for flow integration tests that verify an XML flow definition executes as expected.

Example usage:

 public class SearchFlowExecutionTests extends AbstractXmlFlowExecutionTests {
        protected FlowDefinitionResource getFlowDefinitionResource() {
                return createFlowDefinitionResource("src/main/webapp/WEB-INF/flows/search-flow.xml");
        }
 
        public void testStartFlow() {
                startFlow();
                assertCurrentStateEquals("displaySearchCriteria");
        }
 
        public void testDisplayCriteriaSubmitSuccess() {
                startFlow();
                MockParameterMap parameters = new MockParameterMap();
                parameters.put("firstName", "Keith");
                parameters.put("lastName", "Donald");
                ViewSelection view = signalEvent("search", parameters);
                assertCurrentStateEquals("displaySearchResults");
                assertModelAttributeCollectionSize(1, "results", view);
        }
 }
 

Author:

Keith Donald, Erwin Vervaet

Constructor Summary

AbstractXmlFlowExecutionTests()
Constructs a default XML flow execution test.

AbstractXmlFlowExecutionTests(java.lang.String name)
Constructs an XML flow execution test with given name.

Method Summary

protected FlowBuilder	createFlowBuilder(org.springframework.core.io.Resource resource, FlowServiceLocator flowServiceLocator) Factory method to create the builder that will build the flow definition whose execution will be tested.
protected void	registerLocalMockServices(Flow flow, org.springframework.beans.factory.config.ConfigurableBeanFactory beanFactory) Template method subclasses may override to register mock implementations of services used locally by the flow being tested.

Methods inherited from class org.springframework.webflow.test.execution.AbstractExternalizedFlowExecutionTests

createFlow, createFlowDefinitionResource, createFlowDefinitionResource, createFlowDefinitionResource, createFlowServiceLocator, getFlowDefinition, getFlowDefinitionResource, isCacheFlowDefinition, registerMockServices, setCacheFlowDefinition, setFlowExecutionAttributes, setFlowExecutionListener, setFlowExecutionListeners

Methods inherited from class org.springframework.webflow.test.execution.AbstractFlowExecutionTests

applicationView, assertActiveFlowEquals, assertCurrentStateEquals, assertFlowExecutionActive, assertFlowExecutionEnded, assertModelAttributeCollectionSize, assertModelAttributeEquals, assertModelAttributeNotNull, assertModelAttributeNull, assertViewNameEquals, createExternalContext, createFlowExecutionFactory, evaluateModelAttributeExpression, externalRedirect, flowDefinitionRedirect, flowExecutionRedirect, getConversationAttribute, getFlashAttribute, getFlowAttribute, getFlowExecution, getFlowExecutionFactory, getRequiredConversationAttribute, getRequiredConversationAttribute, getRequiredFlashAttribute, getRequiredFlashAttribute, getRequiredFlowAttribute, getRequiredFlowAttribute, nullView, refresh, refresh, setExpressionParser, signalEvent, signalEvent, signalEvent, startFlow, startFlow, startFlow, updateFlowExecution

Methods inherited from class junit.framework.TestCase

countTestCases, createResult, getName, run, run, runBare, runTest, setName, setUp, tearDown, toString

Methods inherited from class junit.framework.Assert

assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertFalse, assertFalse, assertNotNull, assertNotNull, assertNotSame, assertNotSame, assertNull, assertNull, assertSame, assertSame, assertTrue, assertTrue, fail, fail, failNotEquals, failNotSame, failSame

Methods inherited from class java.lang.Object

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

Constructor Detail

AbstractXmlFlowExecutionTests

public AbstractXmlFlowExecutionTests()

Constructs a default XML flow execution test.

See Also:

TestCase.setName(String)

AbstractXmlFlowExecutionTests

public AbstractXmlFlowExecutionTests(java.lang.String name)

Constructs an XML flow execution test with given name.

Parameters:

name - the name of the test

Since:

1.0.2

Method Detail

createFlowBuilder

protected FlowBuilder createFlowBuilder(org.springframework.core.io.Resource resource,
                                        FlowServiceLocator flowServiceLocator)

Description copied from class: AbstractExternalizedFlowExecutionTests

Factory method to create the builder that will build the flow definition whose execution will be tested. Subclasses must implement.

A subclass may return a builder that sets up mock implementations of services needed locally by the flow definition at runtime.

Specified by:

createFlowBuilder in class AbstractExternalizedFlowExecutionTests

Parameters:

resource - the externalized flow definition resource location

flowServiceLocator - the flow service locator

Returns:

the flow builder that will build the flow to be tested

registerLocalMockServices

protected void registerLocalMockServices(Flow flow,
                                         org.springframework.beans.factory.config.ConfigurableBeanFactory beanFactory)

Template method subclasses may override to register mock implementations of services used locally by the flow being tested.

Parameters:

flow - the flow to register the services for

beanFactory - the local flow service registry; register mock services with it using SingletonBeanRegistry.registerSingleton(String, Object)

Since:

1.0.4