## 接口
像许多类型系统一样,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?