首页 > > 网页制作 > Javascript >

完爆Facebook/GraphQL，APIJSON全方位对比解析(…

2018-07-17 04:14:04来源：博客园阅读 ()

特点功能

在线解析

自动生成文档，清晰可读永远最新
自动生成请求代码，支持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 是这样查的：

{
  user(id: 82001) {
    id
    sex
    name
    tag
    head
    contactIdList
    pictureList
    friends(first: 5) {
      name
    }
  }
}

返回结果是

{
    "data":{
        "user":{
            "id":82001,
            "sex":0,
            "name":"测试改名",
            "tag":"APIJSON User",
            "head":"https://static.oschina.net/uploads/user/19/39085_50.jpg",
            "contactIdList":[
                38710,
                82002,
                82006,
                82030,
                82025,
                82003,
                93793
            ],
            "pictureList":[
                "http://common.cnblogs.com/images/icon_weibo_24.png"
            ],
            "friends":[
                {
                    "name":"TommyLemon"
                },
                {
                    "name":"Happy~"
                },
                {
                    "name":"Wechat"
                },
                {
                    "name":"Meria"
                },
                {
                    "name":"Tommy"
                }
            ]
        }
    }
}

GraphQL 后端怎么知道 user 的类型是 User，friends 的 类型是 User数组 呢？

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

//声明 GraphQLObjectType 类型，包括字段 fields 和解析函数 resolver
var UserType = new GraphQLObjectType({
  name: 'User',
  fields: () => ({
    name: { type: GraphQLString },
    friends: {
      args: {
        first: { type: GraphQLInt }
      },
      type: new GraphQLList(UserType), //声明 friends 的类型是 User 数组
      resolve: (user, { first }) => { //查 friends 的解析函数
         var ids = user.contactIdList == null ? [] : user.contactIdList.join();
         return ctx.db.findAll(
           'SELECT name FROM User WHERE id IN(' + ids + ') LIMIT ' + first
         ).then(rows => rows.map(row => getUserFromRow(row)));
      }
    }
  })
});

//声明结构 Schema，包括 查询结构 Query
export const UserSchema = new GraphQLSchema({
  query: {
    user: {
      type: UserType //声明 me 的类型是 User
      fields: () => ({
        id: { type: new GraphQLNonNull(GraphQLID) },
        sex: { type: GraphQLInt },
        name: { type: GraphQLString },
        tag: { type: GraphQLString },
        head: { type: GraphQLString },
        contactIdList: { type: new GraphQLList(GraphQLID) },
        pictureList: { type: new GraphQLList(GraphQLString) }
      }),
      args: {
        id: { type: new GraphQLNonNull(GraphQLID) }
      },      
      resolve: ({ id }) => { //查 User 的解析函数
        return ctx.db.findOne(
          'SELECT * FROM User WHERE id = ' + id
        ).then(row => getUserFromRow(row));
      }
    }
  }
});

以上代码是根据官方代码

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 是这样查的：

{
  "User": {
    "id": 82001, //查询条件：id = 82001
    "User[]": { //数组，提取里面每一项的 User
      "count": 5, //前 5 条：LIMIT 0, 5
      "User": {
        "id{}@": "User/contactIdList", //在朋友id列表里：id IN contactIdList
        "@column": "name" //只查字段 name： SELECT name
      }
    }
  }
}

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

{
  "User": {
    "id": 82001    
  },
  "User[]": {
    "count": 5,
    "User": {
      "id{}@": "User/contactIdList",
      "@column": "name"
    }
  }
}

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

APIJSON 可以【提取字段】（GraphQL 未提供）

{
  "User": {
    "id": 82001    
  },
  "User-name[]": { //从数组里面每个 User 里取出 name
    "count": 5,
    "User": {
      "id{}@": "User/contactIdList",
      "@column": "name"
    }
  }
}

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

APIJSON 后端不用写任何代码，

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

SELECT * FROM User WHERE id = 82001

SELECT name FROM User WHERE id IN ${contactIdList} -- contactIdList 从上面的 User 取出

然后【自动执行】并返回对应结构的 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)

标签：

版权申明：本站文章部分自网络，如有侵权，请联系：west999com@outlook.com
特别注意：本站所有转载文章言论不代表本站观点，本站所提供的摄影照片，插画，设计作品，如需使用，请与原作者联系，版权归原作者所有

上一篇：JS浏览器的三种弹框：

下一篇：js实现进度条

前端从零开始学习Graphql 2019-08-14

IDC资讯：主机资讯注册资讯托管资讯 vps资讯网站建设

网站运营：建站经验策划盈利搜索优化网站推广免费资源

网站联盟：联盟新闻联盟介绍联盟点评网赚技巧

行业资讯：搜索引擎网络游戏电子商务广告传媒

网络编程： Asp.Net编程 Asp编程 Php编程 Xml编程 Access Mssql Mysql 其它

服务器技术： Web服务器 Ftp服务器 Mail服务器 Dns服务器安全防护

软件技巧：其它软件 Word Excel Powerpoint Ghost Vista QQ空间 QQ FlashGet 迅雷

网页制作： FrontPages Dreamweaver Javascript css photoshop fireworks Flash

程序设计： Java技术 C/C++ VB delphi

网络知识：网络协议网络安全网络管理组网方案 Cisco技术

操作系统： Win2000 WinXP Win2003 Mac OS Linux FreeBSD

热门词条

最新资讯

热门关注

热门标签