4. Die View und ihr Template
Bisher haben die Actions ihre Antworten selbst erzeugt: Text, JSON und einige als Zeichenkette geschriebene HTML-Tags. In einer MVC-Anwendung ist dies die Aufgabe einer View: einer Datei, die die HTML-Seite beschreibt, mit Platzhaltern für die Daten, die ihr die Action übergibt – das Modell der View. [Spring MVC] stellt selbst keine View-Sprache bereit: Es kann mit mehreren View-Engines ([Thymeleaf], [FreeMarker], [Mustache], [JSP] ...) arbeiten. Dieser Kurs verwendet [Thymeleaf], die zusammen mit [Spring MVC] am weitesten verbreitete View-Engine, die [Spring Boot] selbstständig konfigurieren kann.
Eine [Thymeleaf]-View ist eine gewöhnliche [.html]-Datei: eine gültige HTML-Datei, die unverändert in einem Browser geöffnet werden kann. Daten werden über zusätzliche Attribute mit dem Präfix [th:] ([th:text], [th:if], [th:each] ...) eingefügt, die [Thymeleaf] auf dem Server ausführt und anschließend aus der Seite entfernt. [Thymeleaf] bezeichnet dies als natürliche Templates ([natural templates]): Ein Grafikdesigner kann an der View arbeiten, ohne die Anwendung zu starten, und der Entwickler fügt ihr die Attribute [th:] hinzu. Das unterscheidet sich von [Razor], der View-Engine von [ASP.NET Core MVC], die HTML und [C#]-Code kombiniert, dem das Zeichen [@] vorangestellt ist.
4.1. Beispiel 13: Eine erste View
Um [Thymeleaf] zu verwenden, genügt es, in der Datei [pom.xml] des Beispiels eine Abhängigkeit hinzuzufügen:
- Zeilen 3–6: der [spring-boot-starter-thymeleaf] Starter. Ein Starter ist eine „Alles-in-einem“-Abhängigkeit: Er liefert [Thymeleaf], dessen Integration mit [Spring] (die Bibliothek [thymeleaf-spring6]) und die automatische Konfiguration von [Spring Boot], die sie mit [Spring MVC] verbindet. Mehr ist nicht zu schreiben: keine Version (sie wird vom übergeordneten Projekt [spring-boot-starter-parent] festgelegt), keine Konfigurationsklasse.
Das Modell der View ist eine einfache Klasse. Die Datei [models/PageModel.java]:
- Zeile 4: Ein [Java]-Record (siehe Beispiel 03) ist eine Klasse, deren Felder einmalig vom Konstruktor festgelegt werden: hier drei Zeichenketten [title], [message] und [time]. Der Compiler erzeugt automatisch den Konstruktor und die Zugriffsmethoden, die die Felder für uns lesen. Beachten Sie: Diese Zugriffsmethoden sind nach dem Feld benannt ([title()]), nicht [getTitle()] wie in einer als [JavaBean] bezeichneten Klasse (siehe Beispiel 08). Das ist eine knappe Schreibweise für eine Klasse, die lediglich Daten transportiert.
Die Datei [controllers/ViewsController.java]:
Lassen Sie uns diesen Code kommentieren:
- Zeile 17: Die Annotation [@Controller] ersetzt die Annotation [@RestController] der vorherigen Beispiele. Mit [@RestController] ist das, was eine Action zurückgibt, die Antwort (Text, JSON). Mit [@Controller] gibt eine Action, die eine Zeichenkette zurückgibt, den Namen einer View zurück: Die View erzeugt dann die Antwort;
- Zeile 25: Die Action erhält einen Parameter vom Typ [Model], bereitgestellt von [Spring MVC]. Das ist das Modell der View: ein Dictionary, in dem jeder Eintrag (ein Attribut) einen Namen mit einem Objekt verknüpft;
- Zeilen 26–30: Die Action erzeugt ein [PageModel]-Objekt (einen Titel, eine Meldung, die aktuelle Uhrzeit) und legt es unter dem Namen [model] im Modell ab. Die View ruft es unter diesem Namen ab;
- Zeile 31: Die Action gibt den Namen der View zurück, [views/index]. Sie erzeugt die Antwort nicht mehr selbst, sondern verweist auf eine View und hat deren Daten vorbereitet;
- Zeile 36: Die Action [hello] gibt ein Objekt [ModelAndView] zurück, das den Namen der View und ihr Modell in einem einzigen Objekt vereint. Das ist eine weitere Möglichkeit, eine Action zu schreiben, die eine View verwendet;
- Zeile 38: Hängt die View von der Anfrage ab, wählt die Action die View aus. Hier zeigt der Name [unknown] die View [views/unknown] an, mit dem Statuscode 404: Das dritte Argument des Konstruktors von [ModelAndView] ist der Antwortcode. Das Modell dieser View enthält eine einfache Zeichenkette: den angeforderten Namen. [Map.of(...)] erzeugt ein schreibgeschütztes Dictionary;
- Zeile 44: Die beiden Actions teilen sich dieselbe View, [views/index], mit unterschiedlichen Modellen.
Wo sucht [Spring MVC] nach der View [views/index]? Es übergibt den Namen der View an einen View-Resolver ([ViewResolver]), der ihn in eine konkrete View umwandelt. Der von [Spring Boot] für [Thymeleaf] ([ThymeleafViewResolver]) konfigurierte Resolver fügt ein Präfix, [classpath:/templates/], und ein Suffix, [.html], hinzu: Die View [views/index] ist die Datei [templates/views/index.html] im Classpath – das heißt in den Ordnern und Archiven, in denen die virtuelle [Java]-Maschine nach den Klassen und Ressourcen der Anwendung sucht. Der Ordner [src/main/resources] des Projekts gehört dazu: Sein Inhalt wird von [Maven] zusammen mit den kompilierten Klassen nach [target/classes] kopiert. Diese beiden Werte lassen sich in [application.properties] ändern (Eigenschaften [spring.thymeleaf.prefix] und [spring.thymeleaf.suffix]). Anders als bei [ASP.NET Core MVC] gibt es keine Konvention, die den Namen der View aus den Namen von Controller und Action ableitet: Die Action gibt stets den Pfad zur View an, relativ zum Ordner [templates]. Die Projektdateien:
Die Datei [templates/views/index.html]:
Lassen Sie uns diesen Code kommentieren:
- Zeile 2: Ein [Thymeleaf]-Kommentar wird als [<!--/* ... */-->] geschrieben. Das ist ein HTML-Kommentar, dessen Inhalt von [/*] und [*/] eingeschlossen wird: [Thymeleaf] entfernt ihn aus der gerenderten Seite, während ein gewöhnlicher HTML-Kommentar ([<!-- -->]) an den Browser gesendet würde;
- Zeile 3: Das Attribut [xmlns:th] deklariert den Namensraum für die Attribute [th:]. Es ist ausschließlich für Code-Editoren gedacht (Autovervollständigung, Validierung): [Thymeleaf] verarbeitet die Attribute [th:] auch ohne es und entfernt es aus der erzeugten Seite;
- Zeile 6: Das Attribut [th:text] ersetzt den Inhalt des Tags durch den Wert des Ausdrucks. [${model.title}] ist ein Variablenausdruck: [model] ist das von der Action gesetzte Attribut des Modells, und [.title] ruft dessen Zugriffsmethode auf, [title()]. Der im Tag stehende Text „Page Title“ ist nur ein Beispiel, das angezeigt wird, wenn die Datei direkt in einem Browser geöffnet wird; er verschwindet aus der erzeugten Seite;
- Zeilen 9–11: Dasselbe Prinzip gilt für Titel, Meldung und Uhrzeit. Um einen Wert mitten in einen Text einzufügen, umgeben Sie ihn mit einem [<span>]-Tag, das das Attribut [th:text] trägt.
[${...}]-Ausdrücke werden in der [Spring]-Ausdruckssprache geschrieben, [SpEL] ([Spring Expression Language]). [model.title] ruft die Methode [getTitle()] einer [JavaBean] oder die Methode [title()] eines Records auf: In beiden Fällen wird derselbe Code geschrieben.
Eine [Thymeleaf]-View wird nicht mit der Anwendung kompiliert: Sie wird beim Aufruf der Seite gelesen und interpretiert. Ein Fehler in einer View wird daher nicht zur Kompilierzeit gemeldet, sondern erst bei der Anzeige der Seite. Wenn Sie [${model.titl}] in die View schreiben, schlägt die Anfrage fehl (Statuscode 500), und die Serverkonsole zeigt Folgendes an: [Property or field 'titl' cannot be found on object of type 'example13.models.PageModel']. Ebenso verursacht ein View-Name, der keiner Datei entspricht, den Fehler [Error resolving template [views/missing], template might not exist or might not be accessible by any of the configured Template Resolvers]. Das Ergebnis unter http://localhost:5000/:

Der Quelltext der vom Browser empfangenen Seite enthält keine Spur von [Thymeleaf] mehr:
Beachten Sie Folgendes:
- Die Attribute [th:text] sind verschwunden, ersetzt durch die Werte des Modells, ebenso das Attribut [xmlns:th];
- der [Thymeleaf]-Kommentar ist verschwunden, hinterlässt aber eine Leerzeile;
- Akzentuierte Zeichen, falls vorhanden (diese englische Seite hat keine), werden unverändert geschrieben ([é], [è] ...): [Thymeleaf] maskiert nur Zeichen, die in HTML eine Bedeutung haben ([<], [>], [&], ["], [']). [Razor] kodiert akzentuierte Zeichen dagegen standardmäßig ([è] für [è]), was im Kurs zu [ASP.NET Core MVC] eine Änderung einer Einstellung erzwingt; hier gibt es eine solche Anforderung nicht.
Die URL http://localhost:5000/hello/martin zeigt dieselbe View mit einem anderen Modell an:

Hätte der Text einen Apostroph enthalten, würde der HTML-Code dieser Seite ihn als ['] darstellen: Dies ist eines der Zeichen, die von [th:text] maskiert werden. Die URL http://localhost:5000/hello/unknown zeigt eine andere View:
Die Antwort hat tatsächlich den vom Objekt [ModelAndView] gesetzten Statuscode 404 ([Tomcat] sendet nur den Code, ohne seine Bezeichnung [Not Found]). Die Datei [templates/views/unknown.html]:
- Zeile 9: Ein von zwei senkrechten Strichen eingeschlossener Text, [|...|], ist eine literale Substitution: Die darin enthaltenen Ausdrücke [${...}] werden durch ihre Werte ersetzt. Das ist lesbarer als eine Folge von [<span>]. [${name}] ist das Attribut [name] des Modells, eine einfache Zeichenkette.
4.2. Beispiel 14: Die Sprache Thymeleaf
Eine [Thymeleaf]-View enthält keinerlei [Java]-Code: Alles läuft über die Attribute [th:] und die darin enthaltenen Ausdrücke. Dennoch bietet sie Bedingungen, Schleifen, lokale Variablen und Methodenaufrufe. Diese Mächtigkeit erfordert Disziplin: Die View muss ein reines Darstellungselement bleiben; Berechnungen und Entscheidungen gehören in die Action und die Services. Beispiel 14 gibt einen Überblick über die Syntax. Das Modell, Datei [models/BasicsModel.java]:
- Zeilen 6–15: Das Modell ist ein Record: einige Zeichenketten, ein Boolean, zwei Listen von Produkten und eine Adresse;
- Zeilen 17–21: Zwei im ersten verschachtelte Records: [BasicsModel.Product] und [BasicsModel.Address]. Ein Preis ist ein [BigDecimal]; dieser [Java]-Typ repräsentiert exakte Dezimalzahlen (ein [double] kann [0.1] nicht exakt darstellen).
Die Datei [controllers/BasicsController.java]:
- Zeilen 19–31: Die Action befüllt das Modell: einige Zeichenketten, ein Boolean, eine Liste mit drei Produkten, ein leerer Warenkorb und eine Adresse. Der Spitzname (Zeile 22) wird absichtlich auf [null] gesetzt. [List.of(...)] erzeugt eine schreibgeschützte Liste; [List.of()] erzeugt eine leere Liste.
Die View, Datei [templates/basics/index.html]:
Lassen Sie uns diesen Code kommentieren:
- Zeile 8: Das Attribut [th:with] deklariert lokale Variablen, die innerhalb des Tags, das es enthält, und in allen seinen untergeordneten Tags verwendet werden können – hier [total] und [count] – im gesamten Body der Seite. [model.products.![price]] ist eine Projektion von [SpEL]: die Liste der Produktpreise. [#aggregates] und [#lists] sind Hilfsobjekte von [Thymeleaf] (sie beginnen mit [#]): [#aggregates.sum] berechnet die Summe einer Liste von Zahlen; [#lists.size] zählt die Elemente einer Liste;
- Zeilen 10–11: ein [Thymeleaf]-Kommentar, der in der erzeugten Seite nicht enthalten ist;
- Zeile 12: Ein Wert [null] ([${model.nickname}]) zeigt nichts an, ohne Fehler;
- Zeilen 14–15: [th:text] maskiert die Sonderzeichen in HTML ([<] wird zu [<] ...): Der Text wird unverändert angezeigt. [th:utext] ([unescaped text]) fügt ihn ohne Maskierung ein: Er wird als HTML interpretiert. [th:utext] wird nur für HTML verwendet, das von der Anwendung erzeugt wurde, niemals für Daten, die ein Benutzer eingegeben hat: Der Benutzer könnte HTML oder sogar [JavaScript] in die Seite einschleusen (ein Angriff, bekannt als [XSS], [cross-site scripting]);
- Zeilen 17–18: eine Bedingung. [th:if] behält das Tag (und seinen Inhalt), wenn der Ausdruck wahr ist, und entfernt es andernfalls; [th:unless] tut das Gegenteil. Es gibt kein [th:else]: Man schreibt die gegenteilige Bedingung;
- Zeile 22: eine Schleife. Das Attribut [th:each] wiederholt das Tag, das es enthält – hier [<li>] –, einmal für jedes Element der Liste. [product] ist das aktuelle Element; [stat], das optional ist, ist der Iterationszähler: [stat.index] (beginnend bei 0), [stat.count] (beginnend bei 1), [stat.size], [stat.first], [stat.last], [stat.even], [stat.odd]. Im Text des Tags ist [[[${product.name}]]] ein Inline-Ausdruck: Er fügt den Wert ein, maskiert wie bei [th:text], ohne das Tag [<span>] (die Form [[(...)]] fügt wie [th:utext] ohne Maskierung ein);
- Zeile 23: der Bedingungsoperator [condition ? value1 : value2]. Literale Zeichenketten werden zwischen einfachen Anführungszeichen geschrieben;
- Zeilen 24–25: [th:block] ist ein für [Thymeleaf] spezifisches Tag: Es dient nur dazu, die Attribute [th:] zu tragen, und verschwindet aus der erzeugten Seite, sodass nur sein Inhalt übrig bleibt. [stat.first] und [stat.last] prüfen die Position in der Schleife;
- Zeilen 30–31: der Fall einer leeren Liste. [#lists.isEmpty] prüft, ob die Liste leer ist; eine Schleife [th:each] über eine leere Liste erzeugt nichts;
- Zeile 34: eine literale Substitution [|...|] , die die Variablen aus [th:with] verwendet, und zwei Methodenaufrufe: [total.doubleValue()] wandelt [BigDecimal] in [double] um, und [#numbers.formatDecimal(value, 1, 2)] formatiert eine Zahl mit mindestens einer Stelle vor dem Dezimaltrennzeichen und genau zwei danach;
- Zeile 35: ein Zugriff auf [model.address.street] und das Hilfsobjekt [#strings], das Operationen auf Zeichenketten bündelt ([toUpperCase], [isEmpty], [contains], [startsWith] ...);
- Zeile 36: [Thymeleaf] verarbeitet nur die Attribute [th:] und die Inline-Ausdrücke [[[...]]]; der restliche Text wird unverändert kopiert. Das Zeichen [@] hat hier keine besondere Bedeutung.
Das Ergebnis unter http://localhost:5000/:

Der erzeugte HTML-Code:
Beachten Sie Folgendes:
- Die Tags [th:block], die [Thymeleaf]-Kommentare und die von [th:if] / [th:unless] entfernten Tags hinterlassen Leerzeilen, die keinen Einfluss auf die Anzeige haben;
- Der Durchschnittspreis ist [62.17] bei [curl] und [62,17] im Browser. [#numbers.formatDecimal] verwendet die Sprache der Anfrage. Standardmäßig liest [Spring MVC] sie aus dem vom Browser gesendeten HTTP-Header [Accept-Language]: Ein auf Französisch eingestellter Browser sendet [Accept-Language: fr-FR] und erhält ein Komma; [curl] sendet diesen Header nicht, und die Sprache ist dann die des Systems, auf dem der Server läuft (hier Englisch; auf einem auf Französisch eingestellten Rechner würde [curl] ebenfalls ein Komma erhalten). Beispiel 16 und das Kapitel „Internationalisierung“ behandeln diesen Mechanismus;
- die Preise selbst ([12.5]) werden von der Methode [toString] von [BigDecimal] erzeugt, die sprachunabhängig ist. Beispiel 16 formatiert sie.
Zum Abschluss dieses Beispiels hier die fünf Arten von Ausdrücken in [Thymeleaf], die in den Beispielen dieses und des nächsten Kapitels verwendet werden:
Ausdruck | Rolle | Beispiel |
[${...}] | Variablenausdruck ([SpEL]): ein Attribut des Modells, eine Eigenschaft, ein Methodenaufruf, eine Bean ([${@name...}]), ein Hilfsobjekt ([${#strings...}]) | 13, 14, 16 |
[*{...}] | Auswahlausdruck: eine Eigenschaft des Objekts, das durch das Attribut [th:object] bezeichnet wird | 18, 19, 21 |
[#{...}] | Nachricht: Text aus der Datei [messages.properties], in der Sprache der Anfrage | Nächstes Kapitel |
[@{...}] | Link: eine URL mit ihren Variablen und Parametern | 16, 21 |
[~{...}] | Fragment: ein einzufügender Abschnitt einer Seite | 15 bis 21 |
Es gibt zahlreiche Hilfsobjekte: [#strings], [#numbers], [#lists], [#aggregates], [#dates] (Datumsangaben vom Typ [java.util.Date]), [#temporals] (Datumsangaben aus [java.time]: [LocalDate], [LocalDateTime] ...), [#locale] (die Sprache der Anfrage), [#ids], und [#fields] (Formulare, Beispiele 18 und 19) ... Die Dokumentation von [Thymeleaf] (https://www.thymeleaf.org) beschreibt sie alle.
4.3. Beispiel 15: Template, Fragmente, statische Dateien
Die Seiten einer Website teilen sich ein gemeinsames Template (Kopfbereich, Navigationsleiste, Fußbereich). Bei [Thymeleaf] sind die wiederverwendbaren Seitenbestandteile Fragmente; und das Template selbst ist ein Fragment, in das jede Seite ihren Inhalt einfügt. Schließlich benötigen die Seiten statische Dateien (Stylesheets, Bilder, Skripte), die unverändert ausgeliefert werden, ohne über einen Controller zu laufen. Die Dateien des Beispiels:
4.3.1. Die statischen Dateien
[Spring Boot] liefert die Dateien aus dem Ressourcenordner [static] automatisch ohne Controller aus: Die Datei [src/main/resources/static/css/styles.css] wird unter der URL [/css/styles.css] bereitgestellt. Entspricht keine Datei der URL und behandelt keine Action sie, lautet die Antwort 404. Prüfen wir das:
Der Header [Last-Modified] liefert das Änderungsdatum der Datei: Der Browser sendet dieses Datum zurück, damit die Datei nur dann erneut übertragen wird, wenn sie sich geändert hat.
Das CSS-[Bootstrap]-Framework ist allen Beispielen gemeinsam: Es wird nur einmal gespeichert, im Ordner [examples/common/bootstrap], außerhalb der Ressourcen der Beispiele. Sie müssen daher [Spring MVC] mitteilen, wo es zu finden ist. Die Datei [config/WebConfig.java]:
Lassen Sie uns diesen Code kommentieren:
- Zeile 8: eine Konfigurationsklasse (siehe Beispiel 06);
- Zeile 9: Das Interface [WebMvcConfigurer] erlaubt uns, die Konfiguration zu ergänzen, die [Spring MVC] von [Spring Boot] erhalten hat, ohne sie zu ersetzen: Wir überschreiben nur die Methoden, die uns interessieren (alle anderen haben eine leere Standardimplementierung);
- Zeilen 14–19: Die Methode [addResourceHandlers] deklariert Verzeichnisse für statische Dateien. Die Dateien der URL, die mit [/bootstrap/] beginnen (Zeile 15; [**] steht für eine beliebige Folge von Verzeichnissen und Dateien), werden aus dem Verzeichnis [common/bootstrap] ausgeliefert;
- Zeile 18: Das Präfix [file:] bezeichnet einen Ordner auf der Festplatte (nicht im Classpath). Der Pfad ist relativ zum aktuellen Verzeichnis – dem, aus dem die Anwendung gestartet wurde: [../common/bootstrap/] bei Start aus dem Verzeichnis des Beispiels, [common/bootstrap/] bei Start aus dem Verzeichnis [examples]. Beide Orte werden der Reihe nach geprüft. So wird [examples/common/bootstrap/css/bootstrap.min.css] unter der URL [/bootstrap/css/bootstrap.min.css] ausgeliefert. Die Fallstudie hingegen legt [Bootstrap] in ihrem eigenen Ordner ab, [static].
Alle folgenden Beispiele verwenden diese Datei: [WebConfig.java].
4.3.2. Das Template
Die Datei [templates/layout.html]:
Lassen Sie uns diesen Code aufschlüsseln:
- Zeile 4: Das Attribut [th:fragment] macht das Tag [<html>] – und damit die gesamte Seite – zu einem Fragment namens [page], das zwei Parameter erwartet: [title] und [content]. Die Seiten der Anwendung rufen dieses Fragment auf und übergeben ihm ihren Titel und ihren Inhalt;
- Zeile 8: Der Parameter [title] wird als Attribut des Modells verwendet;
- Zeilen 9–10: die Stylesheets, die als statische Dateien ausgeliefert werden;
- Zeile 15: Das Attribut [th:replace] ersetzt das Tag, das es enthält (hier [<nav>]), durch ein Fragment. [~{fragments/navbar :: navbar}] ist ein Fragmentausdruck: das Fragment [navbar] aus der Datei [templates/fragments/navbar.html] (links von [::] der View-Name, rechts der Fragmentname);
- Zeile 17: die Stelle, an der der Inhalt der Seite eingefügt wird, den der Parameter [content] erhält; dieser Parameter ist selbst ein Fragment, das [th:replace] anstelle des Tags [<main>] einfügt;
- Zeile 19: [path] ist der Pfad der angeforderten Seite. Das ist kein Fragmentparameter: Es ist ein Attribut, das dem Modell aller Views von einer Klasse hinzugefügt wird, auf die wir später eingehen. [#dates.createNow()] ist das aktuelle Datum, und [#dates.year] extrahiert daraus das Jahr.
Es gibt ein zweites Einfügeattribut, [th:insert], das das Fragment innerhalb des Host-Tags einfügt, statt es zu ersetzen. Bei einem Fragment [<span th:fragment="f">...</span>] erzeugt [<div th:replace="~{:: f}"></div>] das Ergebnis [<span>...</span>], und [<div th:insert="~{:: f}"></div>] erzeugt [<div><span>...</span></div>] ([~{:: f}] ohne View-Namen verweist auf ein Fragment der aktuellen View). Die Beispiele dieses Kurses verwenden [th:replace].
Die Datei [templates/fragments/navbar.html]:
- Zeile 2: Eine Fragmentdatei ist keine vollständige Seite; sie enthält ein oder mehrere Tags mit dem Attribut [th:fragment]. Dieses Fragment hat keine Parameter. Beachten Sie, dass die Datei den Namensraum [xmlns:th] nicht deklariert; das ist nicht notwendig.
Die Datei [templates/fragments/card.html]:
- Zeile 2: Das Fragment [card] hat zwei Parameter, einen Namen und eine Funktion;
- Zeilen 4–5: Die Parameter werden als Attribute des Modells verwendet.
4.3.3. Die Seiten
Die Datei [controllers/PagesController.java]:
- Zeilen 13–14: der Typ der Teammitglieder, ein im Controller deklarierter Record ([PagesController.Member]);
- Zeilen 17–19: Die Action [home] hat kein Modell; sie benötigt den Parameter [Model] nicht;
- Zeilen 22–28: Die Action [team] übergibt eine Liste von Mitgliedern.
Die Datei [templates/pages/home.html]:
Lassen Sie uns diesen Code aufschlüsseln:
- Zeile 4: Das Attribut [th:replace] des Tags [<html>] ersetzt die gesamte Seite durch das Fragment [page] aus dem Template [layout.html]. Es übergibt ihm zwei Parameter: den Titel, eine in einfache Anführungszeichen gesetzte literale Zeichenkette, und den Inhalt, [~{::main}]. Dieser Fragmentausdruck ohne View-Namen verweist auf ein Tag der aktuellen View: hier das Tag [<main>] (Zeilen 6–12). Das Template wird so erzeugt, wobei das Tag der Seite sein eigenes Tag ersetzt, [<main>];
- Zeile 11: der Aufruf des Fragments [card] mit zwei fest vorgegebenen Parametern.
Alles in der Seite, was nicht im Tag [<main>] steht (zum Beispiel das Tag [<body>]), verschwindet: Nur das an das Template übergebene Fragment zählt. Die Tags [<html>] und [<body>] sind ausschließlich vorhanden, damit die Datei eine gültige HTML-Seite bleibt, die in einem Browser geöffnet werden kann.
Die Datei [templates/pages/team.html]:
- Zeile 7: Das Tag [<div class="col-md-4">] wird für jedes Mitglied wiederholt;
- Zeile 9: Dem Fragment werden Name und Funktion des aktuellen Mitglieds übergeben: Das mit [th:replace] versehene Tag ist in das mit [th:each] versehene Tag geschachtelt, in dem die Variable [member] definiert ist.
Die Datei [templates/pages/raw.html]:
- Zeilen 3–11: Diese View ruft das Template nicht auf; sie ist eine vollständige Seite ohne Attribute [th:]. [Thymeleaf] kopiert sie unverändert (bis auf den Kommentar in Zeile 2). Eine View ist nicht verpflichtet, das Template zu verwenden.
Der HTML-Code der Seite http://localhost:5000/team zeigt das Ergebnis des Zusammenbaus:
Der Titel, die Navigationsleiste, drei Karten und der Fußbereich wurden aus vier Dateien zusammengesetzt: [layout.html], [navbar.html], [team.html] und [card.html].
4.3.4. Ein allen Views gemeinsames Attribut
Der Fußbereich des Templates zeigt den Pfad der angeforderten Seite an, [path]. Mit [Razor] hat eine View direkten Zugriff auf die aktuelle Anfrage. Eine [Thymeleaf] -View konnte dies bis Version 3.0 ebenfalls, mithilfe des Objekts [#request]: Man hätte [${#request.requestURI}] geschrieben. Seit Version 3.1 ist das nicht mehr möglich. Eine View, die [#request] verwendet, verursacht einen 500-Fehler, und die Konsole zeigt an:
Die Objekte [#request], [#session], [#servletContext], und [#response] wurden entfernt: Sie erlaubten es einer View, jeden Parameter der Anfrage zu lesen, was Injektionen Tür und Tor öffnete, und sie verbanden [Thymeleaf] mit der API der Servlets. Der Ausdruck [${#ctx.request.requestURI}] funktioniert ebenfalls nicht: [#ctx.request] ist gleich [null]. Die Fehlermeldung nennt die Lösung: Fügen Sie das, was die View benötigt, dem Modell hinzu. Damit dies für alle Views gilt, ohne dass jede Action es tun muss, erstellen wir die Datei [config/CommonModel.java]:
Lassen Sie uns diesen Code kommentieren:
- Zeile 9: Die Annotation [@ControllerAdvice] bezeichnet eine Klasse, die alle Controller der Anwendung erweitert. Was sie deklariert, gilt für jeden von ihnen, als wäre es in jedem einzelnen geschrieben;
- Zeile 14: Eine mit [@ModelAttribute("path")] annotierte Methode wird vor jeder Action ausgeführt; ihr Rückgabewert wird dem Modell unter dem Namen [path] hinzugefügt. In einem Controller geschrieben, gilt sie für die Actions dieses Controllers (siehe Beispiel 18); in einer Klasse mit [@ControllerAdvice] geschrieben, gilt sie für alle Actions der Anwendung;
- Zeilen 15–16: Die Methode kann dieselben Parameter wie eine Action entgegennehmen: hier die aktuelle Anfrage, [HttpServletRequest] (siehe Beispiel 05). [getRequestURI()] liefert den angeforderten Pfad ohne die Parameter.
Die Fallstudie verwendet dasselbe Verfahren (ihre Datei [web/CommonModel.java]), um allen ihren Views den Pfad, die Sprache und den angemeldeten Benutzer bereitzustellen.
Die resultierenden Seiten unter der URL http://localhost:5000/, http://localhost:5000/team und http://localhost:5000/raw:



Das Template, die Fragmente und das gemeinsame Attribut [path] entsprechen genau dem, was die Fallstudie verwendet: ein [layout.html]-Template sowie Fragmente für die Navigationsleiste, die Meldungen und die Bestätigungsfenster.
4.4. Beispiel 16: Helper
Eine View benötigt oft kleine Formatierungsfunktionen: ein Datum oder einen Preis formatieren, einen Text großschreiben, das HTML für ein Badge erzeugen ... Diese werden als Helper bezeichnet. Mit [Thymeleaf] sind dies Methoden von [Spring]-Beans, die innerhalb eines Ausdrucks oder eines Fragments aufgerufen werden. [Thymeleaf] erlaubt es außerdem, eigene Attribute zu erstellen, die in einem Dialekt zusammengefasst werden.
4.4.1. Eine von den Views aufgerufene Bean
Die Datei [helpers/Formats.java]:
Kommentieren wir diesen Code:
- Zeile 16: Die Annotation [@Component] macht die Klasse zu einer Bean: [Spring] findet sie beim Start (genau wie die Controller), erzeugt eine Instanz davon und hält sie vor. ["formats"] ist der Name der Bean: Unter diesem Namen rufen die Views sie auf;
- Zeilen 20–22: Großschreibung. [Locale.ROOT] macht das Ergebnis unabhängig von der Sprache des Benutzers;
- Zeilen 25–31: ein Betrag in einer Währung, formatiert gemäß der Sprache der Anfrage. [LocaleContextHolder.getLocale()] (Zeile 27) liefert diese Sprache, ein [Locale]-Objekt, das von [Spring MVC] zu Beginn jeder Anfrage gesetzt wird. [NumberFormat.getCurrencyInstance] liefert das Währungsformat für diese Sprache: Dezimaltrennzeichen, Tausendertrennzeichen und Position des Währungssymbols; [setCurrency] wählt die Währung aus, die über ihren internationalen Code identifiziert wird ([EUR], [USD]);
- Zeilen 34–36: eine überladene Methode: gleicher Name, andere Parameter. Wird keine Währung angegeben, gilt standardmäßig der Euro;
- Zeilen 39–41: ein ausgeschriebenes Datum ([FormatStyle.FULL]) in der Sprache der Anfrage.
Die Seite [templates/pages/products.html] ruft diese Methoden auf:
- Zeilen 10–12: In einem Ausdruck [${...}] verweist die Schreibweise [@formats] auf die Bean mit dem Namen [formats]: [${@formats.money(product.price)}] ruft ihre Methode [money] auf. Der Rückgabewert der Methode wird von [th:text] eingefügt und daher maskiert;
- Zeile 14: Das Badge wird von einem Fragment erzeugt, das weiter unten beschrieben wird.
Die Datei [templates/fragments/badge.html]:
- Zeile 3: Ein Helper, der HTML erzeugt, ist bei [Thymeleaf] ein Fragment: in diesem Fall ein [<span>]-Tag, das den Lagerbestand des Produkts als Parameter erhält;
- Zeile 4: Das Attribut [th:classappend] fügt den vorhandenen Klassen des Tags ([badge]) eine CSS-Klasse hinzu: grün ([text-bg-success]), wenn das Produkt auf Lager ist, andernfalls rot;
- Zeile 5: der Text des Badges, maskiert durch [th:text]. Anders als ein Helper, der HTML in einem String erzeugen würde, muss sich ein Fragment nicht um das Maskieren kümmern: [th:text] übernimmt das.
Der Controller, Datei [controllers/PagesController.java]:
- Zeile 19: Die Startseite erhält das heutige Datum, ein [LocalDate] (ein Datum ohne Uhrzeit);
- Zeilen 25–28: die Produktliste.
Die Datei [templates/pages/home.html]:
- Zeile 7: der Aufruf der Methode [date] der Bean [formats] in einer literalen Substitution;
- Zeile 9: das Hilfsobjekt [#locale] ist die Sprache der Anfrage.
4.4.2. Die Sprache der Anfrage
Was bestimmt die Sprache der Anfrage? Eine Bean von [Spring MVC], der Sprachresolver ([LocaleResolver]). Der Resolver, den [Spring Boot] standardmäßig installiert, [AcceptHeaderLocaleResolver], liest den vom Browser gesendeten Header [Accept-Language]: Das war die Ursache für die unterschiedlichen Ergebnisse bei Browser und [curl] in Beispiel 14. Damit sich beide Sprachen leicht testen lassen, ersetzt Beispiel 16 ihn durch einen Resolver, der den Parameter [lang] aus der URL liest. Die Datei [config/WebConfig.java]:
Kommentieren wir diesen Code:
- Zeilen 21–27: die Dateien von [Bootstrap] wie in Beispiel 15;
- Zeilen 30–33: unser [Thymeleaf]-Dialekt, der weiter unten beschrieben wird, als Bean deklariert. [Spring Boot] fügt alle Beans, die Dialekte sind, automatisch der [Thymeleaf]-Engine hinzu;
- Zeilen 38–41: unser Sprachresolver. Die Bean muss den Namen [localeResolver] tragen: Unter diesem Namen sucht [Spring MVC] sie. Eine Methode mit dem Namen [@Bean] liefert den Namen der Bean: [localeResolver()]. Mit der Deklaration dieser Bean ersetzen wir diejenige von [Spring Boot];
- Zeilen 45–56: Der Resolver ist eine verschachtelte Klasse, die das Interface [LocaleResolver] implementiert;
- Zeilen 48–50: Die Methode [resolveLocale] wird zu Beginn jeder Anfrage aufgerufen: Sie liefert Französisch ([Locale.FRANCE]), wenn die URL [lang=fr] enthält; andernfalls liefert sie amerikanisches Englisch ([Locale.US]). [Spring MVC] speichert diese Sprache in [LocaleContextHolder], wo sie von der Bean [formats] und den Hilfsobjekten von [Thymeleaf] abgerufen wird;
- Zeilen 53–55: Die Methode [setLocale] würde es ermöglichen, die Sprache zu ändern (indem man sie beispielsweise in einem Cookie speichert). Hier stammt die Sprache aus der URL: Die Methode verweigert die Arbeit, indem sie eine Exception auslöst.
Das ist eine einfache Möglichkeit zum Testen; das nächste Kapitel behandelt das Thema gründlicher.
4.4.3. Ein Thymeleaf-Dialekt
Die Navigationsleiste hebt den Link der aktuellen Seite hervor (CSS-Klasse [active] von [Bootstrap]). Die Datei [templates/fragments/navbar.html] zeigt drei Möglichkeiten, Links zu schreiben:
Gehen wir diesen Code durch:
- Zeile 3: Der Namespace [xmlns:ex] ist wie [xmlns:th] nur für Editoren gedacht;
- Zeile 7: die erste Möglichkeit, den Link der aktuellen Seite hervorzuheben: eine in der View geschriebene Bedingung, die das Attribut [path] verwendet, das von der Klasse [CommonModel] bereitgestellt wird (identisch mit der aus Beispiel 15). Ohne „else“-Zweig erzeugt der Bedingungsoperator nichts, wenn die Bedingung falsch ist, und [th:classappend] fügt daher keine Klasse hinzu. Diese Methode wird in der Fallstudie verwendet;
- Zeile 9: die zweite, knappere Möglichkeit: ein Attribut „home“, [ex:active], das von unserem Dialekt bereitgestellt wird;
- Zeile 11: ein Link-Ausdruck [@{...}]. [Spring] erzeugt die URL: Die Klammern enthalten Parameter, die an die URL angehängt werden ([?lang=fr]). In Beispiel 21 sehen wir, dass sie auch dazu dienen, Pfadvariablen zu füllen. Ein Link-Ausdruck fügt bei Bedarf außerdem den Basispfad der Anwendung hinzu, wenn die Anwendung nicht im Stammverzeichnis des Servers installiert ist.
Ein Dialekt ist eine Menge von Attributen (oder Tags), die ein Präfix gemeinsam haben: Die Attribute [th:] gehören zum Standarddialekt von [Thymeleaf]. Jedes Attribut wird von einem Prozessor verarbeitet. Die Datei [helpers/ActiveDialect.java]:
- Zeile 12: Ein Dialekt, der nur Prozessoren bereitstellt, wird von der Klasse [AbstractProcessorDialect] abgeleitet;
- Zeile 16: der Name des Dialekts, das Präfix seiner Attribute ([ex]) und seine Priorität: dieselbe wie die der Attribute [th:];
- Zeilen 21–23: die Prozessoren des Dialekts: nur einer, nämlich der des Attributs [ex:active]. [Set.of(...)] erzeugt eine unveränderliche Menge.
Die Datei [helpers/ActiveProcessor.java]:
Kommentieren wir diesen Code:
- Zeile 13: ein Attributprozessor, der von der Klasse [AbstractAttributeTagProcessor] abgeleitet ist;
- Zeile 18: Sein Konstruktor beschreibt, was er verarbeitet: den HTML-Modus, das Dialektpräfix, ausschließlich [<a>]-Tags, das Attribut [active] (mit Präfix: [ex:active]), eine Priorität und [true]: Das Attribut [ex:active] wird aus der erzeugten Seite entfernt;
- Zeilen 23–24: Die Methode [doProcess] wird für jedes [<a>]-Tag aufgerufen, das das Attribut [ex:active] besitzt. Sie erhält den View-Kontext, das Tag und den Attributwert; das Objekt [structure] ermöglicht es, das Tag zu ändern;
- Zeile 26: Der Prozessor ist [Java]-Code und kein View-Ausdruck: Er darf die aktuelle Anfrage lesen. Wenn die View für eine Webanfrage gerendert wird, ist der Kontext ein [IWebContext], der Zugriff auf den Austausch (die Anfrage und ihre Antwort) bietet; [getRequestPath()] liefert den angeforderten Pfad. Der Ausdruck [context instanceof IWebContext web] prüft den Typ des Kontexts und speichert ihn gegebenenfalls in der Variablen [web];
- Zeilen 27–32: Beginnt der Seitenpfad mit dem Attributwert, wird die Klasse [active] zum Attribut [class] des Tags hinzugefügt.
Der HTML-Code der Navigationsleiste unter der URL [/products]:
Dem Link „Products“ wurde die Klasse [active] zugewiesen, und das Attribut [ex:active] wurde entfernt. Der Link-Ausdruck hat [/products?lang=fr] erzeugt. Beachten Sie, dass [Thymeleaf] das Attribut [xmlns:th] entfernt hat, nicht aber das Attribut [xmlns:ex]: Letzteres kennt es nicht. Es hätte weggelassen werden können, da es nur von Editoren verwendet wird.
Das Template [layout.html] ist das aus Beispiel 15, jedoch ohne Fußzeile (und die Seitentitel enden mit [- Helpers] statt mit [- My site]). Die resultierenden Seiten, zunächst auf Englisch (http://localhost:5000/, http://localhost:5000/products) und dann auf Französisch (http://localhost:5000/products?lang=fr):



Die Preise ändern ihr Format je nach Sprache: [1 149,90 €] auf Französisch, [€1,149.90] auf Englisch. Auf Französisch wird der Dollar als [$US] geschrieben, um ihn von anderen Währungen (kanadisch, australisch usw.) zu unterscheiden. Der HTML-Code der Tabelle auf Französisch ([/products?lang=fr]):
und auf Englisch ([/products]), wo der Dollar einfach als [$] geschrieben wird:
Nur die Beträge haben sich geändert: Der Text der Badges ist fest im Fragment codiert (das nächste Kapitel übersetzt die Texte).
4.5. Beispiel 17: Ein GET-Formular
Ein HTML-Formular, das per GET-Methode gesendet wird, legt seine Felder in der URL ab. Das ist die geeignete Methode für eine Suche: Sie ändert nichts, und die resultierende URL kann als Lesezeichen gespeichert oder geteilt werden. Die Fallstudie verwendet sie, um einen Arzt und ein Datum auszuwählen.
Die Dateien [models/Book.java] and [models/SearchModel.java] :
- Zeile 6: Das View-Template enthält die eingegebenen Werte ([keyword], [genre]), damit das Formular sie erneut anzeigen kann, zusammen mit der Liste der Genres und den Ergebnissen.
Die Datei [controllers/BooksController.java]:
Gehen wir diesen Code durch:
- Zeilen 17–24: die Bücher und Genres im Speicher;
- Zeile 27: Eine einzelne Action kann mehreren Pfaden entsprechen; sie verarbeitet sowohl [GET /] als auch [GET /search];
- Zeilen 28–29: Die Parameter [keyword] und [genre] werden an die gleichnamigen Parameter der URL gebunden (siehe Beispiel 07). [required = false] macht sie optional: Beim ersten Aufruf wurde das Formular noch nicht gesendet, und ihre Werte sind [null];
- Zeilen 31–35: Filterung mithilfe eines Streams ([stream]) [Java] (siehe Beispiel 06): [stream()] durchläuft die Liste; jeder [filter] behält nur die Bücher, die eine Bedingung erfüllen; und [toList()] sammelt die ausgewählten Bücher in einer neuen Liste. Die Bedingungen sind Lambda-Ausdrücke: [b -> ...] ist eine anonyme Funktion, die ein Buch [b] entgegennimmt und einen Booleschen Wert zurückgibt. Ein leeres Schlüsselwort oder ein leeres Genre filtert nichts;
- Zeilen 36–37: das View-Template. Hier werden die [null]-Werte durch leere Strings ersetzt.
Das Template [templates/layout.html] ist vereinfacht: ein einziger Parameter – der Seiteninhalt – und ein fester Titel:
- Zeile 2: Das Fragment [page] hat nun nur noch einen Parameter, [content];
- Zeile 5: Der Titel ist für alle Seiten gleich.
Die Datei [templates/books/search.html]:
Gehen wir diesen Code durch:
- Zeile 2: Die Seite übergibt ihren einzigen Parameter – das [<main>]-Tag – an das Template;
- Zeile 7: [method="get"] und [action="/search"]: Das Absenden des Formulars ist eine [GET /search?keyword=...&genre=...]-Anfrage. Die Parameternamen sind das Attribut [name] jedes Feldes;
- Zeile 11: Das Attribut [th:value] setzt das Attribut [value] des Feldes: Es stellt den eingegebenen Wert wieder her. Allgemein berechnet [th:xxx] den Wert der HTML-Attribute [xxx]: [th:value], [th:href], [th:action], [th:class] ...
- Zeilen 18–19: eine Option pro Genre. Innerhalb desselben Tags wird [th:each] zuerst verarbeitet, danach [th:value] und [th:text], die die Schleifenvariable verwenden. [th:selected] ist ein Boolesches Attribut: Ist der Ausdruck wahr, schreibt [Thymeleaf] [selected="selected"]; ist er falsch, schreibt es das Attribut gar nicht. Genau das verlangt HTML; bei diesem Attribut genügt allein das Vorhandensein des Attributs [selected], um die Option auszuwählen. Dasselbe gilt für [th:checked], [th:disabled], [th:required], [th:readonly] ...;
- Zeile 26: die Anzahl der Ergebnisse;
- Zeile 28: die Liste der Ergebnisse mit einem [<i>]-Tag und zwei Inline-Ausdrücken.
Der HTML-Code der Dropdown-Liste nach einer Suche wie [poetry]:
Bei der ersten Anzeige (http://localhost:5000/) und dann nach einer Suche:


Die Adressleiste zeigt die gesendeten Parameter. Hier enthalten sie nur einfache Buchstaben; Sonderzeichen würden dort codiert (ein Akzent-[é] wird beispielsweise zu [%C3%A9]): Das ist die URL-Codierung, die [Spring MVC] decodiert, bevor die Parameter verkettet werden.
4.6. Beispiel 18: Formularfelder
Beispiel 18 kombiniert alle Arten von HTML-Feldern: Text, Passwort, Datum, Optionsfelder, Kontrollkästchen, Dropdown-Liste, Mehrfachauswahlliste, Textfeld und verstecktes Feld. Es zeigt, wie der Server sie empfängt und wie die View sie anzeigt. Außerdem führt es das Attribut [th:field] ein, das ein Formularfeld mit einer Eigenschaft eines Modellobjekts verbindet.
Die Datei [services/ListsService.java]:
- Zeile 11: Die Annotation [@Service] macht die Klasse zu einer Bean, genau wie [@Component] (Beispiel 16): [Spring] findet sie beim Start und erzeugt eine einzige Instanz davon, einen Singleton (siehe Beispiel 06), der in Controller injiziert werden kann. [@Service] unterscheidet sich von [@Component] nur in der Absicht, die es ausdrückt: Die Klasse ist ein Service. Die vom Formular bereitgestellten Listen sind für alle Benutzer gleich: Ein Singleton ist der natürliche Ort, um sie zu speichern;
- Zeilen 14–15: ein Land – ein Code und ein Name;
- Zeilen 17–32: die Listen, zurückgegeben von den Methoden [getXxx()]. Für eine View sind dies die Eigenschaften [titles], [countries], [hobbies] und [languages] der Bean: [${lists.titles}] ruft [getTitles()] auf.
Die Datei [models/Input.java]:
Kommentieren wir diesen Code:
- Zeilen 13–23: Die Eingabe ist eine Klasse im Stil einer [JavaBean] (private Felder, ein parameterloser Konstruktor und Accessoren [getXxx] und [setXxx]), kein Record: Das Model Binding erzeugt sie leer und befüllt dann jede Eigenschaft mit dem gleichnamigen Parameter über ihren Setter [setXxx];
- Zeilen 17 und 19: Die Kontrollkästchen und die Mehrfachauswahlliste sind Listen: Sie erhalten alle gesendeten Werte (siehe Beispiel 10). Sie werden mit einer leeren Liste initialisiert, niemals mit [null];
- Zeilen 21–22: Ein Feld [<input type="date">] sendet das Datum im Format [ISO 8601] [yyyy-mm-dd]. Die Annotation [@DateTimeFormat(iso = DateTimeFormat.ISO.DATE)] gibt dieses Format an [Spring] weiter, das es in beide Richtungen verwendet: um den empfangenen Text in [LocalDate] umzuwandeln und um das Datum im Feld wieder auszugeben.
Die Datei [controllers/FormController.java]:
Gehen wir diesen Code durch:
- Zeilen 22–26: Der Listen-Service wird über den Konstruktor injiziert (siehe Beispiel 06);
- Zeilen 30–33: Eine Methode, die mit [@ModelAttribute("lists")] annotiert und in einem Controller deklariert ist, wird vor jeder Action dieses Controllers ausgeführt: Beide Actions finden das Attribut [lists] in ihrem Modell vor, ohne es dort hinzufügen zu müssen (siehe [CommonModel], Beispiel 15, für alle Actions der Anwendung);
- Zeilen 36–45: [GET /form] zeigt das Formular mit Anfangswerten an. Das Objekt wird im Modell unter dem Namen [input] gespeichert;
- Zeile 50: [POST /form] empfängt die Benutzereingabe. Die Annotation [@ModelAttribute], angewendet auf einen Parameter, weist das Model Binding an, das Objekt aus den Anfrageparametern zu erzeugen (das ist das Standardverhalten für einen Parameter eines Klassentyps; siehe Beispiel 08) und es im View-Modell zu speichern. Ohne expliziten Namen entspricht der Attributname dem Klassennamen mit kleinem Anfangsbuchstaben: [input]. Das Formular wird mit den empfangenen Werten erneut angezeigt;
- Zeilen 52–56: [getParameterMap()] bietet ebenfalls Zugriff auf die Parameter so, wie sie gesendet wurden: ein Dictionary, in dem jeder Wert ein Array von Strings ist (ein Parameter kann mehrfach vorkommen). Es wird in Text umgewandelt, eine Zeile pro Parameter, und im Template unter dem Namen [received] gespeichert. [Collectors.joining("\n")] verkettet die Zeilen, getrennt durch einen Zeilenumbruch.
Das Template [templates/layout.html] ist das aus Beispiel 17 (nur der Titel ändert sich). Die Datei [templates/form/form.html]:
Gehen wir diesen Code durch:
- Zeile 7: Das Attribut [th:object] legt das Formularobjekt fest: das Attribut [input] des Templates. Innerhalb des Tags verweist ein Auswahlausdruck [*{name}] auf die Eigenschaft [name] dieses Objekts: Das entspricht [${input.name}];
- Zeile 9: Das Attribut [th:field="*{token}"] verbindet das Feld mit der Eigenschaft [token]: Es schreibt die Attribute [id] und [name] (den Namen der Eigenschaft) sowie das Attribut [value] (ihren Wert). Ein verstecktes Feld wird mit dem Formular gesendet, aber nicht angezeigt. Es dient dazu, Informationen von einer Seite zur nächsten weiterzugeben (in der Fallstudie enthält es zum Beispiel die Version eines Datensatzes). Achtung: Der Benutzer kann es ändern;
- Zeilen 14–18: Optionsfelder haben denselben [name]; nur eines kann ausgewählt werden, und nur ein Wert wird gesendet. Bei einem Optionsfeld schreibt [th:field] den Wert der Eigenschaft nicht in [value] ([th:value] liefert den Wert des Optionsfeldes): Es wählt das Optionsfeld aus, wenn sein Wert mit der Eigenschaft übereinstimmt. Da alle Optionsfelder denselben Namen haben, vergibt [th:field] an sie nummerierte [id]-Werte: [title1], [title2] ... Das Hilfsobjekt [#ids.prev('title')] (Zeile 17) setzt den Wert des letzten Feldes [title] auf die angegebene [id], für das Attribut [for] seines Labels;
- Zeile 25: ein Textfeld: [th:field] schreibt [id="name"], [name="name"] und den Wert. Das Label in Zeile 23 kann daher [for="name"] fest codieren;
- Zeile 30: Ein Passwort wird niemals auf einer Seite zurückgegeben: Das Feld verwendet [th:field] nicht und hat kein Attribut [value];
- Zeile 35: ein Datumsfeld. Der Browser zeigt das Datum in seinem eigenen Format an, sendet und empfängt aber immer [yyyy-mm-dd]; [th:field] schreibt das Datum dank der Annotation [@DateTimeFormat] in diesem Format;
- Zeilen 42–45: Kontrollkästchen mit demselben [name]: Jedes angekreuzte Kästchen sendet seinen Wert, sodass der Parameter mehrfach vorkommt. [th:field] kreuzt das Kästchen an, wenn sein Wert in der Liste [hobbies] enthalten ist;
- Zeilen 51–53: eine Dropdown-Liste. [th:field] am [<select>]-Tag wählt die Option aus, deren Wert der Eigenschaft [country] entspricht;
- Zeilen 58–60: Das Attribut [multiple] erlaubt die Auswahl mehrerer Optionen: [th:field] wählt alle Optionen aus, die zur Liste [languages] gehören;
- Zeile 67: Der Wert eines Textbereichs steht zwischen seinen Tags und nicht in einem Attribut [value]: [th:field] weiß das;
- Zeilen 73–76: was der Server empfangen hat, nur nach dem Absenden angezeigt, innerhalb eines [<pre>]-Tags, das Zeilenumbrüche beibehält.
Hier ein Auszug aus dem HTML-Code, den diese [th:field]-Attribute erzeugen (das versteckte Feld, das zweite Optionsfeld, die ersten beiden Kontrollkästchen, die Dropdown-Liste):
Beachten Sie die versteckten Felder, die wir nicht geschrieben haben: [_hobbies] nach jedem Kontrollkästchen, [_languages] vor der Dropdown-Liste. Sie lösen ein Problem von HTML: Ein nicht angekreuztes Kontrollkästchen wird überhaupt nicht gesendet. Wenn der Benutzer alle Kontrollkästchen abwählt, fehlt der Parameter [hobbies] in der Anfrage, und das Model Binding würde die Eigenschaft [hobbies] nicht aktualisieren, die ihren vorherigen Wert behielte. Die Markierung [_hobbies] hingegen wird immer gesendet: Wenn [Spring] sie ohne den Parameter [hobbies] vorfindet, leert es die Liste (oder setzt einen Booleschen Wert auf [false]). Hier ist die Eingabe ein neues Objekt, dessen Liste bereits leer ist, sodass der Unterschied nicht auffällt; er spielt eine Rolle, wenn das Formularobjekt zuvor befüllt wurde (zum Beispiel in einer Session gespeichert; siehe das Kapitel „Datenbereiche“).
Das anfängliche Formular (http://localhost:5000/form) und danach nach dem Absenden:


Beachten Sie Folgendes:
- Das Textfeld zeigte „[Hello <b>whole</b> world]“ genau so an, wie es eingegeben wurde: „[th:field]“ maskiert den Wert, und die eingegebenen Tags werden nicht interpretiert;
- Das Passwort wurde empfangen, wird aber nicht angezeigt;
- Der Browser hat die Markierungen [_hobbies] (eine pro Kontrollkästchen) und [_languages] gesendet.
Mit [curl] sehen wir den Unterschied, wenn ein Kontrollkästchen angekreuzt ist:
und bei zwei angekreuzten Kästchen:
(es wird nur das [<pre>]-Tag der Seite wiedergegeben). Die Option [-d] von [curl] sendet eine POST-Anfrage mit diesem Body und dem Header [Content-Type: application/x-www-form-urlencoded] eines HTML-Formulars.
4.7. Beispiel 19: Formularvalidierung
Ein ungültiges Formular muss erneut angezeigt werden, mit den eingegebenen Werten und einer Meldung unter jedem fehlerhaften Feld. Beispiel 19 wendet die Technik aus Beispiel 09 an (Validierung durch die Action mithilfe des Parameters [BindingResult]) auf ein Registrierungsformular und zeigt, wie [Thymeleaf] Fehler anzeigt.
Die Validierung erfordert eine zusätzliche Abhängigkeit. Die Datei [pom.xml]:
- Zeilen 7–11: der Validierungs-Starter: die API [Bean Validation] (die Annotationen [@NotBlank], [@Size] ...) und ihre Implementierung [Hibernate Validator] (siehe Beispiel 08).
Die Datei [models/RegistrationModel.java]:
Kommentieren wir diesen Code:
- Zeilen 16–18: Der Name ist erforderlich ([@NotBlank] weist [null], einen leeren String und einen nur aus Leerzeichen bestehenden String zurück) und auf 20 Zeichen begrenzt;
- Zeilen 20–22: [@Email] validiert das Format einer E-Mail-Adresse;
- Zeilen 25–28: Das Alter wird in eine Ganzzahl umgewandelt und dann validiert. Der Typ [Integer] (nicht [int]) erlaubt den Wert [null]: Ein fehlendes Alter bleibt [null], und [@NotNull] beanstandet dies;
- Zeilen 30–32: mindestens 6 Zeichen. [@Size] validiert keinen Wert [null]: Das ist die Aufgabe von [@NotBlank];
- Zeilen 38–41: Die Regel „Die Bestätigung stimmt mit dem Passwort überein“ betrifft zwei Felder. [Bean Validation] hat hierfür keine vordefinierte Annotation; die einfachste Lösung ist eine Boolesche Methode, die den Vergleich durchführt und mit [@AssertTrue] annotiert ist: Die Einschränkung ist verletzt, wenn die Methode [false] zurückgibt. Für [Bean Validation] dient eine Methode mit dem Namen [isXxx()] als Accessor einer Booleschen Eigenschaft: Jeder Fehler wird daher der Eigenschaft [confirmationValid] zugeordnet. [Objects.equals] vergleicht zwei Objekte, ebenso wie zwei Werte [null].
Die Datei [controllers/RegistrationController.java]:
Gehen wir diesen Code durch:
- Zeilen 25–28: Eine mit [@InitBinder] annotierte Methode konfiguriert das Model Binding für die Actions dieses Controllers. Sie erhält das Objekt [WebDataBinder], das die Bindung durchführt. Dort wird ein Property-Editor für den Typ [String] registriert: [StringTrimmerEditor] entfernt führende und nachfolgende Leerzeichen aus jedem empfangenen String; mit dem Argument [true] wird ein leerer String zu [null]. Ein eingegebener Name [" Martin "] wird zu ["Martin"]. Achtung: Das gilt für alle Strings, auch für Passwörter;
- Zeilen 31–36: das leere Formular. Der Parameter [html5] wird später erklärt. Das Formularobjekt wird im Template unter dem Namen [registration] gespeichert;
- Zeile 40: [@Valid] fordert die Validierung des Objekts an; [@ModelAttribute("registration")] speichert es im Modell unter dem Namen [registration], demselben wie in Zeile 33, der von der View verwendet wird. Der Parameter [BindingResult] muss unmittelbar auf das validierte Objekt folgen: Er erhält die Binding- und Validierungsfehler, und die Action wird dann immer ausgeführt (siehe Beispiel 09);
- Zeile 41: [@RequestParam] liest einen Parameter aus der URL oder aus dem Anfrage-Body: Hier stammt [html5] aus der URL des Formulars;
- Zeilen 42–50: Wenn Fehler vorliegen, wird das Formular mit den eingegebenen Werten – außer den Passwörtern – und einer allgemeinen Meldung, die im Template gespeichert wird, erneut angezeigt. Mehr ist nicht zu tun: Das Objekt [registration] und seine Fehler ([BindingResult]) befinden sich bereits im Modell, wo die View sie findet;
- Zeile 51: andernfalls die Willkommensseite, die ebenfalls das Objekt [registration] aus dem Modell verwendet.
Ein Konvertierungsfehler (ein Alter [abc]) erzeugt eine englische Standardmeldung, die schwer lesbar ist: [Failed to convert property value of type java.lang.String to required type java.lang.Integer for property age; For input string: "abc"]. Die Datei [messages.properties] ersetzt sie:
- Zeile 3: [Spring Boot] liest automatisch die Ressourcendatei [messages.properties]: Dies ist die Nachrichtendatei der Anwendung (das nächste Kapitel erklärt, wie sie in mehrere Sprachen lokalisiert wird). Bei einem Konvertierungsfehler sucht [Spring] unter mehreren Schlüsseln nach einer Nachricht, vom spezifischsten zum allgemeinsten: [typeMismatch.registration.age] (das Objekt und seine Eigenschaft), [typeMismatch.age] (die Eigenschaft), [typeMismatch.java.lang.Integer] (der erwartete Typ) und schließlich [typeMismatch]. Der erste gefundene Schlüssel hat Vorrang; andernfalls wird die englische Nachricht verwendet. In einer solchen Datei muss ein Apostroph doppelt geschrieben werden (auf Französisch zum Beispiel: [n''est]): Die Nachrichten werden von der Klasse [MessageFormat] von [Java] verarbeitet, für die der einfache Apostroph ein Sonderzeichen ist. Die Fallstudie ersetzt daher alle diese Nachrichten.
4.7.1. Ein Feld-Fragment
Alle Felder folgen demselben Muster: ein Label, ein Feld und eine Fehlermeldung. Ein Fragment fasst diese Bestandteile zusammen. Die Datei [templates/fragments/field.html]:
Kommentieren wir diesen Code:
- Zeile 5: Das Fragment [field] wird ohne Signatur deklariert, das heißt ohne Parameterliste. Es wird mit benannten Parametern ([field(name='age', label='Age', ...)]) aufgerufen, die zu Variablen des Fragments werden; ein nicht übergebener Parameter wird einfach auf [null] gesetzt. Das ist nützlich für ein Fragment mit vielen optionalen Parametern. [th:with] deklariert die Variable [key]: den Namen der Eigenschaft, für die der Fehler angezeigt wird. Der Operator [?:] (bekannt als „Elvis“) liefert seinen linken Operanden, wenn dieser nicht [null] ist, andernfalls seinen rechten Operanden: [errorOf], falls angegeben, andernfalls [name];
- Zeile 9: [th:type] schreibt das Attribut [type]. [th:field] muss den Namen der Eigenschaft erhalten, der in der Variablen [name] gespeichert ist. Man kann nicht [*{name}] schreiben (das wäre die Eigenschaft [name]): Verwenden Sie stattdessen den Vorverarbeitungsschritt [__...__]. Der Ausdruck zwischen den doppelten Unterstrichen wird zuerst ausgewertet, und sein Ergebnis ersetzt den Text: Wenn [name] gleich [email] ist, wird das Attribut zu [th:field="*{email}"], das dann normal ausgewertet wird. [th:field] verwendet das Formularobjekt ([th:object]), das von der View deklariert wird, die das Fragment einfügt;
- Zeile 10: [#fields.hasErrors(key)] gibt an, ob die Eigenschaft im [BindingResult] des Formularobjekts Fehler hat. Die Klassen [Bootstrap] und [is-invalid] heben das Feld dann rot hervor;
- Zeile 11: Das Boolesche Attribut [required] wird geschrieben, wenn [required] wahr ist; andernfalls wird es weggelassen;
- Zeile 12: [th:attr] schreibt mehrere Attribute auf einmal. Ein Attribut mit dem Wert [null] wird nicht geschrieben: Jedes Feld erhält nur die HTML5-Einschränkungen, die für es gelten;
- Zeile 14: die Fehlermeldung unterhalb des Feldes (Klasse [Bootstrap] [invalid-feedback]). [#fields.errors(key)] liefert die Liste der Meldungen für die Eigenschaft; eine Eigenschaft kann mehrere Einschränkungen verletzen, und nur die erste wird angezeigt ([[0]]).
Die Datei [templates/registration/registration.html]:
- Zeilen 6–7: der Link, der die Validierung durch den Browser aktiviert oder deaktiviert;
- Zeile 10: Das Attribut [action] des Formulars behält den Parameter [html5] bei;
- Zeile 11: Das Boolesche Attribut [novalidate] wird gesetzt, wenn [html5] falsch ist. [th:object] verweist auf das Formularobjekt [registration];
- Zeilen 12–16: Jedes Feld ist eine Einfügung des Fragments mit benannten Parametern. Bei der Bestätigung (Zeile 16) ist der anzuzeigende Fehler der der Eigenschaft [confirmationValid] und der der Regel [@AssertTrue].
Die Datei [templates/layout.html]:
- Zeile 13: Die globale Meldung wird am Ende der Seite auf hellrosa Hintergrund angezeigt (Klasse [error-area] aus [static/css/styles.css] abgeleitet), wie in der Fallstudie zu sehen.
Die Datei [templates/registration/welcome.html]:
- Zeile 4: [th:object] ist nicht Formularen vorbehalten: Im [<main>]-Tag erlaubt es, [*{name}] statt [${registration.name}] zu schreiben;
- Zeilen 5–6: die konvertierten und bereinigten Werte: Das Alter ist eine Zahl, und der Name enthält keine Leerzeichen mehr.
Das leere Formular (http://localhost:5000/register), dann mit mehreren Fehlern gesendet (ein nur aus Leerzeichen bestehender Name, eine unvollständige Adresse, ein zu geringes Alter sowie zu kurze und voneinander verschiedene Passwörter):


dann korrekt ausgefüllt (mit Leerzeichen um den Namen):

Und mit einem nicht numerischen Alter, gesendet mit [curl] (der Browser hätte es in einem [type="number"]-Feld abgelehnt):
Beachten Sie Folgendes:
- Der Konvertierungsfehler beim Alter verwendet die Nachricht aus [messages.properties];
- Das Feld [age] zeigt den abgelehnten Wert [abc] nicht erneut an: Bei einem Feld [type="number"] schreibt [th:field] keinen Wert, der keine Zahl ist (mit [type="text"] hätte es [value="abc"] geschrieben);
- Das fehlende Passwort hat nur einen Fehler, „erforderlich“: [@Size] validiert keinen Wert [null]. Die Bestätigung hat dagegen keinen Fehler: Zwei fehlende Passwörter sind gleich;
- Die Felder ohne Fehler haben nicht die Klasse [is-invalid], und ihr Fragment erzeugt keine Meldung.
4.7.2. Validierung im Browser
Die Attribute [required], [maxlength], [min], [max], [type="email"] ... weisen den Browser an, das Formular vor dem Absenden zu validieren: Der Benutzer wird sofort über einen Tooltip benachrichtigt, ohne dass eine Kommunikation mit dem Server stattfindet. Dieses Verhalten erhalten Sie, wenn Sie auf den Link „enable it“ klicken (http://localhost:5000/register?html5=true), der das Attribut [novalidate] aus dem Formular entfernt.
Diese Validierung ist eine Komfortfunktion und keine Sicherheitsmaßnahme: Man kann sie umgehen, indem man das Attribut [required] mit den Entwicklerwerkzeugen des Browsers entfernt oder die Anfrage mit [curl] sendet. Die serverseitige Validierung bleibt unerlässlich. Deshalb deaktiviert das Beispiel die Browser-Validierung standardmäßig: um die Funktionsweise des Servers zu zeigen. Die Fallstudie behält dagegen beides bei: die HTML5-Attribute für den Komfort und die serverseitige Validierung für die Sicherheit.
4.8. Beispiel 20: Das Post/Redirect/Get-Muster
Wird ein POST-Formular erfolgreich gesendet, kann die Action direkt eine Seite anzeigen. Das Problem entsteht, wenn der Benutzer diese Seite anschließend neu lädt (Taste F5): Der Browser sendet das Formular erneut, und die Operation wird ein zweites Mal ausgeführt (eine doppelt aufgegebene Bestellung, ein doppelt vereinbarter Termin ...). Das Post/Redirect/Get-Muster (PRG) verhindert dieses Problem: Eine erfolgreiche POST-Action erzeugt keine Seite, sondern leitet auf eine GET-Seite um. Das erneute Laden dieser Seite löst lediglich ein weiteres GET ohne Auswirkung aus.
Ein Detail bleibt: Die GET-Seite muss eine Meldung anzeigen („Die Aufgabe wurde hinzugefügt“), obwohl diese Meldung von der POST-Action in einer anderen Anfrage erzeugt wurde. [Spring MVC] stellt hierfür die Flash-Attribute bereit: Attribute, die vor der Umleitung gesetzt werden und bis zur nächsten Anfrage erhalten bleiben, wo sie dem Template hinzugefügt werden und dann verschwinden. Man spricht von einer Flash-Meldung. Standardmäßig speichert [Spring MVC] die Flash-Attribute in der HTTP-Session des Benutzers: einem Speicherbereich, den der Server jedem Browser zuordnet (dem Kapitel „Datenbereiche“ ist dieses Thema gewidmet).
Die Datei [services/TasksService.java]:
- Zeile 13: Ein Singleton wird von allen Anfragen gemeinsam genutzt, die gleichzeitig laufen können. Eine Standard-[ArrayList] unterstützt das nicht; [CopyOnWriteArrayList] ist eine Liste, die genau dafür konzipiert ist;
- Zeilen 15–17: [List.copyOf] gibt eine schreibgeschützte Kopie der Liste zurück: Der Aufrufer kann die Liste des Service nicht ändern.
Die Datei [controllers/TasksController.java]:
Kommentieren wir diesen Code:
- Zeilen 24–28: die Listenseite;
- Zeile 33: ein Parameter vom Typ [RedirectAttributes], bereitgestellt von [Spring MVC]: die Umleitungsattribute;
- Zeilen 35–40: eine ungültige Eingabe – die Seite wird ohne Umleitung erneut angezeigt (die Eingabe und die Fehlermeldung müssen erhalten bleiben). Zeile 39 ruft einfach die Methode [display] auf, wie jede andere [Java]-Methode: Sie fügt dem Template die Aufgabenliste hinzu und gibt den Namen der View zurück;
- Zeile 43: eine gültige Eingabe: Nach der Operation zeigt [addFlashAttribute] die Flash-Meldung an;
- Zeile 45: Ein String, der mit [redirect:] beginnt, ist kein View-Name: [Spring MVC] antwortet mit einer Umleitung (Code 302) an die folgende Adresse (siehe Beispiel 04);
- Zeilen 49–54: das Gegenbeispiel zum Vergleich: eine Seite als Antwort auf POST.
Die Datei [templates/tasks/tasks.html]:
- Zeile 10: die Eingabe, die nach einem Fehler erneut angezeigt wird (das Attribut [label] existiert in den anderen Fällen nicht: Das Feld ist leer);
- Zeile 13: Das Attribut [formaction] einer Schaltfläche sendet das Formular an eine andere Adresse als die des Attributs [action] des Formulars. Das Formular hat somit zwei Schaltflächen, die zwei verschiedene Actions auslösen. Die Fallstudie verwendet diesen Ansatz auf ihrer Anmeldeseite;
- Zeile 15: Ein im Template fehlendes Attribut wird auf [null] gesetzt, und [th:if] behandelt [null] als falsch.
Die Datei [templates/layout.html]:
Die Flash-Meldung wird am Seitenanfang angezeigt (Zeile 12) und der Fehler am Seitenende (Zeile 14). Aus Sicht der View ist ein Flash-Attribut einfach ein weiteres Modellattribut.
Hier sehen Sie, was [curl] beim erfolgreichen Absenden des Formulars sieht. Die Option [-c file] speichert die empfangenen Cookies, [-b file] sendet sie zurück; [--data-urlencode] codiert Leerzeichen und Akzente im Feld:
Die Antwort ist eine Umleitung auf [/tasks]. Um die Flash-Meldung zu speichern, hat [Spring MVC] eine HTTP-Session angelegt: Der Server ([Tomcat]) hat ihr eine Kennung zugewiesen, die im Cookie [JSESSIONID] an den Browser gesendet wurde. Die folgende Anfrage sendet dieses Cookie zurück, sodass der Server die Session und die Meldung abrufen kann:
Die Flash-Meldung wird angezeigt; wird die Seite neu geladen, verschwindet sie. Die Session bleibt jedoch geöffnet: Ihre Kennung ändert sich nicht, und der Server sendet das Cookie nicht erneut.
Die Datei [application.properties] enthält eine Einstellung zur Session:
- Zeile 7: Die Session wird ausschließlich über ein Cookie verfolgt. Ohne diese Einstellung weiß [Tomcat] bei der ersten Antwort nicht, ob der Browser Cookies akzeptiert: Es sendet das Cookie, fügt aber zusätzlich die Session-ID in die URL der Umleitung ein. Das Ergebnis ist:
Die URL und [/tasks;jsessionid=...] funktionieren, erscheinen aber in der Adressleiste des Browsers, und eine in der URL zirkulierende Session-ID (Browserverlauf, Lesezeichen, kopierte Links) stellt ein Sicherheitsrisiko dar. Alle Beispiele, die Flash-Attribute verwenden, haben diese Einstellung.
Im Browser (http://localhost:5000/tasks) nach dem Hinzufügen einer Aufgabe:

Die Adressleiste zeigt [/tasks]: Das ist die GET-Seite. Sie können sie bedenkenlos neu laden; die Meldung verschwindet. Eine Eingabe mit Leerzeichen:

Und das Gegenbeispiel:

Hier zeigt die Adressleiste [/tasks/without-prg], die Adresse von POST. Das Neuladen der Seite löst eine Browserwarnung aus („Formularübermittlung bestätigen“) und fügt die Aufgabe dann ein zweites Mal hinzu. Alle POST-Formulare der Fallstudie folgen dem PRG-Schema. Die Fallstudie speichert ihre Flash-Attribute jedoch in einem Cookie statt in der Session, da ihr Server zwischen Anfragen keine Daten aufbewahrt.
4.9. Beispiel 21: Links, Schaltflächen und Bestätigung
Eine einfache Regel leitet die Wahl zwischen einem Link und einer Schaltfläche:
- Ein Link ([<a href>]) erzeugt eine Anfrage (GET). Eine Anfrage (GET) darf nichts ändern: Browser, Suchmaschinen und Virenscanner können Links von sich aus aufrufen, um eine Seite vorzubereiten oder zu analysieren;
- Eine Operation, die Daten ändert (hinzufügen, bearbeiten, löschen, abmelden), ist eine Schaltfläche in einem POST-Formular.
Beispiel 21 verwaltet eine Kontaktliste: Man sieht sich einen Kontakt über einen Link an und löscht ihn über eine Schaltfläche, die ein Bestätigungsfenster öffnet. Die Dateien dieses Beispiels:
Die Datei [services/ContactsService.java]:
Kommentieren wir diesen Code:
- Zeilen 14–15: ein Kontakt;
- Zeilen 17–20: die Liste der Kontakte: eine [ArrayList] (veränderbar), initialisiert mit drei Kontakten;
- Zeile 24: Das Schlüsselwort [synchronized] stellt sicher, dass immer nur eine Anfrage gleichzeitig eine [synchronized]-Methode des Objekts ausführt: Gleichzeitige Anfragen können die Liste nicht zur selben Zeit ändern. Das ist eine andere Lösung als die Liste [CopyOnWriteArrayList] in Beispiel 20;
- Zeilen 29–31: [read] gibt ein [Optional<Contact>] zurück (siehe Beispiel 06): ein Objekt, das einen Kontakt enthält oder nichts, wenn kein Kontakt diese ID hat. [findFirst()] gibt das erste Element des Streams als [Optional] zurück;
- Zeilen 36–38: Ein Record ist unveränderlich: Seine Felder werden nicht geändert; stattdessen wird er durch einen neuen ersetzt;
- Zeile 46: [++lastId] erhöht den Zähler, bevor er verwendet wird: Die folgenden Kennungen sind 4, 5 ...;
- Zeile 53: [ifPresent] führt eine Aktion aus, wenn [Optional] einen Kontakt enthält. [contacts::remove] ist eine Methodenreferenz: eine Kurzschreibweise für das Lambda [c -> contacts.remove(c)].
Die Datei [controllers/ContactsController.java]:
Kommentieren wir diesen Code:
- Zeilen 28–38: die beiden Seiten – die Liste und das Profil des Kontakts. Die Einschränkung [{id:\\d+}] (siehe Beispiel 02) akzeptiert nur eine Kennung, die aus Ziffern besteht;
- Zeile 36: [orElseThrow] gibt den in [Optional] enthaltenen Kontakt zurück oder löst, wenn es leer ist, die Exception aus, die von der übergebenen Funktion erzeugt wird: hier die Methodenreferenz [ContactsController::notFound];
- Zeilen 41–47: Speichern eines Datensatzes im PRG-Muster. Die Parameter [name] und [phone] sind erforderlich: [@RequestParam] kann nicht ohne [required = false] verwendet werden;
- Zeilen 50–56: Duplizieren, ausgelöst durch eine zweite Schaltfläche im selben Formular (Attribut [formaction]);
- Zeilen 58–63: Löschen über ein POST;
- Zeilen 66–68: Eine Exception [ResponseStatusException] trägt einen HTTP-Code und eine Begründung. Wird sie von einer Action ausgelöst, erzeugt sie eine Fehlerantwort mit diesem Code: in diesem Fall 404. Ein nicht vorhandener Kontakt löst somit in den Actions [details], [save] und [delete] einen 404 aus; das Duplizieren liest den Kontakt dagegen nicht erneut ein: Es erzeugt eine Kopie auf Grundlage der empfangenen Felder.
Die Datei [templates/contacts/list.html]:
- Zeile 13: Ansehen: ein Link, der von [Bootstrap] als Schaltfläche dargestellt wird. Der Link-Ausdruck [@{/contacts/{id}(id=${contact.id})}] enthält eine Pfadvariable [{id}], die durch den gleichnamigen Parameter in den Klammern gefüllt wird: [/contacts/1]. Ein Parameter, der keiner Pfadvariablen entspricht, wird nach [?] angehängt (siehe Beispiel 16);
- Zeilen 15–16: Löschen: ein kleines POST-Formular, das auf seine Schaltfläche reduziert ist. Das Attribut [data-confirmation] enthält die Frage, die vor dem Absenden gestellt werden soll. Die Attribute [data-*] sind nicht spezifiziert: HTML ignoriert sie, während [JavaScript] auf der Seite sie lesen kann. [Thymeleaf] kann jedes Attribut schreiben: [th:data-confirmation] berechnet das Attribut [data-confirmation], dessen Wert maskiert wird.
Die Datei [templates/contacts/details.html]:
- Zeile 4: [th:object] am [<main>]-Tag: Der Kontakt ist das ausgewählte Objekt, und [*{id}] verweist auf seine ID;
- Zeile 6: die Adresse des Formulars mit einer Pfadvariablen, die durch einen Auswahlausdruck gefüllt wird;
- Zeilen 9 und 13: Dieses Formular verwendet [th:field] nicht: Die Felder sind nicht mit einem Formularobjekt verbunden, daher genügt [th:value];
- Zeilen 16–17: zwei Absende-Schaltflächen für dasselbe Formular; die zweite hat ihr eigenes Attribut [formaction].
4.9.1. Das Bestätigungsfenster
Das Dialogfeld des Browsers ([window.confirm]) lässt sich weder formatieren noch übersetzen: Seine Schaltflächen bleiben in der Sprache des Browsers. Es wird durch ein [Bootstrap]-Fenster ersetzt, das in die Seite eingebettet und bis zum Bedarfsfall ausgeblendet ist. Die Datei [templates/fragments/confirmation.html]:
- Zeile 2: ein Fragment ohne Parameter. Die Klasse [d-none] blendet das Fenster aus;
- Zeile 3: der graue Hintergrund;
- Zeile 11: der Ort der Frage;
- Zeilen 14–15: die beiden Schaltflächen, identifiziert durch das Attribut [data-action].
Die Datei [templates/layout.html]:
- Zeile 11: die Flash-Meldung;
- Zeile 15: Das Fenster erscheint auf jeder Seite;
- Zeile 17: Das Skript wird am Ende der Seite geladen; wenn es ausgeführt wird, existieren die gesuchten Elemente bereits. Es wird als statische Datei aus [static/js/app.js] ausgeliefert.
Ein kleiner Teil [JavaScript] verbindet die Formulare mit dem Fenster. Die Datei [static/js/app.js]:
- Zeile 3: Der Code ist in eine Funktion eingebettet, die sofort ausgeführt wird, um keine globalen Variablen zu erzeugen;
- Zeilen 9–16: Das Absenden jedes Formulars mit dem Attribut [data-confirmation] wird abgefangen. [preventDefault()] unterbricht das Absenden; das Formular wird gemerkt, die Frage wird im Fenster platziert ([textContent], nicht [innerHTML]: Die Frage wird als Text angezeigt und niemals als HTML interpretiert), und das Fenster wird angezeigt;
- Zeilen 19–27: „Ja“ sendet das gemerkte Formular ab. Die Methode [submit()] eines Formulars sendet es ab, ohne das Ereignis [submit] auszulösen: Es erscheint keine erneute Bestätigungsabfrage. „Nein“ blendet das Fenster aus.
Wenn [JavaScript] deaktiviert ist, werden Formulare einfach ohne Bestätigung gesendet: Die Anwendung funktioniert weiterhin. Dies ist das Prinzip der schrittweisen Verbesserung: [JavaScript] fügt Komfort hinzu, ist aber nicht unerlässlich. Die Fallstudie folgt diesem Prinzip (ihr Skript [static/js/app.js] ergänzt die Tastaturbedienung: Esc-Taste, Fokus). Die resultierenden Seiten ab http://localhost:5000/contacts: die Liste, die Bestätigungsabfrage, die Liste nach dem Löschen und das Profil eines Kontakts:




Schließlich überprüfen wir, dass das Löschen nicht durch eine GET-Anfrage ausgelöst werden kann:
Der Pfad existiert, aber nicht für die Methode GET: [Spring MVC] gibt [405 Method Not Allowed] zurück, und der Header [Allow] nennt die akzeptierte Methode. Der Antwort-Body ist die Fehlerantwort von [Spring Boot], wie sie bei [curl] als JSON zu sehen ist (ein Browser, der HTML anfordert, erhält eine Fehlerseite). Mit POST:
Das Löschen wurde durchgeführt, gefolgt von einer Umleitung auf die Liste; das Cookie [JSESSIONID] ist das Session-Cookie, das die Flash-Meldung trägt. Und ein nicht vorhandener Kontakt:
Die 404-Antwort wiederholt die für die Exception [ResponseStatusException] ([unknown contact]) angegebene Begründung. Dieses Feld, [message], ist nur während der Entwicklung vorhanden: Die Entwicklungswerkzeuge von [Spring Boot] ([devtools], eine Abhängigkeit aller Beispiele) aktivieren seine Anzeige; ohne sie enthält die Antwort nur den Code, den Fehler und den Pfad.