Une analyse approfondie du framework Nest.js dans node

Cet article vous présentera le framework Nest.js dans node et expliquera pourquoi vous choisissez Nest, comment créer et exécuter des projets et recevoir des demandes de différentes manières. J'espère que cela sera utile à tout le monde !

Récemment, j'envisage de créer une plateforme todolist avec mes amis pour mon propre usage. J'ai appris express il y a longtemps, et je veux suivre le rythme et y jeter un œil. sur certains des frameworks les plus populaires récemment. Après plusieurs comparaisons, j'ai choisi nest et je l'ai enregistré après la première utilisation pour référence future. express ，想着与时俱进一下,看看近期热度较高的几个框架是怎样的。在几个对比下选择了 nest 在初步使用后记录一下，方便日后查阅。

贴出中文文档以便大家进一步学习 Nest

Nest.js框架简介

• Nest 是一个用于构建高效，可扩展的 Node.js 服务器端应用程序的框架。它使用渐进式 JavaScript，内置并完全支持 TypeScript（但仍然允许开发人员使用纯 JavaScript 编写代码）并结合了 OOP（面向对象编程），FP（函数式编程）和 FRP（函数式响应编程）的元素。
• Nest 框架底层 HTTP 平台默认是基于 Express 实现的，所以无需担心第三方库的缺失。 Nest 旨在成为一个与平台无关的框架。 通过平台，可以创建可重用的逻辑部件，开发人员可以利用这些部件来跨越多种不同类型的应用程序。 nest 目前有两个支持开箱即用的 HTTP 平台：express 和 fastify 可以在项目中直接引入。

为什么选择 Nest

• 目前市面上有很多 node 框架可供大家选择。
• Express.js 是 Node.JS 诞生之初，是一款基于Node.js以及Chrome V8引擎，快速、极简的JS服务端开发框架。
• Koa.js是一款微型Web框架，写一个hello world很简单，但web应用离不开session，视图模板，路由，文件上传，日志管理。这些 Koa 都不提供，需要自行去官方的 Middleware 寻找。然而，100个人可能找出100种搭配。
• Egg.js是基于Koa.js，解决了上述问题，将社区最佳实践整合进了Koa.js，另取名叫Egg.js，并且将多进程启动，开发时的热更新等问题一并解决了。这对开发者很友好，开箱即用，开箱即是最(较)佳配置。Egg.js发展期间，ECMAScript又推出了 async await，相比yield的语法async写起来更直。后面Koa.js也同步进行了跟进。
• Midway 是阿里团队，基于渐进式理念研发的 Node.js 框架，结合了 OOP和函数式两种编程范式。以 egg 是作为底层框架，加上了良好的TypeScript的定义支持等众多新特性,推出了Midway，有兴趣的小伙伴可以去官方文档学习一下
• Nest.js 基于Express.js的全功能框架 Nest.js，他是在Express.js上封装的，充分利用了TypeScript的特性；Nest.js的优点是社区活跃，涨势喜人，截止目前在 GitHub 拥有 43.7k Star 是近期比较热门的企业级框架。
• 基于支持底层支持ts与企业级和社区活跃度等综合考虑，这里我选择用nest来进行学习。各位同学可以按需选择。

创建项目

• 确保电脑安装了 Node.js (>= 10.13.0)

• 这里我使用的 node 版本为 v14.16.1 包用的是 yarn 管理的 版本为 1.22.17

  Publiez des documents chinois pour que tout le monde puisse en apprendre davantageNest

Introduction au framework Nest.js

Nest est un framework permettant de créer une Node.js Un framework pour les applications côté serveur. Il utilise du JavaScript progressif, prend en charge de manière intégrée et complète TypeScript (mais permet toujours aux développeurs d'écrire du code en JavaScript pur) et combine des éléments de POO (Programmation Orientée Objet), FP (Programmation Fonctionnelle) et FRP (Programmation Réactive Fonctionnelle).

La plate-forme HTTP sous-jacente du framework Nest est implémentée sur la base d'Express par défaut, vous n'avez donc pas à vous soucier du manque de bibliothèques tierces. Nest vise à être un framework indépendant de la plate-forme. La plateforme permet la création de composants logiques réutilisables que les développeurs peuvent exploiter dans de nombreux types d'applications différents. Nest dispose actuellement de deux plates-formes HTTP prêtes à l'emploi : express et fastify, qui peuvent être introduites directement dans le projet.

• Pourquoi choisir Nest

• Il existe de nombreux frameworks de nœuds sur le marché parmi lesquels choisir.
  Express.js est la naissance de Node.JS Il est basé sur Node.js
et moteur Chrome V8, un framework de développement côté serveur JS rapide et minimaliste.
• Koa.js est un framework micro-web. Il est très simple d'écrire un bonjour monde, mais les applications Web sont indissociables des sessions, des modèles d'affichage, du routage, des téléchargements de fichiers et de la gestion des journaux. Ceux-ci ne sont pas fournis par Koa, vous devez donc vous rendre sur le Middleware officiel pour les trouver. Cependant, 100 personnes peuvent trouver 100 combinaisons. Egg.js est basé sur Koa.js, qui résout les problèmes ci-dessus, intègre les meilleures pratiques de la communauté dans Koa.js, et est également nommé Egg.js, et intègre des problèmes tels que le démarrage multi-processus et les mises à jour à chaud pendant le développement. et résolu. C'est très convivial pour les développeurs, cela fonctionne dès la sortie de la boîte et il a la meilleure (meilleure) configuration dès la sortie de la boîte. Lors du développement d'Egg.js, ECMAScript a introduit l'attente asynchrone. Par rapport à la syntaxe rendement, l'async est plus simple à écrire. Plus tard, Koa.js a également suivi. Midway est un framework Node.js développé par l'équipe Alibaba basé sur le concept progressif, combinant les paradigmes de POO et de programmation fonctionnelle. Avec Egg comme framework sous-jacent et avec de nombreuses nouvelles fonctionnalités telles qu'une bonne prise en charge de la définition TypeScript, Midway est lancé. Les amis intéressés peuvent consulter la documentation officielle pour en savoir plusNest.js Nest, un framework complet basé sur Express. .js .js, il est packagé sur Express.js, exploitant pleinement les caractéristiques de TypeScript ; l'avantage de Nest.js est que la communauté est active et que le taux de croissance est gratifiant. ="https://github.com/nestjs /nest" target="_blank" rel="nofollow noopener noreferrer" ref="nofollow noopener noreferrer">GitHub a 43,7k étoiles et est un cadre au niveau de l'entreprise récemment populaire. Sur la base d'une prise en compte globale des supports sous-jacents, du niveau de l'entreprise et de l'activité communautaire, j'ai choisi ici d'utiliser Nest pour l'apprentissage. Les étudiants peuvent choisir en fonction de leurs besoins. Assurez-vous que Node.js est installé sur votre ordinateur (>= 10.13.0)La version du nœud que je suis utiliser ici estv14.16.1 La version gérée par fil est 1.22.17Créer le projetVoir après la création le projet Jetez un œil au répertoire du projet, voici une brève description des fichiers principaux :

  Créer un projet
  $ npm i -g @nestjs/cli $ nest new project-name

  🎜🎜🎜🎜app.controller.ts🎜🎜Exemple de contrôleur de base avec une seule route🎜🎜🎜🎜🎜🎜app.controller .spec.ts🎜🎜 Exemple de test unitaire pour un contrôleur de base🎜🎜🎜🎜app.module.ts🎜🎜Le module racine de l'application. 🎜🎜🎜🎜app.service.ts🎜🎜Service de base avec une seule méthode 🎜🎜🎜🎜main.ts🎜🎜Fichier d'entrée d'application. Utilisé pour créer des instances d'application Nest. 🎜🎜🎜🎜

  /* main.ts */
  import { NestFactory } from '@nestjs/core';
  import { AppModule } from './app.module';
  
  async function bootstrap() {
    const app = await NestFactory.create(AppModule); // 使用核心类 NestFactory 返回一个 接口对象
    await app.listen(3000);  // 这里是默认设置的端口号
  }
  bootstrap();

运行项目

• $ npm run start:watch // 启动项目并监听代码变动 这里可以在package.json 中进行配置指令

•   我们可以看到服务已经启动,输入本机地址并带上端口号3000,发送一次 get 请求 则会返回 `Hello World`。 
    
    这里是因为在 app.controll.ts 文件中 @Get()HTTP请求装饰器告诉Nest为HTTP请求的特定端点创建处理程序。

路由

• 在开始写代码之前我们先简单看一下nest中的基础路由配置是怎样的，就目前而言我的理解为nest的路由是由 全局路由 路由前缀(局部路由) 方法装饰器 组成路由映射提供给前端使用。

•  /* main.ts */
   main文件中我们可以在项目监听前配置一个全局的api前缀
  async function bootstrap() {
  const app = await NestFactory.create(AppModule);
      //设置全局前缀
      app.setGlobalPrefix('api');
      await app.listen(3000);
    }
  /* app.controller.ts */
  @Controller('user') // 控制器设置路由前缀 我理解为局部路由
    export class AppController {
      constructor(private readonly appService: AppService) {}
      @Get('find') // 方法装饰器设置路由路径 这里我理解为设置api子路由
      getHello(): string {
        return this.appService.getHello();
          }
      }

• 以上方法在api中映射成完整的路由为GET api/user/find 。

• 其中 @Get()HTTP请求装饰器告诉Nest为HTTP请求的特定端点创建处理程序。

• 可以看到上面的 get 接收请求及路由以可以使用，下面我们看一下 nest 中如何接收 post 等其他请求方式

不同方式接收请求

• 这里用到的 Nest 提供的请求装饰器知识点Request 对象代表 HTTP 请求，并具有查询字符串，请求参数参数，HTTP 标头（HTTP header） 和 正文（HTTP body）的属性（在这里阅读更多）。在多数情况下，不必手动获取它们。 我们可以使用专用的装饰器，比如开箱即用的 @Body() 或 @Query() 。 下面是 Nest 提供的装饰器及其代表的底层平台特定对象的对照列表。

  

• 下面我们看一下 nest 中如何接收 get post put delete 发起的请求，用几个可用的装饰器来创建基本控制器。 该控制器暴露了几个访问和操作内部数据的方法。

Get

• 我们先创建一个 user 服务/控制器/moudle

  / * user.service.ts  */ 先创建一个 user service服务文件
  import { Injectable } from '@nestjs/common';
     @Injectable() // 
     // 这里
     export class UserService {
       findUser(sid: string): string {
         console.log(sid);
         if (sid === '123456') {
           return 'kid is here';
         }
         return 'No one here';
       }
    }

• 该服务将负责数据存储和检索，其由 UserController 使用，我们用 @Injectable() 来装饰这个类

  / * user.controller.ts  */ 创建一个 user 控制器文件
  import { Controller, Get, Query } from '@nestjs/common';
  import { UserService } from './user.service';
  
  @Controller('user')
  export class UserController {
     constructor(private readonly userService: UserService) {}
     @Get('findOne') //这里暴露出的路由为 user/find
     findUser(@Query() query: any) {
       return this.userService.findUser(query.sid);
     }

• 控制器的目的是接收应用的特定请求。路由机制控制哪个控制器接收哪些请求。通常，每个控制器有多个路由，不同的路由可以执行不同的操作。

• 为了创建一个基本的控制器，我们使用类和装饰器。装饰器将类与所需的元数据相关联，并使 Nest 能够创建路由映射（将请求绑定到相应的控制器）。

  / * user.module.ts  */ 创建一个 user mod
   import { Module } from '@nestjs/common';
   import { UserController } from './user.controller';
   import { UserService } from './user.service';
   @Module({
       controllers: [UserController],
       providers: [UserService],
     })
     export class UserModule {}
  
  /*  app.module.ts  */ 最后在app.module中引入我们自己写的module
  import { Module } from '@nestjs/common';
  import { AppController } from './app.controller';
  import { AppService } from './app.service';
  import { UserModule } from './user/user.module';
  
  @Module({
       imports: [UserModule],
       controllers: [AppController],
       providers: [AppService],
     })
     export class AppModule {}

• 控制器已经准备就绪，可以使用，但是 Nest 依然不知道 UserController 是否存在，所以它不会创建这个类的一个实例。

• 控制器总是属于模块，这就是为什么我们在 @Module() 装饰器中包含 controllers 数组的原因。 由于除了根模块 AppModule之外，我们还没有定义其他模块，所以我们将使用它来介绍 UserController

  使用 postman 看下效果

  

  • 可以看到发送get请求 请求成攻。
  • 接下来我们依次使用 post put delete 发送请求,看nest是如何接受并处理的

Post

• user.service 文件

  / * user.service.ts  */ 先创建一个 user service服务文件
  import { Injectable } from '@nestjs/common';
     @Injectable() // 
     // 这里
    setUser(sid: string, body: any): any {
         if (sid === '123456') {
           return {
             msg: '设置成功',
             body,
           };
       }
    }

• user.controller 文件

  / * user.controller.ts  */ 创建一个 user 控制器文件
  import { Controller, Get, Query } from '@nestjs/common';
  import { UserService } from './user.service';
  
  @Controller('user')
  export class UserService {
      @Post('set')
      setUser(@Body() body: any, @Query() query: any) {
        return this.userService.setUser(query.sid, body);
      } 
  }

使用 postman 看下效果

• 可以看到发送 post 请求 请求成攻。

Put

• user.service 文件

  / * user.service.ts  */ 先创建一个 user service服务文件
  import { Injectable } from '@nestjs/common';
     @Injectable() // 
     // 这里
    updateUser(sid: string, body: any): any {
         if (sid === '123456') {
           return {
             msg: '设置成功',
             body,
           };
       }
    }

• user.controller 文件

• 这里用到了 Param 装饰器 @Param() 用于修饰一个方法的参数（上面示例中的 params），并在该方法内将路由参数作为被修饰的方法参数的属性。如上面的代码所示，我们可以通过引用 params.id来访问（路由路径中的） id 参数。 您还可以将特定的参数标记传递给装饰器，然后在方法主体中按参数名称直接引用路由参数。

  / * user.controller.ts  */ 创建一个 user 控制器文件
  import { Body, Controller, Get, Param, Post, Put, Query } from '@nestjs/common';
  import { UserService } from './user.service';
  
  @Controller('user')
  export class UserService {
     @Put(':sid')
     updateUser(@Param('sid') sid: string, @Body() body: any) {
       return this.userService.updateUser(sid, body);
     }
  }

使用 postman 看下效果

• 可以看到发送 put 请求 请求成攻。

Delete

• user.service 文件

  / * user.service.ts  */ 先创建一个 user service服务文件
  import { Injectable } from '@nestjs/common';
     @Injectable() // 
     // 这里
   deleteUser(sid: string): any {
         if (sid === '123456') {
           return {
             msg: '删除成功',
           };
       }
    }

• user.controller 文件

  / * user.controller.ts  */ 创建一个 user 控制器文件
  import { Body, Controller, Get, Param, Post, Put, Query } from '@nestjs/common';
  import { UserService } from './user.service';
  
  @Controller('user')
  export class UserService {
     @Delete(':sid')
     deleteUser(@Param('sid') sid: string) {
       return this.userService.deleteUser(sid);
     }
  }

  使用 postman 看下效果

  

  • 可以看到发送 delete 请求 请求成攻。

  总结

  • 至此我们用 Nest 的装饰器模拟了基础的接口请求增删改查，认识到 Nest 中的三种基本应用程序构建块Module Controller Service
  • 服务和控制的划分明确，带来更好的代码体验。TypeScrip 的个人使用还有待提高，以后还要继续学习hhh

  更多node相关知识，请访问：nodejs 教程！

Ce qui précède est le contenu détaillé de. pour plus d'informations, suivez d'autres articles connexes sur le site Web de PHP en chinois!