* [[InstalaceVzorovehoOpencmsModulu|Instalace vzorového [=SpringOpenCms=] modulu]]

* [[InstalaceVzorovehoOpencmsModulu|Instalace [=OpenCms=] modulu]]

* [[Instalace [=OpenCms=] modulu]]

* [[OpenCmsMapovaniNaUrl|Mapování modulů na hezká URL]]

* [[OpenCmsValidaceVstupnichPoliFormularu|Validace vstupních polí formulářů]]

!Ostatní dokumenty

* [[OpenCmsBestPractices|Best Practices]]

* [[OpenCmsLogovaniJednotlivychModulu|Jak vytvorit logovaci soubor pro jednotlive moduly do OpenCms]]
* [[OpenCmsLogovaniTraceLevel|Jak Přinutit Opencms aby logoval úroveň trace]]
* [[OpenCmsZnepristupneniViewStranek|Znepřístupnění view stránek z URL v OpenCms]]
* [[OpenCmsMapovaniNaUrl|Mapování modulů na hezká URL external]]
* [[OpenCmsPouzitiTaglibAKnihoven|Využití dalších Taglib a knihoven v prostředí OpenCms a Spring MVC]]
* [[OpenCmsValidaceVstupnichPoliFormularu|Validace vstupních polí formulářů external]]
* [[OpenCmsInternacionalizace|Internacionalizace]]
* [[OpenCmsTestovaniModulu|Testování modulů]]

----

* [[OpenCmsOdkazy|Odkazy]]

----

!Hlavní dokumenty

* [[IntegraceSpringWebFlowDoOpenCms|Integrace Spring Web Flow do [=OpenCms=]]]

----

!Integrace Spring Web Flow do [=OpenCms=]


!!Instalace knihoven

# Funkční Spring MVC (minimálně verze 2.5.4!) podle návodu výše.

# Stažení [[http://www.springsource.org/download#webflow|Spring Web Flow]] (min. verze 2.0.x).

# Stažení [[http://repo1.maven.org/maven2/ognl/ognl/2.6.9/ognl-2.6.9.jar|OGNL 2.6.9]] nebo [[http://www.springsource.com/repository/app/bundle/detail?name=com.springsource.org.jboss.el|jboss-el]].

# Přidání stažených [@JAR@] knihoven do [@OPENCMS_HOME\WEB-INF\lib@].


!!Konfigurace

Upravíme soubor [@TOMCAT_HOME\webapps\opencms\WEB-INF\springapp-servlet.xml@]

Atributy kořenového elementu [@beans@] rožšíríme o schema pro Web Flow. Dostaneme tedy:

[@<beans xmlns="http://www.springframework.org/schema/beans"
xmlns:context="http://www.springframework.org/schema/context"
xmlns:flow="http://www.springframework.org/schema/webflow-config"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://www.springframework.org/schema/beans
http://www.springframework.org/schema/beans/spring-beans-2.5.xsd
http://www.springframework.org/schema/context
http://www.springframework.org/schema/context/spring-context-2.5.xsd
http://www.springframework.org/schema/webflow-config
http://www.springframework.org/schema/webflow-config/spring-webflow-config-2.0.xsd">@]

Mapováni controlleru flow na [@springappflow.html@]. Soubor s definicí flow bude očekáván ve tvaru [@springappflow.xml@], viz definice níže.

[@<bean id="simpleUrlMapping" class="org.springframework.web.servlet.handler.SimpleUrlHandlerMapping">
<property name="mappings">
<props>
<prop key="springappflow.html">flowController</prop>
</props>
</property>
</bean>@]

Dále je samotná konfigurace Web Flow (stále jsme ve [@springapp-servlet.xml@]):

[@<bean id="flowController" class="org.springframework.webflow.mvc.servlet.FlowController">
<property name="flowExecutor" ref="flowExecutor"/>
</bean>

<flow:flow-executor id="flowExecutor" flow-registry="flowRegistry"/>@]

Nastavení cesty k definicím flow. Povinně musíme zadat cestu k [@springappflow.xml@], které jsme umístili do [@/WEB-INF/flows/@]. Je možné zde nastavit cesty k dalším definicím.

[@<flow:flow-registry id="flowRegistry" flow-builder-services="flowBuilderServices">
<flow:flow-location path="/WEB-INF/flows/springappflow.xml"/>
</flow:flow-registry>@]

Zaregistrování [@viewResolveru@] pro používaní view z MVC:

[@<flow:flow-builder-services id="flowBuilderServices" view-factory-creator="viewFactoryCreator"/>

<bean id="viewFactoryCreator" class="org.springframework.webflow.mvc.builder.MvcViewFactoryCreator">
<property name="viewResolvers">
<list>
<ref bean="viewResolver"/>
</list>
</property>

Hlavní dokumenty
* [[IntegraceSpringMVCDoOpenCms|Integrace Spring MVC do [=OpenCms=]]]

!!!TODO Instalace modulu pro OpenCMS - jako odkaz

!!!TODO Odkaz na stranku s dalsimi "vecmi"


----

* najdeme na [[http://springide.org/blog/|SpringIDE]]

Dále je samotná konfigurace Web Flow (stále jsme ve [@springapp-servlet.xml@]):

Nastavení cesty k definicím flow. Povinně musíme zadat cestu k [@springappflow.xml@], které jsme umístili do [@/WEB-INF/flows/@]. Je možné zde nastavit cesty k dalším definicím.

[@<flow:flow-builder-services id="flowBuilderServices" view-factory-creator="viewFactoryCreator"/>

Tímto máme hotovou konfiguraci souboru [@springapp-servlet.xml@].

* při problémech s instalací hledejte např. v [[http://jira.springframework.org/secure/Dashboard.jspa|bugzille]] springu

Není vhodné přidávat soubory s definicemi flow do hlavního projektu, který synchronizujeme s [=OpenCms serverem=] (jsou vyžadovány DTD pro XML). Vytvoříme tedy samostatný Spring projekt, kterému do Build Path přidáme náš hlavní projekt. Pro tvorbu nové definice máme k dispozici průvodce (jako pro vytváření projektu). Projekt obsahuje složku Spring Elements, kam můžeme vložit naše definice flow (právé tlačitko myši -> Properties). Grafický editor otevřeme položkou v kontextovém menu pravým tlačítkem myši na definici flow.

'''Dále je samotná konfigurace Web Flow:'''

* [[http://static.springframework.org/spring-webflow/docs/2.0.x/reference/html/index.html|Referenční příručka]]
* [[http://www.springbyexample.org/examples/simple-spring-web-flow-webapp.html|Spring by Example - Web Flow]]
* [[http://www.springbyexample.org/examples/spring-web-flow-subflow-webapp.html|Spring by Example - Web Flow Subflow]]
* [[http://wheelersoftware.com/articles/spring-web-flow-2.0.html|Tutorial - Shopping Cart]]

[@<flow:flow-registry id="flowRegistry" flow-builder-services="flowBuilderServices">
<flow:flow-location path="/WEB-INF/flows/springappflow.xml"/>
</flow:flow-registry>@]

Zaregistrování [@viewResolveru@] pro používaní view z MVC:
[@
<flow:flow-builder-services id="flowBuilderServices" view-factory-creator="viewFactoryCreator"/>

<bean id="viewFactoryCreator" class="org.springframework.webflow.mvc.builder.MvcViewFactoryCreator">
<property name="viewResolvers">
<list>
<ref bean="viewResolver"/>
</list>
</property>
</bean>@]

[@ViewResolver@] může vypadat například takto:

[@<bean id="viewResolver" class="org.springframework.web.servlet.view.InternalResourceViewResolver">
<property name="viewClass" value="org.springframework.web.servlet.view.JstlView"></property>
<property name="prefix" value="/opencms/system/modules/cz.zcu.kiv.opencms.springapp/elements/views/"></property>
<property name="suffix" value=".jsp"></property>
</bean>@]


!!Definice Flow

Podle výše uvedené konfigurace předpokládáme definici flow v souboru [@springappflow.xml@]. Tvorba definic flow a práce s nimi je popsána v [[http://static.springframework.org/spring-webflow/docs/2.0.x/reference/html/index.html|referenční příručce]] v kapitolách 2-5.

!!Spring IDE

* plugin do Eclipse
* podpora Web Flow 2.0
* kontrola syntaxe, našeptávač
* grafický editor

!!!Instalace

* najdeme na [[http://springide.org/blog/|SpringIDE]] external
* v Eclipse WTP lze stahovat přímo v 'Help -> Software Updates -> Available Software -> Spring IDE Update Site', kde vybereme
** /Core/Spring IDE Core
** /Extensions/Spring IDE Web Flow Extension
* při problémech s instalací hledejte např. v [[http://jet2009.origo.ethz.ch/http://jira.springframework.org/secure/Dashboard.jspa|bugzille]] springu

!!!Založení Spring projektu

Není vhodné přidávat soubory s definicemi flow do hlavního projektu, který synchronizujeme s OpenCms serverem (jsou vyžadovány DTD pro XML). Vytvoříme tedy samostatný Spring projekt, kterému do Build Path přidáme náš hlavní projekt. Pro tvorbu nové definice máme k dispozici průvodce (jako pro vytváření projektu). Projekt obsahuje složku Spring Elements, kam můžeme vložit naše definice flow (právé tlačitko myši -> Properties). Grafický editor otevřeme položkou v kontextovém menu pravým tlačítkem myši na definici flow.


!!Odkazy

* Referenční příručka external
* Spring by Example - Web Flow external
* Spring by Example - Web Flow Subflow external
* Tutorial - Shopping Cart external

# Stažení [[http://repo1.maven.org/maven2/ognl/ognl/2.6.9/ognl-2.6.9.jar|OGNL 2.6.9]] nebo [[http://www.springsource.com/repository/app/bundle/detail?name=com.springsource.org.jboss.el|jboss-el]].

# Přidání stažených [@JAR@] knihoven do [@OPENCMS_HOME\WEB-INF\lib@].


!!Konfigurace

Upravíme soubor [@TOMCAT_HOME\webapps\opencms\WEB-INF\springapp-servlet.xml@]

Atributy kořenového elementu [@beans@] rožšíríme o schema pro Web Flow. Dostaneme tedy:

[@<beans xmlns="http://www.springframework.org/schema/beans"
xmlns:context="http://www.springframework.org/schema/context"
xmlns:flow="http://www.springframework.org/schema/webflow-config"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://www.springframework.org/schema/beans
http://www.springframework.org/schema/beans/spring-beans-2.5.xsd
http://www.springframework.org/schema/context
http://www.springframework.org/schema/context/spring-context-2.5.xsd
http://www.springframework.org/schema/webflow-config
http://www.springframework.org/schema/webflow-config/spring-webflow-config-2.0.xsd">@]

Mapováni controlleru flow na [@springappflow.html@]. Soubor s definicí flow bude očekáván ve tvaru [@springappflow.xml@], viz definice níže.

[@<bean id="simpleUrlMapping" class="org.springframework.web.servlet.handler.SimpleUrlHandlerMapping">
<property name="mappings">
<props>
<prop key="springappflow.html">flowController</prop>
</props>
</property>
</bean>@]

[+Dále je samotná konfigurace Web Flow:+]

[@<bean id="flowController" class="org.springframework.webflow.mvc.servlet.FlowController">
<property name="flowExecutor" ref="flowExecutor"/>
</bean>

<flow:flow-executor id="flowExecutor" flow-registry="flowRegistry"/>@]

Nastavení cesty k definicím flow. Povinně musíme zadat cestu k [@springappflow.xml@], které jsme umístili do [@/WEB-INF/flows/@]. Dále zde můžeme nastavit cesty k dalším definicím.

# Stažení [[http://www.springsource.org/download#webflow|Spring Web Flow]] (min. verze 2.0.x).

# Funkční Spring MVC (minimálně verze 2.5.4!) podle návodu výše.

# Stažení [[Spring Web Flow|http://www.springsource.org/download#webflow]] (min. verze 2.0.x).

!!Instalace knihoven

# Funkční Spring MVC (minimálně verze 2.5.4!) podle návodu.

# Stažení Spring Web Flow external (min. verze 2.0.x).

# Stažení OGNL 2.6.9 external nebo jboss-el external.

# Přidání stažených JAR knihoven do OPENCMS_HOME\WEB-INF\lib.

!Integrace Spring Web Flow do [=OpenCms=]

----

Web Flow



----

Do souboru [@web.xml@] ([@OPENCMS_HOME\WEB-INF@]) se musí doplnit nastavení [@DispatcherServletu@] Spring MVC a jeho namapování na URL. Volitelně se může přidat definice [@tld@] souboru pro knihovnu značek Springu. (Při použití nové verze servletů toto odpadá, neboť všechny jar soubory na classpath jsou javou skenovány a všechny nalezené [@*.tld@] soubory jsou automaticky přidány. Nicméně není na závadu, pokud je [@tld@] soubor explicitně v [@web.xml@] specifikován.)

Jako další bod je potřeba přidat definici [@tld@] souboru. Toto se provede tím, že se do elementu [@<jsp-config>@] přidá následující kód:

!!!3. Přidání [@tld@] (Tag library deskriptor) souboru s popisem taglib Spring-forms

!!!5. Přidání souboru s [@applicationContextem@] pro Spring

Spring poté bude hledat soubor [@applicationContext.xml@], který musí ležet na stejné úrovni jako soubor [@web.xml@] (pokud se nenastaví jinak). Prázdný soubor [@applicationContext.xml@] má následující strukturu:

Do souboru [@web.xml@] ([@OPENCMS_HOME\WEB-INF@]) se musí doplnit nastavení [@DispatcherServletu@] Spring MVC a jeho namapování na URL. Volitelně se může přidat definice tld souboru pro knihovnu značek Springu. (Při použití nové verze servletů toto odpadá, neboť všechny jar soubory na classpath jsou javou skenovány a všechny nalezené *.tld soubory jsou automaticky přidány. Nicméně není na závadu, pokud je tld soubor explicitně v [@web.xml@] specifikován.)

Do [@web.xml@] doplňte následující definici servletu a jeho mapování:

Vzhledem k tomu, že konfigurační soubor Spring MVC není jediným místem, ze kterého si Spring může načítat definice java bean, je možné a i důrazně doporučené oddělit konfigurační soubor Spring MVC od ostatních konfiguračních souborů Springu. Tím se zaručí to, že se mezi sebou nemíchají definice beanů, které jsou použiti v zobrazovací vrstvě s definicemi beanů, které se například starají o přístup k databázi. Toho se docílí tím, že se do souboru [@web.xml@] přidá následující kód:

Spring poté bude hledat soubor [@applicationContext.xml@], který musí ležet na stejné úrovni jako soubor [@web.xml@] (pokud se nenastaví jinak). Prázdný soubor applicationContext.xml má následující strukturu:

!Integrace Spring MVC do [=OpenCms=]

* [=OpenCms=] 7.0.5 a teoreticky vyšší

* [@TOMCAT_HOME@] je adresář, ve kterém je nainstalován tomcat, na kterém je [=OpenCms=] nasazeno
* [@OPENCMS_HOME@] je adresář, ve kterém je běžící [=OpenCms=] (standardně [@TOMCAT_HOME\webapps\opencms@])

Tento návod je napsán tak, že i ve Spring MVC nezkušenému uživateli poskytne návod na to, jak tento framework zaintegrovat do [=OpenCms=]. Nicméně je doporučeníhodné projít si nejdříve Spring MVC Step By Step Tutorial, který je standardně v distribuci Spring Framweworku. Dále uvedený postup pro vás poté bude daleko více srozumitelnější.

!!Integrace Spring MVC do [=OpenCms=]

Do souboru [@web.xml@] ([@OPENCMS_HOME\WEB-INF@]) se musí doplnit nastavení [@DispatcherServletu@] Spring MVC a jeho namapování na URL. Volitelně se může přidat definice tld souboru pro knihovnu značek Springu. (Při použití nové verze servletů toto odpadá, neboť všechny jar soubory na classpath jsou javou skenovány a všechny nalezené *.tld soubory jsou automaticky přidány. Nicméně není na závadu, pokud je tld soubor explicitně v web.xml specifikován.)

!!!6. Přidání knihoven Spring MVC do [=OpenCms=]

Jako poslední krok je potřeba nahrát do [=OpenCms=] knihovny, které Spring MVC potřebuje pro svůj běh. Do adresáře: [@OPENCMS_HOME/WEB-INF/lib@] nahrajte následující soubory:

Nyní spusťte Tomcat a [=OpenCms=] by mělo bez chyby nastartovat. Pokud se [=OpenCms=] nerozběhlo, můžete se podívat do log souborů v adresáři: [@TOMCAT_HOME\webapps\opencms\WEB-INF\logs@] A pokusit se v nich příčinu chyby objevit.

* [@TOMCAT_HOME@] je adresář, ve kterém je nainstalován tomcat, na kterém je OpenCms nasazeno
* [@OPENCMS_HOME@] je adresář, ve kterém je běžící OpenCms (standardně [@TOMCAT_HOME\webapps\opencms@])

!!!2. Úprava souboru [@web.xml@]

Do souboru [@web.xml@] ([@OPENCMS_HOME\WEB-INF@]) se musí doplnit nastavení DispatcherServletu Spring MVC a jeho namapování na URL. Volitelně se může přidat definice tld souboru pro knihovnu značek Springu. (Při použití nové verze servletů toto odpadá, neboť všechny jar soubory na classpath jsou javou skenovány a všechny nalezené *.tld soubory jsou automaticky přidány. Nicméně není na závadu, pokud je tld soubor explicitně v web.xml specifikován.)

Stěžejnímy body v tomto kódu je element: [@<servlet-name>springmvcapp</servlet-name>@], neboť udává, v jakém soubor bude Spring MVC hledat svá nastavení.

Jako další bod je potřeba přidat definici tld souboru. Toto se provede tím, že se do elementu [@<jsp-config>@] přidá následující kód:

Tento soubor musí být zkopírován do adresáře zadaného v minulém kroku. V našem případě je to tedy [@OPENCMS_HOME/WEB-INF/tld/@]. Soubor se nachází v distribuci Spring frameworku v adresáři: [@spring-framework-2.5.X/dist/resources/@].

Spring MVC požaduje konfigurační soubor, ve kterém jsou uloženy definice beans a dalších java tříd, které při své činnosti potřebuje. Jméno tohoto souboru je určeno jménem servletu - viz. výše v souboru [@web.xml@] a příponou [@–servlet.xml@]. V našem případě se tedy tento soubor bude jmenovat [@springapp-servlet.xml@]. A bude ležet na stejné adresářové úrovni jako soubor [@web.xml@]. Tento soubor bude vypadat následujícím způsobem:

Vzhledem k tomu, že konfigurační soubor Spring MVC není jediným místem, ze kterého si Spring může načítat definice java bean, je možné a i důrazně doporučené oddělit konfigurační soubor Spring MVC od ostatních konfiguračních souborů Springu. Tím se zaručí to, že se mezi sebou nemíchají definice beanů, které jsou použiti v zobrazovací vrstvě s definicemi beanů, které se například starají o přístup k databázi. Toho se docílí tím, že se do souboru web.xml přidá následující kód:

Spring poté bude hledat soubor [@applicationContext.xml@], který musí ležet na stejné úrovni jako soubor web.xml (pokud se nenastaví jinak). Prázdný soubor applicationContext.xml má následující strukturu:

Jako poslední krok je potřeba nahrát do OpenCms knihovny, které Spring MVC potřebuje pro svůj běh. Do adresáře: [@OPENCMS_HOME/WEB-INF/lib@] nahrajte následující soubory:

* spring.jar z adresáře: [@spring-framework-2.5.6/dist@]
* spring-webmvc.jar z adresáře: [@spring-framework-2.5.6/dist/modules @]

Nyní spusťte Tomcat a OpenCms by mělo bez chyby nastartovat. Pokud se OpenCms nerozběhlo, můžete se podívat do log souborů v adresáři: [@TOMCAT_HOME\webapps\opencms\WEB-INF\logs@] A pokusit se v nich příčinu chyby objevit.

!Integrace Spring MVC do OpenCms

!!Softwarové požadavky

!!Používaní konvence

!!Než začnete číst tento tutoriál

!!Integrace Spring MVC do OpenCms

!!!1. Zastavte Tomcat

!!!2. Úprava souboru web.xml

!!!3. Přidání tld (Tag library deskriptor) souboru s popisem taglib Spring-forms

!!!4. Vytvoření souboru s definicí beans a nastavení Spring MVC

!!!5. Přidání souboru s applicationContextem pro Spring

!!!6. Přidání knihoven Spring MVC do OpenCms

!!!7. Test instalace

!!!!Integrace Spring MVC do OpenCms

!!!!1. Zastavte Tomcat

!!!!2. Úprava souboru web.xml

!!!!3. Přidání tld (Tag library deskriptor) souboru s popisem taglib Spring-forms

!!!!4. Vytvoření souboru s definicí beans a nastavení Spring MVC

!!!!5. Přidání souboru s applicationContextem pro Spring

!!!!6. Přidání knihoven Spring MVC do OpenCms

!!!!7. Test instalace

!!Integrace Spring MVC do OpenCms

!!!Softwarové požadavky

!!!Používaní konvence

!!!Než začnete číst tento tutoriál

!!!Integrace Spring MVC do OpenCms

#Zastavte Tomcat

#Úprava souboru web.xml

#Přidání tld (Tag library deskriptor) souboru s popisem taglib Spring-forms

#Vytvoření souboru s definicí beans a nastavení Spring MVC

#Přidání souboru s applicationContextem pro Spring

#Přidání knihoven Spring MVC do OpenCms

#Test instalace

[++Integrace Spring MVC do OpenCms ++]

Softwarové požadavky

* OpenCms 7.0.5 a teoreticky vyšší
* Spring Framwork 2.5.6 (obsahuje i MVC)
* Java 1.5 a vyšší


Používaní konvence

Pro zjednodušení výkladu je v následujícím dokumentu použita při odkazování na adresáře následující konvence:

* TOMCAT_HOME je adresář, ve kterém je nainstalován tomcat, na kterém je OpenCms nasazeno
* OPENCMS_HOME je adresář, ve kterém je běžící OpenCms (standardně TOMCAT_HOME\webapps\opencms)


Než začnete číst tento tutoriál

Tento návod je napsán tak, že i ve Spring MVC nezkušenému uživateli poskytne návod na to, jak tento framework zaintegrovat do OpenCms. Nicméně je doporučeníhodné projít si nejdříve Spring MVC Step By Step Tutorial, který je standardně v distribuci Spring Framweworku. Dále uvedený postup pro vás poté bude daleko více srozumitelnější.

Integrace Spring MVC do OpenCms

Instalace Spring MVC frameworků se obecně skládá z následkujících bodů:


Zastavte Tomcat

Předtím, než budete pokračovat v čtení a provádění tohoto tutoriálu, zastavte prosím tomcata.


Úprava souboru web.xml

Do souboru web.xml (OPENCMS_HOME\WEB-INF) se musí doplnit nastavení DispatcherServletu Spring MVC a jeho namapování na URL. Volitelně se může přidat definice tld souboru pro knihovnu značek Springu. (Při použití nové verze servletů toto odpadá, neboť všechny jar soubory na classpath jsou javou skenovány a všechny nalezené *.tld soubory jsou automaticky přidány. Nicméně není na závadu, pokud je tld soubor explicitně v web.xml specifikován.)

Do web.xml doplňte následující definici servletu a jeho mapování:

[@<!-- Spring MVC Sample App Servlet -->
<servlet>
<servlet-name>springmvcapp</servlet-name>
<servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>
<load-on-startup>1</load-on-startup>
</servlet>

<!-- Servlet Mapping -->
<servlet-mapping>
<servlet-name>springmvcapp</servlet-name>
<url-pattern>/springmvcapp/*</url-pattern>
</servlet-mapping>@]

Stěžejnímy body v tomto kódu je element: <servlet-name>springmvcapp</servlet-name>, neboť udává, v jakém soubor bude Spring MVC hledat svá nastavení.

Jako další bod je potřeba přidat definici tld souboru. Toto se provede tím, že se do elementu <jsp-config> přidá následující kód:
[@<jsp-config>
...
<taglib>
<taglib-uri>/spring</taglib-uri>
<taglib-location>/WEB-INF/tld/spring-form.tld</taglib-location>
</taglib>
</jsp-config>@]


Přidání tld (Tag library deskriptor) souboru s popisem taglib Spring-forms

Tento soubor musí být zkopírován do adresáře zadaného v minulém kroku. V našem případě je to tedy OPENCMS_HOME/WEB-INF/tld/. Soubor se nachází v distribuci Spring frameworku v adresáři: spring-framework-2.5.X/dist/resources/.


Vytvoření souboru s definicí beans a nastavení Spring MVC

Spring MVC požaduje konfigurační soubor, ve kterém jsou uloženy definice beans a dalších java tříd, které při své činnosti potřebuje. Jméno tohoto souboru je určeno jménem servletu - viz. výše v souboru web.xml a příponou –servlet.xml. V našem případě se tedy tento soubor bude jmenovat springapp-servlet.xml. A bude ležet na stejné adresářové úrovni jako soubor web.xml. Tento soubor bude vypadat následujícím způsobem:
[@<?xml version="1.0" encoding="utf-8"?>
<beans xmlns="http://www.springframework.org/schema/beans"
xmlns:xsi="http://www.w3.org/2001/xmlschema-instance"
xsi:schemalocation="http://www.springframework.org/schema/beans
http://www.springframework.org/schema/beans/spring-beans-2.5.xsd">
<!-- the application context definition for the springapp dispatcherservlet -->

</beans>@]
Výše uvedená, na ještě prázdný soubor obsáhlá definice, je důležitá pro správnou funkci nástrojů, například pro podporu Springu v Eclipse.


Přidání souboru s applicationContextem pro Spring

Vzhledem k tomu, že konfigurační soubor Spring MVC není jediným místem, ze kterého si Spring může načítat definice java bean, je možné a i důrazně doporučené oddělit konfigurační soubor Spring MVC od ostatních konfiguračních souborů Springu. Tím se zaručí to, že se mezi sebou nemíchají definice beanů, které jsou použiti v zobrazovací vrstvě s definicemi beanů, které se například starají o přístup k databázi. Toho se docílí tím, že se do souboru web.xml přidá následující kód:
[@<listener>
<listenerclass>org.springframework.web.context.ContextLoaderListener</listener-class>
</listener>@]

Spring poté bude hledat soubor applicationContext.xml, který musí ležet na stejné úrovni jako soubor web.xml (pokud se nenastaví jinak). Prázdný soubor applicationContext.xml má následující strukturu:
[@<?xml version="1.0" encoding="utf-8"?>
<beans xmlns="http://www.springframework.org/schema/beans"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://www.springframework.org/schema/beans http://www.springframework.org/schema/beans/spring-beans-2.5.xsd">

</beans>@]

Přidání knihoven Spring MVC do OpenCms

Jako poslední krok je potřeba nahrát do OpenCms knihovny, které Spring MVC potřebuje pro svůj běh. Do adresáře: OPENCMS_HOME/WEB-INF/lib nahrajte následující soubory:

* spring.jar z adresáře: spring-framework-2.5.6/dist
* spring-webmvc.jar z adresáře: spring-framework-2.5.6/dist/modules


Test instalace

Nyní spusťte Tomcat a OpenCms by mělo bez chyby nastartovat. Pokud se OpenCms nerozběhlo, můžete se podívat do log souborů v adresáři: TOMCAT_HOME\webapps\opencms\WEB-INF\logs A pokusit se v nich příčinu chyby objevit.

* např. re-implementace modulu Osoby

Omezující podmínky
* stávající architektura webových aplikací KIV -- výchozí bod, ne nutně cílový stav
* koncepční jednoduchost (krátká learning curve) -- "příjemcem" je čerstvý absolvent KIV/PIA

# analyzovat možnosti integrace OpenCms a webových frameworků, zejména Spring MVC

* termín 30.3.2009

Projekt (semestrální práce z předmětu KIV/JET) má následující cíle:

# analyzovat možnosti integrace OpenCms a webových frameworků
# vyhodnotit přínosy nasazení frameworku - learning curve vs efektivita práce
# vytvořit vzorovou implementaci ve vybrané sadě frameworků

Potenciální frameworky k analýze jsou Spring MVC, JPA/Hibernate, Stripes; tento výčet bude upraven na základě výsledků cíle 1.

----
Zpět na WebKiv.RedSys