使用GraphQL构建灵活的API接口 - JavaScript

雨中漫步 2022-03-18 ⋅ 20 阅读

什么是GraphQL？

GraphQL是一种用于API接口的查询语言和运行时。它允许客户端精确地指定需要的数据，而不是像传统的REST远程过程调用（RPC）那样，由服务器决定返回什么数据。

GraphQL基于类型系统，使其易于理解和构造查询。它是由Facebook在2012年首次开发，并在2015年开源。

GraphQL具有以下特点：

精确的数据请求：客户端可以指定想要的字段和相关联的字段，减少了不必要的数据传输，提高了性能。
单个请求多个资源：通过一次查询可以获取多个资源的数据，减少了多次请求的次数，提高了效率。
自我文档化：GraphQL模式定义了可用字段和类型的约定，使其易于理解和操作。

为什么要使用GraphQL？

传统的RESTful API遇到以下一些问题：

过度获取数据：由于服务器返回的是预定义的固定数据结构，客户端可能需要多个请求来获取所需的信息，导致数据浪费和性能问题。
版本控制困难：RESTful API通常是直接与数据库模型关联的。当数据库模型更改时，API的不兼容性升级成为一个大问题。
API过细化或过粗化：客户端往往需要请求多个终端点才能获取所需的所有信息，造成查询的冗长或者混杂。

GraphQL的出现解决了上述问题：

精确查询：客户端可以通过查询语句精确指定需要的字段，避免了网络传输不必要的数据，也提高了应用的性能。
动态类型：GraphQL使用GraphQL模式定义字段和类型，当数据库模型更改时，没有回退兼容性问题。
单一终端点：GraphQL使用单个终端点，客户端可以一次性获取所需的所有信息，而不需要多个请求。

如何使用GraphQL？

在JavaScript中，有很多GraphQL服务和库可供选择。下面是一个使用apollo-server和node.js构建GraphQL API的例子：

首先，安装所需的包：npm install apollo-server graphql

创建GraphQL服务器：

const { ApolloServer, gql } = require('apollo-server');

const typeDefs = gql`
  type Query {
    hello: String
  }
`;

const resolvers = {
  Query: {
    hello: () => 'Hello world!',
  },
};

const server = new ApolloServer({ typeDefs, resolvers });

server.listen().then(({ url }) => {
  console.log(`Server ready at ${url}`);
});

运行服务器：node server.js，将会在http://localhost:4000/ 上启动GraphQL服务器。
在浏览器中打开GraphQL Playground，在左侧进行GraphQL查询：
```
query {
  hello
}
```
您将获得以下响应：
```
{
  "data": {
    "hello": "Hello world!"
  }
}
```

这只是GraphQL的入门示例。使用GraphQL，您可以构建更复杂和灵活的API接口，根据实际需求指定需要的数据，并减少客户端与服务器之间不必要的通信。

本文来自极简博客，作者：雨中漫步，转载请注明原文链接：使用GraphQL构建灵活的API接口 - JavaScript

#GraphQL

全部评论: 0 条

我有话说:

雨中漫步
- 800发布
- 0评论
收藏 0