SuperAPI AI 工具集

controllers

编程与开发

查看项目

更新于 10-16 10:21

技能介绍

用途:在 NestJS 中创建控制器,处理传入的 HTTP 请求并返回响应,适用于创建 REST API 端点、处理 GET/POST/PUT/DELETE/PATCH 请求、使用路由参数与查询参数、设置路由与路径前缀、处理重定向、响应头与状态码,以及在路由处理器中使用 async/await。

主要能力:通过装饰器把路由映射到处理方法,如 @Controller('cats') 设置路由前缀,@Get()、@Post()、@Put()、@Delete()、@Patch() 映射 HTTP 方法。可用 @Param() 读取路由参数(支持多个参数或整体对象),用 @Query() 读取查询参数,用 @Body() 读取请求体并配合 DTO 类,用 @Req() 获取完整请求对象。还支持 @Headers()、@Ip()、@HostParam()、@Session()、@Next() 等请求装饰器;@HttpCode() 自定义状态码,@Header() 设置响应头,@Redirect() 处理静态或动态重定向,支持通配符路由、子域名路由、RxJS Observable 与 async/await 异步处理。

使用方式:控制器须在模块的 controllers 数组中注册;DTO 使用类而非接口以便运行时校验,可配合 class-validator 与 Pipes 使用。可使用 nest generate resource cats 生成模块、控制器、服务、DTO 与实体。@Version('1') 等支持 API 版本化。资料建议保持控制器轻薄、将业务逻辑委托给服务、注入服务、抛出自定义 HTTP 异常、使用 @nestjs/swagger 输出 OpenAPI 文档。

限制:资料未提供安装、收费、平台或效果等信息。