Unterschiede

Hier werden die Unterschiede zwischen zwei Versionen angezeigt.

--- modul:m290_guko:learningunits:lu16:theorie:b_update_delete [2025/12/18 13:15] – gkoch
+++ modul:m290_guko:learningunits:lu16:theorie:b_update_delete [2026/01/02 23:06] (aktuell) – gkoch
@@ Zeile 9: / Zeile 9: @@
   * Sie können die Endpoints mit **Postman** testen.
-<WRAP center round info 80%>
-Diese Learning Unit baut auf Ihrer LU16-Seite auf. Sie verwenden weiterhin das gleiche ''posts''-Array (Dummy-Daten) und arbeiten ohne Datenbank.
-</WRAP>
@@ Zeile 46: / Zeile 43: @@
   const id = Number(req.params.id);
-  // Post suchen
+  // Post suchen nach der ID aus dem Request im posts-Array (Liste)
   const post = posts.find(p => p.post_id === id);
@@ Zeile 53: / Zeile 50: @@
   }
-  // Neue Werte aus dem Body lesen
+  // Alle Felder werden erwartet (PUT ersetzt alles)
-  const userId = req.body.user_id;
+  const user_id = req.body.user_id;
   const title = req.body.title;
-  const imageUrl = req.body.image_url;
+  const image_url = req.body.image_url;
   const description = req.body.description;
   const likes = req.body.likes;
-  // Validierung: mindestens ein Feld muss vorhanden sein
+  // Validierung: sind wirklich alle Felder vorhanden?
+  // likes kann 0 sein -> deshalb auf undefined prüfen
   if (
-    userId === undefined &&
+    user_id === undefined ||
-    title === undefined &&
+    title === undefined ||
-    imageUrl === undefined
+    image_url === undefined ||
+    description === undefined ||
+    likes === undefined
+  ) {
+    return res.status(400).send('Bitte user_id, title, image_url, description und likes mitsenden (PUT ersetzt alles).');
+  }
+  // Post überschreiben
+  post.user_id = user_id;
+  post.title = title;
+  post.image_url = image_url;
+  post.description = description;
+  post.likes = likes;
+  // Antwort: 200 OK + aktualisiertes Objekt
+  res.status(200).json(post);
+});
+</code>
+</WRAP>
+==== Test mit Postman (PUT) ====
+{{:modul:m290_guko:learningunits:lu16:theorie:screenshot_2025-12-18_at_13.34.19.png?direct&900| Screenshot: einen Post abändern.}}
+  - Methode: ''PUT''
+  - URL: ''http://localhost:3000/api/posts/2''
+  - Tab ''Body'' → ''raw'' → ''JSON''
+  - Beispiel-Body:
+<WRAP box round center 80%>
+<code json>
+{
+  "title": "Sunset Vibes (updated)",
+  "likes": 99
+}
+</code>
+</WRAP>
+Erwartung:
+  * Status ''200 OK''
+  * JSON-Objekt des aktualisierten Posts (''post_id: 2'') mit neuem ''title'' und ''likes''
+  * Danach ''GET /api/posts/2'' testen → Änderungen sollten sichtbar sein
+===== DELETE – Post löschen (DELETE /api/posts/:id) =====
+==== Was bedeutet DELETE? ====
+Mit ''DELETE'' entfernen Sie einen Datensatz.
+Der Client schickt dazu einen Request an:
+  * ''DELETE /api/posts/:id''
+Der Server sucht den passenden Post und entfernt ihn aus der Liste.
+==== Code: DELETE-Route ====
+<WRAP box round center 80%>
+<code javascript>
+// DELETE – Post löschen
+app.delete('/api/posts/:id', (req, res) => {
+  const id = Number(req.params.id);
+  // Index suchen (praktisch fürs Löschen)
+  const index = posts.findIndex(p => p.post_id === id);
+  if (index === -1) {
+    return res.status(404).send('Post nicht gefunden');
+  }
+  // Löschen: splice gibt ein Array zurück -> [0] ist das gelöschte Objekt
+  const deletedPost = posts.splice(index, 1)[0];
+  // Antwort: 200 OK + gelöschter Post (zur Kontrolle)
+  res.status(200).json(deletedPost);
+});
+</code>
+</WRAP>
+==== Test mit Postman (DELETE) ====
+{{:modul:m290_guko:learningunits:lu16:theorie:screenshot_2025-12-18_at_13.40.40.png?direct&900| Screenshot: einen Post aus der Liste löschen.}}
+  - Methode: ''DELETE''
+  - URL: ''http://localhost:3000/api/posts/1''
+Erwartung:
+  * Status ''200 OK''
+  * JSON-Objekt des gelöschten Posts
+Danach:
+  * ''GET /api/posts'' → der gelöschte Post sollte nicht mehr in der Liste sein
+  * ''GET /api/posts/1'' → sollte ''404 Not Found'' liefern
+===== Typische Fehlerquellen =====
+  * ''req.params.id'' ist immer ein String → mit ''Number(...)'' oder ''parseInt(...)'' umwandeln.
+  * Bei ''PUT'' vergessen viele, den Request-Body als JSON zu senden → in Postman unbedingt ''raw'' + ''JSON'' wählen.
+  * Bei ''PUT'' und ''DELETE'' immer prüfen: existiert das Objekt? → sonst ''404'' zurückgeben.
+  * Bei ''PUT'': wenn keine Felder im Body sind → ''400'' zurückgeben (sonst „Update ohne Update“).
+===== Ausblick =====
+Sie können jetzt CRUD auf API-Ebene komplett:
+  * Create → ''POST /api/posts''
+  * Read → ''GET /api/posts'' und ''GET /api/posts/:id''
+  * Update → ''PUT /api/posts/:id''
+  * Delete → ''DELETE /api/posts/:id''
+In der nächsten Unterrichtseinheit ersetzen wir die lokale Liste ''posts'' durch eine echte MySQL-Tabelle und führen dieselben Operationen über SQL aus.