Apprendre NestJS

Le but de ce MON est de faire une étude sur NestJS. NestJS est un framework de développement web Node.js qui permet de créer des applications web. Il est basé sur TypeScript et utilise les concepts de modèles de conception de l'architecture de l'application.

Table des matières

• Table des matières
• Introduction
• 1. Les Modules
  • Qu'est-ce qu'un Module dans NestJS ?
• 2. Les Contrôleurs
  • Qu'est-ce qu'un Contrôleur dans NestJS ?
• 3. Les Services
  • Qu'est-ce qu'un Service dans NestJS ?
• 4. Les DTOs (Data Transfer Objects)
  • Qu'est-ce qu'un DTO dans NestJS ?
• 5. Modèles
  • Qu'est-ce qu'un Modèle dans NestJS ?
• 6. Les Filtres, Pipes et Guards
  • Filtres d'Exception
  • Pipes
  • Guards
• 7. Le Point d’Entrée (main.ts)
  • Qu'est-ce que le Point d’Entrée dans NestJS ?
  • Horodatage
• Sources :

Introduction

J'apprends NestJs dans le but de me familiariser avec un langage backend autre que Laravel. Pour tout ce qui est en rapport avec l'installation et les autres étapes, je vous invite à consulter ce site web 1ère étape NestJs. Pour voir également une application concrète de NestJs, veuillez consulter mon POK du temps 2 POK Temps 2. J'ai commencé par visiter le site Créer un CRUD avec NestJs, dont le lien est au niveau de mes références, ce qui m'a permis de connaître les éléments les plus importants en NestJs. Je vais procéder ainsi par question, et tous mes exemples ont été basés sur mon forum de discussion.

1. Les Modules

Qu'est-ce qu'un Module dans NestJS ?

Un module est une unité de base dans NestJS. Il regroupe des contrôleurs, des services et d'autres éléments liés à une fonctionnalité spécifique. Par exemple, si tu construis un forum, tu pourrais avoir un module PostsModule pour gérer les posts, un UsersModule pour gérer les utilisateurs, etc. J'ai été aidé par la vidéo NestJs 7 Les modules NestJs, création de module et module global mentionnée dans mes sources pour comprendre cette partie.

Chaque application NestJS a un module principal (généralement AppModule) qui importe tous les autres modules.

Image explicite trouvée sur le site de la documentation de NestJs.

2. Les Contrôleurs

Qu'est-ce qu'un Contrôleur dans NestJS ?

Les contrôleurs sont responsables de gérer les requêtes HTTP. Ils définissent les endpoints (routes) de l’API et mappent chaque requête à une méthode spécifique.

Ils ont comme responsabilité de :

• Recevoir les requêtes HTTP (GET, POST, PUT, DELETE, etc.).
• Extraire les paramètres ou le corps de la requête.
• Appeler les services pour effectuer la logique métier.
• Retourner une réponse au client.

Image explicite trouvée sur le site de la documentation de NestJs.

Rôle important : Le contrôleur ne contient pas de logique complexe. Il délègue les opérations au service.

Le point n°4, expliqué par Webeleon sur le site dev.to, m'a aidé à comprendre les contrôleurs. Le lien se trouve dans la partie sources.

3. Les Services

Qu'est-ce qu'un Service dans NestJS ?

Les services contiennent la logique métier de l'application. Ce sont des classes où tu définis tout ce qui doit être fait pour manipuler ou traiter les données.

Ils ont comme responsabilité de :

• Interagir avec la base de données (via un modèle comme Mongoose pour MongoDB).
• Effectuer des calculs ou des validations complexes.
• Fournir des données au contrôleur.

Rôle important : Les services permettent de garder les contrôleurs simples et centrés sur la gestion des requêtes.

L'explication de la partie service de Créer un CRUD avec NestJs était explicite pour moi. Le lien se trouve dans la partie sources.

4. Les DTOs (Data Transfer Objects)

Qu'est-ce qu'un DTO dans NestJS ?

Les DTOs définissent la structure des données qui transitent entre le client et le serveur. Ils sont utilisés pour valider les données envoyées dans les requêtes HTTP.

Ils ont comme responsabilité de :

• Assurer que les données reçues ou envoyées respectent un format spécifique.
• Faciliter la validation des données avec des outils comme class-validator.

Rôle important : Les DTOs aident à sécuriser et structurer les interactions entre le client et le serveur.

Pour cette partie, j'ai consulté l'explication de David Ekete sur dev.to, ainsi que le site web GeeksforGeeks. Les liens se trouvent dans la partie sources.

5. Modèles

Qu'est-ce qu'un Modèle dans NestJS ?

Un modèle représente la structure des données dans la base de données. Avec MongoDB, les modèles sont définis à l'aide de Mongoose.

• Ils ont comme responsabilité de :
  • Définir les champs d'un document (par exemple : titre, contenu, date de création).
  • Définir les règles de validation pour la base de données (par exemple : title est obligatoire).

Rôle important : Les modèles servent d’interface entre l’application et la base de données.

L'article de SFEIR sur dev.to m'a permis de comprendre cette partie. Le lien se trouve dans la partie sources.

6. Les Filtres, Pipes et Guards

Filtres d'Exception

• Qu'est-ce que c'est ? : Les filtres interceptent les erreurs dans l'application.
• Utilité : Fournir des messages d'erreur personnalisés au client.
• Exemple : Si un ID de post est invalide, retourner un message Post not found.

Pipes

• Qu'est-ce que c'est ? : Les pipes transforment ou valident les données avant qu'elles n'atteignent un contrôleur ou un service.
• Utilité : Valider les données reçues dans une requête (par exemple, vérifier qu'un champ title n'est pas vide).

Image explicite trouvée sur le site de la documentation de NestJs.

Guards

• Qu'est-ce que c'est ? : Les guards protègent les routes en contrôlant l'accès.
• Utilité : Implémenter l'authentification (JWT) ou des permissions.

Image explicite trouvée sur le site de la documentation de NestJs.

L'article de SFEIR sur dev.to m'a permis de comprendre cette partie. Le lien se trouve dans la partie sources.

7. Le Point d’Entrée (main.ts)

Qu'est-ce que le Point d’Entrée dans NestJS ?

Le fichier main.ts initialise l'application NestJS et configure son comportement global.

• Il a comme responsabilité de :
  • Lancer le serveur.
  • Configurer les middlewares globaux (par exemple : activer CORS).
  • Intégrer des outils comme Swagger pour la documentation.

L'article Construire un serveur backend robuste avec NestJS sur la partie initiation est la seule source explicite que j'ai trouvée pour cette partie. Le lien se trouve dans la partie sources.

Horodatage

Voici à peu près (pas exactement, car parfois cela dépasse de quelques minutes) comment j’organise mon temps d’étude.

Sources :