3. Kapitel 2 - Einführung in [NestJS]
3.1. Quellen
Dieses Kapitel stützt sich auf die folgenden Quellen:
- die offizielle [NestJS]-Website: nestjs.com und ihre Dokumentation docs.nestjs.com;
- das GitHub-Repository des Frameworks: github.com/nestjs/nest.
3.2. Die Rolle von [NestJS] in einer Webanwendung
[NestJS] ist ein in TypeScript geschriebenes Node.js-Framework zum Bau der Serverseite einer Webanwendung – meist einer REST-API (JSON). Es erfindet die Verarbeitung des HTTP-Protokolls nicht neu: Standardmäßig stützt es sich auf Express, ein schlichteres Node.js-Framework, das rohe HTTP-Anfragen entgegennimmt und beantwortet. [NestJS] setzt darauf auf und bietet eine Code-Organisation, die weder Node.js noch Express von sich aus vorgeben: Aufteilung in Module, Controller und Services, Dependency Injection, Dekoratoren …
Seine Architektur ist stark von [Angular] inspiriert (Dekoratoren, Module, Dependency Injection) – eine Ähnlichkeit, die Leser der [Angular]-Version dieses Kurses auf der Clientseite wiedererkennen werden.
[NestJS] ist in erster Linie darauf ausgelegt, JSON-Antworten zu erzeugen: Standardmäßig wird alles, was eine Controller-Methode zurückgibt, automatisch in JSON umgewandelt und ohne besondere Konfiguration an den Client gesendet.
3.3. Das Entwicklungsmodell von [NestJS]
Drei Konzepte bilden die Struktur einer [NestJS]-Anwendung:
- Module (@[Module]-Dekorator): Ein Modul fasst eine Menge zusammengehöriger Funktionen zusammen – es deklariert, welche Controller und Services zu ihm gehören, welche anderen Module es benötigt und was es anderen zur Verfügung stellt. Eine [NestJS]-Anwendung geht immer von einem Wurzelmodul aus, [AppModule], das alle anderen Module des Projekts zusammenführt;
- Controller (@[Controller]-Dekorator): Ein Controller ist der Einstiegspunkt der Anwendung – eine Klasse, in der jede Methode HTTP-Anfragen zu einer bestimmten URL entgegennimmt und eine Antwort an den Client zurückgibt;
- Provider (Dekorator @[Injectable]): Ein Provider ist eine gewöhnliche Klasse, die typischerweise für die Geschäftslogik oder den Datenzugriff zuständig ist und die [NestJS] automatisch erzeugen und jedem Controller oder Service, der sie benötigt, bereitstellen (d. h. „injizieren“) kann.
In der Praxis deklariert eine Klasse, die einen Provider benötigt, diesen einfach als Parameter ihres Konstruktors – [NestJS] erzeugt die benötigte Instanz und übergibt sie automatisch, ohne dass Sie jemals selbst new schreiben müssen: Dies nennt man Dependency Injection über den Konstruktor, ein Vorgehen, das in NestJS fast immer verwendet wird.
3.4. Ein erstes Beispiel: das Miniprojekt „hello“
Zur Festigung dieser drei Konzepte hier ein sehr kleines [NestJS]-Projekt, unabhängig von der Fallstudie (eine einzige Route /hello), das Sie wie folgt erstellen können (geben Sie diese Befehle in einem leeren Ordner ein, den Sie in VSCode geöffnet haben [File/Open Folder]. Diese Befehle erstellen einen Ordner namens [hello-nest]):

Dieser Befehl generiert ein Projekt mit den folgenden wesentlichen Dateien: [src/main.ts], src/app.module.ts, src/app.controller.ts, src/app.service.ts. Allein diese vier Dateien veranschaulichen die Architektur einer [NestJS]-Anwendung: ein Einstiegspunkt ([main.ts]), ein Wurzelmodul (app.module.ts), ein Controller (app.controller.ts) und ein Service (app.service.ts).
3.4.1. Der Service
// src/app.service.ts
import { Injectable } from '@nestjs/common';
@Injectable()
export class AppService {
getHello(): string {
return 'Hello World!';
}
}
- Zeile 2: Jedes verwendete Element wird explizit importiert; hier wird [Injectable] aus [@nestjs/common] importiert, dem Modul, das die meisten Dekoratoren und Hilfsklassen von [NestJS] enthält;
- Zeile 4: Ein Dekorator ist eine Annotation, die unmittelbar über einer Klasse, einer Methode oder einem Parameter in TypeScript steht (mit vorangestelltem @-Zeichen) und deren Verhalten ändert oder erweitert, ohne ihren Code zu ändern – der Mechanismus, auf dem praktisch das gesamte NestJS-Vokabular beruht. @[Injectable]() kennzeichnet diese Klasse als Provider: [NestJS] erzeugt sie selbstständig und stellt sie jeder anderen Klasse, die sie in ihrem Konstruktor anfordert, automatisch bereit, ohne dass jemals new [AppService]() geschrieben werden muss;
- Zeile 6: : string deklariert den Rückgabetyp – eine TypeScript-spezifische Funktion, die es in JavaScript nicht gibt.
3.4.2. Der Controller
- Zeile 5: @Controller() dekoriert die folgende Klasse und macht sie zu einem Controller: NestJS sendet ihr die HTTP-Anfragen, die zu ihren Routen gehören. Das Argument in Klammern ist ein optionales Präfix, das allen Routen der Klasse vorangestellt wird – hier ist es leer: Die Route „hello“ antwortet daher direkt unter /hello;
- Zeile 7: Der Konstruktor deklariert einen Parameter appService vom Typ [AppService], dem der TypeScript-Modifikator private readonly vorangestellt ist, der ihn in einer einzigen Zeile deklariert und als Eigenschaft der Instanz registriert (`this.appService`). [NestJS] stellt fest, dass der Controller einen [AppService] benötigt, erzeugt eine Instanz davon (eine einzige, von der gesamten Anwendung gemeinsam genutzte Instanz) und stellt sie hier automatisch bereit: Das ist die zuvor erwähnte Dependency Injection über den Konstruktor;
- Zeile 9: [@Get]('hello') ordnet die folgende Methode der Route HTTP GET /hello zu: Dieser Dekorator macht die Aktion unter der testbaren Adresse http://localhost:3000/hello erreichbar, sobald der Server läuft. Für die anderen HTTP-Verben gibt es entsprechende Dekoratoren: @[Post](), @Put(), @Delete(), @Patch() (in der Fallstudie verwenden wir @[Post]() für /addAppointment und /deleteAppointment). Beachten Sie, dass in Zeile 10 der Methodenname [getHello] unerheblich ist. Er könnte beliebig lauten;
- Zeile 11: Der Controller delegiert die Arbeit an den injizierten Service, anstatt die Antwort selbst zu programmieren: Er bleibt eine einfache Routing-Schicht, während die Geschäftslogik im Service liegt – ein Prinzip, das wir in der Fallstudie in Kapitel 3 in größerem Maßstab sehen werden.
3.4.3. Das Modul
- Zeile 6: @[Module]({...}) dekoriert die folgende Klasse und macht sie zu einem Modul: Es fasst einen zusammenhängenden Teil der Anwendung zusammen und deklariert in dem als Argument übergebenen Objekt, woraus er besteht. Vier Eigenschaften sind möglich: controllers (die von diesem Modul bereitgestellten Controller), providers (die von diesem Modul bereitgestellten Services, die innerhalb des Moduls zur Injektion zur Verfügung stehen), imports (die anderen Module, von denen dieses abhängt) und exports (die Provider, die dieses Modul den Modulen zur Verfügung stellt, die es importieren);
- Ohne die Zeile `controllers: [AppController]` würde `[NestJS]` diesen Controller ignorieren, und seine Routen würden auf keine Anfragen antworten; ohne `providers: [AppService]` würde die Dependency Injection des Controllers beim Start fehlschlagen.
3.4.4. Ausführung
Geben Sie mit VSCode in einem im Stammverzeichnis des Ordners [hello-nest] gestarteten Terminal den folgenden Befehl ein:
Wenn Sie in einem Browser http://localhost:3000/hello öffnen, erhalten Sie die folgende Antwort:

3.5. Provider und Dependency Injection
Eine mit @Injectable annotierte Klasse ist ein Provider: [NestJS] weiß, wie sie zu instanziieren ist, und injiziert sie automatisch überall dort, wo sie in einem Konstruktor angefordert wird, sofern sie im providers-Array eines Moduls aufgeführt ist. Standardmäßig ist ein [NestJS]-Provider ein Singleton: Beim Start der Anwendung wird eine einzige Instanz erzeugt, und dieselbe Instanz wird von allen Komponenten geteilt, die sie benötigen – ein wichtiger Punkt, um die Rolle des Services [ApplicationModelService] in der Fallstudie (Kapitel 3) zu verstehen, der beim Start des Servers Daten zwischenspeichert.
3.6. Die weiteren Dekoratoren, die in der Fallstudie vorkommen
Dekorator | Rolle |
ordnet eine Controller-Methode einer HTTP-Route zu | |
ruft ein variables Segment der URL ab, z. B. /getDoctorById/:id | |
ruft den JSON-Body einer POST-Anfrage ab, deserialisiert in eine Klasse | |
deklariert einen Provider (Service, DAO …) | |
deklariert ein Modul, eine Zusammenstellung aus Controllern und Providern |
Diese Dekoratoren werden einzeln und genau an der Stelle ausführlich erklärt, an der sie im Code des [RdvMedecins]-Servers vorkommen (Kapitel 3).