Analisis mendalam tentang rangka kerja Nest.js dalam nod-tutorial js-php.cn

Artikel ini akan memperkenalkan anda kepada rangka kerja Nest.js dalam nod, dan bercakap tentang sebab anda memilih Nest, cara membuat dan menjalankan projek serta menerima permintaan dengan cara yang berbeza berguna kepada semua orang!

Analisis mendalam tentang rangka kerja Nest.js dalam nod

Baru-baru ini saya sedang mempertimbangkan untuk membuat platform todolist dengan rakan-rakan saya untuk kegunaan saya sendiri. Saya sudah lama mempelajarinya express dan saya mahu mengikuti perkembangan zaman dan lihat betapa popularnya baru-baru ini. Bagaimanakah bingkai tinggi itu. Selepas beberapa perbandingan, saya memilih nest dan merekodkannya selepas penggunaan awal untuk rujukan mudah pada masa hadapan.

Siarkan dokumen bahasa Cina untuk pembelajaran lanjutNest

Pengenalan kepada rangka kerja Nest.js

Nest ialah rangka kerja untuk membina cekap, berskala Rangka kerja Node.js lanjutan untuk aplikasi sebelah pelayan. Ia menggunakan JavaScript Progresif, mempunyai sokongan terbina dalam dan penuh untuk TypeScript (tetapi masih membenarkan pembangun menulis kod dalam JavaScript tulen) dan menggabungkan OOP (Pengaturcaraan Berorientasikan Objek), FP (Pengaturcaraan Fungsian) dan FRP (Fungsian). Pengaturcaraan) elemen pengaturcaraan reaktif.
Platform HTTP asas rangka kerja Nest dilaksanakan berdasarkan Express secara lalai, jadi tidak perlu risau tentang kekurangan perpustakaan pihak ketiga. Nest bertujuan untuk menjadi rangka kerja platform-agnostik. Platform ini membolehkan penciptaan komponen logik boleh guna semula yang boleh dimanfaatkan oleh pembangun merentasi pelbagai jenis aplikasi. Nest pada masa ini mempunyai dua platform HTTP yang menyokong di luar kotak: express dan fastify, yang boleh diperkenalkan terus dalam projek.

Mengapa memilih Nest

Terdapat banyak rangka kerja nod di pasaran untuk anda pilih.
Express.js ialah tempat kelahiran Node.JS Ia merupakan rangka kerja pembangunan bahagian pelayan JS yang pantas dan minimalis berdasarkan Node.js dan enjin Chrome V8.
Koa.js ialah rangka kerja Web mikro Sangat mudah untuk menulis dunia hello, tetapi aplikasi web tidak dapat dipisahkan daripada sesi, lihat templat, penghalaan, muat naik fail dan pengurusan log. Ini tidak disediakan oleh Koa, jadi anda perlu pergi ke Middleware rasmi untuk mencarinya sendiri. Walau bagaimanapun, 100 orang mungkin menemui 100 kombinasi.
Egg.js adalah berdasarkan Koa.js, yang menyelesaikan masalah di atas, menyepadukan amalan terbaik komuniti ke dalam Koa.js, dan juga dinamakan Egg.js, dan memulakan pelbagai proses untuk memudahkan pembangunan . Kemas kini dan isu lain telah diselesaikan bersama. Ini sangat mesra pembangun dan berfungsi di luar kotak, dengan konfigurasi terbaik (lebih baik) di luar kotak. Semasa pembangunan Egg.js, ECMAScript memperkenalkan async menunggu Berbanding dengan sintaks hasil, async adalah lebih mudah untuk ditulis. Kemudian, Koa.js turut membuat susulan.
Midway ialah rangka kerja Node.js yang dibangunkan oleh pasukan Alibaba berdasarkan konsep progresif, menggabungkan OOP dan paradigma pengaturcaraan berfungsi. Menggunakan telur sebagai rangka kerja asas, dan menambahkan banyak ciri baharu seperti sokongan definisi TypeScript yang baik, Midway telah dilancarkan Rakan-rakan yang berminat boleh pergi ke dokumentasi rasmi untuk mempelajari
Nest.js berdasarkan Express.js The full-. rangka kerja yang diketengahkan Nest.js dibungkus pada Express.js dan menggunakan sepenuhnya ciri TypeScript; kelebihan Nest.js ialah komuniti itu aktif dan pertumbuhannya memuaskan sehingga kini, ia dimiliki pada GitHub43.7k Star Ia ialah rangka kerja peringkat perusahaan yang popular baru-baru ini.
Berdasarkan pertimbangan menyeluruh tentang sokongan asas dan aktiviti peringkat perusahaan dan komuniti, saya memilih untuk menggunakan nest untuk pembelajaran di sini. Pelajar boleh memilih mengikut keperluan mereka.

Buat projek

Pastikan komputer anda telah memasang Node.js (>= 10.13.0)
Versi nod yang saya gunakan di sini ialah v14.16.1 dan versi yang diuruskan oleh benang ialah 1.22.17

Buat projek

$  npm i -g @nestjs/cli
$  nest new project-name

Salin selepas log masuk

Selepas mencipta projek, lihat direktori projek Berikut ialah penerangan ringkas tentang fail teras:

app.controller.ts	带有单个路由的基本控制器示例
app.controller.spec.ts	对于基本控制器的单元测试样例
app.module.ts	应用程序的根模块。
app.service.ts	带有单个方法的基本服务
main.ts	应用程序入口文件。用来创建 Nest 应用实例。

/* main.ts */
import { NestFactory } from &#39;@nestjs/core&#39;;
import { AppModule } from &#39;./app.module&#39;;

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

Salin selepas log masuk

运行项目

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

Salin selepas log masuk

Analisis mendalam tentang rangka kerja Nest.js dalam nod

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

Salin selepas log masuk

路由

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

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

Salin selepas log masuk

以上方法在api中映射成完整的路由为GET api/user/find 。
其中 @Get()HTTP请求装饰器告诉Nest为HTTP请求的特定端点创建处理程序。

Analisis mendalam tentang rangka kerja Nest.js dalam nod

可以看到上面的 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 &#39;@nestjs/common&#39;;
   @Injectable() // 
   // 这里
   export class UserService {
     findUser(sid: string): string {
       console.log(sid);
       if (sid === &#39;123456&#39;) {
         return &#39;kid is here&#39;;
       }
       return &#39;No one here&#39;;
     }
  }

Salin selepas log masuk

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

/ * user.controller.ts  */ 创建一个 user 控制器文件
import { Controller, Get, Query } from &#39;@nestjs/common&#39;;
import { UserService } from &#39;./user.service&#39;;

@Controller(&#39;user&#39;)
export class UserController {
   constructor(private readonly userService: UserService) {}
   @Get(&#39;findOne&#39;) //这里暴露出的路由为 user/find
   findUser(@Query() query: any) {
     return this.userService.findUser(query.sid);
   }

Salin selepas log masuk

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

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

/ * user.module.ts  */ 创建一个 user mod
 import { Module } from &#39;@nestjs/common&#39;;
 import { UserController } from &#39;./user.controller&#39;;
 import { UserService } from &#39;./user.service&#39;;
 @Module({
     controllers: [UserController],
     providers: [UserService],
   })
   export class UserModule {}

/*  app.module.ts  */ 最后在app.module中引入我们自己写的module
import { Module } from &#39;@nestjs/common&#39;;
import { AppController } from &#39;./app.controller&#39;;
import { AppService } from &#39;./app.service&#39;;
import { UserModule } from &#39;./user/user.module&#39;;

@Module({
     imports: [UserModule],
     controllers: [AppController],
     providers: [AppService],
   })
   export class AppModule {}

Salin selepas log masuk

控制器已经准备就绪，可以使用，但是 Nest 依然不知道 UserController 是否存在，所以它不会创建这个类的一个实例。
控制器总是属于模块，这就是为什么我们在 @Module() 装饰器中包含 controllers 数组的原因。由于除了根模块 AppModule之外，我们还没有定义其他模块，所以我们将使用它来介绍 UserController
使用 postman 看下效果
- 可以看到发送get请求请求成攻。
- 接下来我们依次使用 post put delete 发送请求,看nest是如何接受并处理的

Post

user.service 文件

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

Salin selepas log masuk

user.controller 文件

/ * user.controller.ts  */ 创建一个 user 控制器文件
import { Controller, Get, Query } from &#39;@nestjs/common&#39;;
import { UserService } from &#39;./user.service&#39;;

@Controller(&#39;user&#39;)
export class UserService {
    @Post(&#39;set&#39;)
    setUser(@Body() body: any, @Query() query: any) {
      return this.userService.setUser(query.sid, body);
    } 
}

Salin selepas log masuk

使用 postman 看下效果

Analisis mendalam tentang rangka kerja Nest.js dalam nod

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

Put

user.service 文件

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

Salin selepas log masuk

user.controller 文件
这里用到了 Param 装饰器 @Param() 用于修饰一个方法的参数（上面示例中的 params），并在该方法内将路由参数作为被修饰的方法参数的属性。如上面的代码所示，我们可以通过引用 params.id来访问（路由路径中的） id 参数。您还可以将特定的参数标记传递给装饰器，然后在方法主体中按参数名称直接引用路由参数。
```
/ * user.controller.ts  */ 创建一个 user 控制器文件
import { Body, Controller, Get, Param, Post, Put, Query } from &#39;@nestjs/common&#39;;
import { UserService } from &#39;./user.service&#39;;

@Controller(&#39;user&#39;)
export class UserService {
   @Put(&#39;:sid&#39;)
   updateUser(@Param(&#39;sid&#39;) sid: string, @Body() body: any) {
     return this.userService.updateUser(sid, body);
   }
}
```
Salin selepas log masuk

使用 postman 看下效果

Analisis mendalam tentang rangka kerja Nest.js dalam nod

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

Delete

user.service 文件

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

Salin selepas log masuk

user.controller 文件

/ * user.controller.ts  */ 创建一个 user 控制器文件
import { Body, Controller, Get, Param, Post, Put, Query } from &#39;@nestjs/common&#39;;
import { UserService } from &#39;./user.service&#39;;

@Controller(&#39;user&#39;)
export class UserService {
   @Delete(&#39;:sid&#39;)
   deleteUser(@Param(&#39;sid&#39;) sid: string) {
     return this.userService.deleteUser(sid);
   }
}

Salin selepas log masuk

使用 postman 看下效果

Analisis mendalam tentang rangka kerja Nest.js dalam nod

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

总结

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

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

Atas ialah kandungan terperinci Analisis mendalam tentang rangka kerja Nest.js dalam nod. Untuk maklumat lanjut, sila ikut artikel berkaitan lain di laman web China PHP!