GraphQL 简介
介绍
我们一直在使用 REST 架构来构建 API。这种架构至今仍被广泛使用，但它也存在一些问题。REST 存在一些问题，例如：必须使用多个 URL 以及过度获取数据。我们需要一个解决方案来获取所需的精确数据，而不是获取一堆我们无法触及的庞大对象。这正是 GraphQL 发挥作用的地方。
什么是 GraphQL
GraphQL 是由 Facebook 开发的一种开源查询语言。GraphQL
凭借其强大的查询语法，将数据以图的形式组织起来。由于数据的结构类似于图，我们可以像图一样对数据进行排序：遍历、检索和修改数据。它为我们提供了一种更高效的方式来设计、创建和使用 API。在后端，GraphQL 本质上是创建一个中间人服务来过滤我们从 API 中获取的内容。通过这种方式，它避免了数据过度获取和使用多个 URL。
GraphQL 入门
要工作，GraphQL 需要一个服务器和一个客户端。我们来谈谈服务器。我们可以将 graphQL 连接到 Node 服务器或任何其他类型的服务器。连接后，我们实际上会创建一个 Node/GraphQL 服务器或 Express/GraphQL 服务器。现在让我们使用 Express 来实现这一点。首先要做的是创建一个基本的 Express 服务器。接下来，我们需要创建一个 Express GraphQL 服务器。这
需要一个名为 express-graphql 的插件来创建一个 /graphql 端点。
设置服务器
const express = require('express')
const app = express()
const { graphqlHTTP } = require('express-graphql')
var schema = buildSchema(`
type Query {
welcome: String
}
`);
// root gives us a resolver
var root = {
welcome: () => {
return 'Welcome to the GraphQL World!';
},
};
app.use('/graphql', graphqlHTTP( req => {
return {
schema: schema,
rootValue: root,
graphiql: true,
}
}))
app.listen(3000)
console.log('Listening')
使获取数据更加高效
向 API 发送请求可能会返回超出我们实际需要的数据。GraphQL 允许我们向 API 发送查询来获取所需的数据。它限制了应该从服务器获取的数据。让我们来看一个查询数据的示例。
获取数据示例
// basic query
{
students {
id
firstName
}
}
// Result of the query
{
"data": {
"students": [
{
"id": "1",
"firstName": "Paula"
},
{
"id": "2",
"firstName": "Greg"
},
{
"id": "3",
"firstName": "Stephanie"
}
]
}
}
避免使用多个 URL
GraphQL 可以在单个请求中查询多个关系数据。这减少了对多个 URL/端点的需求。GraphQL 正是通过这种方式利用了选择性端点。
我们来看一个例子
谁需要多个 URL？示例
// multiple url query
{
student(id: "10"){
firstName
lastName
college{
name
location
}
}
}
/// result
{
"data": {
"students": [
{
"firstName": "Max",
"lastName": "Kelly",
"college": {
"name": " University",
"location": "Alabama"
}
},
}
}
通常我们需要向多个 URL 发送请求，但使用 GraphQL 我们只需一个请求即可完成此操作。
架构示例
type Query {
Students[Students!]!
}
type Mutation {
createStudent(collegeId:ID,firstName:String,lastName:String):String
updateStudent(collegeId:ID,firstName:String,lastName:String): Student!
deleteStudent(collegeId: ID!): Student!
}
type Student {
id:ID!
firstName:String!
lastName:String!
college:College
}
type College {
id:ID!
name:String!
location:String
students:[Student]
}
在这个模式中，我们设置了请求数据时的数据外观。我们还设置了一个可选的变更，以便我们实现对数据的修改。
突变
查询中的变更是可选的。它们相当于 REST 中的 CRUD 应用程序。变更是指我们修改服务器上的数据并获取更新后的数据的方式。通过这些变更，我们可以：创建、更新和删除数据条目。
结论
总而言之，GraphQL 使我们能够更轻松地选择从外部 API 接收的数据。GraphQL 与语言无关，因此可以轻松地与任何类型的语言集成。GraphQL 可以使用其中一些相同的技术和模式与数据库进行交互。尽管它的类型似乎更适合文档数据库，但它与文档数据库和关系数据库都能很好地兼容。
鏂囩珷鏉ユ簮锛�https://dev.to/neisha1618/an-introduction-to-graphql-462p