mitmario.dev

Synthese: der handgeschriebene Server

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

Einzeln sind Statuscode, Routing und Inhaltstyp schnell erklärt. Schwierig wird es, wenn ein Server alles davon auf einmal braucht. Eine Seite für Menschen, eine API für Programme und eine ehrliche 404 für jede falsche Adresse. Dann kommt es auf die Reihenfolge an, und jeder Weg durch die Funktion muss bei einem res.end() ankommen. Fremden Code braucht es dafür nicht.

Der Ablauf, jedes Mal derselbe

  1. Server starten mit createServer und listen.
  2. Anfrage zerlegen in Methode und Pfad.
  3. Route finden, also die passende Bedingung treffen.
  4. Status und Kopfzeilen setzen, bevor der Rumpf losgeht.
  5. Rumpf senden.
  6. Abschließen mit res.end(), und zwar auf jedem Weg durch die Funktion.
Die sechs Bausteine in einer Datei
import { createServer } from "node:http";

const notizen = [
  { text: "Milch kaufen", erledigt: false },
  { text: "Brot holen", erledigt: true },
];

const server = createServer((req, res) => {
  const pfad = new URL(req.url, "http://localhost").pathname;

  if (req.method === "GET" && pfad === "/") {
    res.writeHead(200, { "Content-Type": "text/html; charset=utf-8" });
    res.end("<!doctype html><h1>Notizen</h1>");
    return;
  }

  if (req.method === "GET" && pfad === "/api/notizen") {
    res.writeHead(200, { "Content-Type": "application/json" });
    res.end(JSON.stringify({ anzahl: notizen.length, notizen }));
    return;
  }

  res.writeHead(404, { "Content-Type": "text/plain; charset=utf-8" });
  res.end("nicht gefunden");
});

server.listen(3000);

Das sind zwei Routen und ein Standardfall, und jede Zeile darin kennst du schon. Der ganze Abschnitt in knapp dreißig Zeilen.

Im Reiter Browser steht diesmal eine echte Seite, also eine Überschrift statt der Zeichen, aus denen sie besteht. text/html und application/json stehen hier zum ersten Mal im selben Server, und den Unterschied siehst du direkt. Mit /api/notizen in der Adresszeile steht dort das JSON, aus derselben Datei und nur mit einer anderen Kopfzeile. Im Terminal zeigt curl -si http://localhost:3000/gibtsnicht den Standardfall mit seiner 404.

Wo es unangenehm wird

Der Server oben funktioniert. An drei Stellen merkst du beim Schreiben aber, dass du Arbeit machst, die eigentlich niemand machen sollte.

Die erste sind Platzhalter im Pfad. Einen davon hast du in Lektion 8.5 schon zerlegt, mit split oder slice. Für eine Route geht das. Für zehn Routen mit unterschiedlich vielen Platzhaltern schreibst du dir eine Mustererkennung.

Die zweite sind Inhaltstypen für Dateien.

Die Tabelle der Inhaltstypen
import { extname } from "node:path";

// Die Tabelle, die dir spaeter jemand abnimmt.
const typen = {
  ".html": "text/html; charset=utf-8",
  ".css": "text/css; charset=utf-8",
  ".js": "text/javascript; charset=utf-8",
  ".png": "image/png",
  ".svg": "image/svg+xml",
};

for (const datei of ["seite.html", "stil.css", "logo.png", "daten.csv"]) {
  const endung = extname(datei);
  console.log(`${datei} -> ${typen[endung] ?? "application/octet-stream"}`);
}

Soll dein Server nicht nur eine Seite, sondern auch Stylesheets, Bilder und Schriften ausliefern, brauchst du diese Zuordnung für jede Endung, die vorkommt. Die Tabelle, die Express mitbringt, kennt über tausend Endungen. Niemand tippt die ab, und niemand sollte.

Die dritte sind die immer gleichen drei Zeilen. Status setzen, Inhaltstyp setzen, umwandeln und senden, in jeder einzelnen Route.

Der eigene kleine Helfer
import { createServer } from "node:http";

// Statt in jeder Route dieselben drei Zeilen: ein Helfer.
const sendeJson = (res, status, daten) => {
  res.writeHead(status, { "Content-Type": "application/json" });
  res.end(JSON.stringify(daten));
};

const server = createServer((req, res) => {
  const pfad = new URL(req.url, "http://localhost").pathname;

  if (pfad === "/api/zeit") {
    sendeJson(res, 200, { stunde: 12 });
    return;
  }

  if (pfad === "/api/notizen") {
    sendeJson(res, 200, { anzahl: 2 });
    return;
  }

  sendeJson(res, 404, { fehler: "nicht gefunden" });
});

server.listen(3000);

Alle Routen rufen jetzt den Helfer auf, und der Aufbau der Antwort steht nur noch an einer Stelle. Auch der Standardfall geht durch denselben Helfer, das siehst du mit /nix in der Adresszeile.

Ein eigener Helfer ist der naheliegende Ausweg, und er ist auch gut. Er spart sofort Zeilen und Flüchtigkeitsfehler. Denkt man das weiter, kommt als Nächstes einer für HTML, dann einer für Weiterleitungen, dann eine Funktion, die Pfade mit Platzhaltern vergleicht, und schließlich eine Liste von Routen statt einer if-Kette. Dann hast du irgendwann Express gebaut, nur schlechter getestet.

Was Abschnitt 9 abnimmt

Um diese drei Stellen geht es in Abschnitt 9. Express bringt Routing mit Platzhaltern mit, setzt Inhaltstypen von selbst, schickt JSON in einem Aufruf und liefert statische Dateien samt passendem Typ aus einem Ordner.

Ab jetzt weißt du bei jeder dieser Erleichterungen, was sie ersetzt. app.get("/api/kurse/:slug", ...) ist für dich eine Bedingung, ein split und eine Längenprüfung, die jemand anderes schon geschrieben hat. In Lektion 9.6 steht der Server aus der Aufgabe noch einmal da, und daneben derselbe mit Express.

Die Aufgabe ist ein Server mit Seite und API, und das Routing dazwischen schreibst du.

Zum Mitnehmen

Ein Server von Hand braucht sechs Schritte, von createServer bis zu einem res.end() auf jedem Weg. Platzhalter, Inhaltstypen und die immer gleichen Zeilen je Route sind die Stellen, die Express abnimmt.

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.