GraphQL接口规范

作者：胡小根

邮箱：[email protected]

更改历史

    2018-02-01    胡小根    初始化文档

1 历史、现状和发展

1.1 历史

1.2 现状

1.3 发展

难点：预测发展方向。

1.4 概念

GraphQL和GraphiQL

• GraphQL是技术
• GraphiQL是浏览器IDE，以使用接口

2 安装和使用

2.1 安装

2.2 使用

2.2.1 试一试

• http://graphql.org/swapi-graphql/
• https://github.com/APIs-guru/graphql-apis

2.3 示例

2.4 最佳实践

难点：最佳实践，超出于示例，应该归纳总结出积累的技巧。

2.5 工具

自动生成工具

• Prisma - turn your database into a GraphQL API

使用示例：https://www.graphqlbin.com/RVIn

• sql-to-graphql

示例：

sql2graphql -u root -p hm20150803 --database wordpress --output-dir=test

GraphQL IDE

Apollo

Chrome插件ChromeiQL

Cheome插件Altair GraphQL Client

2.6 类库

2.6.1 后端库

• Create GraphQL
• GraphQL-SPQR
• GraphQL Java Tools
• Create GraphQL
• DataLoader

2.7.1 前端库

3 同类技术对比

难点：归纳比对项

参考资料

• GraphQL中文官网
• awesome-graphql
• Awesome graphql-java
• 10+ Awesome Tools and Extensions For GraphQL APIs