Swift Vapor — Add an Edit Endpoint to your API
Zusammenfassung
Kurz
Der vollständige Bericht erläutert einen Vapor-PUT-Endpunkt, der ein Beispielmodell anhand seiner ID findet, dessen Felder aktualisiert und den Datensatz speichert; fehlt der Eintrag, wird „Not Found“ ausgelöst. Die Migration wird vorausgesetzt, und PATCH wird als mögliche Alternative erwähnt, aber nicht weiter erklärt.
Mittel
Der vollständige Bericht zeigt anhand eines Swift-Vapor-Beispiels, wie ein Datenbankeintrag über einen PUT-Endpunkt aktualisiert werden kann. Das Fluent-Modell `ExampleObject` hat eine Zeichenketten-ID sowie optionale Felder für Name und Bildlink. Die Migration wird in der Anleitung ausgelassen und als bereits vorhandene Grundlage vorausgesetzt.
Der Endpunkt `/api/example-object` dekodiert den Anfrageinhalt als dieses Modell und sucht anhand seiner ID nach einem vorhandenen Eintrag. Wird keiner gefunden, löst der Code einen „Not Found“-Fehler aus. Andernfalls übernimmt er die Werte aus der Anfrage in den gefundenen Datensatz, speichert diesen und antwortet mit „OK“. Der Autor erwähnt, dass der Endpunkt bei Bedarf auch als PATCH statt PUT eingerichtet werden könne. Der Bericht erläutert jedoch nicht, wie sich das Verhalten dabei unterscheiden sollte, und behandelt weder Migration noch Validierung oder Zugriffsschutz.
Ausführlich lesen
Der vollständige Bericht ist eine kurze Anleitung von Chase dazu, wie sich in einer Swift-Vapor-API ein vorhandener Datenbankeintrag bearbeiten lässt. Er stellt PUT als übliches Verfahren zum Aktualisieren von Daten vor und merkt an, dass sich der Endpunkt je nach Projekt auch als PATCH anlegen lässt.
Als Beispiel dient das Fluent-Modell `ExampleObject`. Es enthält eine benutzerdefinierte Zeichenketten-ID sowie optionale Felder für einen Namen und einen Bildlink. Die zugehörige Datenbankmigration wird ausdrücklich ausgelassen; der Bericht setzt also voraus, dass das Modell und die Datenbankgrundlage bereits vorhanden sind.
Die Anleitung ergänzt einen PUT-Endpunkt unter `/api/example-object` in einem Vapor-Controller. Beim Aufruf wird der Anfrageinhalt zunächst als `ExampleObject` dekodiert. Anschließend sucht der Code anhand der übermittelten ID nach dem bestehenden Datensatz. Findet er keinen, wirft er einen HTTP-Fehler mit dem Status „Not Found“. Findet er einen, übernimmt er die ID und die beiden Felder aus dem übermittelten Objekt, speichert den geänderten Datensatz in der Datenbank und gibt bei Erfolg den Status „OK“ zurück.
Damit beschreibt der Beitrag einen konkreten Ablauf zum Ersetzen der gezeigten Modellwerte. Er behandelt weder die Erstellung der Migration noch weitere Aspekte wie Validierung, Zugriffsschutz oder ein abweichendes Verhalten für PATCH. Solche Themen werden im Bericht nicht erläutert; die Anleitung beschränkt sich auf das Beispielmodell und den grundlegenden Update-Endpunkt.
Gegengeprüft von Claude Haiku 5.5: kleine Mängel
Luna hat zwei Zusammenfassungen (kurz und mittel) geliefert; beide wurden geprüft. Die kurze ist inhaltlich treu. In der mittleren steht, der Bericht behandle keine Migration, obwohl er diese selbst erwähnt und ausdrücklich auslässt; dies ist der Hauptmangel. Da keine Sammel- oder Teilfragen angegeben wurden, ist die Einordnung leer.
Im Bericht, aber nicht in der Zusammenfassung
- Die ID des Modells ist benutzerdefiniert (Custom ID), und der Bericht verweist dafür auf einen eigenen Artikel.
Wie die Modelle den Bericht einordnen
Ansicht
Filter
Kein Modell sieht bei diesem Bericht einen Bezug zu einer der 44 Sammelfragen.