Nest(NestJS)基础复习 - 速通版 02

// ① 写一个装饰器函数function Component(target) {  console.log('装饰器执行了！收到的类是：', target.name);  target.__role = 'component';   // 给类加个静态属性（标记）}// ② 用 @ 挂到类上@Componentclass UserService {}// ③ 运行时输出：// 装饰器执行了！收到的类是：UserServiceconsole.log(UserService.__role);  // 'component'

// 装饰器工厂：外层函数接收参数，返回真正的装饰器函数function Controller(prefix) {  console.log('工厂被调用，prefix =', prefix);  // 返回真正的装饰器  return function(target) {    console.log('装饰器执行，给', target.name, '加路由前缀', prefix);    target.__prefix = prefix;  };}@Controller('users')   // 先调工厂('users')，拿到真正的装饰器class UserController {}// 输出：// 工厂被调用，prefix = users// 装饰器执行，给 UserController 加路由前缀 usersconsole.log(UserController.__prefix);  // 'users'

function Log(target, key, descriptor) {  const original = descriptor.value;   // 拿到原方法  descriptor.value = function(...args) {    console.log(`调用 ${key}，参数：`, args);    const result = original.apply(this, args);  // 调原方法    console.log(`${key} 返回：`, result);    return result;  };}class Calculator {  @Log  add(a, b) { return a + b; }}const c = new Calculator();c.add(1, 2);// 输出：// 调用 add，参数：[1, 2]// add 返回：3

// 属性装饰器：目标.prototype, 属性名function Max(limit) {  return function(target, key) {    // 把校验规则记到类上    const rules = target.__rules || (target.__rules = {});    rules[key] = { max: limit };  };}// 参数装饰器：第三个参数是参数索引function Param(name) {  return function(target, methodName, paramIndex) {     // 先记录/存储下来，然后nest等http请求过来时，     // 再匹配对应的参数拿到对应的值     console.log(`参数装饰器：${methodName} 的第 ${paramIndex} 个参数来自 ${name}`);  };}class UserController {  @Max(100)  name = '';  getUser(@Param('id') id) {}}// 输出：参数装饰器：getUser 的第 0 个参数来自 id

@Injectable()classUserService{　constructor(private db: Database) {}}

// ===== ① 全局容器 =====const container = new Map();// ===== ② @Injectable() 装饰器：把类注册到容器 =====function Injectable() {  return function(Target) {    container.set(Target, null);  // 先占位，实例化时再填  };}// ===== ③ 业务类 =====class Database {  query(sql) { return `执行 ${sql}`; }}@Injectable()class UserService {  constructor(db) {  // 真实 Nest 里靠 TS 元数据自动识别 db: Database    this.db = db;  }  getUser() { return this.db.query('SELECT * FROM users'); }}// ===== ④ 手动注册 Database（真实 Nest 里在 @Module providers 里）=====container.set(Database, new Database());// ===== ⑤ 解析容器：递归创建所有依赖 =====function resolve(Target) {  if (container.get(Target)) return container.get(Target);  // 已实例化，返回单例  // 真实 Nest：这里读构造函数参数类型元数据，自动决定依赖谁  // 我们简化：手动写死 UserService 依赖 Database  const deps = Target === UserService ? [Database] : [];  const depInstances = deps.map(resolve);  const instance = new Target(...depInstances);  container.set(Target, instance);  return instance;}// ===== ⑥ 使用 =====const userService = resolve(UserService);console.log(userService.getUser());// 输出：执行 SELECT * FROM users

注意装饰器的执行顺序：1） 装饰器表达式（工厂函数）从上到下求值；2）装饰器函数调用从下到上。

// src\fundamentals\common\middleware\logger.middleware.tsimport { Injectable, Logger, NestMiddleware } from '@nestjs/common'import { Request, Response } from 'express'@Injectable()export class LoggerMiddleware implements NestMiddleware {  use(req: Request, res: Response, next: () => void) {    const { method, path } = req    Logger.log(`${method}${path}`)    next()  }}// src\app.module.ts// 在模块里配置（只能函数式配置在模块，或用 configure()）export class AppModule {  configure(consumer: MiddlewareConsumer) {    // 为所有路由应用 LoggerMiddleware 中间件，排除 hello 路由的 POST 请求, 其他路由都应用 LoggerMiddleware 中间件    consumer.apply(LoggerMiddleware).exclude({ path: 'hello', method: RequestMethod.POST }).forRoutes('*')  }}

import { Injectable, CanActivate, ExecutionContext, UnauthorizedException } from '@nestjs/common';@Injectable()export class AuthGuard implements CanActivate {  canActivate(context: ExecutionContext): boolean {    const req = context.switchToHttp().getRequest();    const token = req.headers['authorization'];    if (!token) throw new UnauthorizedException('未登录');    return true;  }}

// 用法：控制器级 / 方法级 / 全局@UseGuards(AuthGuard)@Controller('users')export classUserController{}// 全局守卫（main.ts 或 provider 注册）app.useGlobalGuards(new AuthGuard());

import {   Controller, Post, Body, UsePipes,  ValidationPipe, ParseIntPipe } from '@nestjs/common';import { IsString, IsEmail, MinLength } from 'class-validator';export class CreateUserDto {  @IsString()  name: string;  @IsEmail()  email: string;  @MinLength(6)  password: string;}@Controller('users')export class UserController {  // 局部管道：只对这个 handler 生效  @Post()  @UsePipes(new ValidationPipe())  create(@Body() dto: CreateUserDto) { ... }  // 参数级管道：把 '1' 转成数字 1  @Get(':id')  findOne(@Param('id', ParseIntPipe) id: number) { ... }}

import { Controller, Get, Post, Body, Param, Query, Headers, HttpCode } from '@nestjs/common';@Controller('users')   // 路由前缀：/usersexport class UserController {  @Get()                          // GET /users  findAll(@Query() query: any) { ... }  @Get(':id')                    // GET /users/1  findOne(@Param('id') id: string) { ... }  @Post()                         // POST /users  @HttpCode(201)  create(@Body() body: CreateUserDto) { ... }  @Get('header')  readHeader(@Headers('authorization') auth: string) { ... }}

function Param(data) {  // 返回真正的参数装饰器  return function (target, propertyKey, parameterIndex) {    // target        : 类的 prototype（UserController.prototype）    // propertyKey   : 方法名（'getUser'）    // parameterIndex: 参数下标（0 表示第 0 个参数）    console.log(`记录：${propertyKey} 的第 ${parameterIndex} 个参数来自 params 的 ${data}`);  };}class UserController {  getUser(@Param('id') id) {}}// 输出：记录：getUser 的第 0 个参数来自 params 的 id

import {   Injectable, NestInterceptor,   ExecutionContext, CallHandler } from '@nestjs/common';import { map, tap } from 'rxjs';@Injectable()export class LoggingInterceptor implements NestInterceptor {  intercept(context: ExecutionContext, next: CallHandler) {    console.log('请求进来了');    return next.handle().pipe(      tap(() => console.log('响应出去了')),      map((data) => ({ code: 0, data })),   // 统一包装响应体    );  }}

import { ExceptionFilter, Catch, ArgumentsHost, HttpException} from '@nestjs/common';@Catch(HttpException)  // 只捕获 HTTP 异常；@Catch() 捕获所有export class HttpExceptionFilter implements ExceptionFilter {  catch(exception: HttpException, host: ArgumentsHost) {    const ctx = host.switchToHttp();    const res = ctx.getResponse();    const status = exception.getStatus();    res.status(status).json({      code: status,      message: exception.message,      timestamp: new Date().toISOString(),    });  }}

// src/main.tsimport { NestFactory } from '@nestjs/core'import { AppModule } from './app.module'import { HttpExceptionFilter } from './fundamentals/common/filters/http-exception.filter'async function bootstrap() {  const app = await NestFactory.create(AppModule)  // 全局过滤器  app.useGlobalFilters(new HttpExceptionFilter())  app.setGlobalPrefix('api')  await app.listen(8080)}bootstrap()

HTTP请求进来  ↓Middleware（中间件）  ↓Guard 守卫（鉴权/权限）  ↓【Interceptor 拦截器：入站逻辑（intercept 里面，next.handle() 之前的代码）】  ↓Pipe 管道（参数解析、转换、DTO校验 ValidationPipe）  ↓Controller 控制器方法  ↓【Interceptor 拦截器：出站逻辑（next.handle()返回Observable，pipe/map处理响应）】  ↓ExceptionFilter 异常过滤器（任何环节抛异常都会跳到这里）  ↓返回HTTP响应