mitmario.dev

Daten anlegen

Node.js Sandbox 3 Min Lesezeit 3 BeispieleLektion 3 von 8

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.

Anlegen und die Antwort darauf
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 Location mit 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

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

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, kostenlos

Zu 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.