GraphQL-Tools 中的数据获取最佳实践-优快云博客

本文链接：https://blog.youkuaiyun.com/gitblog_01152/article/details/148505543

GraphQL-Tools 中的数据获取最佳实践

graphql-tools :wrench: Utility library for GraphQL to build, stitch and mock GraphQL schema using SDL 项目地址: https://gitcode.com/gh_mirrors/gr/graphql-tools

GraphQL-Tools 是一个强大的工具集，用于构建和维护 GraphQL 服务器。在实际应用中，如何高效地从后端获取数据是每个开发者都需要面对的问题。本文将深入探讨 GraphQL-Tools 中的数据获取策略，从基础实现到高级优化技巧。

基础数据获取方式

在 GraphQL 中，解析器(Resolver)是获取数据的核心。GraphQL.js 的解析器可以直接返回 Promise，这使得我们可以轻松地使用任何返回 Promise 的库来获取数据。

import { fetch } from '@whatwg-node/fetch'

const resolverMap = {
  Query: {
    async gitHubRepository(root, args, context) {
      const response = await fetch(`https://api.github.com/repos/${args.name}`)
      return response.json()
    }
  }
}

这种直接方式适合小型应用或快速原型开发，但随着应用规模扩大，我们需要更结构化的解决方案。

抽象数据获取层：连接器模式

当多个解析器需要访问相同的数据源时，直接将获取逻辑写在解析器中会导致代码重复和维护困难。这时，我们可以采用"连接器"(Connector)模式，将数据获取逻辑抽象到专门的模块中。

// github-connector.js
import { fetch } from '@whatwg-node/fetch'

const { GITHUB_API_KEY, GITHUB_API_SECRET } = process.env

export function getRepositoryByName(name) {
  const response = fetch(
    `https://api.github.com/repos/${name}?GITHUB_API_KEY=${GITHUB_API_KEY}&GITHUB_API_SECRET=${GITHUB_API_SECRET}`
  )
  return response.json()
}

然后在解析器中调用这个连接器：

import { getRepositoryByName } from './github-connector.js'

const resolverMap = {
  Query: {
    gitHubRepository(root, args, context) {
      return getRepositoryByName(args.name)
    }
  },
  Submission: {
    repository(root, args, context) {
      return getRepositoryByName(root.repositoryFullName)
    }
  }
}

这种模式的优势在于：

集中管理数据获取逻辑
便于统一处理认证和错误
方便后续优化（如添加缓存）

性能优化：使用 DataLoader 实现请求批处理和缓存

在复杂查询中，经常会遇到"N+1查询"问题。例如，查询多个仓库及其所有者信息时，可能会对同一个所有者发起多次重复请求。

DataLoader 工作原理

DataLoader 是 Facebook 开发的一个工具库，主要解决两个问题：

请求批处理：将多个数据请求合并为单个批量请求
请求缓存：在同一请求周期内缓存结果，避免重复获取

实现方式

关键是要为每个请求创建新的 DataLoader 实例，确保缓存不会在不同请求间共享：

import DataLoader from 'dataloader'
import { getAuthorByName } from './github-connector.js'

function createLoaders() {
  return {
    authorLoader: new DataLoader(names => 
      Promise.all(names.map(getAuthorByName)))
  }
}

// 在解析器中使用
const resolverMap = {
  Repository: {
    owner(root, args, context) {
      return context.loaders.authorLoader.load(root.owner)
    }
  }
}

// 服务器配置中为每个请求创建新的loaders
const server = new ApolloServer({
  schema,
  context: () => ({
    loaders: createLoaders()
  })
})