GraphQL + Node 实践（二）：从入门到应用，构建你的 GraphQL API

前端

2023-09-08 10:52:54

1. GraphQL 基础知识储备

在开始构建 GraphQL API 之前，让我们先回顾一些基本知识。

1.1 什么是 GraphQL？

GraphQL 是一种查询语言，用于 API 的数据请求。它允许客户端指定要从服务器获取的确切数据，而不是像 REST API 那样获取整个资源。这使得 GraphQL 更加灵活和高效，尤其是当需要从复杂数据结构中提取特定信息时。

1.2 GraphQL 的优势

灵活的数据获取： GraphQL 允许客户端指定要获取的确切数据，而不是像 REST API 那样获取整个资源。
高效的数据传输： GraphQL 只返回客户端请求的数据，减少了不必要的数据传输。
强类型系统： GraphQL 使用类型系统来定义数据的结构和类型，有助于减少错误并提高代码的可维护性。
可扩展性： GraphQL 的架构设计使其易于扩展，可以轻松添加新的数据源和功能。

1.3 GraphQL 的缺点

学习曲线： GraphQL 的学习曲线比 REST API 更陡峭，需要花费更多的时间来掌握。
工具支持： GraphQL 的工具支持不如 REST API 丰富，尤其是对于一些不那么流行的编程语言。
性能： GraphQL 的性能可能不如 REST API，尤其是在处理大量数据时。

2. GraphQL + Node.js 实践

现在，我们已经了解了 GraphQL 的基础知识，让我们开始使用 Node.js 构建一个 GraphQL API。

2.1 安装必要的软件包

首先，我们需要安装必要的软件包。

npm install --save express graphql apollo-server-express graphql-tools

2.2 创建 GraphQL 类型定义 schema

接下来，我们需要创建一个 GraphQL 类型定义 schema。schema 定义了 API 中的数据类型和字段。

// 定义 GraphQL 类型
const typeDefs = `
  type Query {
    hello: String
  }
`;

2.3 创建 GraphQL 解析器

解析器是用来处理 GraphQL 查询和变动的函数。

// 定义 GraphQL 解析器
const resolvers = {
  Query: {
    hello: () => 'Hello, world!'
  }
};

2.4 创建 GraphQL 服务端

接下来，我们需要创建一个 GraphQL 服务端。

// 创建 GraphQL 服务端
const server = new ApolloServer({
  typeDefs,
  resolvers
});

// 启动 GraphQL 服务端
server.listen().then(({ url }) => {
  console.log(`🚀 Server ready at ${url}`);
});

2.5 创建 GraphQL 客户端

最后，我们需要创建一个 GraphQL 客户端来发送查询和变动。

// 创建 GraphQL 客户端
const client = new ApolloClient({
  uri: 'http://localhost:4000/graphql'
});

// 发送 GraphQL 查询
client.query({
  query: `{ hello }`
}).then(result => {
  console.log(result.data.hello); // "Hello, world!"
});