GraphQL 是由 Facebook 创造的用于描述复杂数据模型的一种查询语言。这里查询语言所指的并不是常规意义上的类似 sql 语句的查询语言，而是一种用于前后端数据查询方式的规范

Restful的不足

• 扩展性，单个RESTful接口返回数据越来越臃肿
• 某个前端展现，实际需要调用多个独立的RESTful API才能获取到足够的数据

GraphQL的优势

• 按需索取数据
• 一次查询多个数据
• API演进无需划分版本

查询规范

字段

在GraphQL的查询中，请求结构中包含了所预期结果的结构，这个就是字段。并且响应的结构和请求结构基本一致

{
  hero {
    name
  }
}

{
  "data": {
    "hero": {
      "name": "R2-D2"
    }
  }
}

参数

语法：(参数名:参数值)

{
  human(id: "1000") {
    name
    height
  }
}

{
  "data": {
    "human": {
      "name": "Luke Skywalker",
      "height": 1.72
    }
  }
}

别名

如果一次查询多个相同对象，但是值不同，这个时候就需要起别名了，否则json的语法就不能通过了

{
  empireHero: hero(episode: EMPIRE) {
    name
  }
  jediHero: hero(episode: JEDI) {
    name
  }
}

{
  "data": {
    "empireHero": {
      "name": "Luke Skywalker"
    },
    "jediHero": {
      "name": "R2-D2"
    }
  }
}

片段

查询对的属相如果相同，可以采用片段的方式进行简化定义

{
  leftComparison: hero(episode: EMPIRE) {
    ...comparisonFields
  }
  rightComparison: hero(episode: JEDI) {
    ...comparisonFields
  }
}

fragment comparisonFields on Character {
  name
  appearsIn
  friends {
    name
  }
}

{
  "data": {
    "leftComparison": {
      "name": "Luke Skywalker",
      "appearsIn": [
        "NEWHOPE",
        "EMPIRE",
        "JEDI"
      ],
      "friends": [
        {
          "name": "Han Solo"
        },
        {
          "name": "Leia Organa"
        },
        {
          "name": "C-3PO"
        },
        {
          "name": "R2-D2"
        }
      ]
    },
    "rightComparison": {
      "name": "R2-D2",
      "appearsIn": [
        "NEWHOPE",
        "EMPIRE",
        "JEDI"
      ],
      "friends": [
        {
          "name": "Luke Skywalker"
        },
        {
          "name": "Han Solo"
        },
        {
          "name": "Leia Organa"
        }
      ]
    }
  }
}

Schema

Schema 是用于定义数据结构的，比如说，User对象中有哪些属性，对象与对象之间是什么关系等

schema { #定义查询 
    query: UserQuery 
}
type UserQuery { #定义查询的类型 
    user(id:ID) : User #指定对象以及参数类型 
}
type User {#定义对象 
    id:ID! # !表示该属性是非空项 
    name:String age:Int 
}

类型规范

标量类型

• Int ：有符号 32 位整数。
• Float ：有符号双精度浮点值。
• String ：UTF‐8 字符序列。
• Boolean ： true 或者 false 。 ID ：
• ID 标量类型表示一个唯一标识符，通常用以重新获取对象或者作为缓存中的键。

枚举类型

枚举类型是一种特殊的标量，它限制在一个特殊的可选值集合内

enum Episode { # 定义枚举
  NEWHOPE
  EMPIRE
  JEDI
}
type Character { # 使用枚举
  name: String!
  appearsIn: [Episode]!
}

接口

跟许多类型系统一样，GraphQL 支持接口。一个接口是一个抽象类型，它包含某些字段，而对象类型必须包含这些字段，才能算实现了这个接口

interface Character {
  id: ID!
  name: String!
  friends: [Character]
  appearsIn: [Episode]!
}
type Human implements Character {
  id: ID!
  name: String!
  friends: [Character]
  appearsIn: [Episode]!
  starships: [Starship]
  totalCredits: Int
}