相关阅读:

完爆Facebook/GraphQL,APIJSON全方位对比解析(一)-基础功能

完爆Facebook/GraphQL,APIJSON全方位对比解析(二)-权限控制

自APIJSON发布以来,不断有网友拿来和Facebook的GraphQL对比,

甚至有不少人声称“完爆”APIJSON。

然而事实正好相反,本系列博客将以大量真实依据来证明,

APIJSON“完爆”GraphQL!

APIJSON的口号是:

后端接口和文档自动化,前端(客户端) 定制返回JSON的数据和结构!

APIJSON的简介:

APIJSON是一种为API而生的JSON网络传输协议。
为 简单的增删改查、复杂的查询、简单的事务操作 提供了完全自动化的API。
能大幅降低开发和沟通成本,简化开发流程,缩短开发周期。
适合中小型前后端分离的项目,尤其是互联网创业项目和企业自用项目。

通过自动化API,前端可以定制任何数据、任何结构!
大部分HTTP请求后端再也不用写接口了,更不用写文档了!
前端再也不用和后端沟通接口或文档问题了!再也不会被文档各种错误坑了!
后端再也不用为了兼容旧接口写新版接口和文档了!再也不会被前端随时随地没完没了地烦了!

特点功能

在线解析

  • 自动生成文档,清晰可读永远最新
  • 自动生成请求代码,支持Android和iOS
  • 自动生成JavaBean文件,一键下载
  • 自动管理与测试接口用例,一键共享
  • 自动校验与格式化JSON,支持高亮和收展

对于前端

  • 不用再向后端催接口、求文档
  • 数据和结构完全定制,要啥有啥
  • 看请求知结果,所求即所得
  • 可一次获取任何数据、任何结构
  • 能去除重复数据,节省流量提高速度

对于后端

  • 提供通用接口,大部分API不用再写
  • 自动生成文档,不用再编写和维护
  • 自动校验权限、自动管理版本
  • 开放API无需划分版本,始终保持兼容
  • 支持增删改查、模糊搜索、正则匹配、远程函数等

视频演示:http://i.youku.com/apijson

[以下Gif图看起来比较卡,实际在手机上App运行很流畅] 
 

项目主页: https://github.com/TommyLemon/APIJSON

完爆Facebook/GraphQL,APIJSON全方位对比解析(三)-表关联查询

DB-Engines 发布了 2018 年 6 月份的数据库排名:

以及它们的历年发展走势:

很明显,Oracle, MySQL, Microsoft SQL Server 常年稳占前三名,

并且大幅超过其他数据库,只有这3个的 Score 在1000以上。

PostgreSQL 近年稳步上升,已跃居第4名。

以上前4大最流行的数据库都有一个共同点 —— 它们都是【关系型数据库】

APIJSON 和 GraphQL 作为和 HTTP API 相关的通用开源项目,都必须支持 关系型数据库。

然后它们虽然都支持,但 APIJSON “完爆” GraphQL !

用 GraphQL 实现表关联查询是复杂繁琐的,而用 APIJSON 则非常简单方便!

关系型数据库之所以称之为“关系”型数据库,是因为它们能很好地支持表关联查询

例如 查询当前用户的【全部信息】和TA的前5个朋友的【名字】

GraphQL 是这样查的:

  1. {
  2. user(id: 82001) {
  3. id
  4. sex
  5. name
  6. tag
  7. head
  8. contactIdList
  9. pictureList
  10. friends(first: 5) {
  11. name
  12. }
  13. }
  14. }

返回结果是

  1. {
  2. "data":{
  3. "user":{
  4. "id":82001,
  5. "sex":0,
  6. "name":"测试改名",
  7. "tag":"APIJSON User",
  8. "head":"https://static.oschina.net/uploads/user/19/39085_50.jpg",
  9. "contactIdList":[
  10. 38710,
  11. 82002,
  12. 82006,
  13. 82030,
  14. 82025,
  15. 82003,
  16. 93793
  17. ],
  18. "pictureList":[
  19. "http://common.cnblogs.com/images/icon_weibo_24.png"
  20. ],
  21. "friends":[
  22. {
  23. "name":"TommyLemon"
  24. },
  25. {
  26. "name":"Happy~"
  27. },
  28. {
  29. "name":"Wechat"
  30. },
  31. {
  32. "name":"Meria"
  33. },
  34. {
  35. "name":"Tommy"
  36. }
  37. ]
  38. }
  39. }
  40. }
  1. GraphQL 后端怎么知道 user 的类型是 Userfriends 类型是 User数组 呢?

因为后端提前用大量代码写死了数据结构和解析方式,也就是 Type 和 Schema :

  1. //声明 GraphQLObjectType 类型,包括字段 fields 和解析函数 resolver
  2. var UserType = new GraphQLObjectType({
  3. name: 'User',
  4. fields: () => ({
  5. name: { type: GraphQLString },
  6. friends: {
  7. args: {
  8. first: { type: GraphQLInt }
  9. },
  10. type: new GraphQLList(UserType), //声明 friends 的类型是 User 数组
  11. resolve: (user, { first }) => { //查 friends 的解析函数
  12. var ids = user.contactIdList == null ? [] : user.contactIdList.join();
  13. return ctx.db.findAll(
  14. 'SELECT name FROM User WHERE id IN(' + ids + ') LIMIT ' + first
  15. ).then(rows => rows.map(row => getUserFromRow(row)));
  16. }
  17. }
  18. })
  19. });
  1. //声明结构 Schema,包括 查询结构 Query
  2. export const UserSchema = new GraphQLSchema({
  3. query: {
  4. user: {
  5. type: UserType //声明 me 的类型是 User
  6. fields: () => ({
  7. id: { type: new GraphQLNonNull(GraphQLID) },
  8. sex: { type: GraphQLInt },
  9. name: { type: GraphQLString },
  10. tag: { type: GraphQLString },
  11. head: { type: GraphQLString },
  12. contactIdList: { type: new GraphQLList(GraphQLID) },
  13. pictureList: { type: new GraphQLList(GraphQLString) }
  14. }),
  15. args: {
  16. id: { type: new GraphQLNonNull(GraphQLID) }
  17. },
  18. resolve: ({ id }) => { //查 User 的解析函数
  19. return ctx.db.findOne(
  20. 'SELECT * FROM User WHERE id = ' + id
  21. ).then(row => getUserFromRow(row));
  22. }
  23. }
  24. }
  25. });
  1. 以上代码是根据官方代码

https://github.com/graphql/graphql-js/blob/master/src/__tests__/starWarsSchema.js

https://github.com/facebook/dataloader

http://apijson.org 提供测试的数据库表 来实现的。

GraphQL 用 JavaScript 就这么复杂繁琐了,用 Java,C# 等静态类型语言会麻烦几倍!

APIJSON 是这样查的:

  1. {
  2. "User": {
  3. "id": 82001, //查询条件:id = 82001
  4. "User[]": { //数组,提取里面每一项的 User
  5. "count": 5, //前 5 条:LIMIT 0, 5
  6. "User": {
  7. "id{}@": "User/contactIdList", //在朋友id列表里:id IN contactIdList
  8. "@column": "name" //只查字段 name: SELECT name
  9. }
  10. }
  11. }
  12. }

或者把 User 数组放到外面减少嵌套层级(不知道GraphQL怎么实现,知道的留个评论谢谢)

  1. {
  2. "User": {
  3. "id": 82001
  4. },
  5. "User[]": {
  6. "count": 5,
  7. "User": {
  8. "id{}@": "User/contactIdList",
  9. "@column": "name"
  10. }
  11. }
  12. }

User 数组里每个对象里都只有 name 这一个字段,如果想去掉多余的一层包装,

APIJSON 可以【提取字段】(GraphQL 未提供)

  1. {
  2. "User": {
  3. "id": 82001
  4. },
  5. "User-name[]": { //从数组里面每个 User 里取出 name
  6. "count": 5,
  7. "User": {
  8. "id{}@": "User/contactIdList",
  9. "@column": "name"
  10. }
  11. }
  12. }

以上信息已经充分描述了 表、字段、查询条件、表关联方式 等信息。

 APIJSON 后端不用写任何代码,

 它会【完全自动】地 将以上请求 JSON 自动解析成 SQL 语句

  1. SELECT * FROM User WHERE id = 82001
  1. SELECT name FROM User WHERE id IN ${contactIdList} -- contactIdList 从上面的 User 取出
  1. 然后【自动执行】并返回对应结构的 JSON 结果!

点左边 [ '/" ] 按钮可以将数组符号 [] 转为单词 List 哦(用 JSONResponse.format 格式化)

注: 以上APIJSON请求都可以在 http://apijson.org 在线工具上测试

后期预告:

完爆Facebook/GraphQL,APIJSON全方位对比解析

—— 数据结构灵活性、接口安全性、接口工具、社区生态、静态类型/强类型 语言 ...

总结

用 GraphQL 实现表关联查询是复杂繁琐的,后端要写大量代码,容易出错、扩展麻烦!

而用 APIJSON 则非常简单方便,后端不用写任何代码,完全自动解析,没有维护成本!

APIJSON,让后端接口和文档自动化,前端(客户端) 定制返回JSON的数据和结构!

创作不易,右上角点Star支持下吧,非常感谢^_^

https://github.com/TommyLemon/APIJSON (Java Server, Anroid, iOS, JavaScript)

https://github.com/liaozb/APIJSON.NET (C# .NET Core Server)

完爆Facebook/GraphQL,APIJSON全方位对比解析(三)-表关联查询的更多相关文章

  1. 数据库管理哪家强?Devart VS Navicat 360°全方位对比解析

    今天小编向大家推荐的是两个开发环节的主流数据库管理品牌,那么你知道这两款数据库管理软件品牌与数据库引擎配套的管理软件有什么区别吗?小编这就360°全方位为您解答: ★ 品牌介绍 Devart:拥有超过 ...

  2. libgo协程库:网络性能完爆ASIO异步模型(-O3测试)

    在purecpp社区的github组织中有一个协程库:https://github.com/yyzybb537/libgo 近日有用户找到我,想要了解一下libgo库在网络方面的性能,于是选取已入选标 ...

  3. 【kudu pk parquet】TPC-H Query2对比解析

    这是[kudu pk parquet]的第二篇,query2在kudu和parquet上的对比解析,其中kudu包含有不能下发的谓词. 3台物理机,1T规模的数据集,impala和kudu版本是我们修 ...

  4. Zsh vs. Bash不完全对比解析,zsh是一种更强大的被成为“终极”的Shell

    https://www.zhihu.com/question/21418449 Mort | Zsh vs. Bash:不完全对比解析(1) 2014-10-07  bdpqlxz     Zsh和B ...

  5. 十一、从头到尾彻底解析Hash 表算法

    在研究MonetDB时深入的学习了hash算法,看了作者的文章很有感触,所以转发,希望能够使更多人受益! 十一.从头到尾彻底解析Hash 表算法 作者:July.wuliming.pkuoliver  ...

  6. 从头到尾彻底解析Hash表算法

    作者:July.wuliming.pkuoliver 说明:本文分为三部分内容, 第一部分为一道百度面试题Top K算法的详解:第二部分为关于Hash表算法的详细阐述:第三部分为打造一个最快的Hash ...

  7. 从头到尾解析Hash表算法

    via:点击打开链接 十一.从头到尾解析Hash 表算法 作者:July.wuliming.pkuoliver   出处:http://blog.csdn.net/v_JULY_v.   说明:本文分 ...

  8. 从头到尾彻底解析Hash 表算法

    作者:July.wuliming.pkuoliver  出处:http://blog.csdn.net/v_JULY_v.  说明:本文分为三部分内容,    第一部分为一道百度面试题Top K算法的 ...

  9. 【原创】分布式之数据库和缓存双写一致性方案解析(三) 前端面试送命题(二)-callback,promise,generator,async-await JS的进阶技巧 前端面试送命题(一)-JS三座大山 Nodejs的运行原理-科普篇 优化设计提高sql类数据库的性能 简单理解token机制

    [原创]分布式之数据库和缓存双写一致性方案解析(三)   正文 博主本来觉得,<分布式之数据库和缓存双写一致性方案解析>,一文已经十分清晰.然而这一两天,有人在微信上私聊我,觉得应该要采用 ...

随机推荐

  1. Node.js环境搭建和学习(windwos环境)

    Node.js环境搭建和学习 一.环境搭建 1.下载安装文件 下载地址http://nodejs-org.qiniudn.com/下载Node.js环境安装包,根据操作系统下载对应的安装包 下载地址 ...

  2. selenium-键盘和鼠标事件

    常见的键盘操作 from selenium.webdriver.common.keys import Keys 模拟enter键:send_keys(Keys.ENTER)键盘F1~F12: send ...

  3. 等我干IT发财了,就和你离婚。。。。。

    01 “等我干IT发财了,就和你离婚” 他淡淡地说 听完后,她心里暖暖的, 她想,没有比这更天长地久. 海枯石烂的承诺了. ——2018年度最佳微小说奖 02 “等我干IT发财了,我就买房和你结婚.” ...

  4. October 10th 2017 Week 41st Tuesday

    If you focus on what you left behind you will never see what lies ahead. 如果你只顾回头看,那么你永远也看不见前方有什么. Ye ...

  5. Spring Boot 的 Security 安全控制

    Spring Security 是一个强大且高度可定制的身份验证和访问控制框架,完全基于 Spring 的应用程序的标准,Spring Security 为基于 Java EE 的企业应用程序提供了一 ...

  6. beta阶段学习博客(一) js交互

    js交互 js交互的三种方法

  7. 【项目 · Wonderland】预则立 && 他山之石

    [软 工 实 践 · 团 队 作 业] 预则立&&他山之石 标签:WonderLand Part 0 · 简要目录 Part 1 · 团队计划 Part 2 · 团队访谈 Part 3 ...

  8. SVN 图标不显示的解决办法

    SVN 的图标没办法显示了.经搜索,发现需要修改注册表 HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion\Explorer\Sh ...

  9. UltraISO制作使用(服务器装机u盘制作)

    1.准备工作: 1)U盘一个,需要格式化(大于4G,毕竟ISO文件就已经大于4G了) 2)CentOS7.1 iso文件一个(去这里下载:http://www.centoscn.com/) 3)Ult ...

  10. mtime参数的理解

    mtime参数的理解应该如下:-mtime n 按照文件的更改时间来找文件,n为整数.n表示文件更改时间距离为n天, -n表示文件更改时间距离在n天以内,+n表示文件更改时间距离在n天以前.例如:-m ...