准备
简介：用于封装数据并将其从一个应用程序发送到另一个应用程序，帮助我们定义系统内的接口或输入和输出
// nest g class coffees/dto/create-coffee.dto --no-spec
基础
确保POST等传递的对象是我们约定的对象结构
// create-coffee.dto.ts export class CreateCoffeeDto { // id一般由数据库自动生成，所以不传 name: string; brand: string; flavors: string[]; }
然后就可以在controller中修改所有用到body的对象
@Post() create(@Body() body) { return body; } //----修改为---- @Post() create(@Body() createCoffeeDto:CreateCoffeeDto) { return this.coffeeService.create(createCoffeeDto); } // 这样我们就有了完整的类型检查
Dto的另一个最佳实践就是使用readonly
export class CreateCoffeeDto { readonly name: string; readonly brand: string; readonly flavors: string[]; }
同样的，生成用于更新操作的dto
// nest g class coffees/dto/update-coffee.dto --no-spec
更新的区别就是我们希望对象中的属性是可选的
export class UpdateCoffeeDto { readonly name?: string; readonly brand?: string; readonly flavors?: string[]; }
然后在PATCH中修改
@Patch(':id') update(@Param('id') id: string, @Body() updateCoffeeDto:UpdateCoffeeDto) { return this.coffeeService.update(id, updateCoffeeDto); }
验证传入的请求(ValidationPipe)
- 首先全局引入这个对象：
// main.ts中 async function bootstrap() { const app = await NestFactory.create(AppModule); app.useGlobalPipes(new ValidationPipe()); // 这里 await app.listen(3000); } bootstrap();
- 然后安装：
// npm i class-validator class-transformer
- 在
DTO中添加规则
import { IsString } from 'class-validator'; export class CreateCoffeeDto { @IsString() readonly name: string; @IsString() readonly brand: string; @IsString({each: true}) // each:true代表期望的是一个字符串数组 readonly flavors: string[]; } // 它还有很多其他有用的规则，请查看文档
测试
此时，如果我们请求的数据不符合我们的规则，就会返回400
POST http://localhost:3000/coffees
{ "name":"Shipwreak Roast" } // 返回 { "statusCode": 400, "message": [ "brand must be a string", "each value in flavors must be a string" ], "error": "Bad Request" }
{ "name":"Shipwreak Roast", "brand":"Buddy Brew", "flavors":[1,2] } // 返回 { "statusCode": 400, "message": [ "each value in flavors must be a string" ], "error": "Bad Request" }
{ "name":"Shipwreak Roast", "brand":"Buddy Brew", "flavors":["caramel"] } // 返回 201 Created
修改UpdateCoffeeDto
但是此时我们会发现代码基本和create的一致，所以多余了
nest提供了mapped-types帮助我们快速执行这些类型的常见转换
// update-coffee.dto.ts import { PartialType } from '@nestjs/mapped-types'; import { CreateCoffeeDto } from './create-coffee.dto'; // PartialType代表所有参数可选 export class UpdateCoffeeDto extends PartialType(CreateCoffeeDto){}
然后PATCH http://localhost:3000/coffees/1
{ "name":"Shipwreak Roast" } // 返回 200 OK
白名单
过滤掉不应由方法处理程序接收的属性
// main.ts app.useGlobalPipes(new ValidationPipe({ whitelist: true, }));
假设我们希望用户在创建新咖啡时将无效属性传递给我们的CoffeesController的POST请求，此配置可以确保那些无效的属性自动剥离和删除
app.useGlobalPipes(new ValidationPipe({ whitelist: true, forbidNonWhitelisted: true, }));
添加这个选项可以抛出异常并告诉我们哪个属性是多余的。
@Post() create(@Body() createCoffeeDto:CreateCoffeeDto) { console.log(createCoffeeDto instanceof CreateCoffeeDto); // false return this.coffeeService.create(createCoffeeDto); }
transform
我们发现传递过来的对象并不是CreateCoffeeDto的实例，为此设置transform选项
php
// main.ts app.useGlobalPipes(new ValidationPipe({ whitelist: true, transform: true, forbidNonWhitelisted: true, }));、
console.log(createCoffeeDto instanceof CreateCoffeeDto);这里就会变为true；
还可以进行一些基础类型如bool、number、string的转换
@Get(':id') findOne(@Param('id') id: string) { return this.coffeeService.findOne(id); } // id在路由中会是字符串，这里我们直接设置为number，它就会自动转换为number @Get(':id') findOne(@Param('id') id: number) { return this.coffeeService.findOne(id); }
简单来说设置了这个选项就会将网络传递过来的参数自动转换为我们期望的数据类型，这个会对性能有一定的影响，请确保它是有效的。
