GraphQL API 的查询语言

た入场券 2023-03-06 05:54 2阅读 0赞

[GraphQL][] 是一个用于 API 的查询语言，是一个使用基于类型系统来执行查询的服务端运行时（类型系统由你的数据定义）。GraphQL 并没有和任何特定数据库或者存储引擎绑定，而是依靠你现有的代码和数据支撑

![format_png][]

一、完整原则

确保图被明确定义、稳定且一致

[1. 单一图][1.]

你的公司应当只有一个统一的图，而不是多个团队分别创建的多个图。

[2. 联合实现][2.]

虽然只有一个图，但该图应该由多个团队联合实现。

[3. 追踪在注册表中的 Schema][3. _ Schema]

注册和追踪图时应当有一个单一的事实来源。

二、敏捷原则

快速推出图并适应不断变化的需求

[4. 抽象、面向需求的 Schema][4. _ Schema]

Schema 应当作为抽象层以隐藏服务实现细节并为消费者提供灵活性。

[5. 使用敏捷方法进行 Schema 开发][5. _ Schema]

Schema 应当根据实际需求增量构建，并随着时间的推移平滑演进。

[6. 迭代地提高性能][6.]

性能管理应当是一个连续的、数据驱动的过程，可以平滑地适应不断变化的查询负载和服务实现。

[7. 使用图的元数据为开发人员提供支持][7.]

开发人员应当在整个开发过程中对图充分了解

三、操作原则

安全地将图大规模部署到生产中

[8. 访问和需求控制][8.]

基于每个客户端授予对图的访问权限，并管理客户端可以访问的内容和方式。

[9. 结构化日志][9.]

捕获所有图操作的结构化日志，并以之为主要工具了解图的使用情况。

[10. 将 GraphQL 层从服务层分离][10. _ GraphQL]

采用分层架构将数据图功能分解为单独的层，而不是融入到每个服务中

参考：

[https://www.graphql-java.com/documentation][https_www.graphql-java.com_documentation]

[https://www.graphql-java.com/tutorials/getting-started-with-spring-boot/][https_www.graphql-java.com_tutorials_getting-started-with-spring-boot]

[https://graphql.cn/code/\#java][https_graphql.cn_code_java]

[GraphQL]: https://graphql.cn
[format_png]: /images/20230208/537609a097ea4d2a917c3e498087ecf8.png
[1.]: https://principles.graphql.cn/integrity#1-%E5%8D%95%E4%B8%80%E5%9B%BE
[2.]: https://principles.graphql.cn/integrity#2-%E8%81%94%E5%90%88%E5%AE%9E%E7%8E%B0
[3. _ Schema]: https://principles.graphql.cn/integrity#3-%E8%BF%BD%E8%B8%AA%E5%9C%A8%E6%B3%A8%E5%86%8C%E8%A1%A8%E4%B8%AD%E7%9A%84-schema
[4. _ Schema]: https://principles.graphql.cn/agility#4-%E6%8A%BD%E8%B1%A1%E3%80%81%E9%9D%A2%E5%90%91%E9%9C%80%E6%B1%82%E7%9A%84-schema
[5. _ Schema]: https://principles.graphql.cn/agility#5-%E4%BD%BF%E7%94%A8%E6%95%8F%E6%8D%B7%E6%96%B9%E6%B3%95%E8%BF%9B%E8%A1%8C-schema-%E5%BC%80%E5%8F%91
[6.]: https://principles.graphql.cn/agility#6-%E8%BF%AD%E4%BB%A3%E5%9C%B0%E6%8F%90%E9%AB%98%E6%80%A7%E8%83%BD
[7.]: https://principles.graphql.cn/agility#7-%E4%BD%BF%E7%94%A8%E5%9B%BE%E7%9A%84%E5%85%83%E6%95%B0%E6%8D%AE%E4%B8%BA%E5%BC%80%E5%8F%91%E4%BA%BA%E5%91%98%E6%8F%90%E4%BE%9B%E6%94%AF%E6%8C%81
[8.]: https://principles.graphql.cn/operations#8-%E8%AE%BF%E9%97%AE%E5%92%8C%E9%9C%80%E6%B1%82%E6%8E%A7%E5%88%B6
[9.]: https://principles.graphql.cn/operations#9-%E7%BB%93%E6%9E%84%E5%8C%96%E6%97%A5%E5%BF%97
[10. _ GraphQL]: https://principles.graphql.cn/operations#10-%E5%B0%86-graphql-%E5%B1%82%E4%BB%8E%E6%9C%8D%E5%8A%A1%E5%B1%82%E5%88%86%E7%A6%BB
[https_www.graphql-java.com_documentation]: https://www.graphql-java.com/documentation
[https_www.graphql-java.com_tutorials_getting-started-with-spring-boot]: https://www.graphql-java.com/tutorials/getting-started-with-spring-boot/
[https_graphql.cn_code_java]: https://graphql.cn/code/#java