3. Das Action-Modell
Eine Action benötigt die vom Browser gesendeten Informationen: die Parameter der URL ([?name=martin&age=42]), die Formularfelder, den JSON-Body der Anfrage und manchmal einen HTTP-Anfrage-Header. Der Originalkurs bezeichnet die Gesamtheit dieser Informationen als Modell der Action. Dieses Kapitel zeigt, wie [Spring MVC] der Action diese Informationen bereitstellt, sie in den richtigen Typ konvertiert und validiert. Dieser Vorgang heißt Datenbinding ([data binding]).
Anmerkung zur Terminologie: In [Spring MVC] bezeichnet das Wort „Modell“ ([Model]) in erster Linie die Daten, die eine Action an ihre View übergibt (Kapitel 4, „Die View und ihr Modell“). Das Modell einer Action im Sinne dieses Kapitels ist das, was sie empfängt.
Die Beispiele 07 bis 12 sind wie die des vorherigen Kapitels [Maven] -Module aus dem Ordner [examples]. Sie können eines davon ausführen, indem Sie in diesem Ordner ein Terminal öffnen und [../mvnw spring-boot:run] eingeben ([..\mvnw spring-boot:run] unter [Windows]); [Ctrl-C] beendet den Server. Jedes Beispiel hat eine Datei namens [application.properties] , die so aussieht:
- Zeile 2: der Listening-Port des Servers;
- Zeile 4: Wenn eine Anfrage fehlschlägt, [Spring Boot] antwortet mit einem JSON-Fehlerdokument (wir werden in diesem Kapitel viele davon sehen). Diese Eigenschaft verhindert, dass der Aufrufstapel der Ausnahme ([stack trace]) – der lang ist und niemals einem Benutzer angezeigt werden sollte – einbezogen wird. Das ist notwendig, weil die Abhängigkeit [spring-boot-devtools] (die Entwicklungswerkzeuge, deklariert im übergeordneten [pom.xml]) während der Entwicklung mehrere Standardeinstellungen ändert: Insbesondere fügt sie der JSON-Antwort die Fehlermeldung der Ausnahme (Eigenschaft [spring.web.error.include-message]) und den Aufrufstapel ([spring.web.error.include-stacktrace]) hinzu. Wir behalten die Meldung bei, da sie hilft zu verstehen, was passiert ist; in der Produktion verschwindet sie ohne die Entwicklungswerkzeuge ebenfalls.
3.1. Beispiel 07: Die Parameter der URL
Die Datei [controllers/ParametersController.java]:
Lassen Sie uns diesen Code kommentieren:
- Zeilen 16–17: Die Annotation [@RequestParam] verknüpft einen Parameter der Action mit einem Parameter der URL (dem Teil nach dem [?], bekannt als Query-String bzw. [query string]). Sofern nichts anderes angegeben ist, hat der Parameter in der URL denselben Namen wie der Parameter in [Java]: [name]. Dieser Name ist zur Laufzeit nur deshalb bekannt, weil das übergeordnete Projekt von [Spring Boot] den Compiler anweist, ihn im kompilierten Code beizubehalten (Option [-parameters]). Eine Annotation kann benannte Argumente akzeptieren, die Attribute genannt werden: [required = false] gibt an, dass der Parameter fehlen darf; in diesem Fall entspricht er [null]. Zeile 18: Die Methode [formatted] ersetzt jedes Vorkommen von [%s] in der Zeichenkette durch das folgende Argument; [name.getClass().getSimpleName()] ist der Kurzname des Typs des Werts;
- Zeilen 23–24: Der Parameter ist als Typ [int] deklariert: [Spring MVC] wandelt die empfangene Zeichenkette (["42"]) in eine Zahl um. Ohne das Attribut [required = false] macht [@RequestParam] den Parameter erforderlich: Das ist der Standardwert für [required]. Ein fehlender Parameter oder einer, dessen Umwandlung fehlschlägt, führt zu einem 400-Fehler, und die Action wird nicht ausgeführt;
- Zeilen 29–30: Ein [int] kann nicht gleich [null] sein. Für eine optionale Zahl wird der Parameter mit dem Typ [Integer] deklariert, der Klasse [Java], die ein [int] „umhüllt“ ([wrapper]): Ein [Integer]-Objekt kann den Wert [null] haben, was die Unterscheidung zwischen „kein Alter“ und „Alter 0“ ermöglicht;
- Zeilen 35–36: Das Attribut [defaultValue] liefert den Wert, der verwendet wird, wenn der Parameter fehlt (es macht den Parameter außerdem optional). Es handelt sich um eine Zeichenkette, die auf dieselbe Weise umgewandelt wird wie der empfangene Wert;
- Zeilen 41–42: Das Attribut [name] gibt den Namen des Parameters der URL an, wenn er sich von dem des Parameters [Java] unterscheidet: Der Parameter [search] der Action erhält den Parameter [q] aus der URL;
- Zeilen 47–48: Ein Parameter vom Typ [Map<String, String>] , versehen mit [@RequestParam] , erhält alle Parameter der URL ohne Umwandlung: ein Dictionary (Parametername, Wert). Die Action gibt es unverändert zurück, und [Spring MVC] serialisiert es in JSON.
Die Ergebnisse:
Der Server [Tomcat] gibt den Text [OK] nach dem Code 200 in der ersten Zeile nicht aus: Dieser Text ist in HTTP/1.1 optional; nur der Code zählt. Anführungszeichen um die URL sind erforderlich, wenn sie das Zeichen [&] enthält, das für die Konsole eine besondere Bedeutung hat; wir setzen sie überall. Ein Parameter vom Typ [int]:
Das ist ein wesentlicher Unterschied zu [ASP.NET Core MVC], wo eine unmögliche Umwandlung die Ausführung der Action nicht verhinderte. Mit [@RequestParam] löst [Spring MVC] vor dem Aufruf der Action eine Ausnahme aus: [MethodArgumentTypeMismatchException] bei einer unmöglichen Umwandlung, [MissingServletRequestParameterException] bei einem fehlenden erforderlichen Parameter (die Serverkonsole zeigt die Namen dieser Ausnahmen an). Eine Komponente von [Spring MVC] wandelt sie in eine 400-Fehlerantwort um ([Bad Request], ungültige Anfrage), und [Spring Boot] erzeugt den Body dieser Antwort: Es ist die JSON-Fehlerantwort, der wir bereits im vorigen Kapitel begegnet sind. Ihre Felder:
- [timestamp]: Datum und Uhrzeit des Fehlers (in koordinierter Weltzeit);
- [status], [error]: der HTTP-Code und seine Beschreibung;
- [message]: die Meldung der Ausnahme, hier enthalten, weil die Entwicklungswerkzeuge dies verlangt haben;
- [path]: der Pfad der Anfrage.
Ein Browser, der eine Seite mit dem Code HTML anfordert, erhält stattdessen eine minimale Fehlerseite – die „Whitelabel Error Page“. In Beispiel 12 werden wir sehen, wie Sie diese Ausnahmen selbst behandeln. Mit dem Typ [Integer]:
Ein fehlender Parameter wird als [null] behandelt; ein ungültiger Parameter führt stets zu einem 400-Fehler. Der Standardwert:
Ein vorhandener, aber leerer Parameter ([?page=]) wird behandelt, als fehlte er: Er erhält den Standardwert. Die letzten beiden Actions:
Hier ist age eine Zeichenkette (["42"]): Ohne deklarierten Typ findet keine Umwandlung statt. Schließlich unterscheiden Parameternamen zwischen Groß- und Kleinschreibung:
Der Parameter [NAME] ist nicht derselbe wie der Parameter [name], der folglich fehlt. Das ist ein weiterer Unterschied zu [ASP.NET Core MVC], das die Groß- und Kleinschreibung ignoriert. Festzuhalten ist:
- [@RequestParam] verknüpft einen Parameter der Action mit einem Parameter gleichen Namens in der URL, einschließlich der Großbuchstaben (Attribut [name] , falls die Namen abweichen);
- der Parameter ist standardmäßig erforderlich; [required = false] macht ihn optional, und [defaultValue] liefert einen Ersatzwert;
- sein Wert wird in den deklarierten Typ umgewandelt, und eine unmögliche Umwandlung führt zu einem 400-Fehler, ohne dass die Action ausgeführt wird. Ein Objekttyp ([Integer], nicht [int]) ermöglicht den Empfang von [null].
Akzentuierte Zeichen und Leerzeichen werden in einer URL kodiert ([%C3%A9] für [é] usw.): [Spring MVC] dekodiert sie vor dem Binding. Der Browser zeigt die kodierte URL und das empfangene JSON an:

3.2. Beispiel 08: Ein durch eine Klasse beschriebenes Action-Modell
Wenn eine Action mehrere Parameter hat, werden diese durch eine Klasse beschrieben. Jedes Feld der Klasse hat Validierungsbedingungen in Form von Annotationen. Diese werden von [Bean Validation] definiert, dem [Java]-Validierungsstandard (Paket [jakarta.validation]), dessen am weitesten verbreitete Implementierung [Hibernate Validator] ist. Sie sind nicht Teil von [Spring MVC]: Sie müssen den Validierungs-Starter zur Datei [pom.xml] des Beispiels hinzufügen:
- Zeilen 6–10: das übergeordnete Projekt [pom.xml], im Ordner [examples];
- Zeilen 13–19: Der Starter [spring-boot-starter-validation] enthält [Hibernate Validator] und konfiguriert ihn. Denken Sie daran, dass ein Starter eine Abhängigkeit ist, die andere Abhängigkeiten samt ihren Versionen und ihrer automatischen Konfiguration bündelt. Die Beispiele 09 bis 12 verwenden dieselbe Abhängigkeit.
Die Datei [models/PersonModel.java]:
Lassen Sie uns diesen Code kommentieren:
- Zeilen 3–9: die Validierungsannotationen, alle im Paket [jakarta.validation.constraints];
- Zeilen 14–16: Der Name ist erforderlich und darf nicht leer sein ([@NotBlank] weist [null], eine leere Zeichenkette und eine nur aus Leerzeichen bestehende Zeichenkette zurück) und muss zwischen 2 und 20 Zeichen lang sein ([@Size]). Jede Annotation akzeptiert eine benutzerdefinierte Fehlermeldung (Attribut [message]);
- Zeilen 18–21: Das Alter wird in eine ganze Zahl umgewandelt, die erforderlich ist ([@NotNull]) und zwischen 0 und 150 liegen muss ([@Min], [@Max]). Es ist als [Integer] statt als [int] deklariert, damit „kein Alter“ ([null]) von [@NotNull] erkannt wird, anstatt auf 0 gesetzt zu werden;
- Zeilen 23–25: Die Anrede muss dem regulären Ausdruck [Mr|Mme|Melle] entsprechen ([@Pattern]): Sie muss einer dieser drei Werte sein;
- Zeilen 28–29: Die E-Mail-Adresse ist optional (kein [@NotNull]); falls vorhanden, muss sie gültig sein ([@Email]). Alle Bedingungen außer [@NotNull] und [@NotBlank] akzeptieren den Wert [null]: Das ist es, was ein Feld optional macht;
- Zeilen 33–43: die Zugriffsmethoden. Per Konvention wird der Wert des Felds [name] von der Methode [getName] gelesen ([getter]) und von der Methode [setName] geschrieben ([setter]). Eine Klasse mit einem parameterlosen Konstruktor (hier dem von [Java] implizit bereitgestellten) und Zugriffsmethoden, die dieser Konvention folgen, heißt JavaBean. Das ist die Form, die das Data Binding erwartet: [Spring MVC] erzeugt das Objekt mit seinem parameterlosen Konstruktor und ruft dann für jeden Parameter der Anfrage den gleichnamigen Setter auf: [setName("martin")] für [?name=martin], nachdem der Wert in den Typ des Setters umgewandelt wurde. Der JSON-Konverter hingegen liest die Felder über ihre Getter.
Die Datei [controllers/PersonsController.java]:
- Zeile 21: Die Action erhält ein [PersonModel]. Der Parameter hat keine Annotation [@RequestParam]: Bei einem Parameter, dessen Typ kein „einfacher“ Typ ist (Zeichenkette, Zahl, Datum usw.), setzt [Spring MVC] die Annotation [@ModelAttribute] implizit voraus, die man auch hätte schreiben können. Der Parameter ist dann ein Command-Objekt ([command object]), das wie eben beschrieben durch das Data Binding erzeugt und befüllt wird. Query-Parameter, die keinem Setter entsprechen, werden ignoriert;
- Zeile 21: Die Annotation [@Valid] (aus [jakarta.validation]) verlangt, dass das Objekt nach dem Befüllen validiert wird, indem die Bedingungen für seine Felder geprüft werden. Schlägt das Data Binding oder die Validierung fehl, löst [Spring MVC] die Ausnahme [MethodArgumentNotValidException] aus: Die Action wird nicht ausgeführt, und die Antwort ist ein 400-Fehler. Das entspricht dem Attribut [[ApiController]] von [ASP.NET Core MVC];
- Zeilen 22–25: Die Action gibt die empfangene Person und den Typ ihres Alters zurück. [LinkedHashMap] ist ein Dictionary, das die Einfügereihenfolge seiner Schlüssel beibehält: JSON gibt sie in dieser Reihenfolge aus.
Die Datei [application.properties] im Beispiel hat zwei zusätzliche Zeilen:
- Zeile 6: Resultiert die Fehlerantwort aus einer Validierungsprüfung, enthält sie die Liste der Fehler (Feld [errors]). Die Entwicklungswerkzeuge aktivieren dies bereits; diese Zeile hält es auch in der Produktion aktiviert. Ohne sie – und ohne die Entwicklungswerkzeuge – beschränkt sich die Fehlerantwort auf [{"timestamp":"...","status":400,"error":"Bad Request","path":"/persons/action01"}]: Der Client erfährt, dass seine Anfrage fehlerhaft ist, aber nicht, warum.
Eine gültige Anfrage mit einem Parameter [pirate], der keinem Feld entspricht:
Das Alter ist tatsächlich eine Zahl (ein [Integer]), und der Parameter [pirate] wurde ignoriert. Die Eigenschaften der Person sind alphabetisch sortiert: Das ist die Standardeinstellung von [Jackson] 3, der JSON-Bibliothek, die von [Spring MVC] verwendet wird. Eine ungültige Anfrage (die JSON-Antwort wurde zur besseren Lesbarkeit formatiert: eine Eigenschaft pro Zeile):
Die Action wurde nicht ausgeführt. Das Feld [errors] listet die Fehler auf, einen pro abgelehntem Feld. Für jeden gilt:
- [field], [rejectedValue]: das Feld und der abgelehnte Wert;
- [defaultMessage]: die Fehlermeldung; sie ist die nützlichste;
- [code]: der Name der verletzten Bedingung ([Size], [Email] ...) oder [typeMismatch] bei einem Umwandlungsfehler; [bindingFailure] ist bei einem Umwandlungsfehler gleich [true] (der Fehler trat beim Binding auf, vor der Validierung);
- [codes], [arguments]: Schlüssel und Werte, mit denen die Meldung in einer Nachrichtendatei gesucht wird. So wird die englische Fehlermeldung für den Umwandlungsfehler (Schlüssel [typeMismatch...]) durch eine benutzerdefinierte Meldung ersetzt, wie in Beispiel 19 gezeigt.
Die Reihenfolge der Fehler ist nicht garantiert: Sie kann sich von einem Lauf zum nächsten ändern. Dasselbe gilt ohne Parameter:
Nur eine Meldung pro Feld: Die Bedingungen [@Size] und [@Pattern] akzeptieren den Wert [null]; nur [@NotBlank] und [@NotNull] weisen ihn zurück. Wie bei [@RequestParam] unterscheidet das Data Binding zwischen Groß- und Kleinschreibung: Mit [?NAME=martin&age=42&title=Mr] erhalten Sie den Fehler „Der Name ist erforderlich“, weil [NAME] keinem Setter entspricht.
3.2.1. Warum eine Klasse namens JavaBean und kein Record?
Seit [Java] 16 beschreibt ein einzeiliger Record eine nicht veränderbare Datenklasse: [record Point(int x, int y) {}] deklariert die Felder [x] und [y], einen Konstruktor, der alle Felder entgegennimmt, und die Lesemethoden [x()] und [y()]. Ein Record hat keine Setter. [Spring MVC] kann einen Record befüllen: Es ruft seinen Konstruktor mit den Query-Parametern auf (dies nennt man Konstruktor-Binding). Ersetzen wir, nur zur Veranschaulichung, die Klasse [PersonModel] durch den entsprechenden Record (die Action liest das Alter dann mit [person.age()]):
Eine gültige Anfrage liefert dasselbe Ergebnis, abgesehen von der Reihenfolge der JSON-Eigenschaften: Die Eigenschaften eines Records werden in der Reihenfolge seiner Komponenten geschrieben ([{"name":"martin","age":42,"title":"Mr","email":null}]). Die vorherige ungültige Anfrage liefert nun jedoch nur noch einen Fehler:
Die Umwandlung des Alters ist fehlgeschlagen; daher konnte der Konstruktor des Records nicht aufgerufen werden, weil einem seiner Parameter ein Wert fehlte; ohne Objekt gibt es keine Validierung: Die Fehler bei Name, Anrede und E-Mail-Adresse werden nicht gemeldet. Bei einer JavaBean hingegen wird jeder Setter unabhängig aufgerufen: Ein falsch umgewandeltes Feld bleibt leer und erhält einen Umwandlungsfehler, während die anderen befüllt werden und die Validierung fortgesetzt wird (Beispiel 09). Für ein HTML-Formular, bei dem es darum geht, alle Fehler auf einmal zu melden, ist das unerlässlich: Alle Formulare in diesem Kurs sind daher JavaBean-Formulare. Ein Record bleibt für ein Modell geeignet, dessen Felder keine Umwandlungsfehler haben können: Das ist in Beispiel 10 der Fall.
Diese automatische Zurückweisung eignet sich für einen JSON-Server, der von einem [JavaScript]-Client abgefragt wird, der die Fehler auf seine eigene Weise anzeigt. Für eine HTML-Anwendung ist ein JSON-Fehler sinnlos: Ziel ist es, das Formular mit seinen Fehlern erneut anzuzeigen. Das folgende Beispiel zeigt, wie Sie die Kontrolle behalten.
3.3. Beispiel 09: Von der Action durchgeführte Validierung
Die Klasse [PersonModel] in Beispiel 09 ist mit der in Beispiel 08 identisch; nur der Controller ändert sich. Die Datei [controllers/PersonsController.java]:
Lassen Sie uns diesen Code aufschlüsseln:
- Zeile 20: Das Attribut [produces] von [@GetMapping] legt den Typ der Antwort fest: [MediaType.TEXT_HTML_VALUE] ist die Konstante ["text/html"]. Die von der Action zurückgegebene Zeichenkette wird daher als HTML-Seite gesendet;
- Zeile 21: Die Action hat einen zweiten Parameter vom Typ [BindingResult], der unmittelbar nach dem validierten Modell steht. Seine Anwesenheit ändert alles: Bei einem Binding- oder Validierungsfehler löst [Spring MVC] keine Ausnahme mehr aus, sondern speichert die Fehler in diesem [BindingResult] und führt die Action aus, die entscheidet, was damit geschieht. [BindingResult] erfüllt dieselbe Rolle wie [ModelState] in [ASP.NET Core MVC];
- Zeilen 23–25: [hasErrors()] gibt an, ob Fehler vorliegen. Falls nicht, wird eine Willkommensseite zurückgegeben ([%d] wird durch eine ganze Zahl ersetzt);
- Zeilen 27–29: andernfalls die Liste der Fehler. [getFieldErrors()] gibt die Liste der einem Feld zugeordneten Fehler zurück ([FieldError]), mit dem Feldnamen ([getField()]) und der Meldung ([getDefaultMessage()]). Die Verarbeitung nutzt die API der [Java]-Streams ([Stream]): [stream()] liefert die Listenelemente nacheinander, [map] wandelt jedes um (hier einen Fehler in eine Zeile: HTML [<li>]), [collect(Collectors.joining())] verkettet alles zu einer Zeichenkette. Das Argument von [map] ist ein Lambda: eine anonyme Funktion, geschrieben als [parameter -> expression];
- Zeile 30: eine Seite, die die Fehler auflistet. In beiden Fällen hat die Antwort den Statuscode 200.
Eine gültige Anfrage in einem Browser:

Eine ungültige Anfrage:

Ein Umwandlungsfehler erscheint in [BindingResult] als Validierungsfehler, hindert die anderen Felder aber nicht an der Validierung:
Das ist die Technik, die alle Formulare der Fallstudie verwenden werden (siehe Beispiel 19): Die Action erhält das Formular (eine mit [@Valid] annotierte JavaBean), gefolgt von einem [BindingResult], und zeigt das Formular erneut an, wenn Fehler vorliegen.
3.4. Beispiel 10: Mehrfache Parameter
Derselbe Parameter kann in einer Anfrage mehrfach vorkommen: Das ist bei Checkboxen eines Formulars oder einer Liste mit Mehrfachauswahl der Fall ([?color=red&color=green]).
Die Datei [controllers/ArraysController.java]:
Die Action [action01] (Zeilen 22–27) zeigt, was ein einzelner Parameter erhält:
Ein Parameter vom Typ [String] , der mehrere Werte erhält, verkettet diese, durch Kommas getrennt: ["red,green"]. Das ist eine Falle: Man glaubt, eine einzelne Farbe zu erhalten, erhält tatsächlich aber eine verkappte Liste von Farben. Ein Parameter vom Typ Liste ([action02], Zeilen 30–37) erhält sie alle, jeweils in einem eigenen Listenelement. [List<String>] ist eine Liste von Zeichenketten; [List.of()] (Zeile 32) ist eine leere Liste, die [null] ersetzt, wenn der Parameter fehlt:
Umgekehrt wird ein einzelner Wert, der Kommas enthält, aufgeteilt:
Die Umwandlung einer Zeichenkette in eine Liste verwendet ebenso wie die Umwandlung einer Liste in eine Zeichenkette ein Komma als Trennzeichen. Wir hätten auch ein Array deklarieren können ([String[] color]). Es bleibt nur noch, die Liste zu validieren. Die Datei [models/ChoiceModel.java]:
Lassen Sie uns diesen Code kommentieren:
- Zeile 10: [ChoiceModel] ist ein Record mit nur einem Feld (siehe Beispiele 03 und 08), [color]. Das Konstruktor-Binding bereitet hier kein Problem: Eine Liste von Zeichenketten kann keinen Umwandlungsfehler verursachen;
- Zeile 12: [@Size(min = 1)]bezieht sich, auf eine Liste angewendet, auf die Anzahl der Elemente der Liste: Es muss mindestens eines geben;
- Zeile 13: Die Annotation [@Pattern] steht innerhalb des generischen Typs, vor [String]: Sie gilt nicht für die Liste, sondern für jedes ihrer Elemente. Jede Farbe muss [red], [green], or [blue] sein. In der Meldung wird [${validatedValue}] durch den abgelehnten Wert ersetzt;
- Zeilen 16–18: der kompakte Konstruktor eines Records: ein Block, der zu Beginn des Konstruktors ausgeführt wird, bevor die Felder zugewiesen werden, und der seine Parameter ändern kann. Hier wird eine fehlende Liste ([null]) zu einer leeren Liste.
Die Action [action03] des Controllers [ArraysController] erhält ein validiertes [ChoiceModel], gefolgt von einem [BindingResult], und gibt dessen Inhalt zusammen mit dem Validierungsstatus zurück. [choice.color()] liest das Feld des Records. [result.getAllErrors()] liefert alle Fehler, und [ObjectError::getDefaultMessage] ist eine Methodenreferenz: eine Kurzschreibweise für das Lambda [error -> error.getDefaultMessage()]. [toList()] sammelt den Stream in einer Liste.
[ASP.NET Core MVC] erforderte eine in [C#] geschriebene Validierungsmethode, um jedes Element der Liste zu prüfen; mit [Bean Validation]genügt eine Annotation im generischen Typ.
3.5. Beispiel 11: Die Parameter einer POST-Anfrage
Ein per POST-Methode gesendetes HTML-Formular legt seine Felder in den Body der Anfrage, nicht in die URL. Die Datei [controllers/PostController.java]:
Lassen Sie uns diesen Code kommentieren:
- Zeile 25: [@PostMapping] verknüpft die Action mit den POST-Anfragen, so wie [@GetMapping] es mit den GET-Anfragen tut;
- Zeile 26: [@RequestHeader("Content-Type")] liefert den Wert eines Anfrage-Headers: hier den Typ ihres Bodys;
- Zeile 27: Ein Parameter vom Typ [MultiValueMap<String, String>], annotiert mit [@RequestParam], erhält alle Parameter der Anfrage. Eine [MultiValueMap] ist ein Dictionary, in dem jedem Schlüssel eine Liste von Werten zugeordnet ist: Es behält alle Werte eines wiederholten Parameters, während die [Map<String, String>] aus Beispiel 07 nur einen behalten würde;
- Zeile 36: [@RequestBody] weist das System an, den Body der Anfrage zu lesen und zu deserialisieren, das heißt, ihn in ein [Java]-Objekt umzuwandeln. Der Body muss ein JSON-Dokument sein (was ein [JavaScript]-Client sendet), gelesen von der Bibliothek [Jackson]. [JsonNode] repräsentiert ein beliebiges JSON-Dokument; wir hätten auch eine Klasse oder einen Record deklarieren können. Zeile 18: In [Jackson] 3, das von [Spring Boot] 4 verwendet wird, liegen die Klassen im Paket [tools.jackson.databind] (und nicht mehr in [com.fasterxml.jackson.databind] wie in [Jackson] 2);
- Zeilen 44–45: [@RequestParam] liest ein Formularfeld genau wie einen Parameter der URL;
- Zeilen 50–51: das gesamte Formular, gebunden und validiert durch die Klasse [PersonModel] (eine Kopie der Klasse aus Beispiel 08 im Paket [example11.models]) (ein Command-Objekt, wie in Beispiel 09);
- Zeile 55: [sorted()] sortiert die Meldungen, damit die Reihenfolge der Fehler von einer Ausführung zur nächsten konsistent bleibt.
Die Option [-d] von [curl] sendet eine POST-Anfrage mit einem Body im Format eines HTML-Formulars ([application/x-www-form-urlencoded]):
Jedem Feld ist eine Liste von Werten zugeordnet, die hier nur einen Wert enthält. Derselbe Inhalt im JSON-Format:
(Die Option [-H] von [curl] fügt der Anfrage einen Header hinzu; unter [Windows]würden Sie an der Eingabeaufforderung [-d "{\"name\":\"martin\",\"age\":42}"] eingeben). Im ersten Fall ist das Alter eine Zeichenkette (ein HTML-Formular überträgt nur Text), im zweiten eine Zahl. [Spring MVC] wählt den Konverter, der den Body liest, anhand des Headers [Content-Type] der Anfrage aus. Eine Action [@RequestBody], die JSON erwartet, weist daher einen Body anderen Typs mit einem 415-Fehler zurück ([Unsupported Media Type], nicht unterstützter Inhaltstyp):
Der Antwort-Header [Accept] listet die akzeptierten Typen auf. Ein ungültiger JSON-Body hingegen führt zu einem 400-Fehler:
Die beiden anderen Actions:
[@RequestParam] und die Command-Objekte unterscheiden nicht zwischen URL und Body: Sie behandeln die Parameter der URL und die Formularfelder als eine Einheit. Ein Parameter, der an beiden Stellen vorhanden ist, erhält daher zwei Werte:
Eine POST-Action antwortet wie eine GET-Action mit dem Statuscode 200. Bei einer HTML-Anwendung antwortet eine POST-Action entweder mit einer Seite (dem erneut angezeigten Formular) oder mit einer Weiterleitung (siehe Beispiel 20).
3.6. Beispiel 12: Benutzerdefiniertes Data Binding und benutzerdefinierte Validierung
Data Binding und Validierung lassen sich erweitern. Die Fallstudie nutzt sie nur in geringem Umfang, aber ihr Verständnis hilft, die Funktionsweise von [Spring MVC] besser zu begreifen.
3.6.1. Ein Konverter: DateFrConverter
Um die Zeichenkette ["42"] in [int] umzuwandeln, verwendet [Spring MVC] einen Konverter ([Converter]). Es stellt Konverter für alle gängigen Typen bereit; Sie können eigene schreiben. Die Datei [binding/DateFrConverter.java]:
- Zeile 12: Ein Konverter implementiert das generische Interface [Converter<S, T>], wobei [S] der Quelltyp und [T] der Zieltyp ist: hier von [String] nach [LocalDate] (ein Datum ohne Uhrzeit);
- Zeilen 15–16: das Datumsformat [dd/mm/yyyy]. Im Modus [STRICT] wird ein nicht existierendes Datum (31/02/2026) zurückgewiesen; dieser Modus erfordert, das Jahr als [uuuu] statt als [yyyy] zu schreiben;
- Zeilen 19–21: Die einzige Methode des Interfaces, [convert], liefert das resultierende Datum;
- Zeilen 22–25: Schlägt die Umwandlung fehl, löst der Konverter eine Ausnahme aus. [Spring MVC] macht daraus einen Umwandlungsfehler, genau wie bei [?age=abc]: Fehler 400 bei einem [@RequestParam], [typeMismatch]-Fehler im [BindingResult] bei einem Feld eines Command-Objekts. Unsere Ausnahme bleibt als Ursache des Umwandlungsfehlers erhalten: Wir rufen ihre Meldung im Controller ab.
3.6.2. Ein Resolver-Argument: die Annotation @Language und LanguageResolver
Ein Parameter einer Action kann aus einer anderen Quelle als der URL oder dem Formular stammen. Für jeden Parameter einer Action befragt [Spring MVC] eine Liste von Objekten, die [argument resolvers] („Argument-Resolver“) genannt werden: Der erste, der erklärt, den Parameter verarbeiten zu können, liefert seinen Wert. So funktionieren [@RequestParam], [@RequestHeader], [@RequestBody] und so weiter. Sie können eigene hinzufügen. Zunächst brauchen Sie eine Möglichkeit, die betreffenden Parameter zu kennzeichnen: eine „benutzerdefinierte“ Annotation. Die Datei [binding/Language.java]:
- Zeile 12: [@interface] deklariert eine Annotation. Diese Annotation hat keine Attribute;
- Zeile 10: [@Target] legt fest, wo die Annotation stehen darf: hier nur an einem Methodenparameter;
- Zeile 11: [@Retention(RetentionPolicy.RUNTIME)]: Die Annotation bleibt im kompilierten Code erhalten und ist zur Laufzeit lesbar. Das ist unerlässlich, damit [Spring MVC] sie erkennt.
Die Datei [binding/LanguageResolver.java]:
- Zeile 11: Ein Resolver implementiert das Interface [HandlerMethodArgumentResolver];
- Zeilen 14–17: [supportsParameter] gibt [true] für die Parameter zurück, die es verarbeitet: diejenigen, die mit der Annotation [@Language] versehen sind und den Typ [String] haben. [MethodParameter] beschreibt einen Parameter der Action;
- Zeilen 20–26: [resolveArgument] liefert den Wert des Parameters. Unter seinen Argumenten ermöglicht [NativeWebRequest] den Zugriff auf die Anfrage. Zeile 23: der Header [Accept-Language], der die bevorzugten Sprachen des Benutzers angibt. Zeilen 24–25: die ersten beiden Buchstaben der ersten Sprache in Kleinbuchstaben oder ["fr"] , falls der Header fehlt. Der Operator [? :] liefert seinen zweiten Operanden, wenn die Bedingung wahr ist, andernfalls den dritten.
3.6.3. Eine Validierungsbedingung: @NoSpace
Eine benutzerdefinierte Validierungsbedingung besteht aus zwei Elementen: einer Annotation und der Klasse, die die Validierung durchführt. Die Datei [binding/NoSpace.java]:
- Zeile 13: Die Bedingung kann auf ein Feld einer Klasse oder einen Methodenparameter angewendet werden;
- Zeile 15: [@Constraint] macht die Annotation zu einer Bedingung von [Bean Validation] und legt die Klasse fest, die sie validiert;
- Zeile 19: die Standardfehlermeldung. Ein Attribut einer Annotation wird als Methode ohne Parameter deklariert, und [default] gibt ihm einen Standardwert: Man würde [@NoSpace] oder [@NoSpace(message = "...")] schreiben;
- Zeilen 22–24: zwei vom Standard verlangte Attribute: [groups] erlaubt es, nur eine Teilmenge der Bedingungen zu prüfen, und [payload] erlaubt es, einer Bedingung Informationen anzuhängen. Wir verwenden sie nicht, aber sie müssen deklariert werden.
Die Datei [binding/NoSpaceValidator.java]:
- Zeile 7: Die Validierungsklasse implementiert [ConstraintValidator<A, T>], wobei [A] die Annotation und [T] der Typ der validierten Werte ist;
- Zeilen 10–13: [isValid] gibt [true] zurück, wenn der Wert akzeptabel ist. Der Wert [null] wird akzeptiert, da er alle Standardbedingungen außer [@NotNull] und [@NotBlank] erfüllt.
3.6.4. Konfiguration: WebConfig
Der Konverter und der Resolver müssen in [Spring MVC] deklariert werden; die Bedingung wird über die Annotation [@Constraint] erkannt. Die Datei [binding/WebConfig.java]:
- Zeile 12: [@Configuration] kennzeichnet eine Konfigurationsklasse: [Spring Boot] entdeckt sie beim Start (sie liegt in einem Unterpaket des Pakets, das die Klasse [Example12Application] enthält), erzeugt eine Instanz davon und verwendet sie;
- Zeile 13: Das Interface [WebMvcConfigurer] erlaubt eine Erweiterung der Konfiguration von [Spring MVC] , die von [Spring Boot] eingerichtet wurde, ohne sie zu ersetzen. Es hat viele Methoden, die standardmäßig nichts tun; wir überschreiben ([@Override]) diejenigen, die uns interessieren;
- Zeilen 16–19: [addFormatters] registriert Konverter. [DateFrConverter] wird für jeden Parameter vom Typ [LocalDate] in der Anwendung verwendet;
- Zeilen 22–25: [addArgumentResolvers] fügt der Liste der Resolver in [Spring MVC] weitere hinzu.
3.6.5. Der Controller
Die Datei [controllers/ExamplesController.java]:
- Zeile 24: ein gewöhnlicher Parameter vom Typ [LocalDate]: Nichts weist darauf hin, dass [DateFrConverter] verwendet werden soll; sein Typ legt dies fest;
- Zeile 30: Der Parameter [language] wird von [LanguageResolver] über die Annotation [@Language] bereitgestellt;
- Zeile 37: Eine Validierungsbedingung kann auch direkt auf einen Parameter einer Action angewendet werden (hier mit [@RequestParam]). [@Valid] ist nicht nötig: [Spring MVC] validiert Parameter mit einer Bedingung automatisch. Schlägt die Validierung fehl, löst es die Ausnahme [HandlerMethodValidationException] aus;
- Zeilen 46–51: Eine Methode, die mit [@ExceptionHandler] annotiert ist, ist ein Exception-Handler: Wenn eine Action des Controllers oder das Binding ihrer Parameter eine Ausnahme desselben Typs wie ihr Parameter auslöst (hier [MethodArgumentTypeMismatchException], ein Umwandlungsfehler), ruft [Spring MVC] ihn auf, statt eine eigene Fehlerantwort zu erzeugen. Was er zurückgibt, wird zur Antwort, mit dem von [@ResponseStatus] festgelegten Code: 400 ([HttpStatus.BAD_REQUEST]). Zeile 50: [getMostSpecificCause()] liefert die ursprüngliche Ausnahme – die von [DateFrConverter] ausgelöste –, die unsere Meldung enthält;
- Zeilen 54–58: Dasselbe gilt für das Scheitern der Validierung eines Parameters. [getAllErrors()] liefert die Liste der Fehler, von denen wir die Meldung des ersten übernehmen.
Ohne diese beiden Handler wäre die Antwort der JSON-Fehler von [Spring Boot], mit einer technischen englischen Meldung zum Datum, die unsere eigene nicht enthält. Ein Exception-Handler gilt nur für seinen Controller; in Beispiel 24 werden wir sehen, wie man einen für die gesamte Anwendung schreibt ([@ControllerAdvice]).
Die Ergebnisse:
Ein Datum [LocalDate] wird bei der Umwandlung in eine Zeichenkette als [2026-09-23] geschrieben (ISO-Format). Die Sprache:
Die Bedingung [@NoSpace]:
([%20] ist die Kodierung eines Leerzeichens in der URL)
3.6.6. Fazit
Das Action-Modell wird durch Binden von Daten der Anfrage aufgebaut: Parameter der URL und Formularfelder ([@RequestParam], Command-Objekt), der JSON-Body ([@RequestBody]), Header ([@RequestHeader]) und alles, was ein benutzerdefinierter Resolver liefern kann. Die Werte werden in den Typ des Parameters umgewandelt und anschließend gegen die Bedingungen von [Bean Validation] validiert, wenn das Modell mit [@Valid] annotiert ist. Ein Umwandlungsfehler bei einem [@RequestParam] oder ein ungültiges Modell ohne [BindingResult] führt zu einem 400-Fehler, ohne dass die Action ausgeführt wird: Das ist für einen JSON-Server angemessen. Bei einer HTML-Anwendung ist das Formular eine mit [@Valid] annotierte JavaBean, gefolgt von einem Parameter [BindingResult], den die Action abfragt (Beispiel 09), um das Formular mit seinen Fehlern erneut anzeigen zu können. Das ist das Thema des nächsten Kapitels.