Introduction What this guide covers This guide covers all aspects of Spring Web Flow. It covers implementing flows in end-user applications and working with the feature set. It also covers extending the framework and the overall architectural model. What Web Flow requires to run Java 1.5 or higher Spring 3.0 or higher Where to get support Professional from-the-source support on Spring Web Flow is available from SpringSource, the company behind Spring, and Ervacon, operated by Web Flow project co-founder Erwin Vervaet Where to follow development You can help make Web Flow best serve the needs of the Spring community by interacting with developers at the Spring Community Forums. Report bugs and influence the Web Flow project roadmap using the Spring Issue Tracker. Subscribe to the Spring Community Portal for the latest Spring news and announcements. Visit the Web Flow Project Home for more resources on the project. How to access Web Flow artifacts from Maven Central Each jar in the Web Flow distribution is available in the Maven Central Repository. This allows you to easily integrate Web Flow into your application if you are already using Maven as the build system for your web development project. To access Web Flow jars from Maven Central, declare the following dependency in your pom (also adds "spring-binding", "spring-js", and "spring-js-resources"): org.springframework.webflow spring-webflow 2.2.0.RELEASE ]]> If using JavaServer Faces, declare the following dependency in your pom (also adds the above dependencies): org.springframework.webflow spring-faces 2.2.0.RELEASE ]]> How to access Web Flow artifacts from the SpringSource Bundle Repository Each jar in the Web Flow distribution is also available in the SpringSource Enterprise Bundle Repository. Use this repository when you wish to run Spring Web Flow in an OSGi environment such as the SpringSource dm Server. All jars obtained from the SpringSource Bundle Repository are OSGi-ready. Accessing Web Flow bundles with Maven To access bundles using Maven, add the following repositories to your Maven pom: com.springsource.repository.bundles.release SpringSource Enterprise Bundle Repository - SpringSource Releases http://repository.springsource.com/maven/bundles/release com.springsource.repository.bundles.external SpringSource Enterprise Bundle Repository - External Releases http://repository.springsource.com/maven/bundles/external ]]> Then declare the following dependency: org.springframework.webflow org.springframework.webflow 2.2.0.RELEASE ]]> And if using JavaServer Faces: org.springframework.webflow org.springframework.faces 2.2.0.RELEASE ]]> Note the Web Flow artifacts in the SpringSource Bundle Repository are indexed under different ids because their transitive dependencies are different than the Maven Central artifacts. The difference is the transitive jars such as commons-logging have been patched by SpringSource to add the metadata required to make them OSGi-compatible. Accessing Web Flow bundles with Ivy To access bundles using Ivy, add the following repositories to your Ivy config: ]]> Then declare the following dependencies (also adds "org.springframework.binding", "org.springframework.js", and "org.springframework.spring.js"): runtime" />]]> And if using JavaServerFaces: runtime" />]]> Accessing the dm Server Web Flow library A dm Server library for Web Flow is also available if you are deploying to a dm Server environment. Import this library in your MANIFEST.mf to automatically import all Web Flow bundles. To access the library, add the following repository: com.springsource.repository.libraries.release SpringSource Enterprise Bundle Repository - SpringSource Library Releases http://repository.springsource.com/maven/libraries/release ]]> And declare the following dependency: org.springframework.webflow org.springframework.webflow-library libd 2.2.0.RELEASE ]]> How to access nightly builds Nightly snapshots of Web Flow development branches are available using Maven, and distribution zips are also available for download. These snapshot builds are useful for testing out fixes you depend on in advance of the next release, and provide a convenient way for you to provide feedback about whether a fix meets your needs. If using Maven, you may obtain snapshots from either the SpringSource-managed Maven Central-compatible repository or the SpringSource Enterprise Bundle Repository. Use the Maven Central-compatible snapshot repository when your project obtains its other open source dependencies from Maven Central. Use the Spring Source Enterprise Bundle Snapshot Repository when you wish to run Web Flow in an OSGi environment. Accessing snapshots from the Maven-central compatible repository Add the following repository your pom: org.springsource.maven.snapshot SpringSource Maven Central-compatible Snapshot Repository http://maven.springframework.org/snapshot ]]> Then declare the following dependencies: org.springframework.webflow spring-binding x.y.z.BUILD-SNAPSHOT org.springframework.webflow spring-js x.y.z.BUILD-SNAPSHOT org.springframework.webflow spring-webflow x.y.z.BUILD-SNAPSHOT ]]> And if using JavaServerFaces: org.springframework.webflow spring-faces x.y.z.BUILD-SNAPSHOT ]]> Accessing snapshots from the SpringSource Enterprise Bundle Repository Add the following repository your pom: com.springsource.repository.bundles.snapshot SpringSource Enterprise Bundle Snapshot Repository http://repository.springsource.com/maven/bundles/snapshot ]]> Then declare the following dependencies: org.springframework.webflow org.springframework.binding x.y.z.BUILD-SNAPSHOT org.springframework.webflow org.springframework.js x.y.z.BUILD-SNAPSHOT org.springframework.webflow org.springframework.webflow x.y.z.BUILD-SNAPSHOT ]]> And if using JavaServerFaces: org.springframework.webflow org.springframework.faces x.y.z.BUILD-SNAPSHOT ]]> Accessing snapshot distribution archives Get the snapshot zip with the most recent CI build number from the Web Flow snapshot download area.