+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ * [腾讯科技有限公司](https://www.tencent.com)
+ * [腾讯音乐娱乐集团](https://www.tencentmusic.com)
+ * [深圳市传音通讯有限公司](https://www.transsion.com)
+ * [社宝信息科技（上海）有限公司](https://shebaochina.com)
+ * [华能贵诚信托有限公司](https://www.hngtrust.com)
+ * [投投科技](https://www.toutou.com.cn)
+ * [圆通速递](https://www.yto.net.cn)
+ * [乐拼科技](https://www.lepinyongche.com)
+ * [珠海采筑电子商务有限公司](https://www.aupup.com)
+ * [上海信息出奇科技有限公司](https://www.masscms.com)
+ * [爱投斯智能技术（深圳）有限公司](http://www.aiotos.net)
+
+### 贡献者们
+主项目 APIJSON 的贡献者们(6 个腾讯工程师、1 个微软工程师、1 个知乎基础研发架构师、1 个字节跳动工程师、1 个网易工程师、1 个 Zoom 工程师、1 个圆通工程师、1 个智联招聘工程师、1 个美国加州大学学生、3 个 SUSTech 学生等)：
+https://github.com/Tencent/APIJSON/blob/master/CONTRIBUTING.md
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+生态周边项目的作者们(2 个腾讯工程师、1 个 BAT 技术专家、1 个微软工程师、2 个字节跳动工程师、1 个神州数码工程师&Apache dubbo2js 作者 等)：
+https://github.com/search?o=desc&q=apijson&s=stars&type=Repositories
+https://search.gitee.com/?skin=rec&type=repository&q=apijson&sort=stars_count
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+还有为 APIJSON 扫描代码贡献 Issue 的 [奇安信代码卫士](https://github.com/QiAnXinCodeSafe) 和 [源伞科技](https://www.sourcebrella.com)
+
+
+
+
+
+
+感谢大家的贡献。
+
+### 统计分析
+国内腾讯、华为、阿里巴巴、美团、字节跳动、百度、京东、网易、快手等 和 国外 Google, Microsoft, Amazon, Paypal, IBM, Shopee 等
+数百名知名大厂员工点了 Star，也有腾讯、华为、字节跳动、Microsoft、Zoom 等不少知名大厂员工提了 PR/Issue，非常感谢大家的支持~
+[](https://starchart.cc/Tencent/APIJSON)
+
+
+
+
+
+
+### 规划及路线图
+新增功能、强化安全、提高性能、增强稳定、完善文档、丰富周边、推广使用
+https://github.com/Tencent/APIJSON/blob/master/Roadmap.md
+
+理论上所有支持 SQL 与 JDBC/ODBC 的软件，都可以用本项目对接 CRUD，待测试:
+[Elasticsearch](https://www.elastic.co/cn/what-is/elasticsearch-sql), [OceanBase](https://www.oceanbase.com/docs/oceanbase/V2.2.50/ss-sr-select_daur3l), [Spark](https://spark.apache.org/docs/3.3.0/sql-ref-syntax-qry-select.html)(可用 Hive 对接), [Phoenix](http://phoenix.apache.org/language/index.html#select)(延伸支持 HBase)
+
+### 我要赞赏
+创作不易，坚持更难，右上角点 ⭐Star 来支持/收藏下吧，谢谢 ^_^
+
+
+
+
+
+
导航目录： [项目简介](#--apijson) [上手使用](#%E5%BF%AB%E9%80%9F%E4%B8%8A%E6%89%8B) 社区生态 完整详细的导航目录 [点这里查看](/Navigation.md)
+
+### 技术交流
+如果有什么问题或建议可以 [填问卷](https://wj.qq.com/s2/10971431/2a09) 或 [提 Issue](https://github.com/Tencent/APIJSON/issues/36)，交流技术，分享经验。
+如果你解决了某些 bug，或者新增了一些功能，欢迎 [贡献代码](https://github.com/Tencent/APIJSON/pulls)，感激不尽~
+https://github.com/Tencent/APIJSON/blob/master/CONTRIBUTING.md
+
+**开发者也是人，也需要工作、休息、恋爱、陪伴家人、走亲会友等，也有心情不好和身体病痛，**
+**往往没有额外的时间精力顾及一些小问题，请理解和支持，开源要大家参与贡献才会更美好~**
+**少数个人的热情终有被耗尽的一天，只有大家共同建设和繁荣社区，才能让开源可持续发展！**
-```
-单条新增:
-POST User_address {"MUST":"addr","UPDATE": {"@role": "OWNER,ADMIN","childFunTest-()": "childFunTest(addr)"}, "REFUSE": "id"}
-批量新增:
-POST User_address[] {"User_address[]": [{"MUST":"addr","REFUSE": "id"}], "UPDATE": {"@role": "OWNER,ADMIN","childFunTest-()": "childFunTest(addr)"}}
-单条修改:
-PUT User_address {"User_address":{ "MUST":"id","REFUSE": "userId", "UPDATE": {"@role": "OWNER,ADMIN","childFunTest-()": "childFunTest(addr)"}} }
-批量修改:
-PUT User_address[] {"User_address[]": [{"MUST": "id","REFUSE": "userId"}], "UPDATE": {"@role": "OWNER,ADMIN"}}
-删除:
-DELETE User_address {"User_address":{ "MUST":"id{}","REFUSE": "!", "INSERT": {"@role": "OWNER,ADMIN"}} }
+**QQ 技术群**： 请在常见问题 Issue 中查找
-```
-
+**开发者时间精力有限，原则上优先解决 登记用户 和 贡献者 的问题，**
+**不解决 文档/视频/常见问题 已明确说明、描述简陋 或 态度无礼 的问题！**
+**如果你已经多次得到帮助，却仍然只索取不贡献，那就别指望大家再帮你！**
+**私聊作者请教技术问题 或者 频繁在互助群 @ 作者 可能会被拉黑/禁言/踢群，请尊重和理解，谢谢！**
+如果你 [提 PR 登记了自己使用 APIJSON 的公司](https://github.com/Tencent/APIJSON/issues/187)，可以加 **企业用户支持专群**，作者亲自且优先答疑，
+作者只有解答完了这个专群里的全部问题，才看情况解答 Issue 里的问题(对 Issue 不保证解答、更不保证及时)；
+其它群为互助群，由于大多数问题 在文档/Issue 已有答案却反复提 或者 缺少必要信息要来来回回沟通问清细节 已浪费太多时间，
+甚至有白嫖还把自己当大爷的自私自利伸手党输出情绪，作者不再解答互助群问题，由群友互助解答，建议未登记企业的用户 [填问卷](https://wj.qq.com/s2/10971431/2a09) 或 [提 Issue](https://github.com/Tencent/APIJSON/issues/36)。
+如果你为 APIJSON 做出了以下任何一个贡献：
+[提交了 PR 且被合并](https://github.com/Tencent/APIJSON/pull/92)、[提交了优质 Issue](https://github.com/Tencent/APIJSON/issues/189)、[发表了优质文章](https://blog.csdn.net/qq_41829492/article/details/88670940)、[开发了可用的生态项目](https://github.com/zhangchunlin/uliweb-apijson)，
+可以在群里发出贡献链接并附带说明，管理员将设置关注你一段时间，优先答疑解惑。
+互助群一般解答顺序：贡献者 > 帮助他人的群友 > 带企业名昵称 > 带岗位名昵称 > 其他群友。
+
-### 别名
+### 相关推荐
+[APIJSON, 让接口和文档见鬼去吧！](https://my.oschina.net/tommylemon/blog/805459)
-格式:
+[腾讯业务百万数据 6s 响应，APIJSON 性能优化背后的故事](https://my.oschina.net/tommylemon/blog/5375645)
-Sys_user_role:sur xxx表名:别名
+[仿QQ空间和微信朋友圈，高解耦高复用高灵活](https://my.oschina.net/tommylemon/blog/885787)
-Comment:cArray[]
+[后端开挂:3行代码写出8个接口！](https://my.oschina.net/tommylemon/blog/1574430)
-#### 实现思路
+[后端自动化版本管理，再也不用改URL了！](https://my.oschina.net/tommylemon/blog/1576587)
-当时参考了作者的示例: 注册流程. 看到绕过校验, 可以将多条json语句组装在一起, 批量执行. 于是就想如何实现一个json支持不同操作方法,并支持事物.
+[3步创建APIJSON后端新表及配置](https://my.oschina.net/tommylemon/blog/889074)
-通过分析源码, 熟悉了校验流程、json解析执行流程、json解析生成sql语句流程、一些兼容、校验规则等
+[APIJSON对接分布式HTAP数据库TiDB](https://asktug.com/t/htap-tidb/395)
-经过和作者讨论, 很感谢作者提供了相关解决方案和思路. 逐步理解了apijson的设计原理和框架结构.
+[APIJSON教程（一）：上手apijson项目，学习apijson语法，并实现持久层配置](https://zhuanlan.zhihu.com/p/375681893)
-一个json(事务)同时支持新增、修改、删除、查询、别名, 实现思路如下:
+[apijson简单demo](https://blog.csdn.net/dmw412724/article/details/113558115)
-1、校验模块
+[apijson简单使用](https://www.cnblogs.com/greyzeng/p/14311995.html)
-将json解析成对象、临时变量、子查询、别名、tag等
+[APIJSON简单部署和使用](https://blog.csdn.net/m450744192/article/details/108462611)
-并将method 添加到 json对象属性中.
+[学习自动化接口APIJSON](https://www.jianshu.com/p/981a2a630c7b)
-```
-"Sys_role": {
- "@method": "PUT",
- "id": "6aedce0d-2a29-4fbe-aeed-0ba935ca6b41",
- "id{}@": "sql",
- "role_code": "code-subrange-4",
- "role_name": "角色-subrange-4"
- }
-```
+[APIJSON 接口调试实践](https://github.com/Tencent/APIJSON/issues/189)
+
+[关于APIJSON远程函数](https://mp.weixin.qq.com/s?__biz=Mzg3NTc1NDUyNA==&mid=2247483950&idx=1&sn=b11e70bdf083c55d72238e107449ae2e&chksm=cf3de75df84a6e4b3a4acd0846531b0bd12bc90379523fbaf6b4f900fc3cdc1b1ce3eff97fd9&scene=178&cur_album_id=2548737392338354178#rd)
+
+[APIJSON新增方法实例](https://cloud.tencent.com/developer/article/2098890)
+
+[APIJSON-APIJSON的那些事儿](https://cloud.tencent.com/developer/article/2098888)
-2、对象解析
+[APIJSON-零代码接口和文档 JSON 协议 与 ORM 库](https://cloud.tencent.com/developer/article/2077042)
-用对象属性@method , 替换 Parser 的 method
+[APIJSON使用例子总结](https://blog.csdn.net/weixin_41077841/article/details/110518007)
-3、事物支持
+[APIJSON 自动化接口和文档的快速开发神器 （一）](https://blog.csdn.net/qq_41829492/article/details/88670940)
-### 后续优化建议
+[APIJSON在mac电脑环境下配置去连接SQL Server](https://juejin.im/post/5e16d21ef265da3e2e4f4956)
-1、独立定义一个url method, 通过解析不同method执行不同流程
+[APIJSON复杂业务深入实践（类似12306订票系统）](https://blog.csdn.net/aa330233789/article/details/105309571)
-和已有method区分开,避免歧义
+[全国行政区划数据抓取与处理](https://www.xlongwei.com/detail/21032616)
-2、最外层新增传参 "transaction": true 来指定开启事务
-目前是url put、post来控制开启事物, 以及提交的时候 在 AbstractParser onCommit 判断 transactionIsolation (4 : 开启事物, 0: 非事物请求)
+[新手搭建 APIJSON 项目指北](https://github.com/jerrylususu/apijson_todo_demo/blob/master/FULLTEXT.md)
-
+[使用APIJSON写低代码Crud接口](https://blog.csdn.net/weixin_42375862/article/details/121654264)
+
+[apijson在同一个接口调用中 使用远程函数写入更新时间和创建时间](https://blog.csdn.net/qietingfengsong/article/details/124097229)
-详细实现请参见: https://github.com/Tencent/APIJSON/issues/468
+[APIJSON（一：综述）](https://blog.csdn.net/qq_50861917/article/details/120556168)
-3、完善 "[@Explain](https://github.com/Explain)"
+[APIJSON 代码分析（三：demo主体代码）](https://blog.csdn.net/qq_50861917/article/details/120751630)
-如果没有执行计划,则返回sql语句. 能够在 reponse返回值中, 看到json中执行的每条sql,方便排错
+[APIJSON 代码分析（二）AbstractParser类(解析器)](https://blog.csdn.net/weixin_45767055/article/details/120815927)
-
+[APIJSON 代码分析（四：AbstractObjectParser源码阅读）](https://blog.csdn.net/qq_50861917/article/details/120896381)
-4、@version支持
+[APIJSON 代码分析 AbstractSQLConfig 第二篇](https://blog.csdn.net/csascscascd/article/details/120684889)
-定义不同场景的 新增、修改、删除等执行规则. 请通过version版本区分
+[APIJSON 代码分析（六）APIJSON—Verifier检查类](https://blog.csdn.net/weixin_45767055/article/details/121321731)
-Request表是通过tag、method、version来保证唯一.
+[APIJSON 代码分析（四）AbstractSQLExecutor—SQL执行器](https://blog.csdn.net/weixin_45767055/article/details/121069887)
-
+
+### 生态项目
+[APIJSON-Demo](https://github.com/APIJSON/APIJSON-Demo) APIJSON 各种语言、各种框架 的 使用示例项目、上手文档、测试数据 SQL 文件 等
-5、前置函数
+[apijson-orm](https://github.com/APIJSON/apijson-orm) APIJSON ORM 库，可通过 Maven, Gradle 等远程依赖
-前置函数能够将json语句, 加入到 当前事物中.
+[apijson-framework](https://github.com/APIJSON/apijson-framework) APIJSON 服务端框架，通过数据库表配置角色权限、参数校验等，简化使用
-例如: 像数组一样,解析成每一条语句去执行.
+[apijson-router](https://github.com/APIJSON/apijson-router) APIJSON 的路由插件，可控地对公网暴露类 RESTful 简单接口，内部转成 APIJSON 格式请求来执行。
+
+[apijson-column](https://github.com/APIJSON/apijson-column) APIJSON 的字段插件，支持 字段名映射 和 !key 反选字段
-### mysql8 with-as表达式
+[APIAuto](https://github.com/TommyLemon/APIAuto) 敏捷开发最强大易用的 HTTP 接口工具，机器学习零代码测试、生成代码与静态检查、生成文档与光标悬浮注释
-#### 前提条件
+[UnitAuto](https://github.com/TommyLemon/UnitAuto) 机器学习单元测试平台，零代码、全方位、自动化 测试 方法/函数 的正确性和可用性
-1、mysql版本: 8+
+[SQLAuto](https://github.com/TommyLemon/SQLAuto) 智能零代码自动化测试 SQL 语句执行结果的数据库工具
-2、mysql-connector-java: 8.0.31
+[apijson-doc](https://github.com/vincentCheng/apijson-doc) APIJSON 官方文档，提供排版清晰、搜索方便的文档内容展示，包括设计规范、图文教程等
-版本支持 with-as即可
+[APIJSONdocs](https://github.com/ruoranw/APIJSONdocs) APIJSON 英文文档，提供排版清晰的文档内容展示，包括详细介绍、设计规范、使用方式等
-3、druid: 1.2.15
+[apijson.org](https://github.com/APIJSON/apijson.org) APIJSON 官方网站，提供 APIJSON 的 功能简介、登记用户、作者与贡献者、相关链接 等
-版本支持 with-as即可
+[APIJSON.NET](https://github.com/liaozb/APIJSON.NET) C# 版 APIJSON ，支持 MySQL, PostgreSQL, SQL Server, Oracle, SQLite
-4、去掉 durid wall配置
+[apijson-go](https://github.com/glennliao/apijson-go) Go 版 APIJSON ， 基于Go(>=1.18) + GoFrame2, 支持查询、单表增删改、权限管理等
+
+[apijson-go](https://gitee.com/tiangao/apijson-go) Go 版 APIJSON ，支持单表查询、数组查询、多表一对一关联查询、多表一对多关联查询 等
-delete子查询, druid wall 拦截器报错 sql injection violation
+[apijson-hyperf](https://github.com/kvnZero/hyperf-APIJSON.git) PHP 版 APIJSON，基于 Hyperf 支持 MySQL
-
+[APIJSON-php](https://github.com/xianglong111/APIJSON-php) PHP 版 APIJSON，基于 ThinkPHP，支持 MySQL, PostgreSQL, SQL Server, Oracle 等
-#### 测试案例
+[apijson-php](https://github.com/qq547057827/apijson-php) PHP 版 APIJSON，基于 ThinkPHP，支持 MySQL, PostgreSQL, SQL Server, Oracle 等
-#### 查询单个range ref引用
+[apijson-node](https://github.com/kevinaskin/apijson-node) 字节跳动工程师开源的 Node.ts 版 APIJSON，提供 nestjs 和 typeorm 的 Demo 及后台管理
-```
-// 测试 mysql8 with as表达式
-// 用户表
-// 用户角色表
-// 角色表
-// 示例一 单个range ref引用
-{
- "sql@": {
- "@method": "GET",
- "with": true,
- "from": "Sys_role",
- "Sys_role": {
- "@column": "id",
- "role_name": "角色1"
- }
- },
- "Sys_user_role:sur[]": {
- "@method": "GET",
- "Sys_user_role": {
- "role_id{}@": "sql"
- }
- },
- "Sys_role_permission:srp[]": {
- "@method": "GET",
- "Sys_role_permission": {
- "role_id{}@": "sql"
- }
- },
- "@explain": true
-}
-
-// 第二种写法
-{
- "@get": ["sql@","Sys_user_role:sur[]","Sys_role_permission:srp[]"],
- "sql@": {
- "with": true,
- "from": "Sys_role",
- "Sys_role": {
- "@column": "id",
- "role_name": "角色1"
- }
- },
- "Sys_user_role:sur[]": {
- "Sys_user_role": {
- "role_id{}@": "sql"
- }
- },
- "Sys_role_permission:srp[]": {
- "Sys_role_permission": {
- "role_id{}@": "sql"
- }
- },
- "@explain": true
-}
-```
-
-mysql8执行结果:
-
-
-
-mysql5.7执行结果:
-
-
-
-
-#### 查询多个range ref引用
-
-```
-{
- "sql@": {
- "@method": "GET",
- "with": true,
- "from": "Sys_role",
- "Sys_role": {
- "@column": "id",
- "role_name": "角色1"
- }
- },
- "sql_user@": {
- "@method": "GET",
- "with": true,
- "from": "Sys_user",
- "Sys_user": {
- "@column": "id",
- "id": "f0894db2-6940-4d89-a5b2-4405d0ad0c8f"
- }
- },
- "Sys_user_role:sur[]": {
- "@method": "GET",
- "Sys_user_role": {
- "role_id{}@": "sql",
- "user_id{}@": "sql_user"
- }
- },
- "Sys_role_permission:srp[]": {
- "@method": "GET",
- "Sys_role_permission": {
- "role_id{}@": "sql"
- }
- },
- "@explain": true
-}
-```
-
-mysql8执行结果:
-
-
-
-mysql5.7执行结果:
-
-
-
-#### delete子查询
-
-```j s
-{
- "sql@": {
- "@method": "GET",
- "with": true,
- "from": "Sys_role_permission",
- "Sys_role_permission": {
- "@column": "id",
- "role_id{}": ["e7129d5f-b07e-4996-9965-9528e370a393"]
- }
- },
- "Sys_role_permission": {
- "@method": "DELETE",
- "id{}@": "sql"
- },
- "explan": true
-}
-
-```
-
-
-
-mysql8执行sql语句:
-
-```
-WITH `sql` AS (SELECT `id` FROM `housekeeping`.`Sys_role_permission` WHERE ( (`role_id` IN ('68877ee9-4cf4-4f32-86e6-16c505ca3b21')) ) ) DELETE FROM `housekeeping`.`Sys_role_permission` WHERE ( (`id` IN ( SELECT * FROM `sql`) ) )
-
-Plain Text
-```
-
-mysql5.7执行结果:
-
-```
-DELETE FROM `housekeeping`.`Sys_role_permission` WHERE ( (`id` IN ( SELECT * FROM (SELECT `id` FROM `housekeeping`.`Sys_role_permission` WHERE ( (`role_id` IN ('20d337bb-9886-455f-8dce-f1cadab0ec4f')) ) ) AS `sql`) ) )
-
-
-
-Plain Text
-```
-
-#### update子查询
-
-```
-{
- "sql@": {
- "@method": "GET",
- "with": true,
- "from": "Sys_role_permission",
- "Sys_role_permission": {
- "@column": "role_id",
- "id{}": ["6aedce0d-2a29-4fbe-aeed-0ba935ca6b41"]
- }
- },
- "Sys_role": {
- "@method": "PUT",
- "id": "6aedce0d-2a29-4fbe-aeed-0ba935ca6b41",
- "id{}@": "sql",
- "role_code": "code-subrange-4",
- "role_name": "角色-subrange-4"
- },
- "@explain": true
-}
-
-第二种写法
-{
- "@get": ["sql@"],
- "sql@": {
- "with": true,
- "from": "Sys_role_permission",
- "Sys_role_permission": {
- "@column": "role_id",
- "id{}": ["c95ef2d6-bf14-42b0-bb87-038cee8c78f1"]
- }
- },
- "@put": ["Sys_role"],
- "Sys_role": {
- "id": "0bb92d96-8ca6-469e-91e8-60308ce5b835",
- "id{}@": "sql",
- "role_code": "code-subrange-4",
- "role_name": "角色-subrange-4"
- },
- "@explain": true
-}
-```
-
-mysql8执行sql语句:
-
-
-
-
-mysql5.7执行结果:
-
-
-
-#### GETS 单条子查询
-
-会执行校验流程
-
-```
-http://localhost:8675/lowCodePlatform/forms/api/gets
-
-{
- "sql@": {
- "with": true,
- "from": "Sys_user_role",
- "Sys_user_role": {
- "@column": "role_id",
- "user_id": "4732209c-5785-4827-b532-5092f154fd94"
- }
- },
- "Sys_role[]": {
- "Sys_role": {
- "id{}@": "sql"
- },
- "page": 0,
- "count": 10,
- "query": 2
- },
- "tag":"Sys_role[]",
- "total@": "/Sys_role[]/total",
- "@explain": true
-}
-
-第二种写法
-{
- "@gets": ["sql@","Sys_role[]"],
- "sql@": {
- "with": true,
- "from": "Sys_user_role",
- "Sys_user_role": {
- "@column": "role_id",
- "user_id": "4732209c-5785-4827-b532-5092f154fd94"
- }
- },
- "Sys_role[]": {
- "Sys_role": {
- "id{}@": "sql"
- },
- "page": 0,
- "count": 10,
- "query": 2
- },
- "tag":"Sys_role[]",
- "total@": "/Sys_role[]/total",
- "@explain": true
-}
-
-```
-
-Access、Request需要配置鉴权信息:
-
-
-
-
-mysql8执行sql语句:
-
-
-
-mysql5.7执行结果:
-
-
-
-#### GETS多条子查询
-
-会执行校验流程
-
-```
-http://localhost:8675/lowCodePlatform/forms/api/gets
-
-{
- "sql@": {
- "@method": "GETS",
- "with": true,
- "from": "Sys_role",
- "Sys_role": {
- "@column": "id",
- "role_name": "超级管理员"
- }
- },
- "sql_user@": {
- "@method": "GETS",
- "with": true,
- "from": "Sys_user",
- "Sys_user": {
- "@column": "id",
- "id": "4732209c-5785-4827-b532-5092f154fd94"
- }
- },
- "Sys_user_role:sur[]": {
- "@method": "GETS",
- "Sys_user_role": {
- "role_id{}@": "sql",
- "user_id{}@": "sql_user"
- }
- },
- "Sys_role_permission:srp[]": {
- "@method": "GETS",
- "Sys_role_permission": {
- "role_id{}@": "sql"
- }
- },
- "@explain": true
-}
-
-```
-
-mysql8执行sql语句:
-
-
-
-mysql5.7执行结果:
-
-
-
-#### head 单个子查询
-
-普通获取数量, get/head不执行校验流程
-
-```
-http://localhost:8675/lowCodePlatform/forms/api/head
-{
- "sql@": {
- "@method": "GET",
- "with": true,
- "from": "Sys_user_role",
- "Sys_user_role": {
- "@column": "role_id",
- "user_id": "4732209c-5785-4827-b532-5092f154fd94"
- }
- },
- "Sys_role": {
- "@method": "head",
- "id{}@": "sql"
- },
- "@explain": true
-}
-
-```
-
-mysql8执行sql语句:
-
-
-
-mysql5.7执行结果:
-
-
-
-#### head 多个子查询
-
-普通获取数量, get/head不执行校验流程
-
-```
-{
- "sql@": {
- "@method": "GET",
- "with": true,
- "from": "Sys_role",
- "Sys_role": {
- "@column": "id",
- "role_name": "超级管理员"
- }
- },
- "sql_user@": {
- "@method": "GET",
- "with": true,
- "from": "Sys_user",
- "Sys_user": {
- "@column": "id",
- "id": "4732209c-5785-4827-b532-5092f154fd94"
- }
- },
- "Sys_user_role": {
- "@method": "HEAD",
- "role_id{}@": "sql",
- "user_id{}@": "sql_user"
- },
- "Sys_role_permission": {
- "@method": "HEAD",
- "role_id{}@": "sql"
- },
- "@explain": true
-}
-
-```
-
-mysql8执行sql语句:
-
-
-
-mysql5.7执行结果:
-
-
-
-#### heads 单个子查询
-
-普通获取数量
+[uliweb-apijson](https://github.com/zhangchunlin/uliweb-apijson) Python 版 APIJSON，支持 MySQL, PostgreSQL, SQL Server, Oracle, SQLite 等
-会执行校验流程, Access、Request需要配置鉴权信息:
-
+[APIJSONParser](https://github.com/Zerounary/APIJSONParser) 第三方 APIJSON 解析器，将 JSON 动态解析成 SQL
-```
-http://localhost:8675/lowCodePlatform/forms/api/heads
+[FfApiJson](https://gitee.com/own_3_0/ff-api-json) 用 JSON 格式直接生成 SQL，借鉴 APIJSON 支持多数据源
-{
- "sql@": {
- "@method": "GET",
- "with": true,
- "from": "Sys_user_role",
- "Sys_user_role": {
- "@column": "role_id",
- "user_id": "4732209c-5785-4827-b532-5092f154fd94"
- }
- },
- "Sys_role": {
- "@method": "heads",
- "id{}@": "sql"
- },
- "@explain": true
-}
-
-```
-
-mysql8执行sql语句:
-
-
-
-mysql5.7执行结果:
-
-
-
-#### heads 多个子查询
-
-会执行校验流程, Access、Request需要配置鉴权信息:
-
-
-
-普通获取数量
-
-```
-{
- "sql@": {
- "@method": "GET",
- "with": true,
- "from": "Sys_role",
- "Sys_role": {
- "@column": "id",
- "role_name": "超级管理员"
- }
- },
- "sql_user@": {
- "@method": "GET",
- "with": true,
- "from": "Sys_user",
- "Sys_user": {
- "@column": "id",
- "id": "4732209c-5785-4827-b532-5092f154fd94"
- }
- },
- "Sys_user_role": {
- "@method": "HEADS",
- "role_id{}@": "sql",
- "user_id{}@": "sql_user"
- },
- "Sys_role_permission": {
- "@method": "HEADS",
- "role_id{}@": "sql"
- },
- "@explain": true
-}
-
-```
-
-mysql8执行sql语句:
-
-
-
-mysql5.7执行结果:
-
-
-
-### delete、put 支持子查询
-
-https://github.com/Tencent/APIJSON/issues/471
-
-静态变量做全局处理，特殊接口用 Operation.MUST id/id{}/id{}@ 做自定义处理。
-
-之所以默认必传，是因为安全意识不够、编码粗心大意的人太多了，所以要有一个底线保障，尽可能避免安全隐患。
-
-1、全局配置 为 PUT, DELETE 强制要求必须有 id/id{}/id{}@ 条件
-
-AbstractVerifier.IS_UPDATE_MUST_HAVE_ID_CONDITION = true; // true: 必须有
-
-
-
-2、细粒度控制
-
-
-
-#### 使用说明
-
-```
-// 条件删除
-{
- "User:del": {
- "username": "test3"
- },
- "tag": "User",
- "explain": true
-}
-
-// 引用id{}@删除
-{
- "sql@": {
- "@method": "GET",
- "with": true,
- "from": "Sys_user_role",
- "Sys_user_role": {
- "@column": "user_id",
- "role_id{}": ["023e1880-c0d4-4e7c-ae6c-7703199c2daf"]
- }
- },
- "Sys_user:aa": {
- "@method": "DELETE",
- "id{}@": "sql"
- },
- "explan": true
-}
-// 子查询条件删除
-http://localhost:8675/lowCodePlatform/forms/api/delete
-{
- "sql@": {
- "@method": "GET",
- "with": true,
- "from": "User",
- "User": {
- "@column": "username",
- "username": "test-3"
- }
- },
- "User": {
- "username{}@": "sql"
- },
- "explan": true
-}
-
-第二种写法:
-{
- "@get": ["sql@"],
- "sql@": {
- "with": true,
- "from": "User",
- "User": {
- "@column": "username",
- "username": "test4"
- }
- },
- "User": {
- "username{}@": "sql"
- },
- "explan": true
-}
-
-
-```
-
-
-
-开启id删除, 删除失败:
-
-```
-{
- "@get": ["sql@"],
- "sql@": {
- "with": true,
- "from": "User",
- "User": {
- "@column": "username",
- "username": "test4"
- }
- },
- "User": {
- "username{}@": "sql"
- },
- "explan": true
-}
-```
-
-
-
-开启id删除、id引用 删除成功
-
-```
-{
- "sql@": {
- "@method": "GET",
- "with": true,
- "from": "Sys_user_role",
- "Sys_user_role": {
- "@column": "user_id",
- "role_id{}": ["0bb92d96-8ca6-469e-91e8-60308ce5b835"]
- }
- },
- "Sys_user:aa": {
- "@method": "DELETE",
- "id{}@": "sql"
- },
- "explan": true
-}
-```
-
-
-PUT 子查询 修改
-
-```
-{
- "sql@": {
- "@method": "GET",
- "with": true,
- "from": "Sys_role_permission",
- "Sys_role_permission": {
- "@column": "role_id",
- "id{}": ["ba2634f8-0bdc-4b50-9c5e-47786b1536ef"]
- }
- },
- "Sys_role": {
- "@method": "PUT",
- "id{}@": "sql",
- "role_code": "code-subrange-5",
- "role_name": "角色-subrange-5"
- },
- "@explain": true
-}
-```
-
-
-
-#### bug修复
-
-删除操作 主表 和 子查询 是同一张表
-mysql8以下 非with-as表达式 会报错:
-"msg": "You can't specify target table 'User' for update in FROM clause",
-
-需要调整sql语句,将子查询包一层(select * from (子查询) as xxx)
-DELETE FROM `housekeeping`.`User`
-WHERE ( (`username` IN (SELECT * FROM (SELECT `username` FROM `housekeeping`.`User` WHERE ( (`username` = 'test1') )) as a) ) )
-
-
-
-
-
-
-### must、refuses判断、delete、PUT支持 ref
-
-```
-{
- "sql@": {
- "@method": "GET",
- "with": true,
- "from": "Sys_role_permission",
- "Sys_role_permission": {
- "@column": "id",
- "role_id{}": ["94f79f0b-331b-4cc5-bfc0-ebfc47d00f13"]
- }
- },
- "Sys_role_permission": {
- "@method": "DELETE",
- "id{}@": "sql"
- },
- "explan": true
-}
-```
-
-
+[APIJSON-ToDo-Demo](https://github.com/jerrylususu/apijson_todo_demo) 一个简单的 todo 示例项目，精简数据，简化上手流程，带自定义鉴权逻辑
+
+[apijson-learn](https://github.com/rainboy-learn/apijson-learn) APIJSON 学习笔记和源码解析
+
+[apijson-practice](https://github.com/vcoolwind/apijson-practice) BAT 技术专家开源的 APIJSON 参数校验注解 Library 及相关 Demo
+
+[apijson-db2](https://github.com/andream7/apijson-db2) APIJSON 接入 IBM 数据库 DB2 的 Demo
+
+[APIJSONDemo](https://github.com/qiujunlin/APIJSONDemo) 字节跳动工程师接入 ClickHouse 的 APIJSON 使用 Demo
+
+[APIJSONDemo_ClickHouse](https://github.com/chenyanlann/APIJSONDemo_ClickHouse) APIJSON + SpringBoot 连接 ClickHouse 使用的 Demo
+
+[APIJSONBoot_Hive](https://github.com/chenyanlann/APIJSONBoot_Hive) APIJSON + SpringBoot 连接 Hive 使用的 Demo
+
+[apijson-sample](https://gitee.com/greyzeng/apijson-sample) APIJSON 简单使用 Demo 及教程
+
+[apijson-examples](https://gitee.com/drone/apijson-examples) APIJSON 的前端、业务后端、管理后端 Demo
+
+[light4j](https://github.com/xlongwei/light4j) 整合 APIJSON 和微服务框架 light-4j 的 Demo，同时接入了 Redis
+
+[SpringServer1.2-APIJSON](https://github.com/Airforce-1/SpringServer1.2-APIJSON) 智慧党建服务器端，提供 上传 和 下载 文件的接口
+
+[apijson_template](https://github.com/abliger/apijson_template) apijson java 模版，使用 gradle 管理依赖和构建应用
+
+[api-json-demo](https://gitee.com/hxdwd/api-json-demo) 基于 APIJSON，实现低代码写 CURD 代码，代替传统 ORM 框架，适配 Oracle 事务
+
+[ApiJsonByJFinal](https://gitee.com/zhiyuexin/ApiJsonByJFinal) 整合 APIJSON 和 JFinal 的 Demo
+
+[apijson-builder](https://github.com/pengxianggui/apijson-builder) 一个方便为 APIJSON 构建 RESTful 请求的 JavaScript 库
+
+[AbsGrade](https://github.com/APIJSON/AbsGrade) 列表级联算法，支持微信朋友圈单层评论、QQ空间双层评论、百度网盘多层(无限层)文件夹等
+
+[APIJSON-Android-RxJava](https://github.com/TommyLemon/APIJSON-Android-RxJava) 仿微信朋友圈动态实战项目，ZBLibrary(UI) + APIJSON(HTTP) + RxJava(Data)
+
+[Android-ZBLibrary](https://github.com/TommyLemon/Android-ZBLibrary) Android MVP 快速开发框架，Demo 全面，注释详细，使用简单，代码严谨
+
+[apijson-dynamic-datasource](https://github.com/wb04307201/apijson-dynamic-datasource) 基于APIJSON，动态切换数据源、同一数据源批量操作事务一致性DEMO
+
+感谢热心的作者们的贡献，点 ⭐Star 支持下他们吧。
+
+
+### 腾讯犀牛鸟开源人才培养计划
+https://github.com/Tencent/APIJSON/issues/229
+
+
+#### qiujunlin **2.接入 presto/hive/clickhouse/db2 任意一个**
+
+APIJSON 接入 clickhouse 使用demo
+https://github.com/qiujunlin/APIJSONDemo
+
+#### zhangshukun 2.接入 presto/hive/clickhouse/db2 任意一个
+APIJSON-Demo接入db2
+https://github.com/andream7/apijson-db2
+
+#### hanxu 1.完善入门介绍视频
+重构 APIJSON 文档
+https://hanxu2018.github.io/APIJSON-DOC/
+文档源码
+https://github.com/HANXU2018/APIJSON-DOC
+配套评论区 apijson-doc-Comment
+https://github.com/HANXU2018/apijson-doc-Comment
+
+#### chenyanlan 2.接入 presto/hive/clickhouse/db2 任意一个
+APIJSON + SpringBoot连接ClickHouse使用的Demo
+https://github.com/chenyanlann/APIJSONDemo_ClickHouse
+
+#### zhaoqiming 1.完善入门介绍视频
+APIJSON 后端教程（1）：简介
+https://www.bilibili.com/video/BV1vL411W7yd
+
+APIJSON 后端教程（2）：数据库
+https://www.bilibili.com/video/BV1eB4y1N77s
+
+APIJSON 后端教程（3）：Demo
+https://www.bilibili.com/video/BV1FX4y1c7ug
+
+APIJSON 后端教程（4）：Boot
+https://www.bilibili.com/video/BV18h411z7FK
+
+APIJSON 后端教程（5）：Final
+https://www.bilibili.com/video/BV1GM4y1N7XJ
+
+APIJSON 后端教程（6）：uliweb_apijson
+https://www.bilibili.com/video/BV1yb4y1S79v/
+
+APIJSON 后端教程（7）：问题答疑
+https://www.bilibili.com/video/BV1dQ4y1h7Df
+
+APIJSON配套文档：
+https://github.com/kenlig/apijsondocs
+
+#### huwen 2.接入 presto/hive/clickhouse/db2 任意一个
+APIJSON-Demo 接入presto
+https://github.com/hclown9804/APIJSONDemo_presto
+
+#### zhanghaoling 1.完善入门介绍视频
+APIJSON结合已有项目，简化开发流程
+https://github.com/haolingzhang1/APIJson--demo
+
+说明文档
+https://github.com/haolingzhang1/APIJson--demo/tree/main/APIJson集成项目说明
+
+(1)官方demo
+https://github.com/haolingzhang1/APIJson--demo/blob/main/APIJson集成项目说明/APIJson集成现有项目（1）-%20官方demo.pdf
+
+(2)单表配置
+https://github.com/haolingzhang1/APIJson--demo/blob/main/APIJson集成项目说明/APIJson集成现有项目（2）-%20单表配置.pdf
+
+#### zhoukaile 1.完善入门介绍视频
+
+视频链接：https://www.bilibili.com/video/BV1Uh411z7kZ/
+
+文档链接：https://gitee.com/funkiz/apijson_camp
+
+#### lintao 1.完善入门介绍视频
+
+APIJSON 上手教程：https://www.bilibili.com/video/BV1Pq4y1n7rJ
+
+### 持续更新
+
+https://github.com/Tencent/APIJSON/commits/master
+
+### 工蜂主页
+https://git.code.tencent.com/Tencent_Open_Source/APIJSON
+
+### 码云主页
+https://gitee.com/Tencent/APIJSON
+ 
+ 
+ 
+ 
+ 
+ 
+ 
+ 
+ 
+ 
+
+ 
+ 
+ 
+ 
+ 
+ 
+
+ 
+ 
+
+ 
+ 
+
+
-/**
- * { "xxx:aa":{ "@tag": "" }}
- * 生成规则:
- * 1、@tag存在,tag=@tag
- * 2、@tag不存在
- * 1)、存在别名
- * key=对象: tag=key去除别名
- * key=数组: tag=key去除别名 + []
- * 2)、不存在别名
- * tag=key
- * tag=key + []
- */
+