## 接口
像許多類型系統一樣,GraphQL 支持接口。 接口是一種抽象類型,它包含一組特定的字段,類型必須包含這些字段才能實現接口(在[此處](https://graphql.org/learn/schema/#interfaces)閱讀更多內容)。
### 代碼優先
當使用代碼優先方式時,你可以通過創建一個帶有 `@InterfaceType()` 裝飾器注釋的抽象類,來定義一個 GraphQL 接口,這個裝飾器是從 `@nestjs/graphql` 包里導出。
```typescript
import { Field, ID, InterfaceType } from '@nestjs/graphql';
@InterfaceType()
export abstract class Character {
@Field(type => ID)
id: string;
@Field()
name: string;
}
```
> TypeScript 接口不能用來定義 GraphQL 接口。
最終的結果是在 SDL 中生成以下部分的 GraphQL schema:
```graphql
interface Character {
id: ID!
name: String!
}
```
現在,使用 `implements` 關鍵字來實現 `Character` 這個接口:
```typescript
@ObjectType({
implements: () => [Character],
})
export class Human implements Character {
id: string;
name: string;
}
```
> `@ObjectType()` 裝飾器是從 `@nestjs/graphql` 包里導出。
默認的 `resolveType()` 函數是通過庫根據解析器方法返回值提取的類型來生成的。這意味著你必須返回類的實例(你不能返回 JavaScript 對象字面量)。
提供自定義的 `resolveType()` 函數,將 `resolveType` 屬性傳遞給 `@InterfaceType()` 裝飾器里的選項對象,如下所示:
```typescript
@InterfaceType({
resolveType(book) {
if (book.colors) {
return ColoringBook;
}
return TextBook;
},
})
export abstract class Book {
@Field(type => ID)
id: string;
@Field()
title: string;
}
```
### 模式優先
在模式優先方式中定義接口,只需使用 SDL 創建一個 GraphQL 接口。
```graphql
interface Character {
id: ID!
name: String!
}
```
然后,你可以使用類型生成功能(如[快速開始](/8/graphql?id=快速開始)章節所示)生成相應的 TypeScript 定義。
```typescript
export interface Character {
id: string;
name: string;
}
```
在解析器映射圖中,接口需要一個額外的 `__resolveType` 字段,來確定接口應該解析為哪個類型。讓我們創建一個 `CharactersResolver` 類并定義 `__resolveType` 方法:
```typescript
@Resolver('Character')
export class CharactersResolver {
@ResolveField()
__resolveType(value) {
if ('age' in value) {
return Person;
}
return null;
}
}
```
> 所有裝飾器都是從 `@nestjs/graphql` 包里導出。
- 介紹
- 概述
- 第一步
- 控制器
- 提供者
- 模塊
- 中間件
- 異常過濾器
- 管道
- 守衛
- 攔截器
- 自定義裝飾器
- 基礎知識
- 自定義提供者
- 異步提供者
- 動態模塊
- 注入作用域
- 循環依賴
- 模塊參考
- 懶加載模塊
- 應用上下文
- 生命周期事件
- 跨平臺
- 測試
- 技術
- 數據庫
- 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?