streamalism.org

1. Prehľad

Spring Web Flow vychádza z jarného MVC a umožňuje implementovať toky vo webovej aplikácii. Používa sa na vytváranie sekvencií krokov, ktoré používateľov prevedú procesom alebo obchodnou logikou.

V tomto rýchlom návode si prejdeme jednoduchý príklad toku aktivácie používateľa. Používateľovi sa zobrazí stránka a klikne na ikonu Aktivovať tlačidlo pokračujte alebo na Zrušiť tlačidlo na zrušenie aktivácie.

Nie je tu predpoklad, že máme už nastavenú webovú aplikáciu Spring MVC.

2. Inštalácia

Začnime pridaním závislosti Spring Web Flow do pom.xml:

 org.springframework.webflow spring-webflow 2.5.0.RELEASE 

Najnovšiu verziu Spring Web Flow nájdete v centrálnom úložisku Maven.

3. Vytvorenie toku

Vytvorme teraz jednoduchý tok. Ako už bolo uvedené vyššie, tok predstavuje postupnosť krokov, ktoré používateľa prevedú procesom. V súčasnosti je to možné vykonať iba pomocou konfigurácie založenej na XML.

Každý krok v toku sa nazýva a štát.

Pre tento jednoduchý príklad použijeme a rozhľadový stav. A rozhľadový stav je krok v toku, ktorý poskytuje zhodné zobrazenie. The rozhľadový stav odkazuje na stránku v aplikácii (WEB-INF / zobrazenie), s identifikačným číslom rozhľadový stav je názov stránky, na ktorú odkazuje.

Budeme tiež používať a prechod element. A prechod prvok sa používa na spracovanie udalostí, ktoré sa vyskytujú v konkrétnom štát.

Pre tento príklad toku nastavíme tri vyhliadkové štáty - the aktivácia, úspecha zlyhanie.

Proces tohto toku je dosť priamy. Východiskovým bodom je aktivácia vyhliadka. Ak je Aktivovať udalosť sa spustí, mala by prejsť na úspech vyhliadka. Ak Zrušiť udalosť sa spustí, mala by prejsť na zlyhanie vyhliadka. The prechod element spracováva udalosť kliknutia na tlačidlo, ktorá sa stane v priečinku stav zobrazenia:

Stránka počiatočnej aktivácie, na ktorú odkazuje id aktivácia a nachádza sa v WEB-INF / view / activation.jsp, je jednoduchá stránka, ktorá má dve tlačidlá, Aktivovať a Zrušiť. Kliknutím na tlačidlá s aktiváciou našich prechodov buď používateľa pošlete k úspechu rozhľadový stav (WEB-INF / view / success.jsp) alebo zlyhanie rozhľadový stav (WEB-INF / view / failure.jsp):

Kliknutím aktivujete účet

Používame flowExecutionUrl na prístup k kontextovo relatívnemu URI pre aktuálne vykonávanie toku rozhľadový stav.

4. Konfigurácia toku

Ďalej nakonfigurujeme Spring Web Flow do nášho webového prostredia. Urobíme to nastavením Flow Flow a služby Flow Builder.

Register tokov nám umožňuje určiť umiestnenie našich tokov a tiež určiť službu Flow Builder, ak sa používa.

Služba Flow Builder Service nám pomáha prispôsobiť služby a nastavenia používané na vytváranie tokov.

Jednou zo služieb, ktorú môžeme prispôsobiť, je tvorca vyhliadky. The tvorca vyhliadky nám umožňuje prispôsobiť ViewFactoryCreator používa Spring Web Flow. Pretože používame Spring MVC, môžeme nakonfigurovať Spring Web Flow tak, aby používal rezolver pohľadov v našich konfiguráciách Spring MVC.

Takto nakonfigurujeme Spring Web Flow pre náš príklad:

@Configuration verejná trieda WebFlowConfig rozširuje AbstractFlowConfiguration {@Autowired súkromný WebMvcConfig webMvcConfig; @Bean public FlowDefinitionRegistry flowRegistry () {return getFlowDefinitionRegistryBuilder (flowBuilderServices ()) .addFlowLocation ("/ WEB-INF / toky / aktivácia-tok.xml", "aktiváciaFlow") .build (); } @Bean public FlowExecutor flowExecutor () {return getFlowExecutorBuilder (flowRegistry ()). Build (); } @Bean public FlowBuilderServices flowBuilderServices () {return getFlowBuilderServicesBuilder () .setViewFactoryCreator (mvcViewFactoryCreator ()) .setDevelopmentMode (true) .build (); } @Bean public MvcViewFactoryCreator mvcViewFactoryCreator () {MvcViewFactoryCreator factoryCreator = nový MvcViewFactoryCreator (); factoryCreator.setViewResolvers (Collections.singletonList (this.webMvcConfig.viewResolver ())); factoryCreator.setUseSpringBeanBinding (true); vrátiť factoryCreator; }}

Pre túto konfiguráciu môžeme tiež použiť XML:

5. Navigácia v tokoch

Ak sa chcete pohybovať v tokoch, spustite webovú aplikáciu a prejdite na // localhost: 8080 / {context-path} / activationFlow. Aplikáciu spustíte umiestnením na aplikačný server, napríklad Tomcat alebo Jetty.

Toto nás pošle na úvodnú stránku toku, ktorou je aktivácia stránka uvedená v našej konfigurácii toku:

Môžete kliknúť na ikonu Aktivovať tlačidlo pre prechod na stránku s úspechom:

Alebo Zrušiť tlačidlo pre prechod na stránku zlyhania:

6. Záver

V tomto článku sme použili jednoduchý príklad ako príručku, ako používať Spring Web Flow.

Kompletný zdrojový kód a všetky útržky kódu pre tento článok nájdete na GitHub.