Abschnitt 11 · Lektion 3
Daten anlegen
Ein neuer Eintrag hat noch nicht, was ein Buch beim Lesen schon hatte, nämlich eine Adresse und eine Nummer. Damit sind drei Fragen offen. Wohin geht die Anfrage, was antwortet der Server darauf, und wer vergibt die Nummer? Beantwortet das jede Route anders, muss am Ende jeder Aufrufer nachfragen.
POST geht auf die Sammlung
Der POST geht an die Sammlung /buecher und nicht an /buecher/5, denn /buecher/5 gibt es noch
nicht. Die Adresse entsteht erst mit dem Eintrag, und wer sie zum Anlegen schon kennen müsste, hätte
den Eintrag ja bereits.
import express from "express";
const app = express();
app.use(express.json());
// Ein POST gibt es in der Adresszeile nicht, deshalb steht der Befehl
// dafuer hier.
app.get("/", (req, res) =>
res.type("text/plain").send(
`curl -si -X POST -H "Content-Type: application/json" -d '{"text":"Milch kaufen"}' http://localhost:3000/notizen\n`
)
);
const notizen = [{ id: 1, text: "Steuer abgeben" }];
let naechsteId = 2;
app.post("/notizen", (req, res) => {
const notiz = { id: naechsteId++, text: req.body.text };
notizen.push(notiz);
// 201 statt 200, die Adresse des neuen Eintrags als Kopfzeile, und der
// Eintrag selbst im Rumpf. Danach weiss der Aufrufer alles.
res.status(201).location(`/notizen/${notiz.id}`).json(notiz);
});
app.listen(3000); Der Befehl für den POST steht auf der Seite, und mit -i zeigt curl auch die Kopfzeile
Location.
Was zurückkommt
In die Antwort gehören drei Dinge.
- Der Statuscode 201 statt 200. Beide heißen „hat geklappt“. 201 heißt zusätzlich „dabei ist etwas Neues entstanden“, und daran kann ein Aufrufer festmachen, ob er seine Ansicht aktualisiert.
- Der neue Eintrag im Rumpf. Er enthält Felder, die der Aufrufer nicht mitgeschickt hat, allen voran die Kennung. Ohne sie müsste er die Liste neu holen und raten, welcher Eintrag der neue ist.
- Die Kopfzeile
Locationmit der Adresse, unter der der Eintrag ab jetzt liegt.res.location()setzt sie,res.set("Location", …)täte dasselbe.
Ein Programm muss mit Location keinen Pfad zusammenbauen. Es liest ihn ab.
Die Nummer im Rumpf kennst du aus dem JavaScript-Kurs. Im letzten Beispiel der Lektion „Daten schicken“ stand nach dem Speichern „Gespeichert unter der Nummer 17.“ da. Dort hat eine Funktion den Server nachgespielt, hier kommt die Nummer von einem echten.
Zweimal abgeschickt sind zwei Einträge
import express from "express";
const app = express();
app.use(express.json());
const notizen = [{ id: 1, text: "Steuer abgeben" }];
let naechsteId = 2;
app.get("/notizen", (req, res) => {
res.json({ anzahl: notizen.length, daten: notizen });
});
app.post("/notizen", (req, res) => {
const notiz = { id: naechsteId++, text: req.body.text };
notizen.push(notiz);
res.status(201).location(`/notizen/${notiz.id}`).json(notiz);
});
app.listen(3000); Im Reiter Browser steht der Bestand. Nach zwei gleichen POST und einem Neuladen stehen dort drei
Notizen, zwei davon neu.
Jeder POST legt etwas an, auch der zweite mit demselben Rumpf. Das ist kein Fehler, so ist
POST /notizen gebaut.
Ein zweiter Klick auf den Absenden-Button schickt dieselbe Anfrage noch einmal, genauso wie ein Client, der nach einem Abbruch von selbst wiederholt. Der Server kann nicht wissen, dass die zweite ein Versehen war. So entstehen doppelte Einträge. Bei den Methoden aus Lektion 11.4 ist das anders.
Wer die Kennung vergibt
import express from "express";
const app = express();
app.use(express.json());
const buecher = [{ id: 1, titel: "Node in der Praxis" }];
let naechsteId = 2;
app.get("/buecher", (req, res) => {
res.json({ daten: buecher });
});
app.get("/buecher/:id", (req, res) => {
const buch = buecher.find((eintrag) => eintrag.id === Number(req.params.id));
if (buch === undefined) {
return res.status(404).json({ fehler: "nicht gefunden" });
}
res.json(buch);
});
// Der Aufrufer bestimmt die Kennung. Sieht bequem aus und ist es nicht.
app.post("/vom-aufrufer", (req, res) => {
const buch = { id: req.body.id, titel: req.body.titel };
buecher.push(buch);
res.status(201).json(buch);
});
// Der Server bestimmt sie. Eine Zeile mehr, ein Problem weniger.
app.post("/vom-server", (req, res) => {
const buch = { id: naechsteId++, titel: req.body.titel };
buecher.push(buch);
res.status(201).json(buch);
});
app.listen(3000); Beide Wege liegen nebeneinander, und nach dem Neuladen steht im Reiter Browser, was im Bestand gelandet ist.
Die erste Route lässt den Aufrufer bestimmen, welche Nummer sein Eintrag bekommt. Er schickt die 1,
die es schon gibt, und danach liegen zwei Bücher unter derselben Kennung. /buecher/1 findet das
erste und liefert es aus. Der neue Eintrag ist da, aber über seine eigene Adresse nicht mehr
erreichbar.
In diesem Kurs vergibt der Server die Kennung. Der Aufrufer erfährt sie, und deshalb steht sie
in der Antwort und nicht in der Anfrage. Es gibt auch APIs, in denen der Aufrufer sie wählt, meist
als lange zufällige Kennung mit PUT, und dann muss der Server eine doppelte abweisen. Mit einem
Zähler, den der Aufrufer bestimmt, geht es nie gut.
Der Zähler naechsteId ist die einfachste denkbare Umsetzung und hält so lange, wie der Prozess
läuft. Ab Abschnitt 12 übernimmt das eine Datenbank.
In der Aufgabe bekommt der Bücherserver seine Anlegeroute, mit fortlaufender Kennung und allem, was in die Antwort gehört.
Zum Mitnehmen
Ein POST geht an die Sammlung, und die Antwort ist 201 mit dem neuen Eintrag im Rumpf und seiner Adresse in Location. Die Kennung vergibt der Server, und ein POST, der zweimal ankommt, legt zweimal an.
Jetzt du
Basis Konto, kostenlosZu dieser Lektion gehört eine Aufgabe. Du schreibst den Code selbst, und nach jedem Lauf sagt dir eine Prüfliste, was schon stimmt.
Dafür brauchst du das Basis Konto. Es kostet nichts, und ein Passwort gibt es auch nicht.
In diesem Kurs läuft dein Code auf einem Server. Dafür hat das Basis Konto 1 Stunde im Monat, mehr Zeit gibt es mit dem Premium Konto.
Was in dieser Lektion steckt
-
Artikel mit 3 Beispielen zum Ausprobieren
Steht hier, ohne Konto lesbar.
-
Aufgabe, dein Code läuft auf einem Server
Öffnet sich mit dem Basis Konto.