March 21, 2006

Expert Spring MVC + Spring Web Flow errata

Writing about web page

Below are the changes in Chapter 11 + Chapter 12 as a result of upgrading to Spring Web Flow 1.0 EA:

[global changes]
_flowExecutionId has been renamed to _flowExecutionKey
org.springframework.webflow.manager has been renamed to org.springframework.webflow.executor
FlowExecutionManager has been renamed to FlowExecutor
FlowExecutionManagerImpl has been renamed to FlowExecutorImpl
FlowExecutionContinuationKey has been renamed to FlowExecutionKey
FlowExecutionManagerParameterExtractor has been renamed to FlowExecutorArgumentExtractor

Chapter 11

– Figure 11–3 (page 7) has four boxes which all contain text starting "webflow.manager.". The word "manager" needs to be replaced with the word "executor", i.e the first box should read webflow.executor.struts.FlowAction etc.

– The first line of the last paragraph on page 7 refers to "FlowExecutionManager". This has been renamed to "FlowExecutor".

– Page 8 refers to "org.springframework.webflow.execution.FlowExecutionRepository". This has been renamed to "org.springframework.webflow.execution.repository.FlowExecutionRepository".

– Page 17 refers to "AbstractFlowexecutionTests" but the e after "Flow" should be capitalised: "AbstractFlowExecutionTests".

– The first two methods in Listing 11–8 are duplicates. Please remove the first method. The second method needs to change from:

protected Resource getFlowLocation() {

File flowDir = new File(.......);

return new FileSyste…..


protected Resource getFlowLocation() {

File flowDir = new File(.......);

FileSystemResource resource = new FileSystemResource(new File(flowDir, "purchase-flow.xml"));

return new ExternalizedFlowDefinition("purchaseFlow", resource);

so essentially the first line stays the same, and the second line is replaced with two new lines.

– Listing 11–13 on page 22 refers to "org.springframework.webflow.manager.
mvc.FlowController" The word "manager" needs to be replaced with the word "executor".

– The next paragragh on page 22 contains a reference to "org.springframework.webflow.mvc.FlowController". This should be "org.springframework.webflow.executor.mvc.FlowController".

– Page 26 refers to " org.springframework.webflow.config.FlowBuilder". This should be "org.springframework.webflow.builder.FlowBuilder".

Chapter 12

[global and specific changes]
– Page 8, first sentence contains " org.springframework.binding.AttributeMapper". Should be "org.springframework.binding.mapping.AttributeMapper".

– Page 9, first paragraph contains "ParameterizableFlowAttributeMapper", should be DefaultFlowAttributeMapper.

– Page 9, Listing 12–9 first method signature is "public Map createSubflowInput(Request…..". Should be "public AttributeMap createSubflowInput(Request….".
First line in first method is "Map map = new HashMap()" should be "AttributeMap map = new AttributeMap()".
Second method signature is "public void mapSubflowOuput(Map subflowOutput…." should be "public void mapSubflowOutput(UnmodifiableAttributeMap…".

– Page 12, In "Integration With Web Frameworks" the term FlowExecutionManager needs to be replaced with FlowExecutor. There are 5 occurences (although any others you spot should also be changed).

The last but one sentence "Both methods accept org…... and return org…." should read "Both methods accept org.springframework.webflow.ExternalContext in their parameters and return org.springframework.webflow.executor.ResponseInstruction , from which the org.springframework.webflow.ViewSelection can be obtained."

Listing 12–11 has completely changed:

public interface ExternalContext {

public String getContextPath();

public String getDispatcherPath();

public String getRequestPathInfo();

public ParameterMap getRequestParameterMap();

public AttributeMap getRequestMap();

public SharedAttributeMap getSessionMap();

public SharedAttributeMap getApplicationMap();

public interface SharedMap extends Map {

public Object getMutex();


public static class SharedAttributeMap extends AttributeMap {

public SharedAttributeMap(SharedMap sharedMap) {



public SharedMap getSharedMap() {

return (SharedMap)getMapInternal();


public Object getMutex() {

return getSharedMap().getMutex();



– Page 13 Last entry in Table 12–2 contains the word "manager." should be "executor."

"The FlowExecutionManager" should be renamed "FlowExecutor".
Listing 12–12 heading should be changed to "org.springframework.webflow.executor.FlowExecutor".
Both methods return "ViewSelection". They should return "ResponseInstruction".
Within the Note, "FlowExecutionManager" should be renamed to "FlowExecutor".
The next two paragraphs require all instances of "FlowExecutionManager" to be changed to "FlowExecutor". I count 2 instances
The next two paragraphs require all instances of "_flowExecutionId" to be changed to "_flowExecutionKey". I count 2 instances
The "" needs to be "org.springframework.webflow.executor.FlowExecutorArgumentExtractor".

-Page 15, Listing 12–13 Please remove the last method "rehydrate".

Listing 12–14 FlowExecutionContext has changed. It essentially needs to be:

public interface FlowExecutionContext extends FlowExecutionStatistics {

public Flow getFlow();

public AttributeMap getScope();

FlowSession getActiveSession();

The next paragraph contains the phrase "the active flow definition, the current state, and" which needs to be replaced with "conversation scope and".

The next paragraph contains the phrase "The root flow" which needs to be replaced with "The flow". The last sentence contains "getActiveFlow()" which needs to be "getFlow()".

Page 17, Listing 12–15 has changed. It should now be:

public interface RequestContext {

public Flow getActiveFlow() throws IllegalStateException;

public State getCurrentState() throws IllegalStateException;

public AttributeMap getRequestScope();

public AttributeMap getFlowScope();

public AttributeMap getConversationScope();

public ParameterMap getRequestParameters();

public ExternalContext getExternalContext();

public FlowExecutionContext getFlowExecutionContext();

public Event getLastEvent();

public Transition getLastTransition();

public UnmodifiableAttributeMap getAttributes();

public void setAttributes(AttributeCollection attributes);

public UnmodifiableAttributeMap getModel();

Page 18 contains two references to "org.springframework.webflow.manager.ConditionalFlowExecutionListenerLoader". They should be "org.springframework.webflow.executor.ConditionalFlowExecutionListenerLoader ".

Listing 12–17 on Page 18 contains a reference to "org.springframework.webflow.manager.FlowExecutionManagerImpl". It should be "org.springframework.webflow.executor.FlowExecutorImpl".

Page 19, Listing 12–18 has completely changed:

public interface FlowExecutionRepository {

public FlowExecution createFlowExecution(String flowId);

public FlowExecutionKey generateKey(FlowExecution flowExecution) throws FlowExecutionRepositoryException;

public FlowExecutionKey generateKey(FlowExecution flowExecution, Serializable conversationId) throws FlowExecutionRepositoryException;

public ConversationLock getLock(Serializable conversationId);

public FlowExecution getFlowExecution(FlowExecutionKey key) throws FlowExecutionRepositoryException;

public void putFlowExecution(FlowExecutionKey key, FlowExecution flowExecution) throws FlowExecutionRepositoryException;

public FlowExecutionKey getCurrentFlowExecutionKey(Serializable conversationId) throws FlowExecutionRepositoryException;

public ViewSelection getCurrentViewSelection(Serializable conversationId) throws FlowExecutionRepositoryException;

public void setCurrentViewSelection(Serializable conversationId, ViewSelection viewSelection) throws FlowExecutionRepositoryException;

public void invalidateConversation(Serializable conversationId) throws FlowExecutionRepositoryException;

– Page 22 contains a number of references to FlowExecutionContinuationKey. This has been renamed to FlowExecutionKey.

– Page 22 contains a number of references to _flowExecutionId. This has been renamed to _flowExecutionKey.

– Page 22 at the bottom contains a reference to "org.springframework.webflow.execution.repository.SimpleFlowExecutionRepository ". It should be "".

Page 23. The note should read "This is the default implementation."

Page 23 contains a reference to "_flowExecutionId", it should be "_flowExecutionKey".

Page 24 contains two references to "_flowExecutionId", they should be "_flowExecutionKey".

Page 30, Table 12–10 contains a reference to "RedirectViewSelector". Should be "ExternalRedirectSelector".

Table 12–11 is wrong, should be:

ApplicationViewSelector If viewName is specified.
ApplicationViewSelector If redirect:viewName is specified.
ExternalRedirectSelector If externalRedirect:/url?par1=x is specified
FlowRedirectSelector If flowRedrect:/url is specified
YourViewSelector If bean=yourBean is specified.

– Page 31 contains three references to "FlowExecutionManagerParameterExtractor". They should all be "FlowExecutorArgumentExtractor".

– Page 31 contains three references to "FEMPE". They should all be "FEAE".

– Page 34 contains a reference to "InvalidConversionationContinuationException". Should be "CannotContinueConversationException".

- 10 comments by 1 or more people Not publicly viewable

[Skip to the latest comment]
  1. Wolfgang

    With the posted corrections, the listing of the AbstractFlowExecutionTests class in 11–8 is missing the implemention of abstract method getFlowDefinition.
    Or maybe I didn't get that.


    18 Apr 2006, 14:55

  2. Hi Wolfgang.

    Thanks for the catch :) The only abstract method in EA1.0 for AbstractFlowExecutionTests is a "Flow getFlow()" method.

    The joys of chasing CVS

    When 1.0 is released, I will be going through and listing all errata again, so I will check it then.

    Thanks again :)

    18 Apr 2006, 15:27

  3. Lori

    Is the source code for chapters 11 and 12 posted anywhere?


    03 May 2006, 18:34

  4. Hi Lori,

    I have held off posting the source code until SWF1.0 is released. Now that RC1.0 is released I will update the errata and post it for RC1.0.

    It isn't very different from the included samples though, and in fact the included samples demonstrate some new features that weren't available when the book was written (redirects etc.).

    Check link for more info.

    04 May 2006, 11:23

  5. christophe

    I like the book very much. I wish apress could update the errata page though, because I've got a bunch to send :)
    I was about to try listing 11–8 but noticed that there were no more getFlowLocation :)) Thank you for posting the corrections needed for the new version. I'll refer to them.

    I felt that Chapter 11 was written by a different person than the previous chapters. Am I wrong ?

    24 Aug 2006, 08:29

  6. Fadi Samara

    You guys have been talking about posting the source code forever.
    SWF 1.0 has been released and yet we haven’t seen the source code

    Comments ?


    30 Dec 2006, 04:49

  7. Mike

    I have found myself to be quite dissatisfied that I am unable to download the source code for the spring web flow section of this book. Perhaps I haven’t searched your site enough?

    I bought this book for the web flow chapters which in essence seems to be quite a good guide, but I would prefer to have a working example that I can relate it to.

    Perhaps in the next revision of the book the full application class definitions will be added such that the book is complete or the source code will be obtainable?

    I would like to be able to give positive feedback on this book as the content is good quality.



    09 Jan 2007, 14:09

  8. Chris Yea

    Hi Colin,

    I am a recruitment consultant looking for Java Web developers with strong Spring mvc, jsp, hibernate and xml skills. The 6 month contract is based in Surrey, any recommedations would be welcome.

    Kind regards

    18 Jan 2007, 18:17

  9. Lin

    On Apress website says : “Code for Chapters 11 and 12 can be found at once SWF 1.0 is released.”
    So where can I find the source code for Chapter 11 and 12?



    15 Apr 2007, 18:48

  10. Suleman

    Hello. I bought the book yesterday. I was trying to find the source code for chapter 11 and chapter 12. Can you provide the url for the source code?


    23 Nov 2007, 15:57

Add a comment

You are not allowed to comment on this entry as it has restricted commenting permissions.

March 2006

Mo Tu We Th Fr Sa Su
Feb |  Today  | Apr
      1 2 3 4 5
6 7 8 9 10 11 12
13 14 15 16 17 18 19
20 21 22 23 24 25 26
27 28 29 30 31      

Search this blog



Most recent comments

  • Interesting… While I'm not completely convinced in such microbenchmarks, I'm pretty sure that 1ms … by Alexander Snaps on this entry
  • Hello. I bought the book yesterday. I was trying to find the source code for chapter 11 and chapter … by Suleman on this entry
  • by live mashup demo on this entry
  • Thanks mate ….. This blog was really helpful. by Maaz Hurzuk on this entry
  • Ty. Not directly helpful for my problem, but pointed me in the right direction. You will also get th… by Mike E. on this entry

Blog archive

Not signed in
Sign in

Powered by BlogBuilder