Thymeleaf workshop
I dag skal vi udforske, hvad vi kan bruge Thymeleaf til.
I går brugte vi blandt andet:
th:textth:eachth:ifsession.user- attributes
I dag skal I bruge Thymeleaf på nye måder i jeres bibliotekssystem.
Brug Thymeleaf-materialet som opslagsværk.
Lav en søgefunktion, hvor den loggede bruger kan søge efter bøger.
Brug en formular:
<form action="/searchbooks" method="get">
<input type="text" name="search">
<button type="submit">Søg</button>
</form>
Controlleren skal modtage søgeteksten og finde de bøger, hvor søgeteksten indgår i bogens titel.
Vis resultatet med th:each.
Eksempel:
Harry Potter
Harry Potter og Hemmelighedernes Kammer
Harry Potter og Fønixordenen
Tip: I kan undersøge, hvordan String.contains() kan bruges.
Prøv selv at beslutte, hvad der skal ske, hvis der ikke findes nogen bøger.
Nu skal søgningen tage højde for brugeren.
Vi forestiller os, at en bruger kan være:
- voksen
- barn
Tilføj derfor fx en isChild property til User og en kategori til bøgerne.
Når et barn søger efter bøger, skal barnet kun få vist børnebøger.
En voksen skal se alle bøger.
I skal altså have en liste af bøger og bruge betingelser inde i jeres iteration.
Fx noget i retning af:
<div th:each="book : ${books}">
<div th:if="...">
...
</div>
</div>
I skal selv finde ud af, hvilken betingelse der giver mening.
I skal nu lave en lille lånekurv til biblioteket.
På siden books I lave en knap udfor hver bog:
Lån
Når en bruger finder en bog og trykker på den skal bogen gemmes i brugerens session.
Lav en form ved hver bog i en ny kolonne, så brugeren kan sende bogens id til serveren
<td>
<form action="/cart/add" method="post">
<input type="hidden"
name="isbn"
th:value="${book.isbn}">
<button type="submit">Lån</button>
</form>
</td>
Det interessante her er
<input type="hidden"
name="isbn"
th:value="${book.isbn}">
<button type="submit">Lån</button>
Den er usynlig for brugeren, men Thymeleaf sætter den aktuelle bogs id ind og sender det med i request.
Lav et POST-endpoint:
POST /cart/add
Controlleren skal:
- hente
isbnfra requesten - finde bogen
- hente brugerens kurv fra sessionen
- oprette en tom kurv, hvis brugeren ikke allerede har en
- tilføje bogen til kurven
Kurven kan være:
List<Book>
Kurven ligger i User klassen, så den er automatisk i sessionen når brugeren er det.
Lav en side med endpointet:
GET /cart/show
På siden skal I vise bøgerne i kurven.
I kan fx bruge:
<div th:each="book : ${session.cart}">
<h2 th:text="${book.title}">Bogtitel</h2>
<p th:text="${book.author.name}">Forfatter</p>
</div>
Lav nu en mulighed for at fjerne en bog fra kurven.
I skal selv finde ud af:
- Hvordan sender I bogens id til serveren?
- Skal det være
GETellerPOST? - Hvordan finder I bogen i kurven?
- Hvordan fjerner I den fra listen?
Når brugeren er tilfreds med sin kurv kan vedkommende trykke på
Lån alt
Herefter skal der oprettes lån på serveren og kurven skal ryddes.
Når brugeren trykker Lån , sker der noget i denne rækkefølge:
Browser
↓
POST /cart/add
↓
Controller
↓
Session
↓
List<Book>
↓
redirect
↓
GET /cart
↓
Thymeleaf
↓
HTML
Spørgsmål:
Hvor ligger lånekurven egentlig?
Hvem ændrer kurven?
Hvem viser kurven?
Kan Thymeleaf selv lægge en bog i kurven?
Når man søger efter bøger, kan der være nul resultater.
Lav en pæn besked:
Vi fandt ingen bøger, der matcher din søgning.
Beskeden skal kun vises, når listen med søgeresultater er tom.
Undersøg, hvordan Thymeleaf kan teste, om en liste er tom.
Lav en Log ud-knap på velkomstsiden.
Når brugeren klikker på knappen, skal serveren:
- Fjerne brugeren fra sessionen.
- Sende brugeren tilbage til login-siden.
Lav et nyt endpoint, fx:
GET /logout
I controlleren skal I bruge:
ctx.req().getSession().invalidate();
for at afslutte sessionen.
Send derefter brugeren tilbage til login-siden med:
ctx.redirect("/login.html");
I skal selv finde ud af, hvordan knappen eller linket på siden skal sende brugeren til /logout.
Prøv bagefter at gå direkte til en side, som kræver login, fx:
/myloans
Hvad sker der?
Hvordan kunne serveren kontrollere, om brugeren er logget ind, før den viser siden?
Hvis I bliver hurtigt færdige, så vælg én eller flere af disse.
Tilføj eventuelt et billede til bøgerne.
Hvis jeres Book har en billedsti, kan I bruge:
<img th:src="@{${book.imagePath}}">
Hvis I ikke har billeder i jeres model, kan I bare eksperimentere med et fast billede først.
Se på jeres Thymeleaf-sider.
Er der HTML, som går igen på flere sider?
Fx:
- navigation
- header
- footer
Lav et Thymeleaf-fragment til noget af det.
Undersøg:
th:fragment
og
th:replace
Prøv derefter at bruge fragmentet på flere sider.
Find noget i Thymeleaf-materialet, som vi endnu ikke har brugt.
Prøv det i jeres eget bibliotekssystem.
I skal bagefter kunne forklare:
- Hvad gør det?
- Hvordan bruger man det?
- Hvor kunne det være nyttigt?
I skal ikke kunne huske alle Thymeleaf-attributter.
I skal kunne:
- læse Thymeleaf-kode
- finde den syntaks, I har brug for
- kombinere iterationer og betingelser
- sende data fra Java til Thymeleaf
- bruge Thymeleaf til at lave forskellige views afhængigt af data
- eksperimentere selv
Thymeleaf skal ikke længere føles som noget, læreren viser jer.
Det skal være noget, I selv kan undersøge og bruge.