Skip to main content
Dat 2. semester
Toggle Dark/Light/Auto mode Toggle Dark/Light/Auto mode Toggle Dark/Light/Auto mode Back to homepage

Thymeleaf workshop

I dag skal vi udforske, hvad vi kan bruge Thymeleaf til.

I går brugte vi blandt andet:

  • th:text
  • th:each
  • th:if
  • session.user
  • attributes

I dag skal I bruge Thymeleaf på nye måder i jeres bibliotekssystem.

Brug Thymeleaf-materialet som opslagsværk.


Opgave 1: Søg efter bøger

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.


Opgave 2: Forskellige brugere får forskellige resultater

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.


Opgave 3: Lav en lånekurv

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.

1. Læg en knap ved hver bog

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.

2. Lav et endpoint

Lav et POST-endpoint:

POST /cart/add

Controlleren skal:

  • hente isbn fra 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.

3. Vis lånekurven

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>

4. Lav “Fjern fra kurv”

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 GET eller POST?
  • Hvordan finder I bogen i kurven?
  • Hvordan fjerner I den fra listen?

5. Lav “Lån alt”

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.

Tænk over hvad der sker

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?

Opgave 4: Lav et “ingen resultater”-view

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.


Opgave 5: Log ud knap

Lav en Log ud-knap på velkomstsiden.

Når brugeren klikker på knappen, skal serveren:

  1. Fjerne brugeren fra sessionen.
  2. 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.

Ekstra

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.

Udfordring A: Brug th:src

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.


Udfordring B: Genbrug HTML med fragments

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.


Udfordring C: Find selv en Thymeleaf-funktion

Find noget i Thymeleaf-materialet, som vi endnu ikke har brugt.

Prøv det i jeres eget bibliotekssystem.

I skal bagefter kunne forklare:

  1. Hvad gør det?
  2. Hvordan bruger man det?
  3. Hvor kunne det være nyttigt?

Dagens mål

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.