Controller 与路由

这一课你将能做到

1. 用 @Controller 搭配 @Get / @Post / @Patch / @Delete 声明题库 REST 路由
2. 用 @Param / @Query / @Body / @Headers 取参数，并用 DTO 类描述请求体
3. 设置全局前缀 api，并正确返回 201（已创建）、204（无内容）状态码

为什么要学

Controller（控制器）人话：只负责「HTTP 请求怎么映射到方法」——路径、动词、取参、状态码；真正的业务规则交给 Service。

在 Express 里你写的是 app.get("/questions/:id", ...)；Nest 把路由声明在类与方法上，参数取值也有专门的装饰器。好处是路由集中可读、自动可扫描，后续接 Swagger 生成接口文档也顺理成章。Controller 保持薄，是整套分层的第一条纪律。

先建立图像

GET    /api/questions            → findAll(difficulty, tag, page)
GET    /api/questions/:id        → findOne(id)
POST   /api/questions            → create(dto)            → 201
PATCH  /api/questions/:id        → update(id, dto)
DELETE /api/questions/:id        → remove(id)             → 204

@Param("id")   ← 路径参数
@Query("tag")  ← 查询串 ?tag=js
@Body()        ← JSON 请求体，交给 DTO 类
@Headers()     ← 请求头

Express 对照：

Express	NestJS
app.get("/questions/:id")	@Get(":id") + @Param("id")
req.query.difficulty	@Query("difficulty")
req.body	@Body() dto: CreateQuestionDto
res.status(201).send(...)	@HttpCode(201)（POST 默认即 201）

跟着做

步骤 1：定义 DTO 类

新建 src/questions/dto/create-question.dto.ts：

export class CreateQuestionDto {
  stem: string;
  options: string[];
  answerIndex: number;
  difficulty: "easy" | "medium" | "hard";
  tags?: string[];
}

新建 src/questions/dto/update-question.dto.ts（更新时字段都可选）：

import { PartialType } from "@nestjs/mapped-types";
import { CreateQuestionDto } from "./create-question.dto";

export class UpdateQuestionDto extends PartialType(CreateQuestionDto) {}