Benutzereingabe validieren

Wir beginnen mit der Annotation @mandatory. Elemente, die mit @mandatory gekennzeichnet sind, werden auf nicht leere Eingaben geprüft: null und (abgeschnittene) leere Zeichenfolgen werden abgelehnt.

Im gezeigten Beispiel ist das Titelelement der Entität Dokumentenmappen mit @mandatoryannotiert. Wenn Sie versuchen, eine Dokumentenmappe ohne Titel anzulegen, gibt der entsprechende Request eine Antwort mit dem HTTP-Statuscode 400 (Bad Request) zurück. Die Antwort enthält eine Fehlermeldung ähnlich der folgenden:

123456
"error": {
  "code": "400",
  "message": "Value is required",
  "target": "title",
  "@Common.numericSeverity": 4
}

Die Annotation @assert.target kann für verwaltete Zu-eins-Assoziationen einer CDS-Modellentität verwendet werden. Die Annotation wird verwendet, um während CREATE - und UPDATE -Operationen zu prüfen, ob die Zielentität, auf die sich die Assoziation bezieht, vorhanden ist. Mit dieser Annotation wird also sichergestellt, dass ein Nicht-Null-Fremdschlüssel in einer Tabelle einen entsprechenden Primärschlüssel in der zugehörigen/referenzierten Zieltabelle hat.

Im gezeigten Beispiel wird der Autor der verwalteten Zu-eins-Assoziation der Entität Books mit @mandatory und @assert.targetannotiert. Die Annotation @mandatory sorgt dafür, dass ein Buchautor angegeben wird. Die @assert.target Annotation prüft auch, ob der angegebene Autor vorhanden ist.

Wenn Sie versuchen, eine neue Dokumentenmappe zu erstellen, und die in der Anforderung angegebene Autoren-ID nicht in der Datenbank vorhanden ist, wird der angeforderte CREATE-Vorgang nicht ausgeführt. Stattdessen hat die HTTP-Response den Statuscode 400 (Bad Request), wie wir bereits mit der Annotation @mandatory gesehen haben. Der Antworttext enthält eine Fehlermeldung ähnlich der folgenden. Sie zeigt auf den ungültigen Fremdschlüssel:

123456
"error": {
  "code": "400",
  "message": "Value doesn't exist",
  "target": "author_ID",
  "@Common.numericSeverity": 4
}

Die Annotation @assert.range ermöglicht die Angabe von Wertebereichen für Elemente von Modellentitäten mit Ordinaltypen, d.h. numerischen Typen oder Datums-/Zeittypen. Der Wertebereich ist als Intervall mit folgender Syntax definiert:

1
@assert.range: [min, max]

Der definierte Bereich wird als geschlossenes Intervall betrachtet, d.h. es wird geprüft, ob ein angegebener Wert größer oder gleich min und kleiner oder gleich max ist.

Für Enum-Elemente kann true angegeben werden, um mögliche Werte auf die definierten Enum-Werte einzuschränken.

Im gezeigten Beispiel hat das Genre-Element der Entität Dokumentenmappen den Datentyp Genre, bei dem es sich um einen benutzerdefinierten Typ mit Aufzählungswerten handelt. Die Annotation des Genre-Elements mit @assert.range: true stellt sicher, dass nur Werte aus der Aufzählung für dieses Element angegeben werden können, d.h. 1 oder 2.

Wenn beispielsweise beim Anlegen einer Dokumentenmappe für das Genre-Element der Wert 3 angegeben ist, wird die angeforderte CREATE-Operation nicht ausgeführt. Stattdessen hat die HTTP-Response den Statuscode 400 (Bad Request) und der Response-Body enthält eine Fehlermeldung ähnlich der folgenden:

123456
"error": {
  "code": "400",
  "message": "Value 3 is invalid according to enum declaration {1, 2}",
  "target": "genre",
  "@Common.numericSeverity": 4
}

Sehen Sie sich das Video an, um zu erfahren, wie Sie die Eingabevalidierung implementieren.