## 映射類型
> <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?