使用 Nest CLI 生成一个基本的控制器

使用 CLI 提供的 generate （别名：g） 命令生成一个基本的 users Controller （别名： co）：

$ nest g co users
CREATE /src/users/users.controller.spec.ts (478 bytes)
CREATE /src/users/users.controller.ts (99 bytes)
UPDATE /src/app.module.ts (658 bytes)

Nest CLI 会自动在 src 目录下创建一个 users 目录作为 users 模块，并且在 app.module.ts 中注入该控制器：

src/app.module.ts

import { Module } from '@nestjs/common';
import { UsersController } from './users/users.controller';

@Module({
  controllers: [UsersController],
})
export class ApplicationModule {}

src/users/user.controller.ts

import { Controller } from '@nestjs/common';

@Controller('users')
export class UsersController {}

控制器必须使用 @Controller() 装饰器修饰，传入的 'users' 就是该控制器中所有 action 的路由前缀。

去中心化的路由

首先在 user 控制器同级创建一个 interfaces 目录，并定义一个 User 接口：

src/users/interfaces/user.interface.ts

export interface User {
    readonly id: number;
    readonly name: string;
    readonly age: number;
}

现在给这个控制器添加一个获取所有用户的 action：

import { Controller, Get } from '@nestjs/common';
import { User } from './interfaces/user.interface';

@Controller('users')
export class UsersController {
    @Get()
    async findAll(): Promise<User[]> {

        return [{
            id: 1,
            name: '小明',
            age: 18
        }];
    }
}

有三个比较重要的地方：

Status Code: 200 OK    // 响应状态代码在默认情况下总是 200

Content-Type: application/json; charset=utf-8  // 当返回 JavaScript 对象或数组时, 它会自动转换为 JSON。当返回字符串, Nest 将只发送一个字符串而不尝试解析它。

X-Powered-By: Express  // 底层服务使用 Express

Nest 以同样的方式提供了其他的装饰器来处理不同类型的 HTTP请求 - @Put()，@Delete()，@Patch()，@Options()，@Head() 和 @All()。

    @Post()
    async create() {
        // TODO：创建新用户
    }

    @Put()
    async edit() {
        // TODO： 修改用户信息
    }

    @Delete()
    async remove() {
        // TODO：删除已有用户
    }

所有这些装饰器都从 @nestjs/common 包中导出：

import { Controller, Param, Get, Post, Put, Delete } from '@nestjs/common';

带参数的路由

和 Express 带参数的路由一样，只需要在 @Get() 装饰器中传入 " : + [ 参数名 ] "，新增一个 findOne Action：

    @Get(':id')
    async findOne(@Param() params): Promise<User> {
        
        return {
            id: params.id,
            name: '小明',
            age: 18
        };
    }

{"id":"44","name":"小明","age":18}

下面这个表就是 Nest 装饰器和 HTTP 请求上下文对象的映射关系：