1. Einführung
Das PDF des Dokuments finden Sie |HIER|.
Die Codes des Dokuments finden Sie |HIER|.
Dieses Dokument ist ein Produkt der KI Claude von Anthropic. Sein Ziel ist es, das Dokument *Einführung in ASP.NET MVC anhand von Beispielen* (2013) an das Web-Framework [NestJS] anzupassen:
- das Framework [ASP.NET MVC] und die Sprache [C#] werden durch das Framework [NestJS] und die Sprache [TypeScript] ersetzt;
- die [Razor]-Views werden durch [Handlebars]-Views ersetzt;
- [Entity Framework] wird beim Datenzugriff durch einen ORM, [TypeORM], und eine [MySQL]-Datenbank ersetzt.
Das Dokument folgt der Struktur des ursprünglichen Kurses: zunächst zahlreiche kleine Projekte, die sich jeweils auf ein einziges Konzept konzentrieren, gefolgt von einer umfassenden Fallstudie – einer Webanwendung zur Terminplanung in einer Arztpraxis – mit durchgehend kommentierten Dateien. Das Kapitel des ursprünglichen Kurses zu den Grundlagen der Webprogrammierung (das HTTP-Protokoll, die Sprache HTML) wurde nicht übernommen: Diese Grundlagen werden als bekannt vorausgesetzt.
1.1. Die Rolle von NestJS in einer Webanwendung
Eine Webanwendung wird häufig in Schichten aufgebaut, wobei jede Schicht nur mit den benachbarten Schichten kommuniziert:

- die Web-Schicht empfängt die HTTP-Anfragen des Browsers und liefert ihm HTML-Seiten zurück. [NestJS] unterstützt uns beim Schreiben dieser Schicht;
- die Geschäftsschicht enthält die Geschäftsregeln der Anwendung (z. B. „Ein Patient darf nur einen anstehenden Termin haben“). Sie weiß nichts vom Web: Sie könnte ebenso gut eine Kommandozeilenanwendung bedienen;
- die Datenzugriffsschicht ([DAO]-Schicht, von [Data Access Object]) liest aus der Datenbank und schreibt in sie. Wir verwenden den ORM [TypeORM] ([Object Relational Mapper]), der die Zeilen der Tabellen auf [TypeScript]-Objekte abbildet.
Die Web-Schicht selbst folgt dem [MVC] -Modell ([Model – View – Controller]):
- der Controller (C) ist eine Klasse, deren Methoden – Actions genannt – jeweils einen bestimmten Anfragetyp bearbeiten (zum Beispiel [GET /schedule]). Eine Action liest die Anfrageparameter, ruft die Geschäftsschicht auf und wählt anschließend die anzuzeigende View aus;
- das Modell (M) ist die Menge der Daten, die die Action an die View übergibt: ein einfaches [JavaScript]-Objekt;
- die View (V) ist eine [Handlebars]-Datei (Erweiterung [.hbs]): eine HTML-Datei, in der [{{...}}]-Tags durch Daten aus dem Modell ersetzt werden.
Die Verarbeitung einer Anfrage folgt den nummerierten Schritten im Diagramm:
- 1: Der Browser sendet eine HTTP-Anfrage, zum Beispiel [GET /schedule?doctorId=1&day=2026-09-24];
- 2: [NestJS], das auf dem Webserver [Express] aufbaut, wählt die Action aus, die für diese Anfrage zuständig ist: Das ist das Routing. Bevor die Anfrage dort ankommt, kann sie durch Middleware, Guards, Interceptors und Pipes laufen, die wir in den folgenden Kapiteln untersuchen;
- 3: Die Action fordert die benötigten Daten von der Geschäftsschicht an;
- 4: Sie erstellt das Modell für die View und gibt an, welche View es anzeigen soll;
- 5: Die View-Engine [Handlebars] erzeugt die HTML-Seite, die [NestJS] an den Browser zurückliefert.
[NestJS] ist ein [Node.js]-Framework, das in [TypeScript] geschrieben ist. Es baut auf den Konzepten der Frameworks [Spring] ([Java]) und [Angular] auf: Dekoratoren ([@Controller], [@Get], [@Injectable]...) beschreiben die Rolle jeder Klasse, und die Dependency Injection versorgt jedes Objekt mit den Abhängigkeiten, die es benötigt. Es wird häufig verwendet, um Server zu schreiben, die JSON an einen [JavaScript]-Client ([Angular], [React], [Flutter]...) liefern. Dieses Dokument verwendet es, um eine klassische Webanwendung zu schreiben: Der Server erzeugt die HTML-Seiten, und der Browser zeigt sie lediglich an.
1.2. Verwendete Werkzeuge
Die Beispiele wurden mit den folgenden Werkzeugen geschrieben und getestet (ihre Installation ist im Anhang beschrieben):
- [Node.js] 20 und sein Paketmanager [npm];
- der Editor [Visual Studio Code];
- ein aktueller Browser ([Chrome], [Firefox], [Edge]);
- das Kommandozeilenwerkzeug [curl], das rohe HTTP-Antworten anzeigt (es ist in [Windows] 10 und 11 enthalten);
- das DBMS [MySQL] (oder [MariaDB]), zum Beispiel das von [Laragon] unter [Windows], ab dem Kapitel zum Datenzugriff.
Die Bibliotheksversionen sind die in der Datei [package.json] im Beispielordner: [NestJS] 10, [TypeScript] 5, [hbs] 4 ([Handlebars]), [class-validator] 0.14, [TypeORM] 0.3, [Bootstrap] 5.
1.3. Beispiele
Die Beispiele liegen in einem Ordner namens [examples], mit einem Unterordner pro Beispiel:
Alle Beispiele verwenden dieselben Bibliotheken, die in [examples/package.json] deklariert sind. Sie werden einmalig in einer Konsole installiert, die im Ordner [examples] geöffnet ist. Öffnen Sie in VSCode den Ordner „examples“:

geben Sie dann in einem in VSCode integrierten Terminal den Befehl ein
Jedes Beispiel hat dann die minimale Struktur eines [NestJS]-Projekts:
- [src]: der [TypeScript]-Code;
- [views]: die Views von [Handlebars] (ab Kapitel 4);
- [nest-cli.json]: die Konfiguration des Kommandozeilenwerkzeugs für [NestJS];
- [tsconfig.json]: die Konfiguration des [TypeScript]-Compilers.
Um ein Beispiel auszuführen, öffnen Sie eine Konsole im

und geben Sie ein:
[npx] findet das Werkzeug [nest] im Ordner [node_modules] des übergeordneten Ordners. [nest start] kompiliert den [TypeScript] -Code in den Ordner [dist] und führt dann [dist/main.js] aus. Mit der Option [--watch] wird der Code neu kompiliert und der Server neu gestartet, sobald eine [.ts]-Datei geändert wird:
Alle Beispiele lauschen auf Port 3000: Es kann immer nur eines gleichzeitig laufen. Beenden Sie den Server in der Konsole mit [Ctrl-C].
Die Datei [tsconfig.json] ist für alle Beispiele dieselbe:
Kommentieren wir diese Datei:
- Zeile 3: Der kompilierte Code verwendet die Module [CommonJS] von [Node.js] ([require]);
- Zeile 4: Der erzeugte Code ist aktuelles [JavaScript] (ES2022), das von [Node.js] 20 unterstützt wird;
- Zeilen 6–7: Der Quellcode liegt in [src], der kompilierte Code in [dist];
- Zeilen 9–10: erforderlich für [NestJS]. Dekoratoren ([@Controller]...) sind ein Feature von [TypeScript] , das aktiviert werden muss, und [emitDecoratorMetadata] bewahrt im kompilierten Code die Typen der Konstruktor- und Methodenparameter: Nur dadurch weiß [NestJS] , welches Objekt in einen Konstruktor injiziert werden soll;
- Zeile 12: Der Compiler meldet die Verwendung eines Werts, der [null] oder [undefined] sein kann;
- Zeile 13: Deklarationsdateien von Bibliotheken werden nicht geprüft (schnellere Kompilierung).
Die Datei [nest-cli.json] ist ebenfalls allen Beispielen gemeinsam:
- Zeile 4: Der Quellcode liegt in [src];
- Zeile 6: Der Ordner [dist] wird vor jeder Kompilierung geleert (eine aus [src] gelöschte Datei hinterlässt keine veraltete kompilierte Kopie).
1.4. Inhalt des Dokuments
Das Dokument ist wie folgt aufgebaut:
Kapitel | Inhalt | Beispiele |
Controller, Actions, | Vom Browser zur Action: Routen, Antworten, Weiterleitungen, Module | 01 bis 06 |
Das Action-Modell | Anfrageparameter: Konvertierung, Validierung, POST-Formulare | 07 bis 12 |
Die View und ihr Modell | Handlebars, Templates, Partial Views, Helper, Formulare, Validierung, PRG | 13 bis 21 |
Internationalisierung | Eine Anwendung auf Französisch und Englisch | 22 |
Datenbereiche (Scopes) | Anwendung, Anfrage, Client | 23 |
Der Lebenszyklus einer Anfrage | Middleware, Guard, Interceptor, Pipe, Exception-Filter | 24 |
Authentifizierung und Autorisierung | JWT in einem Cookie, Rollen, CAPTCHA, Versuchsbegrenzung | 25–27 |
Geschichtete Architektur | Web / Geschäftslogik / DAO mit TypeORM und MySQL | 28 |
Fallstudie | Die Anwendung RdvMedecins, Datei für Datei erläutert | - |
Jedes Beispiel führt nur wenige neue Konzepte ein, und die Kapitel bauen aufeinander auf: Am besten lesen Sie sie der Reihe nach. Die Fallstudie dagegen greift auf alle Konzepte der vorangegangenen Kapitel zurück: Wo es sinnvoll ist, verweist ihr Kommentar auf das Beispiel, in dem das Konzept eingeführt wurde.