NestJS 分类

一对一关系（One-to-One）

在这里就以一个用户表和抽奖次数表为例一个用户拥有多少次抽奖机会就是一对一的关系

    user.entity.ts
  
import {Column, Entity, ManyToOne, PrimaryGeneratedColumn, JoinColumn, OneToMany, OneToOne} from 'typeorm'
import {RoleEntity} from '@entity/role.entity'
import {LotteryRecordEntity} from '@entity/lotteryRecord.entity'
import {LotteryChancesEntity} from '@entity/lotteryChances.entity'

@Entity({name: 'user'})
export class UserEntity {
  @PrimaryGeneratedColumn({type: 'int'})
  id: number
  @Column({type: 'varchar', length: 255, nullable: false})
  name: string
  @Column({nullable: true, default: 'man'})
  gender: string
  @Column({nullable: true, default: 0})
  age: number
  @Column({nullable: false, unique: true, type: 'bigint'})
  phone: string
  @Column({nullable: true})
  description: string
  @Column({nullable: true, type: 'datetime', name: 'create_time'})
  createTime: Date
  @Column({type: 'varchar', length: 255, nullable: false})
  password: string

  // many users can have one role. explicit inverse and join column (role_id)
  @ManyToOne(() => RoleEntity, role => role.users, {nullable: true})
  @JoinColumn({name: 'role_id'})
  role: RoleEntity | null

  // @OneToMany(() => LotteryRecordEntity, lotteryRecord => lotteryRecord.user)
  // lotteryRecords: LotteryRecordEntity[]

  @OneToOne(() => LotteryChancesEntity, lotteryChances => lotteryChances.user)
  lotteryChances: LotteryChancesEntity
}

Mr shen2026/1/17大约 2 分钟

查询和参数

基础查询 where

参数放在where 里面

await this.userRepository.findOne({where: [{phone}]})

Mr shen2026/1/17小于 1 分钟

NestJS简介

NestJS 是一个用于构建高效且可扩展的服务器端应用程序的渐进式 Node.js 框架。它使用 TypeScript 编写，并结合了面向对象编程（OOP）、函数式编程（FP）和函数响应式编程（FRP）的元素。NestJS 架构灵感来自于 Angular，因此如果你熟悉 Angular，你会发现 NestJS 的设计理念和结构非常相似。

创建项目

前置条件

Nodejs: 版本 >= 20 (推荐使用最新的LTS版本)
node --version 查看当前版本
包管理器: pnpm (推荐使用pnpm, 也可以使用npm或yarn)
pnpm --version 查看当前版本

Mr shen2025/12/17大约 2 分钟

模块引入和单个模块基础

NestJS 是一个模块化的框架，应用程序由多个模块组成。每个模块封装了一组相关的功能和服务。下面是如何引入和使用单个模块的基础知识。

创建模块

nest generate resource xxx

Mr shen2025/12/17大约 2 分钟

控制器

控制器主要负责处理传入的请求向客户端返回响应

路由

使用@Controller装饰器来定义控制器类，并使用@Get、@Post等装饰器来定义路由处理方法。

请求对象

@Body()装饰器用于提取请求体中的数据。
@Param()装饰器用于提取路由参数。
@Query()装饰器用于提取查询参数。
@Req()装饰器用于获取请求对象。'

Mr shen2025/12/17大约 2 分钟

提供者

在 NestJS 中，提供者（Providers）是用于实现依赖注入（Dependency Injection）的核心概念。它们通常是类，可以被注入到其他类中，以实现松耦合和模块化设计。

基础Nest类（如服务、存储库、工厂和辅助工具）

比如在auth.module.ts 中注入 auth.service.ts


@Module({
  imports: [
    TypeOrmModule.forFeature([UserEntity, PermissionEntity]),
    ConfigModule.forFeature(jwtConfig),
    JwtModule.registerAsync(jwtConfig.asProvider()),
    PermissionModule,
  ],
  controllers: [AuthController],
  providers: [
    {
      provide: APP_GUARD,
      useClass: AccessTokenGuard,
    },
    AuthService,
    HashingService,
  ],
})
export class AuthModule {
}

Mr shen2025/12/17小于 1 分钟

中间件

中间件是在路由处理程序之前调用的函数。中间件函数可以访问请求和响应对象，以及应用程序请求-响应周期中next()中间件函数的调用。下一个中间件函数通常由名称next表示。

中间件函数可以执行以下任务

执行任意代码
修改请求和响应对象
结束请求-响应周期
调用堆栈中的下一个中间件函数
如果当前中间件函数没有结束请求-响应周期，则必须调用next()函数将控制权传递给下一个中间件函数。否则，请求将被挂起。

Mr shen2025/12/17大约 1 分钟

异常处理

异常抛出

在@nestjs/common包中有一个HttpException类

@Get()
async findAll() {
 throw new HttpException('Forbidden', HttpStatus.FORBIDDEN);
}

Mr shen2025/12/17大约 2 分钟

管道（参数校验）

管道主要有两种用法

转换：将输入数据转化为所需的形式
验证：评估输入数据是否符合特定的规则

内置管道

ValidationPipe
ParseIntPipe
ParseFloatPipe
ParseBoolPipe
ParseArrayPipe
ParseUUIDPipe
ParseEnumPipe
DefaultValuePipe
ParseFilePipe
ParseDatePipe

Mr shen2025/12/17大约 2 分钟

守卫（结合jwt Token）

Mr shen2025/12/17小于 1 分钟