## 插件
> **提醒**:本章僅適用于 `@nestjs/apollo` 驅動程序。
插件能讓你通過響應某些特定事件時執行自定義操作,來擴展 Apollo Server 的核心功能。現在,這些事件對應 GraphQL 請求生命周期的各個階段,以及 Apollo Server 本身的啟動階段(參見[這里](https://www.apollographql.com/docs/apollo-server/integrations/plugins/))。比如,一個基本的日志插件可能會記錄每一個發送給 Apollo Server 請求的相關 GraphQL 查詢字符串。
### 自定義插件
創建插件,首先要聲明一個用 `@Plugin` 裝飾器注釋的類,這個裝飾器是從 `@nestjs/graphql` 包里導出的。還有,為了更好的使用代碼自動補全功能,我們要從 `Apollo-server-plugin-base` 包中實現 `ApolloServerPlugin` 這個接口。
```typescript
import { Plugin } from '@nestjs/graphql';
import {
ApolloServerPlugin,
GraphQLRequestListener,
} from 'apollo-server-plugin-base';
@Plugin()
export class LoggingPlugin implements ApolloServerPlugin {
requestDidStart(): GraphQLRequestListener {
console.log('Request started');
return {
willSendResponse() {
console.log('Will send response');
},
};
}
}
```
有了下面這段代碼,我們就可以將 `LoggingPlugin` 注冊為一個提供者。
```typescript
@Module({
providers: [LoggingPlugin],
})
export class CommonModule {}
```
Nest 會自動實例化一個插件并將其應用于 Apollo 服務。
### 使用外部插件
有幾個開箱即用的插件。使用一個現成的插件,只需將它導入并加入到 `plugins` 數組即可:
```typescript
GraphQLModule.forRoot({
// ...
plugins: [ApolloServerOperationRegistry({ /* options */})]
}),
```
> `ApolloServerOperationRegistry` 插件是從 `apollo-server-plugin-operation-registry` 包里導出的。
- 介紹
- 概述
- 第一步
- 控制器
- 提供者
- 模塊
- 中間件
- 異常過濾器
- 管道
- 守衛
- 攔截器
- 自定義裝飾器
- 基礎知識
- 自定義提供者
- 異步提供者
- 動態模塊
- 注入作用域
- 循環依賴
- 模塊參考
- 懶加載模塊
- 應用上下文
- 生命周期事件
- 跨平臺
- 測試
- 技術
- 數據庫
- 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?