GraphQl

follow howtographql.com tutorial

sql 是很好的数据请求描述方式。一个定义良好的 schema，完整的 doc 了 api
decouple( 解耦 , 分离 ) 前后端。rest 里，api 是 endpoint based，返回的数据结构由服务器端决定，而在 graphql 里由前端决定，将数据结构和 ui 摆在一起是现代前端开发最自然的方式。
一次请求可以取回 UI 组件所有需要的数据，让 batching 和 caching 更方便。

query / mutation / subscription

类型修饰
String 可 null
String! 不可 null
[String] 数组（可空，元素可 null）
[String!]! 不可空，元素不可 null
Query & Mutation, 参数写法

type Query {
    users(limit: Int = 10, sort: String = "asc"): [User]
}

input ListUsersInput {
    limit: Int
    since_id: ID
}

type Mutation {
    users(params: ListUsersInput): [User]!
}

query 和 mutation 类似函数声明，具体函数要在resolver里定义

fieldName(obj, args, context, info) { result }

obj: 父级 resolver 的返回值（顶层就是 rootValue），使得 nesting 成为可能
args: 参数
context: auth, dataloader, 数据库的值等，所有 resolvers 都接受的值
info: 不常用

npm i express body-parser apollo-server-express graphql-tools graphql

express body-parser express 服务器
apollo-server-express 使用 schema 处理服务器 req 和 res
graphql-tools
- 简化 graphql schema 的书写
- 提供makeExecutableSchema, 接受 typeDefs ( 一个 string), resolvers(objects), 生成真正可用的 graphql schema。
graphql

Provide feedback