前言
在 Web 开发中，API 是一个非常重要的部分。RESTful API 是目前最常用的 API 架构之一，但是在 2015 年，Facebook 推出了一种新型的 API 架构，叫做 GraphQL。GraphQL 被认为是 RESTful API 的一种替代方案，也是越来越受欢迎的选择。
本文将介绍 GraphQL 和 RESTful API 的区别，并以 Mercurius 为例进行对比。Mercurius 是一个基于 GraphQL 的 Node.js 库，用于构建 GraphQL 服务器。
GraphQL 和 RESTful API 的区别
数据获取方式
RESTful API 通常通过 HTTP 请求获取数据，每个请求都对应一个资源。例如，如果要获取某个用户的信息，可以向 /users/{id} 发送 GET 请求。如果要获取所有用户的信息，则可以向 /users 发送 GET 请求。
相比之下，GraphQL 通过一个查询语言来获取数据。客户端可以编写一个查询，包含所需的所有字段和关联。这个查询将被发送到服务器，服务器将返回与查询匹配的数据。
数据格式
RESTful API 通常返回 JSON 或 XML 格式的数据。客户端需要解析这些数据，以便在应用程序中使用。
GraphQL 返回一个 JSON 格式的数据对象，其中包含客户端请求的所有字段和关联。客户端可以直接使用这个对象，而不需要进行解析。
性能
RESTful API 的性能通常受到两个因素的影响：请求次数和返回的数据量。由于每个请求只能获取一个资源，因此需要多次请求才能获取所有所需的数据。此外，返回的数据中可能包含不需要的字段，这会浪费带宽和处理时间。
相比之下，GraphQL 可以一次性获取多个资源，并只返回客户端所需的字段。这可以减少请求次数和返回的数据量，从而提高性能。
缓存
RESTful API 可以使用 HTTP 缓存来提高性能。如果客户端发送一个带有适当缓存头的请求，则服务器可以返回一个 304 响应，表示数据没有变化。这可以减少带宽和服务器负载。
GraphQL 没有内置的缓存机制，但是可以使用现有的缓存工具来缓存查询结果。
适用场景
RESTful API 适用于简单的数据获取场景，例如获取单个资源或列表。它也适用于需要遵循标准 HTTP 方法和状态码的场景。
GraphQL 适用于复杂的数据获取场景，例如获取多个资源或关联的资源。它也适用于需要动态查询字段的场景，例如搜索。
Mercurius 的示例代码
下面是使用 Mercurius 构建 GraphQL 服务器的示例代码。这个服务器提供了一个简单的查询，用于获取所有用户的信息。
// javascriptcn.com 代码示例
const { ApolloServer, gql } = require('apollo-server');
const users = [
{ id: 1, name: 'Alice', email: 'alice@example.com' },
{ id: 2, name: 'Bob', email: 'bob@example.com' },
{ id: 3, name: 'Charlie', email: 'charlie@example.com' },
];
const typeDefs = gql`
type User {
id: ID!
name: String!
email: String!
}
type Query {
users: [User!]!
}
`;
const resolvers = {
Query: {
users: () => users,
},
};
const server = new ApolloServer({ typeDefs, resolvers });
server.listen().then(({ url }) => {
console.log(`🚀 Server ready at ${url}`);
});客户端可以使用以下查询来获取所有用户的信息：
query {
users {
id
name
email
}
}总结
GraphQL 和 RESTful API 都有自己的优点和适用场景。RESTful API 适用于简单的数据获取场景，而 GraphQL 适用于复杂的数据获取场景。在选择 API 架构时，需要考虑到具体的业务场景和需求，选择最适合的方案。
来源：JavaScript中文网 ，转载请注明来源 https://www.javascriptcn.com/post/65072d4995b1f8cacd2b54dc