{"id":216,"date":"2009-04-27T22:07:31","date_gmt":"2009-04-28T03:07:31","guid":{"rendered":"http:\/\/www.andygibson.net\/blog\/?p=216"},"modified":"2010-08-09T14:23:53","modified_gmt":"2010-08-09T19:23:53","slug":"creating-a-spring-web-flow-jsf-project-from-scratch","status":"publish","type":"post","link":"https:\/\/www.andygibson.net\/blog\/tutorial\/creating-a-spring-web-flow-jsf-project-from-scratch\/","title":{"rendered":"Creating A Spring Web Flow JSF Project From Scratch"},"content":{"rendered":"

(Updated – 9 August 2010<\/b> – This was written in my pre-Maven days and after a few requests for working source, I’ve built the same project using Maven which can be downloaded<\/a>. Just unzip the maven project, go to the directory in the command line and type mvn jetty:run<\/code> to start the server and deploy the project. Navigate to http:\/\/localhost:8080\/swfproject\/home.jsf<\/a> or http:\/\/localhost:8080\/swfproject\/spring\/testFlow<\/a> to see the pages demonstrated in the tutorial.<\/p>\n

I recently had to start another project using Spring Web Flow and found myself banging my head against a brick wall to get the web flow stuff set up and to request the page properly. As a result, I decided to write up my results as a quick how-to for other developers should they find themselves in the same situation and also as a reference for myself the next time I need to start a Spring Web Flow project using Spring Faces from scratch.This article is meant more of a “here’s-how” as opposed to a “how-to” or an “explain-why” so we’ll move at a quick pace with little explanation.
\n
\nFor the IDE, I used Eclipse 3.4.1 with Spring IDE plugins version 2.2.1, with Spring 2.5.6 (with dependencies) and Spring Web Flow 2.0.5. You should be able to use SWF 2.0.7 without any problems. For dependencies, I mostly used the ones provided with Spring except for a few, the details of which are included below. Hibernate was used as the JPA implementation and it was all deployed on Tomcat 6.0.18.<\/p>\n

Getting Started<\/h1>\n

U started by installing Eclipse and then the Spring plugins. I created a new workspace, and added Tomcat as a server, and created a new dynamic web project. I right clicked on the project to add the Spring nature to the project.
\nThe project will be arranged with multiple Spring configuration files for the database, spring web flow and the main applicationContext.xml<\/code> to include them in. Flows will be in a directory under \/WebContent\/WEB-INF\/flows<\/code>.
\nI started off setting web.xml<\/code> up with the faces pieces and the Spring MVC dispatcher servlet. <\/p>\n

\r\n\t<!-- The main config file for this Spring web application -->\r\n\t<context-param>\r\n\t\t<param-name>contextConfigLocation<\/param-name>\r\n\t\t<param-value>\/WEB-INF\/applicationContext.xml<\/param-value>\r\n\t<\/context-param>\r\n\r\n\t<!-- Use JSF view templates saved as *.xhtml, for use with Facelets -->\r\n\t<context-param>\r\n\t\t<param-name>javax.faces.DEFAULT_SUFFIX<\/param-name>\r\n\t\t<param-value>.xhtml<\/param-value>\r\n\t<\/context-param>\r\n\r\n\t<!-- Enables special Facelets debug output during development -->\r\n\t<context-param>\r\n\t\t<param-name>facelets.DEVELOPMENT<\/param-name>\r\n\t\t<param-value>true<\/param-value>\r\n\t<\/context-param>\r\n\r\n\t<!-- Causes Facelets to refresh templates during development -->\r\n\t<context-param>\r\n\t\t<param-name>facelets.REFRESH_PERIOD<\/param-name>\r\n\t\t<param-value>1<\/param-value>\r\n\t<\/context-param>\r\n\r\n\t<!-- Loads the Spring web application context -->\r\n\t<listener>\r\n\t\t<listener-class>\r\n\t\t\torg.springframework.web.context.ContextLoaderListener\r\n\t\t<\/listener-class>\r\n\t<\/listener>\r\n\r\n\t<!-- Serves static resource content from .jar files such as spring-faces.jar -->\r\n\t<servlet>\r\n\t\t<servlet-name>Resources Servlet<\/servlet-name>\r\n\t\t<servlet-class>\r\n\t\t\torg.springframework.js.resource.ResourceServlet\r\n\t\t<\/servlet-class>\r\n\t\t<load-on-startup>0<\/load-on-startup>\r\n\t<\/servlet>\r\n\r\n\t<!-- Map all \/resources requests to the Resource Servlet for handling -->\r\n\t<servlet-mapping>\r\n\t\t<servlet-name>Resources Servlet<\/servlet-name>\r\n\t\t<url-pattern>\/resources\/*<\/url-pattern>\r\n\t<\/servlet-mapping>\r\n\r\n\t<!-- The front controller of this Spring Web application, responsible for handling all application requests -->\r\n\t<servlet>\r\n\t\t<servlet-name>Spring MVC Dispatcher Servlet<\/servlet-name>\r\n\t\t<servlet-class>\r\n\t\t\torg.springframework.web.servlet.DispatcherServlet\r\n\t\t<\/servlet-class>\r\n\t\t<init-param>\r\n\t\t\t<param-name>contextConfigLocation<\/param-name>\r\n\t\t\t<param-value><\/param-value>\r\n\t\t<\/init-param>\r\n\t\t<load-on-startup>1<\/load-on-startup>\r\n\t<\/servlet>\r\n\r\n\t<!-- Map all \/spring requests to the Dispatcher Servlet for handling -->\r\n\t<servlet-mapping>\r\n\t\t<servlet-name>Spring MVC Dispatcher Servlet<\/servlet-name>\r\n\t\t<url-pattern>\/spring\/*<\/url-pattern>\r\n\t<\/servlet-mapping>\r\n\r\n\t<!-- Just here so the JSF implementation can initialize, *not* used at runtime -->\r\n\t<servlet>\r\n\t\t<servlet-name>Faces Servlet<\/servlet-name>\r\n\t\t<servlet-class>javax.faces.webapp.FacesServlet<\/servlet-class>\r\n\t\t<load-on-startup>1<\/load-on-startup>\r\n\t<\/servlet>\r\n\r\n\t<!-- Just here so the JSF implementation can initialize -->\r\n\t<servlet-mapping>\r\n\t\t<servlet-name>Faces Servlet<\/servlet-name>\r\n\t\t<url-pattern>*.jsf<\/url-pattern>\r\n\t<\/servlet-mapping>\r\n\r\n\t<welcome-file-list>\r\n\t\t<welcome-file>index.html<\/welcome-file>\r\n\t<\/welcome-file-list>\r\n\t\r\n<\/pre>\n
At the top of this web.xml<\/code> file, we indicate that our primary Spring bean config file is called \\WEB-INF\\applicationContext.xml<\/code> so we navigate to that folder (it’s in the WebContent folder) and right click and add a new Spring Bean Definition. We also add two other Spring Bean definitions in the same place called dbConfig.xml<\/code> and flowConfig.xml<\/code>. These files are defined below :<\/p>\n
\/WebContent\/WEB-INF\/applicationContext.xml<\/code> <\/p>\n
\r\n<?xml version="1.0" encoding="UTF-8"?>\r\n<beans xmlns="http:\/\/www.springframework.org\/schema\/beans"\r\n\txmlns:xsi="http:\/\/www.w3.org\/2001\/XMLSchema-instance"\r\n\txsi:schemaLocation="http:\/\/www.springframework.org\/schema\/beans http:\/\/www.springframework.org\/schema\r\n\/beans\/spring-beans.xsd">\r\n\r\n\t<import resource="dbConfig.xml" \/>\r\n\t<import resource="flowConfig.xml" \/>\r\n<\/beans>\r\n<\/pre>\n
\/WebContent\/WEB-INF\/dbConfig.xml<\/code> <\/p>\n
\r\n<?xml version="1.0" encoding="UTF-8"?>\r\n<beans xmlns="http:\/\/www.springframework.org\/schema\/beans"\r\n\txmlns:xsi="http:\/\/www.w3.org\/2001\/XMLSchema-instance"\r\n\txmlns:aop="http:\/\/www.springframework.org\/schema\/aop"\r\n\txmlns:tx="http:\/\/www.springframework.org\/schema\/tx"\r\n\txsi:schemaLocation="http:\/\/www.springframework.org\/schema\/beans http:\/\/www.springframework.org\/schema\/beans\/spring-beans.xsd\r\n\t\thttp:\/\/www.springframework.org\/schema\/aop http:\/\/www.springframework.org\/schema\/aop\/spring-aop.xsd\r\n\t\thttp:\/\/www.springframework.org\/schema\/tx http:\/\/www.springframework.org\/schema\/tx\/spring-tx.xsd">\r\n\r\n\t<bean id="entityManagerFactory"\r\n\tclass="org.springframework.orm.jpa.LocalContainerEntityManagerFactoryBean">\r\n\t\t<property name="jpaVendorAdapter">\r\n\t\t\t<bean\r\n\tclass="org.springframework.orm.jpa.vendor.HibernateJpaVendorAdapter">\r\n\t\t\t\t<property name="showSql" value="true" \/>\r\n\t\t\t\t<property name="generateDdl" value="true" \/>\r\n\t\t\t\t<property name="databasePlatform"\r\n\tvalue="org.hibernate.dialect.MySQLDialect" \/>\r\n\t\t\t<\/bean>\r\n\t\t<\/property>\r\n\t\t<property name="dataSource" ref="dataSource" \/>\r\n\t\t\r\n\t<\/bean>\r\n\r\n\t<bean id="dataSource" class="org.apache.commons.dbcp.BasicDataSource"\r\n\tdestroy-method="close">\r\n\t\t<property name="driverClassName" value="com.mysql.jdbc.Driver" \/>\r\n\t\t<property name="url" value="jdbc:mysql:\/\/localhost:3306\/dbName" \/>\r\n\t\t<property name="username" value="someUser" \/>\r\n\t\t<property name="password" value="somePassword" \/>\r\n\t<\/bean>\r\n\r\n\t<bean id="transactionManager"\r\n\tclass="org.springframework.orm.jpa.JpaTransactionManager">\r\n\t\t<property name="dataSource" ref="dataSource" \/>\r\n\t\t<property name="entityManagerFactory" ref="entityManagerFactory" \/>\r\n\t<\/bean>\r\n\r\n\t<tx:annotation-driven \/>\r\n\r\n\t<bean\r\n\tclass="org.springframework.orm.jpa.support.PersistenceAnnotationBeanPostProcessor" \/>\r\n\r\n<\/beans>\r\n\r\n<\/pre>\n
\/WebContent\/WEB-INF\/flowConfig.xml<\/code> <\/p>\n
\r\n<?xml version="1.0" encoding="UTF-8"?>\r\n<beans xmlns="http:\/\/www.springframework.org\/schema\/beans"\r\n\txmlns:xsi="http:\/\/www.w3.org\/2001\/XMLSchema-instance"\r\n\txmlns:webflow="http:\/\/www.springframework.org\/schema\/webflow-config"\r\n\txmlns:faces="http:\/\/www.springframework.org\/schema\/faces"\r\n\txsi:schemaLocation="\r\n           http:\/\/www.springframework.org\/schema\/beans\r\n           http:\/\/www.springframework.org\/schema\/beans\/spring-beans-2.5.xsd\r\n           http:\/\/www.springframework.org\/schema\/webflow-config\r\n           http:\/\/www.springframework.org\/schema\/webflow-config\/spring-webflow-config-2.0.xsd\r\n           http:\/\/www.springframework.org\/schema\/faces\r\n           http:\/\/www.springframework.org\/schema\/faces\/spring-faces-2.0.xsd">\r\n\r\n\t<!--Executes flows: the central entry point into the Spring Web Flow system-->\r\n\t<webflow:flow-executor id="flowExecutor">\r\n\t\t<webflow:flow-execution-listeners>\r\n\t\t\t<webflow:listener ref="jpaFlowExecutionListener" \/>\r\n\r\n\t\t<\/webflow:flow-execution-listeners>\r\n\t<\/webflow:flow-executor>\r\n\r\n\t<!-- The registry of executable flow definitions -->\r\n\t<webflow:flow-registry id="flowRegistry"\r\n\tflow-builder-services="facesFlowBuilderServices">\r\n\t\t<webflow:flow-location path="\/WEB-INF\/flows\/testFlow\/testFlow.xml"><\/webflow:flow-location>\r\n\t<\/webflow:flow-registry>\r\n\r\n\t<!-- Configures the Spring Web Flow JSF integration -->\r\n\t<faces:flow-builder-services id="facesFlowBuilderServices"\r\n\tdevelopment="true" \/>\r\n\r\n\t<!--\r\n\t\tInstalls a listener that manages JPA persistence contexts for flows\r\n\t\tthat require them\r\n\t-->\r\n\t<bean id="jpaFlowExecutionListener"\r\n\tclass="org.springframework.webflow.persistence.JpaFlowExecutionListener">\r\n\t\t<constructor-arg ref="entityManagerFactory" \/>\r\n\t\t<constructor-arg ref="transactionManager" \/>\r\n\t<\/bean>\r\n\r\n\t<!-- Maps request URIs to controllers -->\r\n\t<bean\r\n\tclass="org.springframework.web.servlet.handler.SimpleUrlHandlerMapping">\r\n\r\n\t\t<property name="mappings">\r\n\r\n\t\t\t<value>\r\n\t\t\t\t\/testFlow=flowController\r\n\t\t\t<\/value>\r\n\t\t<\/property>\r\n\t\t<property name="defaultHandler">\r\n\t\t\t<!--\r\n\t\t\t\tSelects view names to render based on the request URI: e.g. \/main\r\n\t\t\t\tselects "main"\r\n\t\t\t-->\r\n\t\t\t<bean\r\n\tclass="org.springframework.web.servlet.mvc.UrlFilenameViewController" \/>\r\n\t\t<\/property>\r\n\t<\/bean>\r\n\r\n\t<!-- Handles requests mapped to the Spring Web Flow system -->\r\n\t<bean id="flowController"\r\n\tclass="org.springframework.webflow.mvc.servlet.FlowController">\r\n\t\t<property name="flowExecutor" ref="flowExecutor" \/>\r\n\t\t\r\n\t<\/bean>\r\n\r\n<\/beans>\r\n<\/pre>\n
Since we are using JPA, we need to include a persistence.xml<\/code> file to the classpath in src\/META-INF\/persistence.xml<\/code>.<\/p>\n
\r\n<?xml version="1.0" encoding="UTF-8"?>\r\n<persistence xmlns="http:\/\/java.sun.com\/xml\/ns\/persistence"\r\n\txmlns:xsi="http:\/\/www.w3.org\/2001\/XMLSchema-instance"\r\n\txsi:schemaLocation="http:\/\/java.sun.com\/xml\/ns\/persistence\r\n      http:\/\/java.sun.com\/xml\/ns\/persistence\/persistence_1_0.xsd"\r\n\tversion="1.0">\r\n\r\n    <persistence-unit name="default" transaction-type="RESOURCE_LOCAL" \/>\r\n    \r\n<\/persistence>\r\n<\/pre>\n
Now we need to add a faces-config.xml<\/code> in the same location.<\/p>\n
\/WebContent\/WEB-INF\/faces-config.xml<\/code> <\/p>\n
\r\n<?xml version="1.0" encoding="UTF-8"?>\r\n<faces-config version="1.2" xmlns="http:\/\/java.sun.com\/xml\/ns\/javaee"\r\n\txmlns:xi="http:\/\/www.w3.org\/2001\/XInclude"\r\n\txmlns:xsi="http:\/\/www.w3.org\/2001\/XMLSchema-instance"\r\n\txsi:schemaLocation="http:\/\/java.sun.com\/xml\/ns\/javaee http:\/\/java.sun.com\/xml\/ns\/javaee\/web-facesconfig_1_2.xsd">\r\n\r\n\t<application>\r\n\t\t<el-resolver>org.springframework.web.jsf.el.SpringBeanFacesELResolver<\/el-resolver>\r\n\t\t<view-handler>com.sun.facelets.FaceletViewHandler<\/view-handler>\r\n\t<\/application>\r\n<\/faces-config>\r\n\r\n<\/pre>\n
We’ll also add a html page that redirects to a jsf page immediately. Since we are using facelets, we’ll also throw in a template to work from. In the WebContent folder, we’ll add the templates<\/code> directory to contain our page layout.<\/p>\n
WebContent\\templates\\template.xhtml<\/code> <\/p>\n
\r\n<!DOCTYPE html PUBLIC "-\/\/W3C\/\/DTD XHTML 1.0 Transitional\/\/EN" \r\n                      "http:\/\/www.w3.org\/TR\/xhtml1\/DTD\/xhtml1-transitional.dtd">\r\n<html xmlns="http:\/\/www.w3.org\/1999\/xhtml"\r\n\txmlns:ui="http:\/\/java.sun.com\/jsf\/facelets"\r\n\txmlns:h="http:\/\/java.sun.com\/jsf\/html"\r\n\txmlns:f="http:\/\/java.sun.com\/jsf\/core">\r\n<head>\r\n  <meta http-equiv="Content-Type" content="text\/html; charset=UTF-8" \/>\r\n\r\n  <title><ui:insert name="title">untitled<\/ui:insert><\/title>\r\n\r\n<\/head>\r\n\r\n<body>\r\n  <h:messages globalOnly="true" \/>\r\n\r\n  <ui:insert name="title">Title Here<\/ui:insert>\r\n\r\n  <ui:insert name="body" \/>\r\n<\/body>\r\n<\/html>\r\n<\/pre>\n
Now to add our two pages that will initially launch is into a JSF page.<\/p>\n
\/WebContent\/index.html<\/code><\/p>\n
\r\n<html>\r\n<head>\r\n  <meta http-equiv="Refresh" content="0; URL=home.jsf">\r\n<\/head>\r\n<\/html>\r\n<\/textarea> <code>\/WebContent\/home.xhtml<\/code> <pre name="code" class="xml">\r\n<!DOCTYPE composition PUBLIC "-\/\/W3C\/\/DTD XHTML 1.0 Transitional\/\/EN" \r\n                      "http:\/\/www.w3.org\/TR\/xhtml1\/DTD\/xhtml1-transitional.dtd">\r\n<ui:composition xmlns="http:\/\/www.w3.org\/1999\/xhtml"\r\n\txmlns:ui="http:\/\/java.sun.com\/jsf\/facelets"\r\n\txmlns:f="http:\/\/java.sun.com\/jsf\/core"\r\n\txmlns:h="http:\/\/java.sun.com\/jsf\/html"\r\n\ttemplate="templates\/template.xhtml">\r\n\r\n\t<ui:define name="body">\r\n\t\t<h:form>\r\n\r\n\t\t\t<h:outputText value="Hello From JSF!" \/>\r\n\r\n\t\t<\/h:form>\r\n\t<\/ui:define>\r\n<\/ui:composition>\r\n\r\n<\/pre>\n
One more configuration file we need is for Log4j to get rid of the warnings that it has not been set up correctly. The properties file goes in the src<\/code> directory.<\/p>\n
\/src\/log4j.properties<\/code><\/p>\n
\r\n### direct log messages to stdout ###\r\nlog4j.appender.stdout=org.apache.log4j.ConsoleAppender\r\nlog4j.appender.stdout.Target=System.out\r\nlog4j.appender.stdout.layout=org.apache.log4j.PatternLayout\r\nlog4j.appender.stdout.layout.ConversionPattern=%d{ABSOLUTE} %5p %c{1}:%L - %m%n\r\nlog4j.rootLogger=info, stdout\r\nlog4j.category.org.springframework=WARN\r\nlog4j.category.org.hibernate=WARN\r\n<\/pre>\n
Now let’s look at libraries. There are a bunch of libraries that are needed since we haven’t added any yet.<\/p>\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
Libraries located in \/WebContent\/WEB-INF\/lib\/<\/code> <\/th>\n<\/tr>\n
antlr-2.7.6.jar<\/td>\nSpring Dependencies<\/td>\n<\/tr>\n
cglib-nodep-2.1_3.jar<\/td>\nSpring Dependencies<\/td>\n<\/tr>\n
commons-beanutils.jar<\/td>\nSpring Dependencies<\/td>\n<\/tr>\n
commons-collections.jar<\/td>\nSpring Dependencies<\/td>\n<\/tr>\n
commons-dbcp.jar<\/td>\nSpring Dependencies<\/td>\n<\/tr>\n
commons-digester.jar<\/td>\nSpring Dependencies<\/td>\n<\/tr>\n
commons-logging.jar<\/td>\nSpring Dependencies<\/td>\n<\/tr>\n
commons-pool.jar<\/td>\nSpring Dependencies<\/td>\n<\/tr>\n
dom4j-1.6.1.jar<\/td>\nSpring Dependencies<\/td>\n<\/tr>\n
hibernate3.jar<\/td>\nSpring Dependencies<\/td>\n<\/tr>\n
hibernate-annotations.jar<\/td>\nSpring Dependencies<\/td>\n<\/tr>\n
hibernate-commons-annotations.jar<\/td>\nSpring Dependencies<\/td>\n<\/tr>\n
hibernate-entitymanager.jar<\/td>\nSpring Dependencies<\/td>\n<\/tr>\n
javaee.jar<\/td>\nObtained From Glassfish<\/td>\n<\/tr>\n
javassist-3.4.GA.jar<\/td>\nSpring Dependencies<\/td>\n<\/tr>\n
jboss-el.jar<\/td>\nObtained From JBoss Seam<\/td>\n<\/tr>\n
jsf-api.jar<\/td>\nDownloaded Mojarra 1.2_11<\/td>\n<\/tr>\n
jsf-facelets.jar<\/td>\nObtained From JBoss Seam<\/td>\n<\/tr>\n
jsf-impl.jar –<\/td>\nDownloaded Mojarra 1.2_11<\/td>\n<\/tr>\n
log4j-1.2.15.jar<\/td>\nSpring Dependencies<\/td>\n<\/tr>\n
mysql-connector-java-5.0.4-bin.jar<\/td>\nDownloaded from MySQL<\/td>\n<\/tr>\n
org.springframework.binding-2.0.5.RELEASE.jar<\/td>\nSpring Web Flow Download<\/td>\n<\/tr>\n
org.springframework.faces-2.0.5.RELEASE.jar<\/td>\nSpring Web Flow Download<\/td>\n<\/tr>\n
org.springframework.js-2.0.5.RELEASE.jar<\/td>\nSpring Web Flow Download<\/td>\n<\/tr>\n
org.springframework.webflow-2.0.5.RELEASE.jar<\/td>\nSpring Web Flow Download<\/td>\n<\/tr>\n
persistence.jar<\/td>\nSpring Dependencies<\/td>\n<\/tr>\n
slf4j-api-1.5.0.jar<\/td>\nSpring Dependencies<\/td>\n<\/tr>\n
slf4j-log4j12-1.5.0.jar<\/td>\nSpring Dependencies<\/td>\n<\/tr>\n
spring.jar<\/td>\nSpring Dependencies<\/td>\n<\/tr>\n
spring-webmvc.jar<\/td>\nSpring Dependencies<\/td>\n<\/tr>\n<\/table>\n
One reason I downloaded the latest JSF version was because I was having problems with the JSF version I was using. The SpringBeanELResolver was being ignored at run-time, it didn’t even blink if I set it to an undefined class name, however the Spring Delegating variable resolver was working, but the IDE was saying it was deprecated. Once I upgraded to JSF 1.2_11, the EL resolver worked fine. I’m wondering if an old 1.1 JSF version had crept in there.<\/p>\n
Depending on where you end up deploying your application (i.e.Glassfish), you may end up having to remove some of these libraries if they are already installed on the server. In this case, I was using Apache 6.0.18 with a clean install, and therefore with no libraries added to the server.<\/p>\n
Creating a Flow<\/h1>\n
Now we should have a working application all ready to go. To test this, we’ll add a little code and a test page just to verify that everything is working ok. Create a new class called MessageHolder<\/code> in a package called swfproject<\/code>. This is a simple class that contains a string that can be set and retrieved from our pages.<\/p>\n
\/src\/swfproject\/MessageHolder.java<\/code> <\/p>\n
\r\npackage swfproject;\r\n\r\npublic class MessageHolder implements Serializable {\r\n\r\n\tprivate String text = "Hello From the Message Holder";\r\n\t\r\n\tpublic String getText() {\r\n\t\treturn text;\r\n\t}\r\n\t\r\n\tpublic void setText(String text) {\r\n\t\tthis.text = text;\r\n\t}\r\n}\r\n<\/pre>\n
Now we define the bean in the \/WEB-INF\/applicationContext.xml<\/code> so we can call the bean from a regular jsf page, or a flow page. <\/p>\n
\r\n\t<bean name="springMessage" class="swfproject.MessageHolder">\r\n\t\t<property name="text" value="This was defined in Spring" \/>\t\r\n\t<\/bean>\r\n<\/pre>\n
In the home.xhtml<\/code> page, we add the following line to the page, somewhere between the ui:define<\/code> tag on the page to display the message<\/p>\n
\r\nMessage is : #{springMessage.text}\r\n<\/pre>\n
If you start Tomcat, assuming you have already attached the project to the server if you are using an IDE, and go to http:\/\/localhost:8080\/projectName\/<\/code> you should redirect to home.jsf<\/code> and it should the message that was defined in Spring.<\/p>\n
Now let’s add a simple flow called testFlow. If you look in the flowConfig.xml<\/code> file, there is already a mappings property where we already defined \/testFlow=flowController<\/code>. This means that when this url is requested, the flowController<\/code> bean instance deals with it.<\/p>\n
We need to create a new directory under \/WebContent\/WEB-INF\/flows\/<\/code>, and in there, we need to create a directory called testFlow<\/code>. In that, we add a page called testFlow.xhtml<\/code> and testFlow.xml<\/code>. This is the view and the flow defined respectively.
\n\/WebContent\/WEB-INF\/flows\/testFlow\/testFlow.xml<\/code> Flow <\/p>\n
\r\n<?xml version="1.0" encoding="UTF-8"?>\r\n<flow xmlns="http:\/\/www.springframework.org\/schema\/webflow"\r\n\txmlns:xsi="http:\/\/www.w3.org\/2001\/XMLSchema-instance"\r\n\txmlns:faces="http:\/\/www.springframework.org\/schema\/faces"\r\n\txsi:schemaLocation="http:\/\/www.springframework.org\/schema\/webflow\r\n        http:\/\/www.springframework.org\/schema\/webflow\/spring-webflow-2.0.xsd"\r\n\tstart-state="testFlow">\r\n\r\n\t<var name="flowMessage" class="swfproject.MessageHolder" \/>\r\n\t<view-state id="testFlow">\r\n\t\t<transition on="post" to="testFlow" \/>\r\n\t<\/view-state>\r\n<\/flow>\r\n<\/pre>\n
\/WebContent\/WEB-INF\/flows\/testFlow\/testFlow.xhtml<\/code> View <\/p>\n
\r\n<!DOCTYPE composition PUBLIC "-\/\/W3C\/\/DTD XHTML 1.0 Transitional\/\/EN" \r\n                      "http:\/\/www.w3.org\/TR\/xhtml1\/DTD\/xhtml1-transitional.dtd">\r\n<ui:composition xmlns="http:\/\/www.w3.org\/1999\/xhtml"\r\n\txmlns:ui="http:\/\/java.sun.com\/jsf\/facelets"\r\n\txmlns:f="http:\/\/java.sun.com\/jsf\/core"\r\n\txmlns:h="http:\/\/java.sun.com\/jsf\/html"\r\n\ttemplate="\/templates\/template.xhtml">\r\n\r\n\t<ui:define name="body">\r\n\t\t<h:form>\r\n\t\t\t<h:outputText value="This is a test flow" \/>\r\n\t\t\t<br \/>\r\n\t\t\tMessage From Spring = #{springMessage.text}<br \/>\r\n\t\t\tMessage From Flow = #{flowMessage.text}<br \/>\r\n\t\t\t<h:inputText value="#{flowMessage.text}" style="width:200px" \/>\r\n\t\t\t<h:commandButton action="post" value="Update" \/>\r\n \t\t<\/h:form>\r\n\t<\/ui:define>\r\n<\/ui:composition>\r\n<\/pre>\n
Now if you go to http:\/\/localhost:8080\/app_name\/spring\/testFlow<\/a><\/code> (Remember to replace app_name<\/code> with your project name<\/b>) you should see the page we have made as part of our flow. It displays the message from the springMessage<\/code> instance of the MessageHolder<\/code> that contains the message from spring. I now also displays the instance from the flow which contains the default message displayed since the flow variable hasn’t had the text property changed. Also, the URL should change to http:\/\/localhost:8080\/app_name\/spring\/testFlow?execution=e3s1<\/code> or something similar with the execution on the end. This page demonstrates that we will have access to the spring beans, as well as access to variables defined in a flow which is where flowMessage<\/code> is defined. You can edit the message and click post to change the flowMessage text value. You can open the link up in two browser windows or tabs and see how the two values can be edited independently, and the flowMessage variable is scoped to the flow in the browser.
\nFrom this point, you can go ahead and move on with the application all you like. You can change the flow mappings, put in wildcarded flow locations, even get started with trying out Spring MVC (as I plan to). Hope you find this useful as a quick start guide to getting a JSF Spring Web Flow project up and running, as well as defining flows and calling them.<\/p>\n","protected":false},"excerpt":{"rendered":"
(Updated – 9 August 2010 – This was written in my pre-Maven days and after a few requests for working source, I’ve built the same project using Maven which can be downloaded. Just unzip the maven project, go to the directory in the command line and type mvn jetty:run to start the server and deploy […]<\/p>\n","protected":false},"author":2,"featured_media":0,"comment_status":"open","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"_monsterinsights_skip_tracking":false,"_monsterinsights_sitenote_active":false,"_monsterinsights_sitenote_note":"","_monsterinsights_sitenote_category":0},"categories":[64],"tags":[6,32,19],"_links":{"self":[{"href":"https:\/\/www.andygibson.net\/blog\/wp-json\/wp\/v2\/posts\/216"}],"collection":[{"href":"https:\/\/www.andygibson.net\/blog\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/www.andygibson.net\/blog\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/www.andygibson.net\/blog\/wp-json\/wp\/v2\/users\/2"}],"replies":[{"embeddable":true,"href":"https:\/\/www.andygibson.net\/blog\/wp-json\/wp\/v2\/comments?post=216"}],"version-history":[{"count":39,"href":"https:\/\/www.andygibson.net\/blog\/wp-json\/wp\/v2\/posts\/216\/revisions"}],"predecessor-version":[{"id":1322,"href":"https:\/\/www.andygibson.net\/blog\/wp-json\/wp\/v2\/posts\/216\/revisions\/1322"}],"wp:attachment":[{"href":"https:\/\/www.andygibson.net\/blog\/wp-json\/wp\/v2\/media?parent=216"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/www.andygibson.net\/blog\/wp-json\/wp\/v2\/categories?post=216"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/www.andygibson.net\/blog\/wp-json\/wp\/v2\/tags?post=216"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}