前言
控制器主要是用来处理客户端传入的请求并向客户端返回响应。
它一般是用来做路由导航的，内部路由机制控制哪个控制器接收哪些请求。
路由
为了创建基本控制器，我们需要使用@Controller装饰器，装饰器将类与所需元数据关联起来，并使Nest能够创建路由映射。
我们使用nest-cli快速创建一个REST API风格的完整CURD代码。
nest g resource nanjiu
在生成的nanjiu文件夹下，我们可以看到有nanjiu.controller.ts文件，代码如下：
// nanjiu.controller.ts
import { Controller, Get, Post, Body, Patch, Param, Delete, Query } from '@nestjs/common';
import { NanjiuService } from './nanjiu.service';
import { CreateNanjiuDto } from './dto/create-nanjiu.dto';
import { UpdateNanjiuDto } from './dto/update-nanjiu.dto';
@Controller('nanjiu')
export class NanjiuController {
constructor(private readonly nanjiuService: NanjiuService) {}
@Post()
create(@Body() createNanjiuDto: CreateNanjiuDto) {
return this.nanjiuService.create(createNanjiuDto);
}
@Get()
findAll(@Param() params, @Query() query) {
console.log('find', query)
return this.nanjiuService.findAll();
}
@Get(':id')
findOne(@Param('id') id: string) {
return this.nanjiuService.findOne(+id);
}
@Patch(':id')
update(@Param('id') id: string, @Body() updateNanjiuDto: UpdateNanjiuDto) {
return this.nanjiuService.update(+id, updateNanjiuDto);
}
@Delete(':id')
remove(@Param('id') id: string) {
return this.nanjiuService.remove(+id);
}
}
@controller装饰器中传入了nanjiu参数，表示指定路由前缀nanjiu，在@controller装饰器中使用路由前缀，可以让我们很轻松地将一组相关路由放在一起集中管理。
比如当我们通过get方式请求/nanjiu这个路由时，它应该会走到@get装饰器修饰的findAll方法内
可以使用ApiFox工具进行接口测试：
从上图中可以看到我此时的请求路径是http://localhost:3000/apinanjiu，是不是很好奇为了什么多了一层/api，这是因为我加了一层全局路由前缀
// main.ts
app.setGlobalPrefix('api'); // 全局路由前缀
这里我们还可以看到状态码为200，并且能够看到findAll的返回值，就说明此时的请求是正常的，但右边还有个error提示返回数据结构与接口定义不一致。
这是因为这里我们只是简单地返回了一个字符串，并不符合JSON格式
在Nest中，有两种选项来处理响应值：
-
标准模式：使用此内置方法，当请求处理程序返回 JavaScript 对象或数组时，它将自动序列化为 JSON。然而，当它返回 JavaScript 基本类型（例如，
string、number、boolean）时，Nest 将仅发送该值，而不尝试对其进行序列化。这使得响应处理变得简单：只需返回值，Nest 就会处理其余的事情。此外，默认情况下，响应的状态代码始终为 200，除了使用 201 的 POST 请求。我们可以通过
@HttpCode(...)在处理程序级别添加装饰器来轻松更改此行为 -
特定库模式：我们可以使用特定于库的（例如，Express）响应对象
@Res()，可以使用方法处理程序签名中的装饰器注入该对象（例如，findAll(@Res() response)）。通过这种方法，您可以使用该对象公开的本机响应处理方法。例如，使用 Express，可以使用response.status(200).send().
路由通配符
Nest还支持基于模式的路由，比如，使用通配符
@Get('ab*cd')
findAll() {
return 'This route uses a wildcard';
}
路由'ab*cd'路径将匹配abcd、ab_cd、abecd等。字符?、+、*和()可以在路由路径中使用，并且是其正则表达式对应项的子集。连字符 ( -) 和点 ( .) 按字面意思解释为基于字符串的路径。
请求对象
作为后端项目，访问客户端请求的详细信息也非常重要，从上面生成的代码中我们可以看到@Body、@Param、@Query等装饰器，没错，在大多数时候我们并不需要手动获取请求对象（查询字符串、参数、请求头、正文等），直接通过这些开箱即用的装饰器就能快速获取。
比如我们在findAll内加上日志
// nanjiu.controller.ts
@Get()
findAll(@Param() params, @Query() query) {
console.log('find', params, query) // 日志
return this.nanjiuService.findAll();
}
然后在请求时带上一些参数：
此时我们再来看看后端打印的日志：
这里就能看到前端请求传过来的Query参数为city: shanghai
这些开箱即用的装饰器有以下这些：
@Request(), @Req() |
req |
|---|---|
@Response(), @Res()* |
res |
@Next() |
next |
@Session() |
req.session |
@Param(key?: string) |
req.params/req.params[key] |
@Body(key?: string) |
req.body/req.body[key] |
@Query(key?: string) |
req.query/req.query[key] |
@Headers(name?: string) |
req.headers/req.headers[name] |
@Ip() |
req.ip |
@HostParam() |
req.hosts |
HTTP请求方法
从上面生成的代码中的，我们可以发现除了@Get请求方法装饰器外还有一些其它的，事实上，Nest为所有标准 HTTP 方法提供了装饰器：@Get()、@Post()、@Put()、@Delete()、@Patch()、@Options()和@Head()。
一般大家常用的都是get请求与post请求吧，好像很少看到其它类型的请求
获取get请求参数
这里可以使用@Request装饰器与@Query装饰器，与express完全一致
上面已经演示了通过@Query获取，那就在通过@Request再演示一遍
// nanjiu.controller.ts
@Get()
findAll(@Request() req, @Query() query) {
console.log('find', req.query, query)
return this.nanjiuService.findAll();
}
通过req.query与Query获取的是一致的，所以使用@Query装饰器获取get类型的请求参数会更方便一些，如果你还想获取更多关于请求的参数可以使用@Request装饰器。
获取post请求参数
与express一样，可以使用@Request装饰器与Body装饰器
// nanjiu.controller.ts
@Post()
create(@Body() createNanjiuDto: CreateNanjiuDto) {
console.log('body', createNanjiuDto)
return this.nanjiuService.create(createNanjiuDto);
}
查看日志
动态路由
当需要接受动态数据作为请求的一部分（例如，GET /nanjiu/1获取带有 id 为 1的nanjiu）时，具有静态路径的路由将不起作用。为了定义带参数的路由，我们可以在路由的路径中添加路由参数**标记，以捕获请求 URL 中该位置的动态值。**下面装饰器示例中的路由参数标记@Get()演示了这种用法。以这种方式声明的路由参数可以使用装饰器来访问@Param()
// nanjiu.controller.ts
@Get(':id')
findOne(@Param() params) {
console.log('params', params)
return this.nanjiuService.findOne(+params.id);
}
查看日志
状态码
从上面几个例子我们可以看到，默认情况下响应状态码都是200，POST请求除外，POST默认为201，Nest同样提供了HttpCode()装饰器来自定义响应状态码
// nanjiu.controller.ts
@Get()
@HttpCode(202)
findAll(@Request() req, @Query() query) {
console.log('find', req, query)
return this.nanjiuService.findAll();
}
响应头
想要自定义响应头，可以使用@Header装饰器
@Post()
@Header('Cache-Control', 'none')
create(@Body() createNanjiuDto: CreateNanjiuDto) {
console.log('body', createNanjiuDto)
return this.nanjiuService.create(createNanjiuDto);
}