This commit updates URLs to prefer the https protocol. Redirects are not followed to avoid accidentally expanding intentionally shortened URLs (i.e. if using a URL shortener). # HTTP URLs that Could Not Be Fixed These URLs were unable to be fixed. Please review them to see if they can be manually resolved. * [ ] http://joda-time.sourceforge.net/ (200) with 1 occurrences could not be migrated: ([https](https://joda-time.sourceforge.net/) result AnnotatedConnectException). * [ ] http://saxon.sourceforge.net/ (200) with 1 occurrences could not be migrated: ([https](https://saxon.sourceforge.net/) result AnnotatedConnectException). * [ ] http://www.jjg.net/ia/visvocab/ (200) with 1 occurrences could not be migrated: ([https](https://www.jjg.net/ia/visvocab/) result AnnotatedConnectException). # Fixed URLs ## Fixed But Review Recommended These URLs were fixed, but the https status was not OK. However, the https status was the same as the http request or http redirected to an https URL, so they were migrated. Your review is recommended. * [ ] http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd (ReadTimeoutException) with 2 occurrences migrated to: https://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd ([https](https://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd) result ReadTimeoutException). * [ ] http://static.springframework.org/spring/docs/current/reference/portlet.html (301) with 1 occurrences migrated to: https://docs.spring.io/spring/docs/current/reference/portlet.html ([https](https://static.springframework.org/spring/docs/current/reference/portlet.html) result 404). * [ ] http://www.ognl.org/2.6.9/Documentation/html/LanguageGuide/index.html (404) with 1 occurrences migrated to: https://www.ognl.org/2.6.9/Documentation/html/LanguageGuide/index.html ([https](https://www.ognl.org/2.6.9/Documentation/html/LanguageGuide/index.html) result 404). * [ ] http://www.springframework.org/schema/faces/spring-faces-2.2.xsd (404) with 1 occurrences migrated to: https://www.springframework.org/schema/faces/spring-faces-2.2.xsd ([https](https://www.springframework.org/schema/faces/spring-faces-2.2.xsd) result 404). * [ ] http://www.springframework.org/schema/faces/spring-faces-2.4.xsd (404) with 3 occurrences migrated to: https://www.springframework.org/schema/faces/spring-faces-2.4.xsd ([https](https://www.springframework.org/schema/faces/spring-faces-2.4.xsd) result 404). * [ ] http://www.springframework.org/schema/webflow-config/spring-webflow-config-2.0.xsd (404) with 1 occurrences migrated to: https://www.springframework.org/schema/webflow-config/spring-webflow-config-2.0.xsd ([https](https://www.springframework.org/schema/webflow-config/spring-webflow-config-2.0.xsd) result 404). * [ ] http://www.springframework.org/schema/webflow-config/spring-webflow-config-2.3.xsd (404) with 2 occurrences migrated to: https://www.springframework.org/schema/webflow-config/spring-webflow-config-2.3.xsd ([https](https://www.springframework.org/schema/webflow-config/spring-webflow-config-2.3.xsd) result 404). * [ ] http://www.springframework.org/schema/webflow-config/spring-webflow-config-2.4.xsd (404) with 4 occurrences migrated to: https://www.springframework.org/schema/webflow-config/spring-webflow-config-2.4.xsd ([https](https://www.springframework.org/schema/webflow-config/spring-webflow-config-2.4.xsd) result 404). * [ ] http://www.springframework.org/schema/webflow/spring-webflow-1.0.xsd (404) with 2 occurrences migrated to: https://www.springframework.org/schema/webflow/spring-webflow-1.0.xsd ([https](https://www.springframework.org/schema/webflow/spring-webflow-1.0.xsd) result 404). * [ ] http://www.springframework.org/schema/webflow/spring-webflow-2.0.xsd (404) with 43 occurrences migrated to: https://www.springframework.org/schema/webflow/spring-webflow-2.0.xsd ([https](https://www.springframework.org/schema/webflow/spring-webflow-2.0.xsd) result 404). * [ ] http://www.springframework.org/schema/webflow/spring-webflow-2.4.xsd (404) with 2 occurrences migrated to: https://www.springframework.org/schema/webflow/spring-webflow-2.4.xsd ([https](https://www.springframework.org/schema/webflow/spring-webflow-2.4.xsd) result 404). ## Fixed Success These URLs were switched to an https URL with a 2xx status. While the status was successful, your review is still recommended. * [ ] http://static.springframework.org/spring-security/site/reference.html (301) with 2 occurrences migrated to: https://docs.spring.io/spring-security/site/reference.html ([https](https://static.springframework.org/spring-security/site/reference.html) result 200). * [ ] http://static.springsource.org/spring/docs/2.5.x/reference/mvc.html (301) with 1 occurrences migrated to: https://docs.spring.io/spring/docs/2.5.x/reference/mvc.html ([https](https://static.springsource.org/spring/docs/2.5.x/reference/mvc.html) result 200). * [ ] http://static.springsource.org/spring/docs/3.0.x/spring-framework-reference/html/expressions.html (301) with 2 occurrences migrated to: https://docs.spring.io/spring/docs/3.0.x/spring-framework-reference/html/expressions.html ([https](https://static.springsource.org/spring/docs/3.0.x/spring-framework-reference/html/expressions.html) result 200). * [ ] http://static.springsource.org/spring/docs/3.0.x/spring-framework-reference/html/index.html (301) with 1 occurrences migrated to: https://docs.spring.io/spring/docs/3.0.x/spring-framework-reference/html/index.html ([https](https://static.springsource.org/spring/docs/3.0.x/spring-framework-reference/html/index.html) result 200). * [ ] http://static.springsource.org/spring/docs/3.0.x/spring-framework-reference/html/mvc.html (301) with 2 occurrences migrated to: https://docs.spring.io/spring/docs/3.0.x/spring-framework-reference/html/mvc.html ([https](https://static.springsource.org/spring/docs/3.0.x/spring-framework-reference/html/mvc.html) result 200). * [ ] http://static.springsource.org/spring/docs/3.0.x/spring-framework-reference/html/validation.html (301) with 2 occurrences migrated to: https://docs.spring.io/spring/docs/3.0.x/spring-framework-reference/html/validation.html ([https](https://static.springsource.org/spring/docs/3.0.x/spring-framework-reference/html/validation.html) result 200). * [ ] http://en.wikipedia.org/wiki/Unified_Expression_Language with 1 occurrences migrated to: https://en.wikipedia.org/wiki/Unified_Expression_Language ([https](https://en.wikipedia.org/wiki/Unified_Expression_Language) result 200). * [ ] http://hibernate.sourceforge.net/hibernate-mapping-3.0.dtd (301) with 2 occurrences migrated to: https://hibernate.org/dtd/hibernate-mapping-3.0.dtd ([https](https://hibernate.sourceforge.net/hibernate-mapping-3.0.dtd) result 200). * [ ] http://jira.spring.io with 1 occurrences migrated to: https://jira.spring.io ([https](https://jira.spring.io) result 200). * [ ] http://portals.apache.org/pluto/ with 1 occurrences migrated to: https://portals.apache.org/pluto/ ([https](https://portals.apache.org/pluto/) result 200). * [ ] http://primefaces.org/documentation.html with 1 occurrences migrated to: https://primefaces.org/documentation.html ([https](https://primefaces.org/documentation.html) result 200). * [ ] http://repo.spring.io/libs-release/ with 2 occurrences migrated to: https://repo.spring.io/libs-release/ ([https](https://repo.spring.io/libs-release/) result 200). * [ ] http://repository.springsource.com/ivy/bundles/external/ with 2 occurrences migrated to: https://repository.springsource.com/ivy/bundles/external/ ([https](https://repository.springsource.com/ivy/bundles/external/) result 200). * [ ] http://repository.springsource.com/ivy/bundles/release/ with 2 occurrences migrated to: https://repository.springsource.com/ivy/bundles/release/ ([https](https://repository.springsource.com/ivy/bundles/release/) result 200). * [ ] http://search.maven.org with 1 occurrences migrated to: https://search.maven.org ([https](https://search.maven.org) result 200). * [ ] http://tiles.apache.org/ with 1 occurrences migrated to: https://tiles.apache.org/ ([https](https://tiles.apache.org/) result 200). * [ ] http://tiles.apache.org/dtds/tiles-config_2_1.dtd with 1 occurrences migrated to: https://tiles.apache.org/dtds/tiles-config_2_1.dtd ([https](https://tiles.apache.org/dtds/tiles-config_2_1.dtd) result 200). * [ ] http://tiles.apache.org/dtds/tiles-config_3_0.dtd with 1 occurrences migrated to: https://tiles.apache.org/dtds/tiles-config_3_0.dtd ([https](https://tiles.apache.org/dtds/tiles-config_3_0.dtd) result 200). * [ ] http://www.ognl.org with 1 occurrences migrated to: https://www.ognl.org ([https](https://www.ognl.org) result 200). * [ ] http://xmlns.jcp.org/xml/ns/persistence/orm_2_1.xsd (301) with 1 occurrences migrated to: https://www.oracle.com/webfolder/technetwork/jsc/xml/ns/persistence/orm_2_1.xsd ([https](https://xmlns.jcp.org/xml/ns/persistence/orm_2_1.xsd) result 200). * [ ] http://www.springframework.org/schema/beans/spring-beans-2.0.xsd with 1 occurrences migrated to: https://www.springframework.org/schema/beans/spring-beans-2.0.xsd ([https](https://www.springframework.org/schema/beans/spring-beans-2.0.xsd) result 200). * [ ] http://www.springframework.org/schema/beans/spring-beans-2.5.xsd with 1 occurrences migrated to: https://www.springframework.org/schema/beans/spring-beans-2.5.xsd ([https](https://www.springframework.org/schema/beans/spring-beans-2.5.xsd) result 200). * [ ] http://www.springframework.org/schema/beans/spring-beans-4.0.xsd with 8 occurrences migrated to: https://www.springframework.org/schema/beans/spring-beans-4.0.xsd ([https](https://www.springframework.org/schema/beans/spring-beans-4.0.xsd) result 200). * [ ] http://www.springframework.org/schema/beans/spring-beans.xsd with 6 occurrences migrated to: https://www.springframework.org/schema/beans/spring-beans.xsd ([https](https://www.springframework.org/schema/beans/spring-beans.xsd) result 200). * [ ] http://www.springframework.org/schema/mvc/spring-mvc-4.0.xsd with 4 occurrences migrated to: https://www.springframework.org/schema/mvc/spring-mvc-4.0.xsd ([https](https://www.springframework.org/schema/mvc/spring-mvc-4.0.xsd) result 200). * [ ] http://springframework.org with 1 occurrences migrated to: https://springframework.org ([https](https://springframework.org) result 301). * [ ] http://www.docbook.org/xml/5.0/xsd/docbook.xsd with 18 occurrences migrated to: https://www.docbook.org/xml/5.0/xsd/docbook.xsd ([https](https://www.docbook.org/xml/5.0/xsd/docbook.xsd) result 301). * [ ] http://www.docbook.org/xml/5.0/xsd/xlink.xsd with 18 occurrences migrated to: https://www.docbook.org/xml/5.0/xsd/xlink.xsd ([https](https://www.docbook.org/xml/5.0/xsd/xlink.xsd) result 301). * [ ] http://www.jboss.org/richfaces/docs with 1 occurrences migrated to: https://www.jboss.org/richfaces/docs ([https](https://www.jboss.org/richfaces/docs) result 301). * [ ] http://java.sun.com/dtd/facelet-taglib_1_0.dtd with 1 occurrences migrated to: https://java.sun.com/dtd/facelet-taglib_1_0.dtd ([https](https://java.sun.com/dtd/facelet-taglib_1_0.dtd) result 302). * [ ] http://java.sun.com/dtd/web-facesconfig_1_0.dtd with 1 occurrences migrated to: https://java.sun.com/dtd/web-facesconfig_1_0.dtd ([https](https://java.sun.com/dtd/web-facesconfig_1_0.dtd) result 302). * [ ] http://java.sun.com/xml/ns/javaee/web-facesconfig_2_0.xsd with 2 occurrences migrated to: https://java.sun.com/xml/ns/javaee/web-facesconfig_2_0.xsd ([https](https://java.sun.com/xml/ns/javaee/web-facesconfig_2_0.xsd) result 302). * [ ] http://java.sun.com/xml/ns/persistence/persistence_1_0.xsd with 1 occurrences migrated to: https://java.sun.com/xml/ns/persistence/persistence_1_0.xsd ([https](https://java.sun.com/xml/ns/persistence/persistence_1_0.xsd) result 302). * [ ] http://repo.spring.io/snapshot with 1 occurrences migrated to: https://repo.spring.io/snapshot ([https](https://repo.spring.io/snapshot) result 302). * [ ] http://www.paypal.com?_callbackUrl= with 1 occurrences migrated to: https://www.paypal.com?_callbackUrl= ([https](https://www.paypal.com?_callbackUrl=) result 302). # Ignored These URLs were intentionally ignored. * http://docbook.org/ns/docbook with 36 occurrences * http://jakarta.apache.org/log4j/ with 4 occurrences * http://java.sun.com/jsf/facelets with 2 occurrences * http://java.sun.com/jsf/html with 2 occurrences * http://java.sun.com/xml/ns/javaee with 4 occurrences * http://java.sun.com/xml/ns/persistence with 2 occurrences * http://localhost/app/hotels/booking?hotelId=1 with 1 occurrences * http://www.springframework.org/schema/beans with 32 occurrences * http://www.springframework.org/schema/faces with 8 occurrences * http://www.springframework.org/schema/mvc with 8 occurrences * http://www.springframework.org/schema/webflow with 96 occurrences * http://www.springframework.org/schema/webflow-config with 14 occurrences * http://www.springframework.org/security/tags with 2 occurrences * http://www.springframework.org/security/tags</namespace> with 1 occurrences * http://www.w3.org/1999/xhtml with 2 occurrences * http://www.w3.org/1999/xlink with 36 occurrences * http://www.w3.org/2001/XInclude with 35 occurrences * http://www.w3.org/2001/XMLSchema-instance with 85 occurrences * http://xmlns.jcp.org/xml/ns/persistence/orm with 2 occurrences
176 lines
6.9 KiB
XML
176 lines
6.9 KiB
XML
<?xml version="1.0" encoding="UTF-8"?>
|
|
<chapter xml:id="introduction"
|
|
xmlns="http://docbook.org/ns/docbook" version="5.0"
|
|
xmlns:xl="http://www.w3.org/1999/xlink"
|
|
xmlns:xi="http://www.w3.org/2001/XInclude"
|
|
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
|
|
xsi:schemaLocation="
|
|
http://docbook.org/ns/docbook https://www.docbook.org/xml/5.0/xsd/docbook.xsd
|
|
http://www.w3.org/1999/xlink https://www.docbook.org/xml/5.0/xsd/xlink.xsd">
|
|
<title>Introduction</title>
|
|
<sect1 xml:id="manual-overview">
|
|
<title>What this guide covers</title>
|
|
<para>
|
|
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.
|
|
</para>
|
|
</sect1>
|
|
<sect1 xml:id="system-requirements">
|
|
<title>What Web Flow requires to run</title>
|
|
<para>
|
|
Java 1.6 or higher.
|
|
</para>
|
|
<para>
|
|
Spring 3.2 or higher.
|
|
</para>
|
|
</sect1>
|
|
<sect1 xml:id="resources">
|
|
<title>Resources</title>
|
|
<para>
|
|
You can ask questions and interact on StackOverflow using the designated tags,
|
|
see <link xl:href="https://spring.io/questions">Spring at StackOverflow</link>.
|
|
</para>
|
|
<para>
|
|
Report bugs and make requests using the
|
|
<link xl:href="https://jira.spring.io">Spring Issue Tracker</link>.
|
|
</para>
|
|
<para>
|
|
Submit pull requests and work with the source code ,
|
|
see <link xl:href="https://github.com/spring-projects/spring-webflow">Web Flow on Github</link>.
|
|
</para>
|
|
</sect1>
|
|
<sect1 xml:id="jars-mvn-central">
|
|
<title>How to access Web Flow artifacts from Maven Central</title>
|
|
<para>
|
|
Each jar in the Web Flow distribution is available in the <link xl:href="https://search.maven.org">Maven Central Repository</link>.
|
|
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.
|
|
</para>
|
|
<para>
|
|
To access Web Flow jars from Maven Central, declare the following dependency in your pom (includes
|
|
transitive dependencies "spring-binding" and "spring-js"):
|
|
</para>
|
|
<programlisting language="xml"><![CDATA[
|
|
<dependency>
|
|
<groupId>org.springframework.webflow</groupId>
|
|
<artifactId>spring-webflow</artifactId>
|
|
<version>x.y.z.RELEASE</version>
|
|
</dependency>
|
|
]]>
|
|
</programlisting>
|
|
<para>
|
|
If using JavaServer Faces, declare the following dependency in your pom (includes transitive dependencies "spring-binding", "spring-webflow" and "spring-js"):
|
|
</para>
|
|
<programlisting language="xml"><![CDATA[
|
|
<dependency>
|
|
<groupId>org.springframework.webflow</groupId>
|
|
<artifactId>spring-faces</artifactId>
|
|
<version>x.y.z.RELEASE</version>
|
|
</dependency>
|
|
]]>
|
|
</programlisting>
|
|
</sect1>
|
|
<sect1 xml:id="jars-ivy">
|
|
<title>How to access Web Flow artifacts with Ivy</title>
|
|
<para>
|
|
To access Spring Web Flow jars with Ivy, add the following repositories to your Ivy config:
|
|
</para>
|
|
<programlisting language="xml"><![CDATA[
|
|
<url name="com.springsource.repository.bundles.release">
|
|
<ivy pattern="https://repository.springsource.com/ivy/bundles/release/
|
|
[organisation]/[module]/[revision]/[artifact]-[revision].[ext]" />
|
|
<artifact pattern="https://repository.springsource.com/ivy/bundles/release/
|
|
[organisation]/[module]/[revision]/[artifact]-[revision].[ext]" />
|
|
</url>
|
|
|
|
<url name="com.springsource.repository.bundles.external">
|
|
<ivy pattern="https://repository.springsource.com/ivy/bundles/external/
|
|
[organisation]/[module]/[revision]/[artifact]-[revision].[ext]" />
|
|
<artifact pattern="https://repository.springsource.com/ivy/bundles/external/
|
|
[organisation]/[module]/[revision]/[artifact]-[revision].[ext]" />
|
|
</url>]]>
|
|
</programlisting>
|
|
<para>
|
|
To access Spring Web Flow jars as well as 3rd party dependencies with Ivy, add the following repository to your Ivy config:
|
|
</para>
|
|
<programlisting language="xml"><![CDATA[
|
|
<url name="springsource-repository">
|
|
<ivy pattern="https://repo.spring.io/libs-release/[organization]/[module]/[revision]/[type]s/ivy-[revision].xml" />
|
|
<artifact pattern="https://repo.spring.io/libs-release/[organization]/[module]/[revision]/[type]s/[module](-[classifier])-[revision].[ext]" />
|
|
</url>]]>
|
|
</programlisting>
|
|
<para>
|
|
Then declare the following dependencies in your ivy.xml:
|
|
</para>
|
|
<programlisting language="xml"><![CDATA[
|
|
<dependency org="org.springframework.webflow" name="org.springframework.binding"
|
|
rev="x.y.z.RELEASE" conf="compile->runtime" />
|
|
<dependency org="org.springframework.webflow" name="org.springframework.js"
|
|
rev="x.y.z.RELEASE" conf="compile->runtime" />
|
|
<dependency org="org.springframework.webflow" name="org.springframework.webflow"
|
|
rev="x.y.z.RELEASE" conf="compile->runtime" />]]>
|
|
</programlisting>
|
|
<para>
|
|
If using JavaServer Faces, declare the following dependency in your pom (also adds the above dependencies):
|
|
</para>
|
|
<programlisting language="xml"><![CDATA[
|
|
<dependency org="org.springframework.webflow" name="org.springframework.faces"
|
|
rev="x.y.z.RELEASE" conf="compile->runtime" />]]>
|
|
</programlisting>
|
|
</sect1>
|
|
<sect1>
|
|
<title>How to access nightly builds and milestone releases</title>
|
|
<para>
|
|
Nightly snapshots of Web Flow development branches are available using Maven.
|
|
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.
|
|
</para>
|
|
<sect2>
|
|
<title>Accessing snapshots and milestones with Maven</title>
|
|
<para>
|
|
For milestones and snapshots you'll need to use the SpringSource repository.
|
|
Add the following repository to your Maven pom.xml:
|
|
</para>
|
|
<programlisting language="xml"><![CDATA[
|
|
<repository>
|
|
<id>springsource-repository</id>
|
|
<name>Spring project snapshots, milestones, and releases</name>
|
|
<url>https://repo.spring.io/snapshot</url>
|
|
</repository>]]>
|
|
</programlisting>
|
|
<para>
|
|
Then declare the following dependencies:
|
|
</para>
|
|
<programlisting language="xml"><![CDATA[
|
|
<dependency>
|
|
<groupId>org.springframework.webflow</groupId>
|
|
<artifactId>spring-binding</artifactId>
|
|
<version>x.y.z.BUILD-SNAPSHOT</version>
|
|
</dependency>
|
|
|
|
<dependency>
|
|
<groupId>org.springframework.webflow</groupId>
|
|
<artifactId>spring-js</artifactId>
|
|
<version>x.y.z.BUILD-SNAPSHOT</version>
|
|
</dependency>
|
|
|
|
<dependency>
|
|
<groupId>org.springframework.webflow</groupId>
|
|
<artifactId>spring-webflow</artifactId>
|
|
<version>x.y.z.BUILD-SNAPSHOT</version>
|
|
</dependency>]]>
|
|
</programlisting>
|
|
<para>
|
|
And if using JavaServerFaces:
|
|
</para>
|
|
<programlisting language="xml"><![CDATA[
|
|
<dependency>
|
|
<groupId>org.springframework.webflow</groupId>
|
|
<artifactId>spring-faces</artifactId>
|
|
<version>x.y.z.BUILD-SNAPSHOT</version>
|
|
</dependency>]]>
|
|
</programlisting>
|
|
</sect2>
|
|
</sect1>
|
|
</chapter>
|