Was bedeutet und wie funktioniert app.listen in einer NestJS-Anwendung?
- Einführung in app.listen
- Verwendung von app.listen in NestJS
- Beispiel für den Aufruf von app.listen
- Wichtiges Verhalten von app.listen
- Zusammenfassung
Einführung in app.listen
In NestJS ist die Methode app.listen eine zentrale Funktion, mit der der Server gestartet wird. Sie sorgt dafür, dass die Anwendung auf eingehende HTTP-Anfragen wartet und auf einem definierten Port erreichbar ist. Im Kern entspricht app.listen der Methode aus Node.js oder anderen Frameworks, durch die ein Server auf einem bestimmten Port lauscht.
Verwendung von app.listen in NestJS
Nachdem die NestJS-Anwendung via NestFactory.create(AppModule) initialisiert wurde, wird app.listen(port) aufgerufen, um den HTTP-Server zu starten. Der Parameter port gibt an, auf welchem Netzwerkport die Anwendung lauschen soll. Optional kann eine Callback-Funktion übergeben werden, die ausgeführt wird, sobald der Server erfolgreich gestartet ist.
Beispiel für den Aufruf von app.listen
async function bootstrap() { const app = await NestFactory.create(AppModule); await app.listen(3000);}bootstrap();
Hier startet die Anwendung auf Port 3000. Sobald app.listen erfolgreich ist, ist die App erreichbar und kann Anfragen beantworten.
Wichtiges Verhalten von app.listen
Die Methode führt intern dazu, dass ein HTTP-Server initialisiert und auf den angegebenen Port gebunden wird. Falls der Port bereits belegt ist, führt dies zu einem Fehler. Außerdem ist es möglich, statt einer Zahl als Port auch eine Zeichenkette für eine Unix-Domain-Socket oder Ähnliches zu übergeben. Typischerweise wird diese Methode einmal aufgerufen, um den Server zu starten und anschließend nicht wieder beendet, solange die Anwendung läuft.
Zusammenfassung
Die Methode app.listen ist essenziell, um eine NestJS-Anwendung für externe HTTP-Anfragen verfügbar zu machen. Ohne diesen Aufruf bleibt der Server nicht aktiv und nimmt keine Verbindungen entgegen. Daher ist app.listen ein fundamentaler Bestandteil beim Startvorgang einer NestJS-App.