V dnešním díle si do naší aplikace přidáme potřebné viewy a základní šablonu. Mimo to si předvedeme nové JSTL tagy.
5.7.2013 00:00 | Petr Horáček | přečteno 10228×
V minulém díle jsme začali s tvorbou jednoduché MVC webové aplikace. Vytvořili jsme si model i controller, potřebné viewy nám však stále schází. Dnes se tedy budeme věnovat tvorbě šablon vzhledu.
Jedním z využití souborů s příponou .tag může být i vytvoření základní šablony stránky. Taková šablona může obsahovat HTML hlavičku, hlavičku a patičku webu, případně i menu, do jejího těla se pak bude vkládat samotný obsah jednotlivých stránek.
Nejprve v kartě Web Pages smažte vygenerovaný soubor index.jsp. Ve složce WEB-INF vytvořte novou složku s názvem tags, klikněte na ni pravým tlačítkem a přidejte nový „Tag File“. V průvodci nastavte pouze název tagu Tag File Name na Base a potvrďte. Do vytvořeného souboru vložte tento kód:
<%@tag description="Základní šablona stránky" pageEncoding="UTF-8"%> <%@ attribute name="titulek" rtexprvalue="true" required="true" %> <%@ taglib prefix="c" uri="http://java.sun.com/jsp/jstl/core" %> <!DOCTYPE html> <html> <head> <meta http-equiv="Content-Type" content="text/html; charset=UTF-8"> <title>${titulek}</title> <link rel='stylesheet' href='<c:url value="/css/style.css"/>' /> </head> <body> <h1>Zápisník</h1> <jsp:doBody/> </body> </html>
Na prvním řádku oznamujeme, že jde o tag, přidáme mu krátký popis a nastavíme kódování na UTF-8. Na druhém řádku přidáváme tagu povinný argument titulek. Na třetím řádku vkládáme knihovnu tagů core, je tedy nutné do projektu importovat knihovnu JSTL.
Na zbytku kódu není nic zváštního. Do titulku budeme vkládatat předaný atribut pomocí EL. Adresu CSS zadáme pomocí tagu c:url, ten zajistí přizpůsobení adresy kontextu aplikace. Nakonec tagem <jsp:Body/> označíme prostor pro vypsání těla tagu/stránky.
Dále přidáme soubor s kaskádovými styly CSS. Nebudeme si jej podrobně popisovat, vytvořil jsem jej, aby byl vzhled aplikace přehlednější. V kartě Web Pages vytvořte novou složku css a do ní přidejte Cascading Style Sheet style.css s tímto kódem:
body { font-family: sans-serif; background-color: #e8ecfa; } textarea { width: 300px; } .zapisek { margin-top: 10px; width: 300px; } .nadpis { font-weight: bold; float: left; } .tlacitka { float: right; } .tlacitka form { display: inline; } .obsah { clear: both; }
Pro samotné viewy vytvoříme ve WEB-INF adresář view, do něj potom přidáme nový JSP soubor zapisky.jsp a naplníme ho tímto kódem:
<%@page contentType="text/html" pageEncoding="UTF-8"%> <%@ taglib prefix="c" uri="http://java.sun.com/jsp/jstl/core" %> <%@ taglib prefix="m" tagdir="/WEB-INF/tags" %> <m:Base titulek="Zápisky"> <form action="<c:url value='/pridat' />" method="POST"> <label for="nadpis">Nadpis</label> <input type="text" name="nadpis" /> <br> <textarea name="obsah" cols="40" rows="5"></textarea> <br> <input value="Přidat" type="submit" /> </form> <c:if test="${param.upozorneni}"> <span>Musíte vyplnit obě pole.<br></span> </c:if> <c:choose> <c:when test="${not empty zapisky}"> <c:forEach items="${zapisky}" var="zapisek" varStatus="vs"> <div class="zapisek"> <div class="nadpis"><c:out value="${zapisek.nadpis}"/></div> <div class="tlacitka"> <form method="GET" action="<c:url value='/upravit'/>"> <input type="hidden" value="${vs.index}" name="index" /> <input type="submit" value="Upravit"/> </form> <form method="POST" action="<c:url value='/smazat'/>"> <input type="hidden" value="${vs.index}" name="index" /> <input type="submit" value="Smazat"/> </form> </div> <div class="obsah"><c:out value="${zapisek.obsah}"/></div> </div> </c:forEach> </c:when> <c:otherwise> <span>Dosud nebyl přidán žádný zápisek.</span> </c:otherwise> </c:choose> </m:Base>
Všimněte si, že na začátku kódu neimportujeme pouze knihovnu core s prefixem c, ale i naši novou knihovnu z adresáře /WEB-INF/tags, ke které budeme přistupovat pomocí prefixu m.
Samotný kód stránky začíná otevřením tagu m:Base jemuž předáváme atribut titulek, do těla tagu pak vkládáme tělo stránky. V první části se nachází formulář pro přidání nového zápisku, jemuž je předávána adresa /pridat pomocí tagu c:url a využívá metodu POST. Tag c:url neslouží pouze k udržování správné kořenové adresy aplikace, je také důležitý pro udržování session v případě nepovolených cookies.
K parametrům předaných v URL nemusíme přistupovat pouze pomocí servletu, v JSP stačí použít objekt param a z něj pomocí EL vybrat potřebný parametr. Pokud se parametr v URL nenachází, EL nic nevypíše.
<c:if test="${param.upozorneni}"> <span>Musíte vyplnit obě pole.</span> </c:if>
V souboru index.jsp používáme tag c:if, pomocí něhož testujeme, zda adresa vybízí k vypsání upozornění o nevyplnění formuláře. Vzpomeňte si na controller v minulém díle:
if(adresa.equals("/pridat")) { String nadpis = request.getParameter("nadpis"); String obsah = request.getParameter("obsah"); if(!nadpis.isEmpty() && !obsah.isEmpty()){ zapisky.add(new Zapisek(nadpis, obsah)); presmeruj(request, response, "/"); } else { presmeruj(request, response, "/?upozorneni=True"); } }
Pokud nebudou obě pole vyplněna, servlet provede přesměrování na úvodní stránku a navíc předá parametr vybízející k vypsání upozornění.
Následuje tag c:choose, který funguje podobně jako switch v Javě. Pokud vyjde test ${not empty zapisky} kladně (tedy pokud nebude seznam zápisků prázdný), provede se jejich výpis, v opačném případě se napíše upozornění „Dosud nebyl přidán žádný zápisek.“.
Výpis seznamu zápisků probíhá díky tagu c:forEach. V parametru items předáváme seznam zápisků. Var určuje proměnnou, přes kterou budeme k jednotlivým objektům přistupovat. VarStatus slouží k získání informací o průběhu výpisu, my díky ní budeme zjišťovat index objektu.
Do jednotlivých bloků zápisků se vypisuje jejich nadpis, obsah a dva formuláře – tlačítka sloužící k úpravě a smazání zápisků. Formuláře pracují s metodou POST a obsahují skrytý vstup s indexem zápisku a tlačítko pro odeslání.
Vytvořte v adresáři view nový JSP soubor upravit.jsp a vložte do něj tento kód:
<%@page contentType="text/html" pageEncoding="UTF-8"%> <%@ taglib prefix="c" uri="http://java.sun.com/jsp/jstl/core" %> <%@ taglib tagdir="/WEB-INF/tags" prefix="m" %> <m:Base titulek="Zápisky"> <form action="<c:url value='/ulozitupravy' />" method="POST"> <input type="hidden" name="index" value="${param.index}" /> <label for="nadpis">Nadpis</label> <input type="text" name="nadpis" value="<c:out value='${zapisek.nadpis}' />" /> <br> <textarea name="obsah" cols="40" rows="5"><c:out value='${zapisek.obsah}' /></textarea> <br> <input value="Upravit" type="submit" /> </form> <c:if test="${param.upozorneni}"> <span>Musíte vyplnit obě pole.</span> </c:if> </m:Base>
Tento view je podstatně jednodušší než ten minulý, formulář je však podobný, změnila se pouze adresa zpracování a přibyl nový skrytý vstup předávající servletu index zápisku, který získáváme z parametru v URL. Dalším rozdílem je vložení stávajících hodnot zápisku do vstupu input nadpisu a textarea obsahu. Pod formulářem se nachází chybová hláška případně upozorňující na nevyplnění vstupů.
To je pro dnešek vše, nyní můžete svůj projekt spustit a vyzkoušet. V příštím díle si povíme něco o užití databází ve webových Java aplikacích a seznam současné aplikace vyměníma za plnohodnotnou SQL databázi.
Zdrojové kódy aplikace naleznete na GitHubu: https://github.com/PetrHoracek/JavaNaWeb