## 映射类型
> <a style="color:orange;">该章节仅适用于代码优先模式。</a>
当你构建像 CRUD(创建/查询/更新/删除)这些功能时,在基础实体类型上构造变体通常会很有用。Nest 提供了几个执行类型转换的基础函数,让这项任务变得更加方便。
### Partial 局部
当创建输入验证类型(也被叫做 DTOs)时,同时构建**创建**或**更新**变体通常会很有用。例如,**创建**变体可能会需要全部字段,而**更新**变体则可能全部是可选字段。
Nest 提供了 `PartialType()` 这个基础函数来简化此任务并最大限度的减少模版文件。
`PartialType()` 函数返回了一个类型(类),其中输入类型的所有属性都设置为可选。例如,假设我们有一个如下的**创建**类型:
```typescript
@InputType()
class CreateUserInput {
@Field()
email: string;
@Field()
password: string;
@Field()
firstName: string;
}
```
默认情况下,所有这些字段都是必需的。为创建具有相同字段的类型,但每个字段又都是可选的,可以使用 `PartialType()` 传递类引用(`CreateUserInput`)作为参数:
```typescript
@InputType()
export class UpdateUserInput extends PartialType(CreateUserInput) {}
```
> `PartialType()` 函数是从 `@nestjs/graphql` 包里导出的。
`PartialType()` 函数接受一个可选的第二参数,它是对装饰器工厂的引用。此参数可用于更改应用于结果(子)类的装饰器函数。如果未指定,子类有效地使用与**父**类相同的装饰器(第一个参数中引用的类)。在上面的例子中,我们正在继承用 `@InputType()` 装饰器注释的 `CreateUserInput` 类。即使我们希望 `UpdateUserInput` 也被视为用 `@InputType()` 装饰过,我们不必传递 `InputType` 作为第二个参数。如果父类和子类不同,(例如,父类被 `@ObjectType` 装饰),我们才需要传递 `InputType` 作为第二个参数。例如:
```typescript
@InputType()
export class UpdateUserInput extends PartialType(User, InputType) {}
```
### Pick 选取
`PickType()` 函数可从一个输入类型中选取一组属性并构造一个新的类型(类)。例如,假设我们从这样一个类型开始:
```typescript
@InputType()
class CreateUserInput {
@Field()
email: string;
@Field()
password: string;
@Field()
firstName: string;
}
```
我们用 `PickType()` 这个基础函数从此类中挑选出一组属性:
```typescript
@InputType()
export class UpdateEmailInput extends PickType(CreateUserInput, ['email'] as const) {}
```
> `PickType()` 函数是从 `@nestjs/graphql` 包里导出的。
### Omit 忽略
`OmitType()` 函数通过从输入类型中选取所有属性然后删除一组特定的键来构造一个类型。例如,假设我们从这样一个类开始:
```typescript
@InputType()
class CreateUserInput {
@Field()
email: string;
@Field()
password: string;
@Field()
firstName: string;
}
```
我们可以生成一个派生类型,它具有除了 `email` 之外的所有属性,如下所示。在这个构造中,`OmitType` 的第二个参数是一个属性名数组。
> `OmitType()` 函数是从 `@nestjs/graphql` 包里导出的。
### Intersection 交集
`IntersectionType()` 函数是合并两个类型到一个新的类型(类)。例如,假设我们从这样一个类开始:
```typescript
@InputType()
class CreateUserInput {
@Field()
email: string;
@Field()
password: string;
}
@ObjectType()
export class AdditionalUserInfo {
@Field()
firstName: string;
@Field()
lastName: string;
}
```
我们可以把两个类型中的所有属性都合并起来生成一个新的类型。
```typescript
@InputType()
export class UpdateUserInput extends IntersectionType(CreateUserInput, AdditionalUserInfo) {}
```
> `IntersectionType()` 函数是从 `@nestjs/graphql` 包里导出的。
### Composition 组合
这些类型映射基础函数是可组合的。例如,以下代码会创建一个类型(类),它拥有 `CreateUserInput` 类型的除了 `email` 的所有属性,而且这些属性将被设置为可选:
```typescript
@InputType()
export class UpdateUserInput extends PartialType(
OmitType(CreateUserInput, ['email'] as const),
) {}
```
- 介绍
- 概述
- 第一步
- 控制器
- 提供者
- 模块
- 中间件
- 异常过滤器
- 管道
- 守卫
- 拦截器
- 自定义装饰器
- 基础知识
- 自定义提供者
- 异步提供者
- 动态模块
- 注入作用域
- 循环依赖
- 模块参考
- 懒加载模块
- 应用上下文
- 生命周期事件
- 跨平台
- 测试
- 技术
- 数据库
- Mongo
- 配置
- 验证
- 缓存
- 序列化
- 版本控制
- 定时任务
- 队列
- 日志
- Cookies
- 事件
- 压缩
- 文件上传
- 流式处理文件
- HTTP模块
- Session(会话)
- MVC
- 性能(Fastify)
- 服务器端事件发送
- 安全
- 认证(Authentication)
- 授权(Authorization)
- 加密和散列
- Helmet
- CORS(跨域请求)
- CSRF保护
- 限速
- GraphQL
- 快速开始
- 解析器(resolvers)
- 变更(Mutations)
- 订阅(Subscriptions)
- 标量(Scalars)
- 指令(directives)
- 接口(Interfaces)
- 联合类型
- 枚举(Enums)
- 字段中间件
- 映射类型
- 插件
- 复杂性
- 扩展
- CLI插件
- 生成SDL
- 其他功能
- 联合服务
- 迁移指南
- Websocket
- 网关
- 异常过滤器
- 管道
- 守卫
- 拦截器
- 适配器
- 微服务
- 概述
- Redis
- MQTT
- NATS
- RabbitMQ
- Kafka
- gRPC
- 自定义传输器
- 异常过滤器
- 管道
- 守卫
- 拦截器
- 独立应用
- Cli
- 概述
- 工作空间
- 库
- 用法
- 脚本
- Openapi
- 介绍
- 类型和参数
- 操作
- 安全
- 映射类型
- 装饰器
- CLI插件
- 其他特性
- 迁移指南
- 秘籍
- CRUD 生成器
- 热重载
- MikroORM
- TypeORM
- Mongoose
- 序列化
- 路由模块
- Swagger
- 健康检查
- CQRS
- 文档
- Prisma
- 静态服务
- Nest Commander
- 问答
- Serverless
- HTTP 适配器
- 全局路由前缀
- 混合应用
- HTTPS 和多服务器
- 请求生命周期
- 常见错误
- 实例
- 迁移指南
- 发现
- 谁在使用Nest?