* '''[[Podrobnější popis -> http://www.kiv.zcu.cz/vyzkum/publikace/technicke-zpravy/2009/tr-2009-15.pdf]] v oficiální technické zprávě''' -- důležité!

!!! Základní dokumentace

* Vysvětlení architektury [[ve screencastu -> Attach:webkiv-arch-modulu.avi]] (DivX 80MB)
* [[Podrobnější popis -> http://www.kiv.zcu.cz/vyzkum/publikace/technicke-zpravy/2009/tr-2009-15.pdf]] v PDF dokumentu.

K dispozici je vysvětlení architektury [[ve screencastu -> Attach:webkiv-arch-modulu.avi]] (DivX 80MB) a [[podrobnější popis architektury -> http://www.kiv.zcu.cz/vyzkum/publikace/technicke-zpravy/2009/tr-2009-15.pdf]] v PDF dokumentu.

Používá se WebKivDb knihovna (viz ArchitekturaDaoVrstvy), tedy v Mediatorech a FormHandlerech se volají její DAO třídy z balíku cz.zcu.kiv.db.dao.* a používají doménové třídy z cz.zcu.kiv.db.model balíku. Ty víceméně 1:1 reprezentují entity které definuje DatovyModel.

Je představována "[[Mediátory -> http://objekty.vse.cz/Objekty/Vzory-Mediator]]" (podle [[GoF pattern -> http://www.vincehuston.org/dp/]]) tj třídami, které hrají cca roli servletů. Rozhrani IMediator definuje hlavne handle(...) metody, ktere maji byt analogii doGet() servletu; normalne v modulu je vhodne oddedit od AbstractMediator a predefinovat jen ty metody, ktere jsou potreba -- normalne staci handle(req,resp) a data pro JSTL posilat pres request.setAttribute.

K dispozici je vysvětlení architektury [[ve screencastu -> Attach:webkiv-arch-modulu.avi]] (DivX 80MB) a [[podrobnější popis architektury -> Attach:architektura-modulu.pdf]] v PDF dokumentu.

K dispozici je vysvětlení architektury [[ve screencastu -> Attach:webkiv-arch-modulu.avi]], a [[podrobnější popis architektury -> Attach:architektura-modulu.pdf]] je v PDF dokumentu.

Knihovna je postavena na Spring JDBC vrstvě, kterou používá pro vytváření dotazů a zpracování result setů.

----
Zpět na RedSys

Idea a motivace: v OpenCms nejde dost snadno integrovat servlety tak, aby byly součástí modulu, byly snadno nalezitelné a konfigurovatelné. Proto se pro zpracování formulářů použijí „cílové“ JSP stránky, které na začátku volají třídu zpracovávající požadavek – tzv. Mediator.

Zatímco v servletové aplikaci je postup zpracování
->kontejner → servlet → request dispatcher . forward → JSP
v našich modulech je to
->opencms → JSP → (scriptlet) mediator .handle → (návrat do) JSP

[[Podrobnější popis -> Attach:architektura-modulu.pdf]] je v PDF dokumentu.

!! View vrstva

JSP soubory – má tedy odkazovat na impl třídy a obsahovat minimalistický scriptlet. V JSP se používá JSTL.

!! Aplikační vrstva

Je představována "Mediátory" tj třídami, které hrají cca roli servletů. Rozhrani IMediator definuje hlavne handle(...) metody, ktere maji byt analogii doGet() servletu; normalne v modulu je vhodne oddedit od AbstractMediator a predefinovat jen ty metody, ktere jsou potreba -- normalne staci handle(req,resp) a data pro JSTL posilat pres request.setAttribute.

Trida ModuleBeanFactory je tovarna na vraceni instanci, ktera uvnitr vola Springovou bean factory; ta je pak konfigurovana pres XML v module-beans.cfg ulozeny v korenovem adresari Java namespace modulu (napr. tedy .../cz/zcu/kiv/osoby/module-beans.cfg). Konfiguracni soubor je standardni Spring bean dependency definition soubor, ale tim ze je umisten v adresari modulu se da s modulem instalovat a není treba pri jeho zmene restartovat Tomcat. Jeho obsah je minimalne takovy, ze každý mediator který má být dostupný v JSP musí být deklarován; využití Spring DI deklarací je nepovinné.

!! Datová vrstva

Používá se WebKivDb knihovna (viz ArchitekturaDaoVrstvy), tedy v Mediatorech a FormHandlerech se volají její DAO třídy z balíku cz.zcu.kiv.db.dao.* a používají doménové třídy z cz.zcu.kiv.db.model balíku.

Knihovna je postavena na Spring JDBC vrstvě, kterou používá pro vytváření dotazů a zpracování result setů.