Abschnitt 10 · Lektion 1
Was ist Middleware?
Jede Anfrage soll ins Protokoll. Bei manchen soll geprüft werden, wer fragt, und bei allen soll die
Zeit mitlaufen. Kopierst du diese Zeilen in jede Route, stehen sie bald überall, und ausgerechnet in
der einen neuen Route fehlen sie. Die Lösung stand in Abschnitt 9 schon zweimal im Code, als
Standardfall ganz unten und als express.static, beide Male mit app.use.
Eine Middleware ist eine Funktion, die zwischen der Anfrage und der Antwort sitzt. Express sammelt alle, die angemeldet sind, in einer Liste und arbeitet sie von oben nach unten ab.
Ein Antrag wandert über drei Schreibtische
Ein Antrag geht durch ein Büro. Der erste Schreibtisch trägt ihn ins Eingangsbuch ein und schiebt ihn weiter. Der zweite prüft, ob alles ausgefüllt ist, macht einen Haken dran und schiebt ihn weiter. Der dritte bearbeitet ihn und schickt eine Antwort zurück.
Jeder Schreibtisch darf etwas ergänzen oder den Antrag zurückweisen. Wer nichts zu tun hat, reicht ihn einfach weiter.
import express from "express";
const app = express();
// Erster Schreibtisch: sieht jede Anfrage und reicht weiter.
app.use((req, res, next) => {
console.error(`${req.method} ${req.url}`);
next();
});
// Zweiter Schreibtisch: ergaenzt etwas und reicht weiter.
app.use((req, res, next) => {
req.geprueft = true;
next();
});
// Dritter Schreibtisch: antwortet und reicht nichts mehr weiter.
app.get("/daten", (req, res) => {
res.json({ geprueft: req.geprueft === true, notizen: ["Milch kaufen"] });
});
app.listen(3000); Die Signatur ist (req, res, next). Die ersten beiden kennst du aus Abschnitt 8 und 9. Das dritte
ist neu, und daran hängt der ganze Unterschied. next() heißt so viel wie „ich bin fertig, mach du
weiter“. Es antwortet nicht und beendet nichts. Es reicht nur den Staffelstab an den nächsten
Eintrag in der Liste weiter.
Sein Ergebnis hängt der zweite Schreibtisch an req, so wie man das üblicherweise macht. req
wandert die ganze Kette entlang, und alles, was später noch jemand wissen soll, gehört daran. Mehr
dazu in der nächsten Lektion.
Was passiert, wenn niemand weitergibt
import express from "express";
const app = express();
app.use((req, res, next) => {
console.log("Schreibtisch 1: weitergereicht");
next();
});
// Weder eine Antwort noch next(). Hier endet die Anfrage, ohne zu enden.
app.use((req, res, next) => {
console.log("Schreibtisch 2: liegen geblieben");
});
app.get("/daten", (req, res) => {
console.log("Schreibtisch 3: nie erreicht");
res.json({ notizen: ["Milch kaufen", "Brot holen"] });
});
app.listen(3000); Der zweite Schreibtisch ruft next() nicht auf und antwortet auch nicht. Damit passiert schlicht
nichts. Die Anfrage liegt da und wartet, bis der Aufrufer aufgibt. Im Reiter Browser lädt die
Seite und hört nicht auf damit.
Von außen sieht das aus wie das vergessene res.end aus Lektion 8.1. Der Browser dreht sein Rädchen
und curl läuft in seine Zeitgrenze. Woran es liegt, erfährst du von keinem der beiden. Auch im
Protokoll (englisch log) steht es nicht, also in den Zeilen, die der Server über jede Anfrage
schreibt. Der erste Schreibtisch hat die Anfrage ja gesehen und ordentlich notiert. Danach hört es
einfach auf.
Im Reiter Praxis läuft der Server wirklich, und dort kannst du das nachstellen. Fehlt im
tuersteher das next() am Ende, bleibt jede Anfrage mit Namen bei ihm liegen. Der erste Befehl
der Befehlsleiste, curl -s -S -m 2 "http://localhost:3000/hallo?name=Ada", gibt dann nach zwei
Sekunden auf, denn -m 2 setzt ihm diese Grenze. Ohne sie würde er warten, bis einem langweilig
wird. Im Terminal steht danach
curl: (28) Operation timed out after 2005 milliseconds with 0 bytes received. Die Millisekunden
schwanken um die 2000. Die Zeile des Protokollanten ist trotzdem geschrieben worden, im Protokoll
des Servers. Mit tail -1 /tmp/lern-web.log holst du sie ins Terminal, und da steht
GET /hallo?name=Ada.
Daran erkennst du den Fall. Die Anfrage ist angekommen und protokolliert, und trotzdem kommt nichts
zurück. Mit dem next() kommt auf denselben Befehl sofort {"gruss":"Hallo Ada"} zurück.
Eine Falle gibt es dabei. Manchmal läuft keine Sandbox, aber ein Server von vorhin steht noch, etwa aus dem letzten Prüflauf. Der antwortet dann in beiden Fällen mit dem alten Code. Das bleibt so, bis ein Klick auf Prüfen ihn mit dem neuen startet. Mit laufender Sandbox startet jede Änderung im Editor den Server neu, und der nächste Befehl trifft schon den neuen Code.
Wenn eine Anfrage hängt, fehlt irgendwo ein next() oder eine Antwort. Die Stelle findest du, wenn
du von oben Zeile für Zeile eine Ausgabe einbaust und schaust, welche als letzte noch kommt.
Es geht auch ohne eingebaute Ausgabe, im Reiter Debug. Nach einem Klick auf Aufzeichnen stehen dort
die Schritte je Anfrage untereinander. Stimmt die Reihenfolge, sind es für die Anfrage mit Namen
sechs Schritte, und alle drei Funktionen kommen dran. Ohne das next() im Türsteher sind es vier.
Der letzte steht im Türsteher, danach kommt nichts mehr. Im Ausgangsstand steht die Begrüßung oben,
und dann ist es ein einziger Schritt. Sie antwortet, und die beiden anderen kommen nie dran.
Eine Route ist auch nur eine Middleware
app.get("/daten", ...) sieht aus wie etwas völlig anderes als app.use(...), trägt aber einen
Eintrag in dieselbe Liste ein. Verschieden ist nur, wann er drankommt. Der app.get-Eintrag kommt
dran, wenn Methode und Pfad passen, ein app.use ohne Pfad bei jeder Anfrage. Für beide gilt also
dieselbe Regel.
Die Reihenfolge ist die ganze Semantik
Oben steht, was zuerst passiert. Damit ist fast alles erklärt, was mit Middleware schiefgehen kann.
import express from "express";
const app = express();
// Das Protokoll liegt hier in einer Liste statt in der Ausgabe des
// Servers, damit du es unter /protokoll nachlesen kannst.
const protokoll = [];
// Derselbe Protokollant, zweimal notiert. Einmal ganz oben.
app.use((req, res, next) => {
protokoll.push(`oben sieht ${req.url}`);
next();
});
app.get("/daten", (req, res) => res.json({ notizen: ["Milch kaufen", "Brot holen"] }));
app.get("/protokoll", (req, res) => res.json(protokoll));
// Und einmal ganz unten, unter der Route.
app.use((req, res, next) => {
protokoll.push(`unten sieht ${req.url}`);
next();
});
app.listen(3000); Nach /daten und /nix steht unter /protokoll, was die beiden Protokollanten gesehen haben. Es
ist nicht dasselbe. Der obere protokolliert beide Anfragen. Der untere sieht nur /nix, denn bei
/daten hat die Route darüber schon geantwortet, und dort endet die Kette.
Ganz oben sieht ein Protokollant alles. Ganz unten sieht er nur noch, was durchgefallen ist. Beides kann richtig sein, je nachdem, was im Protokoll stehen soll.
Trotz des unteren next() endet /nix mit 404. Nach dem letzten Eintrag in der Liste kommt nämlich
noch der eingebaute Standardfall von Express, der in Lektion 9.2 ersetzt wurde.
Warum das Express zu einem Baukasten macht
Ohne Middleware würde Express nur Pfade auf Funktionen abbilden. Mit ihr ist es ein Baukasten.
Protokoll, Rumpf lesen, statische Dateien, Anmeldung und Zeitmessung sind jeweils eine Funktion mit
drei Argumenten. Alle kommen mit app.use hinein, und die Reihenfolge bestimmt, wer was sieht.
Triffst du in einer fremden Express-Anwendung auf einen Stapel app.use-Zeilen, liest du ihn
deshalb von oben nach unten, also genau in der Reihenfolge, in der eine Anfrage ihn durchläuft.
In der Aufgabe geht es um nichts als die Reihenfolge von drei app.use-Zeilen.
Zum Mitnehmen
Express ruft die angemeldeten Middleware-Funktionen von oben nach unten auf, und jede, die nicht selbst antwortet, reicht mit next() an die nächste weiter. Eine Funktion, die weder weiterreicht noch antwortet, lässt die Anfrage hängen, und nirgends steht ein Fehler.
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.