From 5451f4be55e57d26e60813da5afb88c9b001f52d Mon Sep 17 00:00:00 2001
From: GeXin97 <141294410+gexin97@users.noreply.github.com>
Date: 2025年7月24日 09:57:21 +0800
Subject: [PATCH 01/26] Update Document.md
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
3.2添加对compat: true的描述
---
 Document.md &#124; 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/Document.md b/Document.md
index a97f7b823..29543da98 100644
--- a/Document.md
+++ b/Document.md
@@ -420,7 +420,7 @@ DELETE: <br> 删除数据 &#124; base_url/delete/ &#124; {<br>  TableName:{< 减少 或 去除 &#124; "key-":Object,与"key+"相反 &#124; "balance-":100.00,对应SQL是`balance = balance - 100.00`,余额减少100.00,即花费了100元 比较运算 &#124;>, <,>=, <= 比较运算符,用于 <br />1 提供 "id{}":"<=90000" 这种条件范围的简化写法 <br /><br />2 实现子查询相关比较运算<br /><br />不支持 "key=":Object 和 "key!=":Object 这两种写法,直接用更简单的 "key":Object 和 "key!":Object 替代。 &#124; 1 ["id<=":90000](http://apijson.cn:8080/get/{"[]":{"user":{"id<=":90000}}}),对应 SQL 是`id<=90000`,查询符合id<=90000的一个user数组<br /><br /> 2 ["id>@":{<br />  "from":"Comment",<br />  "Comment":{<br />    "@column":"min(userId)" <br />  }<br />}](http://apijson.cn:8080/get/{"User":{"id>@":{"from":"Comment","Comment":{"@column":"min(userId)"}}}})<br /> WHERE id>(SELECT min(userId) FROM Comment)
 逻辑运算 &#124; &, \&#124;, ! 逻辑运算符,对应数据库 SQL 中的 AND, OR, NOT。 <br />横或纵与:同一键值对的值内条件默认 \&#124; 或连接,可以在 key 后加逻辑运算符来具体指定;不同键值对的条件默认 & 与连接,可以用下面说明的对象关键词 @combine 来具体指定。 <br /><br />1 & 可用于 "key&{}":"条件"等<br /><br />2 \&#124; 可用于 "key\&#124;{}":"条件", "key\&#124;{}":[]等,一般可省略<br /><br />3 ! 可单独使用,如 "key!":Object,也可像 &,\&#124; 一样配合其他功能符使用 <br /> "key!":null 无效,null 值会导致整个键值对被忽略解析,可以用 "key{}":"!=null" 替代,<br />"key":null 同理,用 "key{}":"=null" 替代。 &#124; 1 ["id&{}":">80000,<=90000"](http://apijson.cn:8080/head/{"user":{"id&{}":">80000,<=90000"}}),对应sql是`id>80000 AND id<=90000`,即id满足id>80000 & id<=90000<br /><br /> 2 ["id\&#124;{}":">90000,<=80000"](http://apijson.cn:8080/head/{"user":{"id\&#124;{}":">90000,<=80000"}}),同 "id{}":">90000,<=80000",对应 SQL 是`id>90000 OR id<=80000`,即 id 满足 id>90000 \&#124; id<=80000<br /><br /> 3 ["id!{}":[82001,38710]](http://apijson.cn:8080/head/{"User":{"id!{}":[82001,38710]}}),对应 SQL 是`id NOT IN(82001,38710)`,即 id 满足 ! (id=82001 \&#124; id=38710),可过滤黑名单的消息
- 数组关键词,可自定义 &#124; "key":Object,key为 "[]":{} 中 {} 内的关键词,Object 的类型由 key 指定<br /><br />1 "count":5,查询数量,0 表示最大值,默认值为 10,默认最大值为 100 <br /><br />2 "page":1,查询页码,从 0 开始,默认值为 0,默认最大值为 100,一般和 count 一起用<br /><br />3 "query":2,查询内容<br />0-对象,1-总数和分页详情,2-数据、总数和分页详情<br />总数关键词为 total,分页详情关键词为 info,<br /> 它们都和 query 同级,通过引用赋值得到自定义 key:value 键值对,不传则返回默认键值对,例如 <br />"total@":"/[]/total", "info@":"/[]/info" <br />这里query及total仅为GET类型的请求提供方便,<br /> 一般可直接用HEAD类型的请求获取总数<br /><br />4 "join":"&/Table0,\</table1/key1@" 或 <br />"join":{<br />  "&/Table0":{}, // 支持 ON 多个字段关联,<br />  "\</table1/key1@":{ // ON 只允许指定的 key1 关联<br />   "key0":value0, // 其它ON条件 <br />   "key2":value2,<br />   ... <br />   "@combine":"...", // 其它ON条件的组合方式 <br />   "@column":"...", // 外层 SELECT <br />   "@group":"...", // 外层 GROUP BY <br />   "@having":"..." // 外层 HAVING <br />  }<br />}<br />多表连接方式:<br /> "@" - APP JOIN <br /> "\<" - LEFT JOIN <br /> ">" - RIGHT JOIN <br /> "&" - INNER JOIN <br /> "\&#124;" - FULL JOIN <br /> "!" - OUTER JOIN <br /> "*" - CROSS JOIN <br /> "^" - SIDE JOIN <br /> "(" - ANTI JOIN <br /> ")" - FOREIGN JOIN <br />其中 @ APP JOIN 为应用层连表,会从已查出的主表里取得所有副表 key@ 关联的主表内的 refKey 作为一个数组 refKeys: [value0, value1...],然后把原来副表 count 次查询 key=$refKey 的 SQL 用 key IN($refKeys) 的方式合并为一条 SQL 来优化性能;<br /> 其它 JOIN 都是 SQL JOIN,具体功能和 MySQL,PostgreSQL 等数据库的 JOIN 一一对应 <br />`"join":"</vicetable/key@",`<br />`"MainTable":{},`<br />`"ViceTable":{"key@":"/MainTable/refKey"}`<br />会对应生成 <br />`MainTable LEFT JOIN ViceTable` <br />`ON ViceTable.key=MainTable.refKey` AND 其它ON条件 <br /> 除了 = 等价关联,也支持 ! 不等关联、\> \< \>= \<= 等比较关联和 $ ~ {} <strong> 等其它复杂关联方式 <br /><br />5 "otherKey":Object,自定义关键词,名称和以上系统关键词不一样,且原样返回上传的值 &#124; 1 查询User数组,最多5个:<br />["count":5](http://apijson.cn:8080/get/{"[]":{"count":5,"User":{}}})<br />对应 SQL 是`LIMIT 5` <br /><br /> 2 查询第3页的User数组,每页5个:<br />["count":5,<br />"page":3](http://apijson.cn:8080/get/{"[]":{"count":5,"page":3,"User":{}}})<br />对应 SQL 是`LIMIT 5 OFFSET 15` <br /><br /> 3 查询User数组和对应的User总数:<br />["[]":{<br />  "query":2,<br />  "User":{}<br />},<br />"total@":"/[]/total", // 可省略<br />"info@":"/[]/info" // 可省略](http://apijson.cn:8080/get/{"[]":{"query":2,"count":5,"User":{}},"total@":"%252F[]%252Ftotal","info@":"%252F[]%252Finfo"})<br /> 返回的数据中,总数及分页详情结构为: <br /> "total":139, // 总数 <br /> "info":{ // 分页详情 <br />  "total":139, // 总数 <br />  "count":5, // 每页数量 <br />  "page":0, // 当前页码 <br />  "max":27, // 最大页码 <br />  "more":true, // 是否还有更多 <br />  "first":true, // 是否为首页 <br />  "last":false // 是否为尾页 <br />} <br /><br /> 4 Moment INNER JOIN User LEFT JOIN Comment:<br />["[]":{<br />  "join":"&/User/id@,\</comment",<br />  "Moment":{<br />   "@group":"id" // 主副表不是一对一,要去除重复数据<br />  },<br />  "User":{<br />   "name~":"t",<br />   "id@":"/Moment/userId"<br />  },<br />  "Comment":{<br />   "momentId@":"/Moment/id"<br />  }<br />}](http://apijson.cn/api/?type=JSON&url=http://apijson.cn:8080/get&json=%7B%22%5B%5D%22:%7B%22count%22:5,%22join%22:%22%26%2FUser%2Fid@,%3C%2FComment%22,%22Moment%22:%7B%22@column%22:%22id,userId,content%22,%22@group%22:%22id%22%7D,%22User%22:%7B%22name~%22:%22t%22,%22id@%22:%22%2FMoment%2FuserId%22,%22@column%22:%22id,name,head%22%7D,%22Comment%22:%7B%22momentId@%22:%22%2FMoment%2Fid%22,%22@column%22:%22id,momentId,content%22%7D%7D%7D)<br /><br /> 5 每一层都加当前用户名:<br />["User":{},<br />"[]":{<br />  "name@":"User/name", // 自定义关键词<br />  "Moment":{}<br />}](http://apijson.cn:8080/get/{"User":{},"[]":{"name@":"User%252Fname","Moment":{}}})
+ 数组关键词,可自定义 &#124; "key":Object,key为 "[]":{} 中 {} 内的关键词,Object 的类型由 key 指定<br /><br />1 "count":5,查询数量,0 表示最大值,默认值为 10,默认最大值为 100 <br /><br />2 "page":1,查询页码,从 0 开始,默认值为 0,默认最大值为 100,一般和 count 一起用<br /><br />3 "query":2,查询内容<br />0-对象,1-总数和分页详情,2-数据、总数和分页详情<br />总数关键词为 total,分页详情关键词为 info,<br /> 它们都和 query 同级,通过引用赋值得到自定义 key:value 键值对,不传则返回默认键值对,例如 <br />"total@":"/[]/total", "info@":"/[]/info" <br />这里query及total仅为GET类型的请求提供方便,<br /> 一般可直接用HEAD类型的请求获取总数<br /><br />4 compat: true <br />处理最外层查询字段有特殊处理的情况下"query":2返回查询总数不准确的问题:<br />如DISTINCT去重、Aggregate 函数等<br /><br />5 "join":"&/Table0,\</table1/key1@" 或 <br />"join":{<br />  "&/Table0":{}, // 支持 ON 多个字段关联,<br />  "\</table1/key1@":{ // ON 只允许指定的 key1 关联<br />   "key0":value0, // 其它ON条件 <br />   "key2":value2,<br />   ... <br />   "@combine":"...", // 其它ON条件的组合方式 <br />   "@column":"...", // 外层 SELECT <br />   "@group":"...", // 外层 GROUP BY <br />   "@having":"..." // 外层 HAVING <br />  }<br />}<br />多表连接方式:<br /> "@" - APP JOIN <br /> "\<" - LEFT JOIN <br /> ">" - RIGHT JOIN <br /> "&" - INNER JOIN <br /> "\&#124;" - FULL JOIN <br /> "!" - OUTER JOIN <br /> "*" - CROSS JOIN <br /> "^" - SIDE JOIN <br /> "(" - ANTI JOIN <br /> ")" - FOREIGN JOIN <br />其中 @ APP JOIN 为应用层连表,会从已查出的主表里取得所有副表 key@ 关联的主表内的 refKey 作为一个数组 refKeys: [value0, value1...],然后把原来副表 count 次查询 key=$refKey 的 SQL 用 key IN($refKeys) 的方式合并为一条 SQL 来优化性能;<br /> 其它 JOIN 都是 SQL JOIN,具体功能和 MySQL,PostgreSQL 等数据库的 JOIN 一一对应 <br />`"join":"</vicetable/key@",`<br />`"MainTable":{},`<br />`"ViceTable":{"key@":"/MainTable/refKey"}`<br />会对应生成 <br />`MainTable LEFT JOIN ViceTable` <br />`ON ViceTable.key=MainTable.refKey` AND 其它ON条件 <br /> 除了 = 等价关联,也支持 ! 不等关联、\> \< \>= \<= 等比较关联和 $ ~ {} <strong> 等其它复杂关联方式 <br /><br />6 "otherKey":Object,自定义关键词,名称和以上系统关键词不一样,且原样返回上传的值 &#124; 1 查询User数组,最多5个:<br />["count":5](http://apijson.cn:8080/get/{"[]":{"count":5,"User":{}}})<br />对应 SQL 是`LIMIT 5` <br /><br /> 2 查询第3页的User数组,每页5个:<br />["count":5,<br />"page":3](http://apijson.cn:8080/get/{"[]":{"count":5,"page":3,"User":{}}})<br />对应 SQL 是`LIMIT 5 OFFSET 15` <br /><br /> 3 查询User数组和对应的User总数:<br />["[]":{<br />  "query":2,<br />  "User":{}<br />},<br />"total@":"/[]/total", // 可省略<br />"info@":"/[]/info" // 可省略](http://apijson.cn:8080/get/{"[]":{"query":2,"count":5,"User":{}},"total@":"%252F[]%252Ftotal","info@":"%252F[]%252Finfo"})<br /> 返回的数据中,总数及分页详情结构为: <br /> "total":139, // 总数 <br /> "info":{ // 分页详情 <br />  "total":139, // 总数 <br />  "count":5, // 每页数量 <br />  "page":0, // 当前页码 <br />  "max":27, // 最大页码 <br />  "more":true, // 是否还有更多 <br />  "first":true, // 是否为首页 <br />  "last":false // 是否为尾页 <br />} <br /><br /> 4查询User数组ID唯一情况下的User总数:<br />["[]":{<br />  "query":2,<br />"compat":"true",<br />  "User":{"@column":"DISTINCT id"}<br />},<br />"total@":"/[]/total", // 可省略<br />"info@":"/[]/info" // 可省略](http://apijson.cn:8080/get/{"[]":{"query":2,"count":5,"User":{}},"total@":"%252F[]%252Ftotal","info@":"%252F[]%252Finfo"})<br /> 返回的数据中,总数及分页详情结构为: <br /> "total":139, // 总数 <br /> "info":{ // 分页详情 <br />  "total":139, // 总数 <br />  "count":5, // 每页数量 <br />  "page":0, // 当前页码 <br />  "max":27, // 最大页码 <br />  "more":true, // 是否还有更多 <br />  "first":true, // 是否为首页 <br />  "last":false // 是否为尾页 <br />} <br /><br /> 5 Moment INNER JOIN User LEFT JOIN Comment:<br />["[]":{<br />  "join":"&/User/id@,\</comment",<br />  "Moment":{<br />   "@group":"id" // 主副表不是一对一,要去除重复数据<br />  },<br />  "User":{<br />   "name~":"t",<br />   "id@":"/Moment/userId"<br />  },<br />  "Comment":{<br />   "momentId@":"/Moment/id"<br />  }<br />}](http://apijson.cn/api/?type=JSON&url=http://apijson.cn:8080/get&json=%7B%22%5B%5D%22:%7B%22count%22:5,%22join%22:%22%26%2FUser%2Fid@,%3C%2FComment%22,%22Moment%22:%7B%22@column%22:%22id,userId,content%22,%22@group%22:%22id%22%7D,%22User%22:%7B%22name~%22:%22t%22,%22id@%22:%22%2FMoment%2FuserId%22,%22@column%22:%22id,name,head%22%7D,%22Comment%22:%7B%22momentId@%22:%22%2FMoment%2Fid%22,%22@column%22:%22id,momentId,content%22%7D%7D%7D)<br /><br /> 6 每一层都加当前用户名:<br />["User":{},<br />"[]":{<br />  "name@":"User/name", // 自定义关键词<br />  "Moment":{}<br />}](http://apijson.cn:8080/get/{"User":{},"[]":{"name@":"User%252Fname","Moment":{}}})
 对象关键词,可自定义 &#124; "@key":Object,@key 为 Table:{} 中 {} 内的关键词,Object 的类型由 @key 指定<br /><br />1 "@combine":"key0 \&#124; (key1 & (key2 \&#124; !key3))...",条件组合方式,最终按 <br /> (其它key条件 AND 连接) AND (key0条件 OR (key1条件 AND (key2条件 OR (NOT key3条件)))) <br />这种方式连接,其中 "其它key" 是指与 @combine 在同一对象,且未被它声明的条件 key,默认都是 & 连接。注意不要缺少或多余任何一个空格。 <br /><br />2 "@column":"column;function(arg)...",返回字段<br /><br />3 "@order":"column0+,column1-...",排序方式<br /><br />4 "@group":"column0,column1...",分组方式。如果 @column 里声明了 Table 的 id,则 id 也必须在 @group 中声明;其它情况下必须满足至少一个条件:<br />1.分组的 key 在 @column 里声明<br />2.Table 主键在 @group 中声明 <br /><br />5 "@having":"function0(...)?value0;function1(...)?value1;function2(...)?value2..." // OR 连接,或 <br />"@having&":"function0(...)?value0;function1(...)?value1;function2(...)?value2..." // AND 连接,或 <br />"@having":{<br />  "h0":"function0(...)?value0",<br />  "h1":function1(...)?value1",<br />  "h2":function2(...)?value2...",<br />  "@combine":"h0 & (h1 \&#124; !h2)" // 任意组合,非必传<br />}<br />SQL 函数条件,一般和 @group 一起用,函数一般在 @column 里声明<br /><br />6 "@schema":"sys",集合空间(数据库名/模式),非默认的值可通过它来指定,可以在最外层作为全局默认配置<br /><br />7 "@database":"POSTGRESQL",数据库类型,非默认的值可通过它来指定,可以在最外层作为全局默认配置<br /><br />8 "@datasource":"DRUID",跨数据源,非默认的值可通过它来指定,可以在最外层作为全局默认配置<br /><br />9 "@json":"key0,key1...",转为 JSON 格式返回,符合 JSONObject 则转为 {...},符合 JSONArray 则转为 \[...] <br /><br />10 "@role":"OWNER",来访角色,包括<br />UNKNOWN,LOGIN,CONTACT,CIRCLE,OWNER,ADMIN,<br />可以在最外层作为全局默认配置,<br />可自定义其它角色并重写 Verifier.verify 等相关方法来自定义校验 <br /><br />11 "@explain":true,性能分析,可以在最外层作为全局默认配置 <br /><br />12 "@raw":"key0,key1...",其中 key0, key1 都对应有键值对<br /> "key0":"SQL片段或SQL片段的别名", <br /> "key1":"SQL片段或SQL片段的别名" <br /> 自定义原始SQL片段,可扩展嵌套SQL函数等复杂语句,必须是后端已配置的,只有其它功能符都做不到才考虑,谨慎使用,注意防 SQL 注入<br /><br />13 "@null":"key1,key2...",空值键值对,自动插入 key1:null, key2:null ... 并作为有效键值对执行,作为条件时对应 SQL 是 `WHERE tag IS NULL`,作为值时对应 SQL 是 `SET tag = NULL`<br /><br />14 "@otherKey":Object,自定义关键词,名称和以上系统关键词不一样,且原样返回上传的值 &#124; 1 搜索 name 或 tag 任何一个字段包含字符 a 的 User 列表:<br /> ["name~":"a",<br />"tag~":"a",<br />"@combine":"name~ \&#124; tag~"](http://apijson.cn:8080/get/{"User[]":{"count":10,"User":{"@column":"id,name,tag","name~":"a","tag~":"a","@combine":"name~%20%7C%20tag~"}}}) <br />对应SQL是`name REGEXP 'a' OR tag REGEXP 'a'` <br /><br /> 2 只查询 id,sex,name 这几列并且请求结果也按照这个顺序:<br />["@column":"id,sex,name"](http://apijson.cn:8080/get/{"User":{"@column":"id,sex,name","id":38710}})<br />对应 SQL 是`SELECT id,sex,name` <br /><br /> 3 查询按 name 降序、id 默认顺序 排序的 User 数组:<br />["@order":"name-,id"](http://apijson.cn:8080/get/{"[]":{"count":10,"User":{"@column":"name,id","@order":"name-,id"}}})<br />对应 SQL 是`ORDER BY name DESC,id` <br /><br /> 4 查询按 userId 分组的 Moment 数组:<br />["@group":"userId,id"](http://apijson.cn:8080/get/{"[]":{"count":10,"Moment":%7B"@column":"userId,id","@group":"userId,id"}}})<br />对应 SQL 是`GROUP BY userId,id` <br /><br /> 5 查询 按 userId 分组、id 最大值>=100 的 Moment 数组:<br />["@column":"userId;max(id)",<br />"@group":"userId",<br />"@having":"max(id)>=100"](http://apijson.cn:8080/get/{"[]":{"count":10,"Moment":{"@column":"userId%253Bmax(id)","@group":"userId","@having":"max(id)>=100"}}})<br />对应 SQL 是`SELECT userId,max(id) ... GROUP BY userId HAVING max(id)>=100` <br />还可以指定函数返回名:<br />["@column":"userId;max(id):maxId",<br />"@group":"userId",<br />"@having":"(maxId)>=100"](http://apijson.cn:8080/get/{"[]":{"count":10,"Moment":{"@column":"userId%253Bmax(id):maxId","@group":"userId","@having":"(maxId)>=100"}}})<br />对应 SQL 是`SELECT userId,max(id) AS maxId ... GROUP BY userId HAVING (maxId)>=100` <br /><br /> 6 查询 sys 内的 User 表:<br />["@schema":"sys"](http://apijson.cn:8080/get/{"User":{"@schema":"sys"}})<br />对应 SQL 是`FROM sys.User` <br /><br /> 7 查询 PostgreSQL 数据库的 User 表:<br />["@database":"POSTGRESQL"](http://apijson.cn:8080/get/{"User":{"@database":"POSTGRESQL","@explain":true}})<br /><br /> 8 使用 Druid 连接池查询 User 表:<br />["@datasource":"DRUID"](http://apijson.cn:8080/get/{"User":{"@datasource":"DRUID"}})<br /><br /> 9 将 VARCHAR 字符串字段 get 转为 JSONArray 返回:<br />["@json":"get"](http://apijson.cn:8080/get/{"Access":{"@json":"get"}})<br /><br /> 10 查询当前用户的动态:<br />["@role":"OWNER"](http://apijson.cn:8080/get/{"[]":{"Moment":{"@role":"OWNER"}}})<br /><br /> 11 开启性能分析:<br />["@explain":true](http://apijson.cn:8080/get/{"[]":{"Moment":{"@explain":true}}})<br />对应 SQL 是`EXPLAIN` <br /><br /> 12 统计最近一周偶数 userId 的数量<br />["@column":"date;left(date,10):day;sum(if(userId%2=0,1,0))",<br />"@group":"day",<br />"@having":"to_days(now())-to_days(\`date\`)<=7",<br />"@raw":"@column,@having"](http://apijson.cn:8080/get/{"[]":{"Moment":{"@column":"date%3bleft(date,10):day%3bsum(if(userId%252=0,1,0))","@group":"day","@having":"to_days(now())-to_days(\`date\`)<=7","@raw":"@column,@having"}}})<br />对应 SQL 是``SELECT date, left(date,10) AS day, sum(if(userId%2=0,1,0)) ... GROUP BY day HAVING to_days(now())-to_days(`date`)<=7`` <br /><br /> 13 把用户的标签设置为空 <br />["@null":"tag"](http://apijson.cn/api/?type=JSON&url=http://apijson.cn:8080/put/User&json={%22id%22:82001,%22@null%22:%22tag%22,%22@explain%22:true}) <br /><br /> 14 从pictureList 获取第 0 张图片:<br />["@position":0, // 自定义关键词<br />"firstPicture()":"getFromArray(pictureList,@position)"](http://apijson.cn:8080/get/{"User":{"id":38710,"@position":0,"firstPicture()":"getFromArray(pictureList,@position)"}})
 全局关键词 &#124; 为最外层对象 {} 内的关键词。其中 @database,@schema, @datasource, @role, @explain 基本同对象关键词,见上方说明,区别是全局关键词会每个表对象中没有时自动放入,作为默认值。 <br /><br />1 "tag":"Table",后面的 tag 是非 GET、HEAD 请求中匹配请求的 JSON 结构的标识,一般是要查询的 Table 的名称或该名称对应的数组 Table[] 或 Table:[],由后端 Request 表中指定。 <br /><br />2 "version":1,接口版本,version 不传、为 null 或 <=0 都会使用最高版本,传了其它有效值则会使用最接近它的最低版本,由后端 Request 表中指定。<br /><br />3 "format":true,格式化返回 Response JSON 的 key,一般是将 TableName 转为 tableName, TableName[] 转为 tableNameList, Table:alias 转为 alias, TableName-key[] 转为 tableNameKeyList 等小驼峰格式。 &#124; 1 查隐私信息:<br />[{"tag":"Privacy","Privacy":{"id":82001}}](http://apijson.cn/api?url=http%3A%2F%2Fapijson.cn%3A8080%2Fgets&type=JSON&json={%22tag%22:%22Privacy%22,%22Privacy%22:{%22id%22:82001}})<br /><br /> 2 使用第 1 版接口查隐私信息:<br />[{"version":1,"tag":"Privacy","Privacy":{"id":82001}}](http://apijson.cn/api?url=http%3A%2F%2Fapijson.cn%3A8080%2Fgets&type=JSON&json={%22version%22:1,%22tag%22:%22Privacy%22,%22Privacy%22:{%22id%22:82001}}) <br /><br /> 3 格式化朋友圈接口返回 JSON 中的 key:<br />[{<br>  "format":true, <br>  "[]":{<br>   "page":0, <br>   "count":3, <br>   "Moment":{}, <br>   "User":{<br>    "id@":"/Moment/userId"<br>   },<br>   "Comment[]":{<br>    "count":3,<br>    "Comment":{<br>     "momentId@":"[]/Moment/id"<br>    }<br>   }<br>  }<br>}](http://apijson.cn:8080/get/{"format":true,"[]":{"page":0,"count":3,"Moment":{},"User":{"id@":"%252FMoment%252FuserId"},"Comment[]":{"count":3,"Comment":{"momentId@":"[]%252FMoment%252Fid"}}}})
 <br />
From 7645a599b9171019afb35be1e0d120127f67c7ab Mon Sep 17 00:00:00 2001
From: TommyLemon <1184482681@qq.com>
Date: 2025年7月26日 22:28:26 +0800
Subject: [PATCH 02/26] =?UTF-8?q?=E6=96=B0=E5=A2=9E=20compat=20=E5=85=BC?=
 =?UTF-8?q?=E5=AE=B9=E5=90=84=E7=A7=8D=20count=20SQL=20=E7=9A=84=E8=AF=B4?=
 =?UTF-8?q?=E6=98=8E=EF=BC=8C=E6=84=9F=E8=B0=A2=20GeXin97=20=E5=AE=8C?=
 =?UTF-8?q?=E5=96=84=E9=80=9A=E7=94=A8=E6=96=87=E6=A1=A3=E7=9A=84=E8=B4=A1?=
 =?UTF-8?q?=E7=8C=AE=20#832?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
https://github.com/Tencent/APIJSON/pull/832
---
 Document.md &#124; 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/Document.md b/Document.md
index 29543da98..1d57d6709 100644
--- a/Document.md
+++ b/Document.md
@@ -420,7 +420,7 @@ DELETE: <br> 删除数据 &#124; base_url/delete/ &#124; {<br>  TableName:{< 减少 或 去除 &#124; "key-":Object,与"key+"相反 &#124; "balance-":100.00,对应SQL是`balance = balance - 100.00`,余额减少100.00,即花费了100元 比较运算 &#124;>, <,>=, <= 比较运算符,用于 <br />1 提供 "id{}":"<=90000" 这种条件范围的简化写法 <br /><br />2 实现子查询相关比较运算<br /><br />不支持 "key=":Object 和 "key!=":Object 这两种写法,直接用更简单的 "key":Object 和 "key!":Object 替代。 &#124; 1 ["id<=":90000](http://apijson.cn:8080/get/{"[]":{"user":{"id<=":90000}}}),对应 SQL 是`id<=90000`,查询符合id<=90000的一个user数组<br /><br /> 2 ["id>@":{<br />  "from":"Comment",<br />  "Comment":{<br />    "@column":"min(userId)" <br />  }<br />}](http://apijson.cn:8080/get/{"User":{"id>@":{"from":"Comment","Comment":{"@column":"min(userId)"}}}})<br /> WHERE id>(SELECT min(userId) FROM Comment)
 逻辑运算 &#124; &, \&#124;, ! 逻辑运算符,对应数据库 SQL 中的 AND, OR, NOT。 <br />横或纵与:同一键值对的值内条件默认 \&#124; 或连接,可以在 key 后加逻辑运算符来具体指定;不同键值对的条件默认 & 与连接,可以用下面说明的对象关键词 @combine 来具体指定。 <br /><br />1 & 可用于 "key&{}":"条件"等<br /><br />2 \&#124; 可用于 "key\&#124;{}":"条件", "key\&#124;{}":[]等,一般可省略<br /><br />3 ! 可单独使用,如 "key!":Object,也可像 &,\&#124; 一样配合其他功能符使用 <br /> "key!":null 无效,null 值会导致整个键值对被忽略解析,可以用 "key{}":"!=null" 替代,<br />"key":null 同理,用 "key{}":"=null" 替代。 &#124; 1 ["id&{}":">80000,<=90000"](http://apijson.cn:8080/head/{"user":{"id&{}":">80000,<=90000"}}),对应sql是`id>80000 AND id<=90000`,即id满足id>80000 & id<=90000<br /><br /> 2 ["id\&#124;{}":">90000,<=80000"](http://apijson.cn:8080/head/{"user":{"id\&#124;{}":">90000,<=80000"}}),同 "id{}":">90000,<=80000",对应 SQL 是`id>90000 OR id<=80000`,即 id 满足 id>90000 \&#124; id<=80000<br /><br /> 3 ["id!{}":[82001,38710]](http://apijson.cn:8080/head/{"User":{"id!{}":[82001,38710]}}),对应 SQL 是`id NOT IN(82001,38710)`,即 id 满足 ! (id=82001 \&#124; id=38710),可过滤黑名单的消息
- 数组关键词,可自定义 &#124; "key":Object,key为 "[]":{} 中 {} 内的关键词,Object 的类型由 key 指定<br /><br />1 "count":5,查询数量,0 表示最大值,默认值为 10,默认最大值为 100 <br /><br />2 "page":1,查询页码,从 0 开始,默认值为 0,默认最大值为 100,一般和 count 一起用<br /><br />3 "query":2,查询内容<br />0-对象,1-总数和分页详情,2-数据、总数和分页详情<br />总数关键词为 total,分页详情关键词为 info,<br /> 它们都和 query 同级,通过引用赋值得到自定义 key:value 键值对,不传则返回默认键值对,例如 <br />"total@":"/[]/total", "info@":"/[]/info" <br />这里query及total仅为GET类型的请求提供方便,<br /> 一般可直接用HEAD类型的请求获取总数<br /><br />4 compat: true <br />处理最外层查询字段有特殊处理的情况下"query":2返回查询总数不准确的问题:<br />如DISTINCT去重、Aggregate 函数等<br /><br />5 "join":"&/Table0,\</table1/key1@" 或 <br />"join":{<br />  "&/Table0":{}, // 支持 ON 多个字段关联,<br />  "\</table1/key1@":{ // ON 只允许指定的 key1 关联<br />   "key0":value0, // 其它ON条件 <br />   "key2":value2,<br />   ... <br />   "@combine":"...", // 其它ON条件的组合方式 <br />   "@column":"...", // 外层 SELECT <br />   "@group":"...", // 外层 GROUP BY <br />   "@having":"..." // 外层 HAVING <br />  }<br />}<br />多表连接方式:<br /> "@" - APP JOIN <br /> "\<" - LEFT JOIN <br /> ">" - RIGHT JOIN <br /> "&" - INNER JOIN <br /> "\&#124;" - FULL JOIN <br /> "!" - OUTER JOIN <br /> "*" - CROSS JOIN <br /> "^" - SIDE JOIN <br /> "(" - ANTI JOIN <br /> ")" - FOREIGN JOIN <br />其中 @ APP JOIN 为应用层连表,会从已查出的主表里取得所有副表 key@ 关联的主表内的 refKey 作为一个数组 refKeys: [value0, value1...],然后把原来副表 count 次查询 key=$refKey 的 SQL 用 key IN($refKeys) 的方式合并为一条 SQL 来优化性能;<br /> 其它 JOIN 都是 SQL JOIN,具体功能和 MySQL,PostgreSQL 等数据库的 JOIN 一一对应 <br />`"join":"</vicetable/key@",`<br />`"MainTable":{},`<br />`"ViceTable":{"key@":"/MainTable/refKey"}`<br />会对应生成 <br />`MainTable LEFT JOIN ViceTable` <br />`ON ViceTable.key=MainTable.refKey` AND 其它ON条件 <br /> 除了 = 等价关联,也支持 ! 不等关联、\> \< \>= \<= 等比较关联和 $ ~ {} <strong> 等其它复杂关联方式 <br /><br />6 "otherKey":Object,自定义关键词,名称和以上系统关键词不一样,且原样返回上传的值 &#124; 1 查询User数组,最多5个:<br />["count":5](http://apijson.cn:8080/get/{"[]":{"count":5,"User":{}}})<br />对应 SQL 是`LIMIT 5` <br /><br /> 2 查询第3页的User数组,每页5个:<br />["count":5,<br />"page":3](http://apijson.cn:8080/get/{"[]":{"count":5,"page":3,"User":{}}})<br />对应 SQL 是`LIMIT 5 OFFSET 15` <br /><br /> 3 查询User数组和对应的User总数:<br />["[]":{<br />  "query":2,<br />  "User":{}<br />},<br />"total@":"/[]/total", // 可省略<br />"info@":"/[]/info" // 可省略](http://apijson.cn:8080/get/{"[]":{"query":2,"count":5,"User":{}},"total@":"%252F[]%252Ftotal","info@":"%252F[]%252Finfo"})<br /> 返回的数据中,总数及分页详情结构为: <br /> "total":139, // 总数 <br /> "info":{ // 分页详情 <br />  "total":139, // 总数 <br />  "count":5, // 每页数量 <br />  "page":0, // 当前页码 <br />  "max":27, // 最大页码 <br />  "more":true, // 是否还有更多 <br />  "first":true, // 是否为首页 <br />  "last":false // 是否为尾页 <br />} <br /><br /> 4查询User数组ID唯一情况下的User总数:<br />["[]":{<br />  "query":2,<br />"compat":"true",<br />  "User":{"@column":"DISTINCT id"}<br />},<br />"total@":"/[]/total", // 可省略<br />"info@":"/[]/info" // 可省略](http://apijson.cn:8080/get/{"[]":{"query":2,"count":5,"User":{}},"total@":"%252F[]%252Ftotal","info@":"%252F[]%252Finfo"})<br /> 返回的数据中,总数及分页详情结构为: <br /> "total":139, // 总数 <br /> "info":{ // 分页详情 <br />  "total":139, // 总数 <br />  "count":5, // 每页数量 <br />  "page":0, // 当前页码 <br />  "max":27, // 最大页码 <br />  "more":true, // 是否还有更多 <br />  "first":true, // 是否为首页 <br />  "last":false // 是否为尾页 <br />} <br /><br /> 5 Moment INNER JOIN User LEFT JOIN Comment:<br />["[]":{<br />  "join":"&/User/id@,\</comment",<br />  "Moment":{<br />   "@group":"id" // 主副表不是一对一,要去除重复数据<br />  },<br />  "User":{<br />   "name~":"t",<br />   "id@":"/Moment/userId"<br />  },<br />  "Comment":{<br />   "momentId@":"/Moment/id"<br />  }<br />}](http://apijson.cn/api/?type=JSON&url=http://apijson.cn:8080/get&json=%7B%22%5B%5D%22:%7B%22count%22:5,%22join%22:%22%26%2FUser%2Fid@,%3C%2FComment%22,%22Moment%22:%7B%22@column%22:%22id,userId,content%22,%22@group%22:%22id%22%7D,%22User%22:%7B%22name~%22:%22t%22,%22id@%22:%22%2FMoment%2FuserId%22,%22@column%22:%22id,name,head%22%7D,%22Comment%22:%7B%22momentId@%22:%22%2FMoment%2Fid%22,%22@column%22:%22id,momentId,content%22%7D%7D%7D)<br /><br /> 6 每一层都加当前用户名:<br />["User":{},<br />"[]":{<br />  "name@":"User/name", // 自定义关键词<br />  "Moment":{}<br />}](http://apijson.cn:8080/get/{"User":{},"[]":{"name@":"User%252Fname","Moment":{}}})
+ 数组关键词,可自定义 &#124; "key":Object,key为 "[]":{} 中 {} 内的关键词,Object 的类型由 key 指定<br /><br />1 "count":5,查询数量,0 表示最大值,默认值为 10,默认最大值为 100 <br /><br />2 "page":1,查询页码,从 0 开始,默认值为 0,默认最大值为 100,一般和 count 一起用<br /><br />3 "query":2,查询内容<br />0-对象,1-总数和分页详情,2-数据、总数和分页详情<br />总数关键词为 total,分页详情关键词为 info,<br /> 它们都和 query 同级,通过引用赋值得到自定义 key:value 键值对,不传则返回默认键值对,例如 <br />"total@":"/[]/total", "info@":"/[]/info" <br />这里query及total仅为GET类型的请求提供方便,<br /> 一般可直接用HEAD类型的请求获取总数<br /><br />4 "compat": true <br />处理最外层查询字段有特殊处理的情况下 "query":2 返回查询总数不准确的问题:如DISTINCT去重、Aggregate 函数等<br /><br />5 "join":"&/Table0,\</table1/key1@" 或 <br />"join":{<br />  "&/Table0":{}, // 支持 ON 多个字段关联,<br />  "\</table1/key1@":{ // ON 只允许指定的 key1 关联<br />   "key0":value0, // 其它ON条件 <br />   "key2":value2,<br />   ... <br />   "@combine":"...", // 其它ON条件的组合方式 <br />   "@column":"...", // 外层 SELECT <br />   "@group":"...", // 外层 GROUP BY <br />   "@having":"..." // 外层 HAVING <br />  }<br />}<br />多表连接方式:<br /> "@" - APP JOIN <br /> "\<" - LEFT JOIN <br /> ">" - RIGHT JOIN <br /> "&" - INNER JOIN <br /> "\&#124;" - FULL JOIN <br /> "!" - OUTER JOIN <br /> "*" - CROSS JOIN <br /> "^" - SIDE JOIN <br /> "(" - ANTI JOIN <br /> ")" - FOREIGN JOIN <br />其中 @ APP JOIN 为应用层连表,会从已查出的主表里取得所有副表 key@ 关联的主表内的 refKey 作为一个数组 refKeys: [value0, value1...],然后把原来副表 count 次查询 key=$refKey 的 SQL 用 key IN($refKeys) 的方式合并为一条 SQL 来优化性能;<br /> 其它 JOIN 都是 SQL JOIN,具体功能和 MySQL,PostgreSQL 等数据库的 JOIN 一一对应 <br />`"join":"</vicetable/key@",`<br />`"MainTable":{},`<br />`"ViceTable":{"key@":"/MainTable/refKey"}`<br />会对应生成 <br />`MainTable LEFT JOIN ViceTable` <br />`ON ViceTable.key=MainTable.refKey` AND 其它ON条件 <br /> 除了 = 等价关联,也支持 ! 不等关联、\> \< \>= \<= 等比较关联和 $ ~ {} <strong> 等其它复杂关联方式 <br /><br />6 "otherKey":Object,自定义关键词,名称和以上系统关键词不一样,且原样返回上传的值 &#124; 1 查询User数组,最多5个:<br />["count":5](http://apijson.cn:8080/get/{"[]":{"count":5,"User":{}}})<br />对应 SQL 是`LIMIT 5` <br /><br /> 2 查询第3页的User数组,每页5个:<br />["count":5,<br />"page":3](http://apijson.cn:8080/get/{"[]":{"count":5,"page":3,"User":{}}})<br />对应 SQL 是`LIMIT 5 OFFSET 15` <br /><br /> 3 查询User数组和对应的User总数:<br />["[]":{<br />  "query":2,<br />  "User":{}<br />},<br />"total@":"/[]/total", // 可省略<br />"info@":"/[]/info" // 可省略](http://apijson.cn:8080/get/{"[]":{"query":2,"count":5,"User":{}},"total@":"%252F[]%252Ftotal","info@":"%252F[]%252Finfo"})<br /> 返回的数据中,总数及分页详情结构为: <br /> "total":139, // 总数 <br /> "info":{ // 分页详情 <br />  "total":139, // 总数 <br />  "count":5, // 每页数量 <br />  "page":0, // 当前页码 <br />  "max":27, // 最大页码 <br />  "more":true, // 是否还有更多 <br />  "first":true, // 是否为首页 <br />  "last":false // 是否为尾页 <br />} <br /><br /> 4查询User数组ID唯一情况下的User总数:<br />["[]":{<br />  "query":2,<br />  "compat":"true",<br />  "User":{<br />   "@column":"DISTINCT id" <br />  }<br />}](http://apijson.cn:8080/get/{"[]":{"query":2,"count":5,"User":{}}})<br /> 返回的数据和结构同上 <br /><br /> 5 Moment INNER JOIN User LEFT JOIN Comment:<br />["[]":{<br />  "join":"&/User/id@,\</comment",<br />  "Moment":{<br />   "@group":"id" // 主副表不是一对一,要去除重复数据<br />  },<br />  "User":{<br />   "name~":"t",<br />   "id@":"/Moment/userId"<br />  },<br />  "Comment":{<br />   "momentId@":"/Moment/id"<br />  }<br />}](http://apijson.cn/api/?type=JSON&url=http://apijson.cn:8080/get&json=%7B%22%5B%5D%22:%7B%22count%22:5,%22join%22:%22%26%2FUser%2Fid@,%3C%2FComment%22,%22Moment%22:%7B%22@column%22:%22id,userId,content%22,%22@group%22:%22id%22%7D,%22User%22:%7B%22name~%22:%22t%22,%22id@%22:%22%2FMoment%2FuserId%22,%22@column%22:%22id,name,head%22%7D,%22Comment%22:%7B%22momentId@%22:%22%2FMoment%2Fid%22,%22@column%22:%22id,momentId,content%22%7D%7D%7D)<br /><br /> 6 每一层都加当前用户名:<br />["User":{},<br />"[]":{<br />  "name@":"User/name", // 自定义关键词<br />  "Moment":{}<br />}](http://apijson.cn:8080/get/{"User":{},"[]":{"name@":"User%252Fname","Moment":{}}})
 对象关键词,可自定义 &#124; "@key":Object,@key 为 Table:{} 中 {} 内的关键词,Object 的类型由 @key 指定<br /><br />1 "@combine":"key0 \&#124; (key1 & (key2 \&#124; !key3))...",条件组合方式,最终按 <br /> (其它key条件 AND 连接) AND (key0条件 OR (key1条件 AND (key2条件 OR (NOT key3条件)))) <br />这种方式连接,其中 "其它key" 是指与 @combine 在同一对象,且未被它声明的条件 key,默认都是 & 连接。注意不要缺少或多余任何一个空格。 <br /><br />2 "@column":"column;function(arg)...",返回字段<br /><br />3 "@order":"column0+,column1-...",排序方式<br /><br />4 "@group":"column0,column1...",分组方式。如果 @column 里声明了 Table 的 id,则 id 也必须在 @group 中声明;其它情况下必须满足至少一个条件:<br />1.分组的 key 在 @column 里声明<br />2.Table 主键在 @group 中声明 <br /><br />5 "@having":"function0(...)?value0;function1(...)?value1;function2(...)?value2..." // OR 连接,或 <br />"@having&":"function0(...)?value0;function1(...)?value1;function2(...)?value2..." // AND 连接,或 <br />"@having":{<br />  "h0":"function0(...)?value0",<br />  "h1":function1(...)?value1",<br />  "h2":function2(...)?value2...",<br />  "@combine":"h0 & (h1 \&#124; !h2)" // 任意组合,非必传<br />}<br />SQL 函数条件,一般和 @group 一起用,函数一般在 @column 里声明<br /><br />6 "@schema":"sys",集合空间(数据库名/模式),非默认的值可通过它来指定,可以在最外层作为全局默认配置<br /><br />7 "@database":"POSTGRESQL",数据库类型,非默认的值可通过它来指定,可以在最外层作为全局默认配置<br /><br />8 "@datasource":"DRUID",跨数据源,非默认的值可通过它来指定,可以在最外层作为全局默认配置<br /><br />9 "@json":"key0,key1...",转为 JSON 格式返回,符合 JSONObject 则转为 {...},符合 JSONArray 则转为 \[...] <br /><br />10 "@role":"OWNER",来访角色,包括<br />UNKNOWN,LOGIN,CONTACT,CIRCLE,OWNER,ADMIN,<br />可以在最外层作为全局默认配置,<br />可自定义其它角色并重写 Verifier.verify 等相关方法来自定义校验 <br /><br />11 "@explain":true,性能分析,可以在最外层作为全局默认配置 <br /><br />12 "@raw":"key0,key1...",其中 key0, key1 都对应有键值对<br /> "key0":"SQL片段或SQL片段的别名", <br /> "key1":"SQL片段或SQL片段的别名" <br /> 自定义原始SQL片段,可扩展嵌套SQL函数等复杂语句,必须是后端已配置的,只有其它功能符都做不到才考虑,谨慎使用,注意防 SQL 注入<br /><br />13 "@null":"key1,key2...",空值键值对,自动插入 key1:null, key2:null ... 并作为有效键值对执行,作为条件时对应 SQL 是 `WHERE tag IS NULL`,作为值时对应 SQL 是 `SET tag = NULL`<br /><br />14 "@otherKey":Object,自定义关键词,名称和以上系统关键词不一样,且原样返回上传的值 &#124; 1 搜索 name 或 tag 任何一个字段包含字符 a 的 User 列表:<br /> ["name~":"a",<br />"tag~":"a",<br />"@combine":"name~ \&#124; tag~"](http://apijson.cn:8080/get/{"User[]":{"count":10,"User":{"@column":"id,name,tag","name~":"a","tag~":"a","@combine":"name~%20%7C%20tag~"}}}) <br />对应SQL是`name REGEXP 'a' OR tag REGEXP 'a'` <br /><br /> 2 只查询 id,sex,name 这几列并且请求结果也按照这个顺序:<br />["@column":"id,sex,name"](http://apijson.cn:8080/get/{"User":{"@column":"id,sex,name","id":38710}})<br />对应 SQL 是`SELECT id,sex,name` <br /><br /> 3 查询按 name 降序、id 默认顺序 排序的 User 数组:<br />["@order":"name-,id"](http://apijson.cn:8080/get/{"[]":{"count":10,"User":{"@column":"name,id","@order":"name-,id"}}})<br />对应 SQL 是`ORDER BY name DESC,id` <br /><br /> 4 查询按 userId 分组的 Moment 数组:<br />["@group":"userId,id"](http://apijson.cn:8080/get/{"[]":{"count":10,"Moment":%7B"@column":"userId,id","@group":"userId,id"}}})<br />对应 SQL 是`GROUP BY userId,id` <br /><br /> 5 查询 按 userId 分组、id 最大值>=100 的 Moment 数组:<br />["@column":"userId;max(id)",<br />"@group":"userId",<br />"@having":"max(id)>=100"](http://apijson.cn:8080/get/{"[]":{"count":10,"Moment":{"@column":"userId%253Bmax(id)","@group":"userId","@having":"max(id)>=100"}}})<br />对应 SQL 是`SELECT userId,max(id) ... GROUP BY userId HAVING max(id)>=100` <br />还可以指定函数返回名:<br />["@column":"userId;max(id):maxId",<br />"@group":"userId",<br />"@having":"(maxId)>=100"](http://apijson.cn:8080/get/{"[]":{"count":10,"Moment":{"@column":"userId%253Bmax(id):maxId","@group":"userId","@having":"(maxId)>=100"}}})<br />对应 SQL 是`SELECT userId,max(id) AS maxId ... GROUP BY userId HAVING (maxId)>=100` <br /><br /> 6 查询 sys 内的 User 表:<br />["@schema":"sys"](http://apijson.cn:8080/get/{"User":{"@schema":"sys"}})<br />对应 SQL 是`FROM sys.User` <br /><br /> 7 查询 PostgreSQL 数据库的 User 表:<br />["@database":"POSTGRESQL"](http://apijson.cn:8080/get/{"User":{"@database":"POSTGRESQL","@explain":true}})<br /><br /> 8 使用 Druid 连接池查询 User 表:<br />["@datasource":"DRUID"](http://apijson.cn:8080/get/{"User":{"@datasource":"DRUID"}})<br /><br /> 9 将 VARCHAR 字符串字段 get 转为 JSONArray 返回:<br />["@json":"get"](http://apijson.cn:8080/get/{"Access":{"@json":"get"}})<br /><br /> 10 查询当前用户的动态:<br />["@role":"OWNER"](http://apijson.cn:8080/get/{"[]":{"Moment":{"@role":"OWNER"}}})<br /><br /> 11 开启性能分析:<br />["@explain":true](http://apijson.cn:8080/get/{"[]":{"Moment":{"@explain":true}}})<br />对应 SQL 是`EXPLAIN` <br /><br /> 12 统计最近一周偶数 userId 的数量<br />["@column":"date;left(date,10):day;sum(if(userId%2=0,1,0))",<br />"@group":"day",<br />"@having":"to_days(now())-to_days(\`date\`)<=7",<br />"@raw":"@column,@having"](http://apijson.cn:8080/get/{"[]":{"Moment":{"@column":"date%3bleft(date,10):day%3bsum(if(userId%252=0,1,0))","@group":"day","@having":"to_days(now())-to_days(\`date\`)<=7","@raw":"@column,@having"}}})<br />对应 SQL 是``SELECT date, left(date,10) AS day, sum(if(userId%2=0,1,0)) ... GROUP BY day HAVING to_days(now())-to_days(`date`)<=7`` <br /><br /> 13 把用户的标签设置为空 <br />["@null":"tag"](http://apijson.cn/api/?type=JSON&url=http://apijson.cn:8080/put/User&json={%22id%22:82001,%22@null%22:%22tag%22,%22@explain%22:true}) <br /><br /> 14 从pictureList 获取第 0 张图片:<br />["@position":0, // 自定义关键词<br />"firstPicture()":"getFromArray(pictureList,@position)"](http://apijson.cn:8080/get/{"User":{"id":38710,"@position":0,"firstPicture()":"getFromArray(pictureList,@position)"}})
 全局关键词 &#124; 为最外层对象 {} 内的关键词。其中 @database,@schema, @datasource, @role, @explain 基本同对象关键词,见上方说明,区别是全局关键词会每个表对象中没有时自动放入,作为默认值。 <br /><br />1 "tag":"Table",后面的 tag 是非 GET、HEAD 请求中匹配请求的 JSON 结构的标识,一般是要查询的 Table 的名称或该名称对应的数组 Table[] 或 Table:[],由后端 Request 表中指定。 <br /><br />2 "version":1,接口版本,version 不传、为 null 或 <=0 都会使用最高版本,传了其它有效值则会使用最接近它的最低版本,由后端 Request 表中指定。<br /><br />3 "format":true,格式化返回 Response JSON 的 key,一般是将 TableName 转为 tableName, TableName[] 转为 tableNameList, Table:alias 转为 alias, TableName-key[] 转为 tableNameKeyList 等小驼峰格式。 &#124; 1 查隐私信息:<br />[{"tag":"Privacy","Privacy":{"id":82001}}](http://apijson.cn/api?url=http%3A%2F%2Fapijson.cn%3A8080%2Fgets&type=JSON&json={%22tag%22:%22Privacy%22,%22Privacy%22:{%22id%22:82001}})<br /><br /> 2 使用第 1 版接口查隐私信息:<br />[{"version":1,"tag":"Privacy","Privacy":{"id":82001}}](http://apijson.cn/api?url=http%3A%2F%2Fapijson.cn%3A8080%2Fgets&type=JSON&json={%22version%22:1,%22tag%22:%22Privacy%22,%22Privacy%22:{%22id%22:82001}}) <br /><br /> 3 格式化朋友圈接口返回 JSON 中的 key:<br />[{<br>  "format":true, <br>  "[]":{<br>   "page":0, <br>   "count":3, <br>   "Moment":{}, <br>   "User":{<br>    "id@":"/Moment/userId"<br>   },<br>   "Comment[]":{<br>    "count":3,<br>    "Comment":{<br>     "momentId@":"[]/Moment/id"<br>    }<br>   }<br>  }<br>}](http://apijson.cn:8080/get/{"format":true,"[]":{"page":0,"count":3,"Moment":{},"User":{"id@":"%252FMoment%252FuserId"},"Comment[]":{"count":3,"Comment":{"momentId@":"[]%252FMoment%252Fid"}}}})
 <br />
From 35bdfad47496604b410eaf82e0286f42faa4da46 Mon Sep 17 00:00:00 2001
From: aPing <34087052+yunjiao-source@users.noreply.github.com>
Date: 2025年7月29日 20:00:24 +0800
Subject: [PATCH 03/26] Update README.md
---
 README.md &#124; 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)
diff --git a/README.md b/README.md
index c4b0cb8bc..bb148d489 100644
--- a/README.md
+++ b/README.md
@@ -743,7 +743,9 @@ Issue/问卷 一般解答顺序:贡献者> 帮助他人的用户> 提供任
 [review_plan](https://gitee.com/PPXcodeTry/review_plan) 复习提醒Web版(Java技术练习项目)
 
 [apijson-nutz](https://github.com/vincent109/apijson-nutz) APIJSON + Nutz 框架 + NutzBoot 的 Demo
- 
+
+[apijson-spring-boot](https://gitee.com/yunjiao-source/apijson-spring-boot) Springboot3 for APIJSON
+
 感谢热心的作者们的贡献,点 ⭐Star 支持下他们吧~
 
 
From 1abe851a19235cbffd97a1b521f49bee6feda6f6 Mon Sep 17 00:00:00 2001
From: TommyLemon <1184482681@qq.com>
Date: 2025年7月29日 22:47:51 +0800
Subject: [PATCH 04/26] =?UTF-8?q?=E7=94=9F=E6=80=81=E9=A1=B9=E7=9B=AE?=
 =?UTF-8?q?=E6=96=B0=E5=A2=9E=20apijson-spring-boot=EF=BC=8C=E6=84=9F?=
 =?UTF-8?q?=E8=B0=A2=20yunjiao-source=20=E7=9A=84=E8=B4=A1=E7=8C=AE=20#834?=
 =?UTF-8?q?=EF=BC=9Ahttps://gitee.com/yunjiao-source/apijson-spring-boot?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
创作不易,为热心的作者右上角点亮 ⭐Star 收藏/支持下项目吧 ^_^
https://gitee.com/yunjiao-source/apijson-spring-boot
---
 README.md &#124; 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/README.md b/README.md
index bb148d489..5c2ee1558 100644
--- a/README.md
+++ b/README.md
@@ -744,7 +744,7 @@ Issue/问卷 一般解答顺序:贡献者> 帮助他人的用户> 提供任
 
 [apijson-nutz](https://github.com/vincent109/apijson-nutz) APIJSON + Nutz 框架 + NutzBoot 的 Demo
 
-[apijson-spring-boot](https://gitee.com/yunjiao-source/apijson-spring-boot) Springboot3 for APIJSON
+[apijson-spring-boot](https://gitee.com/yunjiao-source/apijson-spring-boot) Springboot3 for APIJSON,用 YAML 简化代码配置
 
 感谢热心的作者们的贡献,点 ⭐Star 支持下他们吧~
 
From d21e4003cdcc05118dbd77149de30b2ff57e3ec0 Mon Sep 17 00:00:00 2001
From: wz11wz <wuzeng@chalco-steering.com>
Date: Mon, 4 Aug 2025 11:20:24 +0800
Subject: [PATCH 05/26] =?UTF-8?q?fix:=20=E9=92=88=E5=AF=B9left=20join=20?=
 =?UTF-8?q?=E4=BB=A5=E5=8F=8A=20right=20join=20outerConfig=20=E4=B8=8A?=
 =?UTF-8?q?=EF=BC=8C=E5=A2=9E=E5=8A=A0=20AbstractSQLConfig=20gainWhereStri?=
 =?UTF-8?q?ng=E3=80=82value=E6=B2=A1=E6=9C=89=E5=B8=A6=E4=B8=8A=EF=BC=8C?=
 =?UTF-8?q?=E4=BF=AE=E5=A4=8Dconfig=20PreparedValueList?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
 APIJSONORM/src/main/java/apijson/orm/AbstractSQLConfig.java &#124; 3 +++
 1 file changed, 3 insertions(+)
diff --git a/APIJSONORM/src/main/java/apijson/orm/AbstractSQLConfig.java b/APIJSONORM/src/main/java/apijson/orm/AbstractSQLConfig.java
index f362b35f2..71c367415 100755
--- a/APIJSONORM/src/main/java/apijson/orm/AbstractSQLConfig.java
+++ b/APIJSONORM/src/main/java/apijson/orm/AbstractSQLConfig.java
@@ -3756,6 +3756,9 @@ protected String concatJoinWhereString(String whereString) throws Exception {
 									+ " ( " + outerWhere + " ) "
 					)
 							+ " ) ";
+					newPvl.addAll(pvl);
+					newPvl.addAll(outerConfig.getPreparedValueList());
+
 					changed = true;
 					break;
 
From e0f7eeb2ce883d02681cb34e2a7967944814212e Mon Sep 17 00:00:00 2001
From: moxi <hufengyun@kkguan.com>
Date: Fri, 8 Aug 2025 14:31:20 +0800
Subject: [PATCH 06/26] =?UTF-8?q?fix:=20=E5=A2=9E=E5=8A=A0=20@key=20?=
 =?UTF-8?q?=E4=BD=BF=E7=94=A8=E8=AF=B4=E6=98=8E?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
 Document-English.md &#124; 2 +-
 Document.md &#124; 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)
diff --git a/Document-English.md b/Document-English.md
index 8d1fab8a4..e9a013bba 100644
--- a/Document-English.md
+++ b/Document-English.md
@@ -324,7 +324,7 @@ Response:
 Fuzzy matching &#124; `"key$":"SQL search expressions"` => `"key$":["SQL search expressions"]`<br />Any SQL search expressions.Eg.%key%(include key), key%(start with key),%k%e%y%(include k, e, y). % means any characters. &#124; ["name$":"%m%"](http://apijson.cn:8080/get/{"User[]":{"count":3,"User":{"name$":"%2525m%2525"}}}) <br />In SQL, it's <br />`name LIKE '%m%'`, <br />meaning that get User with ‘m’ in name.
 Regular Expression&#124; `"key~":"regular expression"` => `"key~":["regular expression"]`<br />It can be any regular expressions.Eg. ^[0-9]+$ ,*~ not case sensitive, advanced search is applicable.&#124; ["name~":"^[0-9]+$"](http://apijson.cn:8080/get/{"User[]":{"count":3,"User":{"name~":"^[0-9]%252B$"}}}) <br />In SQL, it's <br />`name REGEXP '^[0-9]+$'`.
 Get data in a range&#124; `"key%":"start,end"` => `"key%":["start,end"]`<br />The data type of start and end can only be either Boolean, Number or String. Eg. "2017-01-01,2019年01月01日" ,["1,90000", "82001,100000"]. It's used for getting data from a specific time range. &#124; ["date%":"2017-10-01,2018年10月01日"](http://apijson.cn:8080/get/{"User[]":{"count":3,"User":{"date%2525":"2017-10-01,2018年10月01日"}}}) <br />In SQL, it's <br />`date BETWEEN '2017-10-01' AND '2018-10-01'`, <br />meaning to get User data that registered between 2017年10月01日 and 2018年10月01日.
- Make an alias &#124; `"name:alias"`<br />this changes name to alias in returning results. It’s applicable to column, tableName, SQL Functions, etc. but only in GET, HEAD requests. &#124; ["@column":"toId:parentId"](http://apijson.cn:8080/get/{"Comment":{"@column":"id,toId:parentId","id":51}}) <br />In SQL, it's <br />`toId AS parentId`. <br />It'll return `parentId` instead of `toId`.
+ Make an alias &#124; `"name:alias"`<br />this changes name to alias in returning results. It’s applicable to column, tableName, SQL Functions, etc. but only in GET, HEAD requests. &#124; ["@column":"toId:parentId"](http://apijson.cn:8080/get/{"Comment":{"@column":"id,toId:parentId","id":51}}) <br />In SQL, it's <br />`toId AS parentId`. <br />It'll return `parentId` instead of `toId`.<br /><br />For @key format like "lc_wai6b3vk2:(lc_wai6b3vk)", it means renaming field lc_wai6b3vk2 to lc_wai6b3vk, commonly used for field renaming scenarios. Example:<br />{<br /> "lc_sinan_ba074fbb": {<br />  "lc_wai6b3vk": "11",<br />  "lc_wai6b3vk2": "22",<br />  "@combine": "lc_wai6b3vk \\&#124; lc_wai6b3vk2",<br />  "@key": "lc_wai6b3vk2:(lc_wai6b3vk)"<br /> }<br />}<br />corresponds to SQL `(lc_wai6b3vk = '11' OR lc_wai6b3vk2 = '22')`, but the lc_wai6b3vk2 field will be renamed and displayed as lc_wai6b3vk in the returned result
 Add / expand an item &#124; `"key+":Object` <br /> The type of Object is decided by *key*. Types can be Number, String, JSONArray. Froms are 82001,"apijson",["url0","url1"] respectively. It’s only applicable to PUT request.&#124; "praiseUserIdList+":[82001]. In SQL, it's <br />`json_insert(praiseUserIdList,82001)`. <br />Add an *id* that praised the Moment.
 Delete / decrease an item &#124; `"Key-":Object`<br /> It’s the contrary of "key+" &#124; "balance-":100.00. In SQL, it's <br />`balance = balance - 100.00`, <br />meaning there's 100 less in balance.
 Operations &#124; &, \&#124;, ! <br /> They're used in logic operations. It’s the same as AND, OR, NOT in SQL respectively. <br />By default, for the same key, it’s ‘\&#124;’ (OR)operation among conditions; for different keys, the default operation among conditions is ‘&’(AND). <br /> &#124; 1 ["id&{}":">80000,<=90000"](http://apijson.cn:8080/head/{"user":{"id&{}":">80000,<=90000"}}) <br />In SQL, it's <br />`id>80000 AND id<=90000`, <br />meaning *id* needs to be id>80000 & id<=90000<br /><br /> 2 ["id\&#124;{}":">90000,<=80000"](http://apijson.cn:8080/head/{"user":{"id\&#124;{}":">90000,<=80000"}}) <br />It's the same as "id{}":">90000,<=80000". <br />In SQL, it's <br />`id>80000 OR id<=90000`, <br />meaning that *id* needs to be id>90000 \&#124; id<=80000<br /><br /> 3 ["id!{}":[82001,38710]](http://apijson.cn:8080/head/{"User":{"id!{}":[82001,38710]}}) <br />In SQL, it's <br />`id NOT IN(82001,38710)`, <br />meaning id needs to be ! (id=82001 \&#124; id=38710).
diff --git a/Document.md b/Document.md
index 38adef507..e46883e0d 100644
--- a/Document.md
+++ b/Document.md
@@ -415,7 +415,7 @@ DELETE: <br> 删除数据 &#124; base_url/delete/ &#124; {<br>  TableName:{< 模糊搜索 &#124; `"key$":"SQL搜索表达式"` => `"key$":["SQL搜索表达式"]`,任意SQL搜索表达式字符串,如 %key%(包含key), key%(以key开始), %k%e%y%(包含字母k,e,y) 等,%表示任意字符 &#124; ["name$":"%m%"](http://apijson.cn:8080/get/{"User[]":{"count":3,"User":{"name$":"%2525m%2525"}}}),对应SQL是`name LIKE '%m%'`,查询name包含"m"的一个User数组
 正则匹配 &#124; "key~":"正则表达式" => "key~":["正则表达式"],任意正则表达式字符串,如 ^[0-9]+$ ,*~ 忽略大小写,可用于高级搜索 &#124; ["name~":"^[0-9]+$"](http://apijson.cn:8080/get/{"User[]":{"count":3,"User":{"name~":"^[0-9]%252B$"}}}),对应SQL是`name REGEXP '^[0-9]+$'`,查询name中字符全为数字的一个User数组
 连续范围 &#124; "key%":"start,end" => "key%":["start,end"],其中 start 和 end 都只能为 Boolean, Number, String 中的一种,如 "2017-01-01,2019年01月01日" ,["1,90000", "82001,100000"] ,可用于连续范围内的筛选 &#124; ["date%":"2017-10-01,2018年10月01日"](http://apijson.cn:8080/get/{"User[]":{"count":3,"User":{"date%2525":"2017-10-01,2018年10月01日"}}}),对应SQL是`date BETWEEN '2017-10-01' AND '2018-10-01'`,查询在2017年10月01日和2018年10月01日期间注册的用户的一个User数组
- 新建别名 &#124; "name:alias",name映射为alias,用alias替代name。可用于 column,Table,SQL函数 等。只用于GET类型、HEAD类型的请求 &#124; ["@column":"toId:parentId"](http://apijson.cn:8080/get/{"Comment":{"@column":"id,toId:parentId","id":51}}),对应SQL是`toId AS parentId`,将查询的字段toId变为parentId返回
+ 新建别名 &#124; "name:alias",name映射为alias,用alias替代name。可用于 column,Table,SQL函数 等。只用于GET类型、HEAD类型的请求 &#124; ["@column":"toId:parentId"](http://apijson.cn:8080/get/{"Comment":{"@column":"id,toId:parentId","id":51}}),对应SQL是`toId AS parentId`,将查询的字段toId变为parentId返回<br /><br />对于@key格式,如 "lc_wai6b3vk2:(lc_wai6b3vk)",表示将字段 lc_wai6b3vk2 重命名为 lc_wai6b3vk,常用于字段重命名场景。例如:<br />{<br /> "lc_sinan_ba074fbb": {<br />  "lc_wai6b3vk": "11",<br />  "lc_wai6b3vk2": "22",<br />  "@combine": "lc_wai6b3vk \\&#124; lc_wai6b3vk2",<br />  "@key": "lc_wai6b3vk2:(lc_wai6b3vk)"<br /> }<br />}<br />对应SQL是`(lc_wai6b3vk = '11' OR lc_wai6b3vk2 = '22')`,但返回结果中 lc_wai6b3vk2 字段会被重命名显示为 lc_wai6b3vk
 增加 或 扩展 &#124; "key+":Object,Object的类型由key指定,且类型为Number,String,JSONArray中的一种。如 82001,"apijson",["url0","url1"] 等。只用于PUT请求 &#124; "praiseUserIdList+":[82001],对应SQL是`json_insert(praiseUserIdList,82001)`,添加一个点赞用户id,即这个用户点了赞
 减少 或 去除 &#124; "key-":Object,与"key+"相反 &#124; "balance-":100.00,对应SQL是`balance = balance - 100.00`,余额减少100.00,即花费了100元
 比较运算 &#124;>, <,>=, <= 比较运算符,用于 <br />1 提供 "id{}":"<=90000" 这种条件范围的简化写法 <br /><br />2 实现子查询相关比较运算<br /><br />不支持 "key=":Object 和 "key!=":Object 这两种写法,直接用更简单的 "key":Object 和 "key!":Object 替代。 &#124; 1 ["id<=":90000](http://apijson.cn:8080/get/{"[]":{"user":{"id<=":90000}}}),对应sql是`id<=90000`,查询符合id<=90000的一个user数组<br /><br /> 2 ["id>@":{<br />  "from":"Comment",<br />  "Comment":{<br />    "@column":"min(userId)" <br />  }<br />}](http://apijson.cn:8080/get/{"User":{"id>@":{"from":"Comment","Comment":{"@column":"min(userId)"}}}})<br /> WHERE id>(SELECT min(userId) FROM Comment)
From 5ea9139a428022490658fa0cf607b35e22a97497 Mon Sep 17 00:00:00 2001
From: TommyLemon <tommylemon@qq.com>
Date: Sat, 9 Aug 2025 01:35:29 +0800
Subject: [PATCH 07/26] =?UTF-8?q?=E5=BC=95=E7=94=A8=E8=B5=8B=E5=80=BC?=
 =?UTF-8?q?=EF=BC=9A=E6=96=B0=E5=A2=9E=E6=94=AF=E6=8C=81=20User-id[]/2=20?=
 =?UTF-8?q?=E4=BB=8E=E6=95=B0=E7=BB=84=20User-id[]=20=E4=B8=AD=20get(2)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
 APIJSONORM/src/main/java/apijson/JSON.java &#124; 14 ++++
 .../main/java/apijson/orm/AbstractParser.java &#124; 68 +++++++------------
 2 files changed, 39 insertions(+), 43 deletions(-)
diff --git a/APIJSONORM/src/main/java/apijson/JSON.java b/APIJSONORM/src/main/java/apijson/JSON.java
index 61557985c..0a14e0420 100755
--- a/APIJSONORM/src/main/java/apijson/JSON.java
+++ b/APIJSONORM/src/main/java/apijson/JSON.java
@@ -674,4 +674,18 @@ public static String getString(Map<string, Object> map, String key) {
 		return value.toString();
 	}
 
+
+	public static Object getFromObjOrArr(Object parent, String k) {
+		if (parent instanceof Map<?, ?>) {
+			return ((Map<string, Object>) parent).get(k);
+		}
+
+		if (parent instanceof List<?>) {
+			int j = Integer.valueOf(k);
+			return ((List<?>) parent).get(j);
+		}
+
+		return null;
+	}
+
 }
diff --git a/APIJSONORM/src/main/java/apijson/orm/AbstractParser.java b/APIJSONORM/src/main/java/apijson/orm/AbstractParser.java
index 43d4c316d..cd0b2c7b8 100755
--- a/APIJSONORM/src/main/java/apijson/orm/AbstractParser.java
+++ b/APIJSONORM/src/main/java/apijson/orm/AbstractParser.java
@@ -39,7 +39,7 @@
 public abstract class AbstractParser<t, M extends Map<string, Object>, L extends List>
 		implements Parser<t, M, L> {
 	protected static final String TAG = "AbstractParser";
-	
+
 	/**
 	 * JSON 对象、数组对应的数据源、版本、角色、method等
 	 */
@@ -706,7 +706,7 @@ public M parseCorrectRequest(RequestMethod method, String tag, int version, Stri
 
 		return batchVerify(method, tag, version, name, request, maxUpdateCount, creator);
 	}
-	
+
 	/**自动根据 tag 是否为 TableKey 及是否被包含在 object 内来决定是否包装一层,改为 { tag: object, "tag": tag }
 	 * @param object
 	 * @param tag
@@ -1902,24 +1902,32 @@ else if (join != null){
 	 * @param pathKeys
 	 * @return
 	 */
-	public static <v extends Object> V getValue(Map<string, Object> parent, String[] pathKeys) {
-		if (parent == null &#124;&#124; pathKeys == null &#124;&#124; pathKeys.length <= 0) { + public static <v extends Object> V getValue(Object parent, String[] pathKeys) {
+		int len = parent == null &#124;&#124; pathKeys == null ? 0 : pathKeys.length;
+		if (len <= 0) { Log.w(TAG, "getChild parent == null &#124;&#124; pathKeys == null &#124;&#124; pathKeys.length <= 0>> return parent;");
 			return (V) parent;
 		}
 
-		//逐层到达child的直接容器JSONObject parent
-		int last = pathKeys.length - 1;
-		for (int i = 0; i < last; i++) {//一步一步到达指定位置 - if (parent == null) {//不存在或路径错误(中间的key对应value不是JSONObject) + // 逐层到达child的直接容器JSONObject parent + Object v = parent; + for (int i = 0; i < len; i++) { // 一步一步到达指定位置 + if (v == null) { // 不存在或路径错误(中间的key对应value不是JSONObject) break; } String k = getDecodedKey(pathKeys[i]); - parent = JSON.get(parent, k); + try { + v = getFromObjOrArr(v, k); + } catch (Throwable e) { + if (IS_PRINT_BIG_LOG) { + e.printStackTrace(); + } + v = null; + } } - return parent == null ? null : (V) parent.get(getDecodedKey(pathKeys[last])); + return (V) v; } @@ -2025,13 +2033,13 @@ public Object getValueByPath(String valuePath) { } //取出key被valuePath包含的result,再从里面获取key对应的value - Map<string, Object> parent = null;
+		Object parent = null;
 		String[] keys = null;
 		for (Entry<string, Object> entry : queryResultMap.entrySet()){
 			String path = entry.getKey();
 			if (valuePath.startsWith(path + "/")) {
 				try {
-					parent = (M) entry.getValue();
+					parent = entry.getValue();
 				} catch (Exception e) {
 					Log.e(TAG, "getValueByPath try { parent = (Map<string>) queryResultMap.get(path); } catch { "
 							+ "\n parent not instanceof Map<string>!");
@@ -2044,39 +2052,13 @@ public Object getValueByPath(String valuePath) {
 			}
 		}
 
-		//逐层到达targetKey的直接容器JSONObject parent
-		int last = keys == null ? -1 : keys.length - 1;
-		if (last>= 1) {
-			for (int i = 0; i < last; i++) {//一步一步到达指定位置parentPath - if (parent == null) {//不存在或路径错误(中间的key对应value不是JSONObject) - break; - } - - String k = getDecodedKey(keys[i]); - Object p = parent.get(k); - parent = p instanceof Map<?, ?> ? (Map<string, Object>) p : null;
-			}
-		}
-
-		if (parent != null) {
-			Log.i(TAG, "getValueByPath>> get from queryResultMap>> return parent.get(keys[keys.length - 1]);");
-			target = last < 0 ? parent : parent.get(getDecodedKey(keys[last])); //值为null应该报错NotExistExeption,一般都是id关联,不可为null,否则可能绕过安全机制 - if (target != null) { - Log.i(TAG, "getValueByPath>> getValue>> return target = " + target);
-				return target;
-			}
+		target = getValue(parent, keys); // 逐层到达targetKey的直接容器JSONObject parent
+		if (target == null) { //从requestObject中取值
+			target = getValue(requestObject, StringUtil.splitPath(valuePath));
 		}
 
-
-		//从requestObject中取值
-		target = getValue(requestObject, StringUtil.splitPath(valuePath));
-		if (target != null) {
-			Log.i(TAG, "getValueByPath>> getValue>> return target = " + target);
-			return target;
-		}
-
-		Log.i(TAG, "getValueByPath return null;");
-		return null;
+		Log.i(TAG, "getValueByPath>> getValue>> return target = " + target);
+		return target;
 	}
 
 	/**解码 引用赋值 路径中的 key,支持把 URL encode 后的值,转为 decode 后的原始值,例如 %2Fuser%2Flist -> /user/list ; %7B%7D -> []
From dbe28f43e4c640ca114f4a663c612adcf2e474a6 Mon Sep 17 00:00:00 2001
From: TommyLemon <tommylemon@qq.com>
Date: Sat, 9 Aug 2025 01:49:38 +0800
Subject: [PATCH 08/26] =?UTF-8?q?=E5=BC=95=E7=94=A8=E8=B5=8B=E5=80=BC?=
 =?UTF-8?q?=EF=BC=9A=E8=A7=A3=E5=86=B3=E4=BB=8E=E6=95=B0=E7=BB=84=E5=A4=96?=
 =?UTF-8?q?=E9=83=A8=E5=BC=95=E7=94=A8=E8=AF=A5=E6=95=B0=E7=BB=84=E5=86=85?=
 =?UTF-8?q?=E5=80=BC=E5=8F=AA=E8=83=BD=E6=8B=BF=E5=88=B0=E7=AC=AC=200=20?=
 =?UTF-8?q?=E4=B8=AA(=E4=B8=94=E8=B7=AF=E5=BE=84=E4=B9=9F=E4=B8=8D?=
 =?UTF-8?q?=E5=8F=8B=E5=A5=BD)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
 .../src/main/java/apijson/orm/AbstractObjectParser.java &#124; 6 ++++--
 1 file changed, 4 insertions(+), 2 deletions(-)
diff --git a/APIJSONORM/src/main/java/apijson/orm/AbstractObjectParser.java b/APIJSONORM/src/main/java/apijson/orm/AbstractObjectParser.java
index c546ae247..4d56499a0 100755
--- a/APIJSONORM/src/main/java/apijson/orm/AbstractObjectParser.java
+++ b/APIJSONORM/src/main/java/apijson/orm/AbstractObjectParser.java
@@ -1171,7 +1171,9 @@ else if (isArrayMainTable && position> 0) { // 数组主表使用专门的缓
 // APP JOIN 副表时副表返回了这个字段 rawList = (List<jsonrequest>) result.remove(AbstractSQLExecutor.KEY_RAW_LIST);
 String arrayPath = parentPath.substring(0, parentPath.lastIndexOf("[]") + 2);
 
- if (isSimpleArray == false) {
+ if (isSimpleArray) {
+					parser.putQueryResult(arrayPath, rawList); // 从数组外部引用该数组内值需要
+				} else {
 long startTime = System.currentTimeMillis();
 
 for (int i = 1; i < rawList.size(); i++) { // 从 1 开始,0 已经处理过 @@ -1196,7 +1198,7 @@ else if (isArrayMainTable && position> 0) { // 数组主表使用专门的缓
 if (isSubquery == false && result != null) {
 parser.putQueryResult(path, result); // 解决获取关联数据时requestObject里不存在需要的关联数据
 
- if (isSimpleArray && rawList != null) {
+ if (isSimpleArray) { // FIXME 改为从缓存获取,而不是 result 查
 result.put(AbstractSQLExecutor.KEY_RAW_LIST, rawList);
 }
 }
From d61ecba9663dc28905e50bb5cc6bfaf167c5fa36 Mon Sep 17 00:00:00 2001
From: TommyLemon <1184482681@qq.com>
Date: Sat, 9 Aug 2025 02:25:52 +0800
Subject: [PATCH 09/26] =?UTF-8?q?=E6=84=9F=E8=B0=A2=20moxixi527=20?=
 =?UTF-8?q?=E8=B4=A1=E7=8C=AE=20#836=20=EF=BC=9A=E6=96=B0=E5=A2=9E=20?=
 =?UTF-8?q?=E5=87=BD=E6=95=B0=E8=B0=83=E7=94=A8=E6=98=A0=E5=B0=84=20"@key"?=
 =?UTF-8?q?:=20"fun:avg(id);keyA:(keyB)"=20=E7=9A=84=E5=8A=9F=E8=83=BD?=
 =?UTF-8?q?=E7=AC=A6=E9=80=9A=E7=94=A8=E6=96=87=E6=A1=A3?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
https://github.com/Tencent/APIJSON/pull/836
---
 Document.md &#124; 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/Document.md b/Document.md
index e46883e0d..49bd86a72 100644
--- a/Document.md
+++ b/Document.md
@@ -415,7 +415,7 @@ DELETE: <br> 删除数据 &#124; base_url/delete/ &#124; {<br>  TableName:{< 模糊搜索 &#124; `"key$":"SQL搜索表达式"` => `"key$":["SQL搜索表达式"]`,任意SQL搜索表达式字符串,如 %key%(包含key), key%(以key开始), %k%e%y%(包含字母k,e,y) 等,%表示任意字符 &#124; ["name$":"%m%"](http://apijson.cn:8080/get/{"User[]":{"count":3,"User":{"name$":"%2525m%2525"}}}),对应SQL是`name LIKE '%m%'`,查询name包含"m"的一个User数组
 正则匹配 &#124; "key~":"正则表达式" => "key~":["正则表达式"],任意正则表达式字符串,如 ^[0-9]+$ ,*~ 忽略大小写,可用于高级搜索 &#124; ["name~":"^[0-9]+$"](http://apijson.cn:8080/get/{"User[]":{"count":3,"User":{"name~":"^[0-9]%252B$"}}}),对应SQL是`name REGEXP '^[0-9]+$'`,查询name中字符全为数字的一个User数组
 连续范围 &#124; "key%":"start,end" => "key%":["start,end"],其中 start 和 end 都只能为 Boolean, Number, String 中的一种,如 "2017-01-01,2019年01月01日" ,["1,90000", "82001,100000"] ,可用于连续范围内的筛选 &#124; ["date%":"2017-10-01,2018年10月01日"](http://apijson.cn:8080/get/{"User[]":{"count":3,"User":{"date%2525":"2017-10-01,2018年10月01日"}}}),对应SQL是`date BETWEEN '2017-10-01' AND '2018-10-01'`,查询在2017年10月01日和2018年10月01日期间注册的用户的一个User数组
- 新建别名 &#124; "name:alias",name映射为alias,用alias替代name。可用于 column,Table,SQL函数 等。只用于GET类型、HEAD类型的请求 &#124; ["@column":"toId:parentId"](http://apijson.cn:8080/get/{"Comment":{"@column":"id,toId:parentId","id":51}}),对应SQL是`toId AS parentId`,将查询的字段toId变为parentId返回<br /><br />对于@key格式,如 "lc_wai6b3vk2:(lc_wai6b3vk)",表示将字段 lc_wai6b3vk2 重命名为 lc_wai6b3vk,常用于字段重命名场景。例如:<br />{<br /> "lc_sinan_ba074fbb": {<br />  "lc_wai6b3vk": "11",<br />  "lc_wai6b3vk2": "22",<br />  "@combine": "lc_wai6b3vk \\&#124; lc_wai6b3vk2",<br />  "@key": "lc_wai6b3vk2:(lc_wai6b3vk)"<br /> }<br />}<br />对应SQL是`(lc_wai6b3vk = '11' OR lc_wai6b3vk2 = '22')`,但返回结果中 lc_wai6b3vk2 字段会被重命名显示为 lc_wai6b3vk
+ 新建别名 &#124; 1 "name:alias",name 映射为 alias,用 alias 替代 name。可用于 column,Table,SQL 函数 等。只用于 GET 类型、HEAD 类型的请求 <br /><br />2 函数调用映射<br />"@key": "fun:avg(id);keyA:(keyB)",<br />"fun>": 1,<br />"keyA": 1<br />其中 fun:fun(arg) 把 SQL 函数调用 fun(arg) 作为左侧表达式替代 fun,即 fun(arg)> 1;<br />keyA:(keyB) 表示将字段 keyA 重命名为 keyB,即实际 SQL 中为 keyB = 1,常用于重命名冲突的多条件同名字段。 &#124; 1 ["@column":"toId:parentId"](http://apijson.cn:8080/get/{"Comment":{"@column":"id,toId:parentId","id":51}}),对应 SQL 是 `toId AS parentId`,将查询的字段 toId 变为 parentId 返回<br /><br />2 ["@key": "len:length(content);mid:(momentId)",<br />"len<=": 10,<br />"mid": 12,<br />"momentId": 15,<br />"@combine": "(len<= \\&#124; mid) & momentId"](http://apijson.cn/api?type=JSON&json={%22Comment%22:{%22@key%22:%22len%3Alength(content)%3Bmid%3A(momentId)%22,%22len%3C=%22:10,%22mid%22:12,%22momentId%22:15,%22@combine%22:%22(len%3C%3D%20%7C%20mid)%20%26%20momentId%22}})<br />对应 SQL 是 `(length(content) <= 10 OR momentId = 12) AND momentId = 15` 增加 或 扩展 &#124; "key+":Object,Object的类型由key指定,且类型为Number,String,JSONArray中的一种。如 82001,"apijson",["url0","url1"] 等。只用于PUT请求 &#124; "praiseUserIdList+":[82001],对应SQL是`json_insert(praiseUserIdList,82001)`,添加一个点赞用户id,即这个用户点了赞 减少 或 去除 &#124; "key-":Object,与"key+"相反 &#124; "balance-":100.00,对应SQL是`balance = balance - 100.00`,余额减少100.00,即花费了100元 比较运算 &#124;>, <,>=, <= 比较运算符,用于 <br />1 提供 "id{}":"<=90000" 这种条件范围的简化写法 <br /><br />2 实现子查询相关比较运算<br /><br />不支持 "key=":Object 和 "key!=":Object 这两种写法,直接用更简单的 "key":Object 和 "key!":Object 替代。 &#124; 1 ["id<=":90000](http://apijson.cn:8080/get/{"[]":{"user":{"id<=":90000}}}),对应sql是`id<=90000`,查询符合id<=90000的一个user数组<br /><br /> 2 ["id>@":{<br />  "from":"Comment",<br />  "Comment":{<br />    "@column":"min(userId)" <br />  }<br />}](http://apijson.cn:8080/get/{"User":{"id>@":{"from":"Comment","Comment":{"@column":"min(userId)"}}}})<br /> WHERE id>(SELECT min(userId) FROM Comment)
From 5310e83d01fc423d9f23965751c9e9b2b5480aba Mon Sep 17 00:00:00 2001
From: TommyLemon <1184482681@qq.com>
Date: 2025年8月10日 02:01:37 +0800
Subject: [PATCH 10/26] Update README.md
---
 README.md &#124; 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/README.md b/README.md
index 5c2ee1558..7c9af1600 100644
--- a/README.md
+++ b/README.md
@@ -704,7 +704,7 @@ Issue/问卷 一般解答顺序:贡献者> 帮助他人的用户> 提供任
 
 [apijson-examples](https://gitee.com/drone/apijson-examples) APIJSON 的前端、业务后端、管理后端 Demo
 
-[apijson-ruoyi](https://gitee.com/yxiedd/apijson-ruoyi) APIJSON 和 RuoYi 框架整合,实现零代码生成页面模板接口,在线维护 APIJSON 数据库配置等
+[apijson-ruoyi](https://github.com/daodol/apijson-ruoyi) APIJSON 和 RuoYi 框架整合,实现零代码生成页面模板接口,在线维护 APIJSON 数据库配置等
 
 [light4j](https://github.com/xlongwei/light4j) 整合 APIJSON 和微服务框架 light-4j 的 Demo,同时接入了 Redis
 
From d9c502299b45d91f3e83007cfc24f2df195c80cb Mon Sep 17 00:00:00 2001
From: TommyLemon <1184482681@qq.com>
Date: 2025年8月10日 02:28:54 +0800
Subject: [PATCH 11/26] Update CONTRIBUTING.md
---
 CONTRIBUTING.md &#124; 10 +++++++---
 1 file changed, 7 insertions(+), 3 deletions(-)
diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
index f9656e289..cb6271544 100644
--- a/CONTRIBUTING.md
+++ b/CONTRIBUTING.md
@@ -25,7 +25,7 @@
 - [403f](https://github.com/403f)
 - [gujiachun](https://github.com/gujiachun)
 - [gdjs2](https://github.com/gdjs2)(University of California, Riverside)
-- [Rkyzzy](https://github.com/Rkyzzy)(SUSTech, University of California, Berkeley)
+- [Rkyzzy](https://github.com/Rkyzzy)(理想汽车工程师, SUSTech, University of California, Berkeley)
 - [kxlv2000](https://github.com/kxlv2000)(SUSTech)
 - [caohao-go](https://github.com/caohao-go)(腾讯工程师,曾在华为、恒生担任C/C++开发工程师,在wps担任项目经理,在360担任技术专家)
 - [Wscats](https://github.com/Wscats)(腾讯工程师、腾讯 AlloyTeam 成员、Tencent Creation Camp 成员、知名技术博主)
@@ -36,7 +36,7 @@
 - [andream7](https://github.com/andream7)(微软工程师,还开源了 apijson-db2)
 - [qiujunlin](https://github.com/qiujunlin)(字节跳动工程师,还开源了 APIJSONDemo)
 - [HANXU2018](https://github.com/HANXU2018)(网易工程师,还开源了 APIJSON-DOC)
-- [hclown9804](https://github.com/hclown9804)
+- [hclown9804](https://github.com/hclown9804)(Datawhale)
 - [chenyanlann](https://github.com/chenyanlann)(还开源了 APIJSONDemo_ClickHouse)
 - [haolingzhang1](https://github.com/haolingzhang1)(腾讯工程师,还开源了 APIJson--demo)
 - [jerrylususu](https://github.com/jerrylususu)(还开源了 apijson_todo_demo 和 apijson_role_extend)
@@ -57,7 +57,7 @@
 - [aninZz](https://github.com/aninZz)
 - [leomiaomiao](https://github.com/leomiaomiao)
 - [YqxLzx](https://github.com/YqxLzx)
-- [hiteshbedre](https://github.com/hiteshbedre)
+- [hiteshbedre](https://github.com/hiteshbedre)(privado.ai 印裔工程师)
 - [wahowaho](https://github.com/wahowaho)
 - [jarrodquan](https://github.com/jarrodquan)
 - [gemufeng](https://github.com/gemufeng)(上海麦市工程师)
@@ -71,6 +71,10 @@
 - [calmcc](https://github.com/calmcc)
 - [lindaifeng](https://github.com/lindaifeng)
 - [DenineLu](https://github.com/DenineLu)(小红书工程师)
+- [wz11wz](https://github.com/wz11wz)
+- [GeXin97](https://github.com/GeXin97)
+- [yunjiao-source](https://github.com/yunjiao-source)(还开源了 [apijson-spring-boot](https://gitee.com/yunjiao-source/apijson-spring-boot))
+- [moxixi527](https://github.com/moxixi527)(热门技术博主)
 
 #### 其中特别致谢: <br/>
 cloudAndMonkey 提交的 11 个 Commits, 对 APIJSON 做出了 1,496 增加和 845 处删减(截止 2022年12月15日 日); <br/>
From e5c62c1959ae0b8c5915c2913d3bef6d09039ebe Mon Sep 17 00:00:00 2001
From: TommyLemon <1184482681@qq.com>
Date: 2025年8月10日 02:35:34 +0800
Subject: [PATCH 12/26] Update CONTRIBUTING.md
---
 CONTRIBUTING.md &#124; 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
index cb6271544..f9fab2942 100644
--- a/CONTRIBUTING.md
+++ b/CONTRIBUTING.md
@@ -33,7 +33,7 @@
 - [JieJo](https://github.com/JieJo)
 - [yeyuezhishou](https://github.com/yeyuezhishou)(圆通工程师)
 - [kenlig](https://github.com/kenlig)(还开源了 apijsondocs)
-- [andream7](https://github.com/andream7)(微软工程师,还开源了 apijson-db2)
+- [andream7](https://github.com/andream7)(字节跳动、微软 工程师,还开源了 apijson-db2)
 - [qiujunlin](https://github.com/qiujunlin)(字节跳动工程师,还开源了 APIJSONDemo)
 - [HANXU2018](https://github.com/HANXU2018)(网易工程师,还开源了 APIJSON-DOC)
 - [hclown9804](https://github.com/hclown9804)(Datawhale)
From 31e8d9316674a4c79d5bd849afbc874c9c69ec11 Mon Sep 17 00:00:00 2001
From: TommyLemon <1184482681@qq.com>
Date: 2025年8月10日 02:38:42 +0800
Subject: [PATCH 13/26] =?UTF-8?q?=E7=94=9F=E6=80=81=E9=A1=B9=E7=9B=AE?=
 =?UTF-8?q?=E6=96=B0=E5=A2=9E=20CVAuto=20-=20=F0=9F=91=81=20=E9=9B=B6?=
 =?UTF-8?q?=E4=BB=A3=E7=A0=81=E9=9B=B6=E6=A0=87=E6=B3=A8=20CV=20AI=20?=
 =?UTF-8?q?=E8=87=AA=E5=8A=A8=E5=8C=96=E6=B5=8B=E8=AF=95=E5=B9=B3=E5=8F=B0?=
 =?UTF-8?q?=EF=BC=9Ahttps://github.com/TommyLemon/CVAuto?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
创作不易、坚持更难,右上角点亮 ⭐ Star 收藏/支持下本项目吧,谢谢 ^_^
---
 README.md &#124; 8 +++++---
 1 file changed, 5 insertions(+), 3 deletions(-)
diff --git a/README.md b/README.md
index 7c9af1600..99d0f7272 100644
--- a/README.md
+++ b/README.md
@@ -652,13 +652,15 @@ Issue/问卷 一般解答顺序:贡献者> 帮助他人的用户> 提供任
 
 [apijson-cassandra](https://github.com/APIJSON/apijson-cassandra) APIJSON 的 Cassandra NoSQL 数据库插件
 
-[APIAuto](https://github.com/TommyLemon/APIAuto) 敏捷开发最强大易用的接口工具,机器学习零代码测试、生成代码与静态检查、生成文档与光标悬浮注释
+[APIAuto](https://github.com/TommyLemon/APIAuto) ☔ 敏捷开发最强大易用的接口工具,零代码测试与 AI 问答、生成代码与静态检查、生成文档与光标悬浮注释,腾讯、SHEIN、传音 等使用
+
+[CVAuto](https://github.com/TommyLemon/CVAuto) 👁 零代码零标注 CV AI 自动化测试平台 🚀 免除大量人工画框和打标签等,直接快速测试 CV 计算机视觉 AI 图像识别算法
 
 [UnitAuto](https://github.com/TommyLemon/UnitAuto) 最先进、最省事、ROI 最高的单元测试,机器学习 零代码、全方位、自动化 测试 方法/函数,用户包含腾讯、快手、某 500 强巨头等
 
-[SQLAuto](https://github.com/TommyLemon/SQLAuto) 智能零代码自动化测试 SQL 语句执行结果的数据库工具,一键批量生成参数组合、快速构造大量测试数据
+[SQLAuto](https://github.com/TommyLemon/SQLAuto) 智能零代码自动化测试 SQL 数据库工具,任意增删改查、任意 SQL 模板变量、一键批量生成参数组合、快速构造大量测试数据
 
-[UIGO](https://github.com/TommyLemon/UIGO) 📱 零代码快准稳 UI 智能录制回放平台 🚀 自动兼容任意宽高比分辨率屏幕、自动精准等待网络请求,录制回放快、准、稳!
+[UIGO](https://github.com/TommyLemon/UIGO) 📱 零代码快准稳 UI 智能录制回放平台 🚀 3 像素内自动精准定位,2 毫秒内自动精准等待,用户包含腾讯,微信团队邀请分享
 
 [apijson-doc](https://github.com/vincentCheng/apijson-doc) APIJSON 官方文档,提供排版清晰、搜索方便的文档内容展示,包括设计规范、图文教程等
 
From a3bf644bf7fce9436464704d5f47aaa71f0dc4b2 Mon Sep 17 00:00:00 2001
From: TommyLemon <1184482681@qq.com>
Date: 2025年8月28日 00:03:03 +0800
Subject: [PATCH 14/26] =?UTF-8?q?=E6=8E=A8=E8=8D=90=E6=96=87=E7=AB=A0?=
 =?UTF-8?q?=E6=96=B0=E5=A2=9E=20springboot=E6=95=B4=E5=90=88APIJSON?=
 =?UTF-8?q?=E2=80=94=E2=80=94=E9=9B=B6=E4=BB=A3=E7=A0=81=E4=B8=87=E8=83=BD?=
 =?UTF-8?q?=E9=80=9A=E7=94=A8=20API=EF=BC=88=E9=99=84=E6=BA=90=E7=A0=81?=
 =?UTF-8?q?=EF=BC=89?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
感谢 程序员码龙 的热心贡献,点赞、收藏、转发 支持下文章作者吧 ^_^
https://blog.csdn.net/longzhutengyue/article/details/150579233
---
 README.md &#124; 2 ++
 1 file changed, 2 insertions(+)
diff --git a/README.md b/README.md
index 99d0f7272..4efda7507 100644
--- a/README.md
+++ b/README.md
@@ -629,6 +629,8 @@ Issue/问卷 一般解答顺序:贡献者> 帮助他人的用户> 提供任
 
 [APIJSON项目实战教程:零代码实现高效JSON接口开发](https://blog.csdn.net/gitblog_00682/article/details/148375065)
 
+[springboot整合APIJSON——零代码万能通用 API(附源码)](https://blog.csdn.net/longzhutengyue/article/details/150579233)
+
 ### 生态项目
 [APIJSON-Demo](https://github.com/APIJSON/APIJSON-Demo) APIJSON 各种语言、各种框架 的 使用示例项目、上手文档、测试数据 SQL 文件 等
 
From edb0e6e83962edf883f42cdadc45b2b7d91b889d Mon Sep 17 00:00:00 2001
From: TommyLemon <tommylemon@qq.com>
Date: Wed, 3 Sep 2025 00:32:27 +0800
Subject: [PATCH 15/26] =?UTF-8?q?=E9=9D=9E=E5=BC=80=E6=94=BE=E8=AF=B7?=
 =?UTF-8?q?=E6=B1=82=E4=B8=8D=E5=85=81=E8=AE=B8=E4=BC=A0=20@combine=20?=
 =?UTF-8?q?=E5=92=8C=20@key?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
 .../java/apijson/orm/AbstractVerifier.java &#124; 31 +++++++++++++------
 1 file changed, 22 insertions(+), 9 deletions(-)
diff --git a/APIJSONORM/src/main/java/apijson/orm/AbstractVerifier.java b/APIJSONORM/src/main/java/apijson/orm/AbstractVerifier.java
index b10828eea..44b2d7f1d 100755
--- a/APIJSONORM/src/main/java/apijson/orm/AbstractVerifier.java
+++ b/APIJSONORM/src/main/java/apijson/orm/AbstractVerifier.java
@@ -6,6 +6,8 @@
 package apijson.orm;
 
 import static apijson.JSON.*;
+import static apijson.JSONMap.KEY_COMBINE;
+import static apijson.JSONMap.KEY_KEY;
 import static apijson.RequestMethod.DELETE;
 import static apijson.RequestMethod.GET;
 import static apijson.RequestMethod.GETS;
@@ -219,7 +221,7 @@ public static HashMap<requestmethod, String[]> getAccessMap(MethodAccess access)
 
 	@Override
 	public String getVisitorIdKey(SQLConfig<t, M, L> config) {
-		return config.getUserIdKey();
+		return config == null ? getUserIdKey(null, null, null, null) : config.getUserIdKey();
 	}
 
 	@Override
@@ -346,21 +348,23 @@ public void verifyAllowRole(SQLConfig<t, M, L> config, String table, RequestMeth
 	 * @throws Exception
 	 * @see {@link JSONMap#KEY_ROLE}
 	 */
-	public void verifyUseRole(SQLConfig<t, M, L> config, String table, RequestMethod method, String role) throws Exception {
+	public void verifyUseRole(@NotNull SQLConfig<t, M, L> config, String table, RequestMethod method, String role) throws Exception {
 		Log.d(TAG, "verifyUseRole table = " + table + "; method = " + method + "; role = " + role);
+		Objects.requireNonNull(config);
 		//验证角色,假定真实强制匹配<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<< - String visitorIdKey = getVisitorIdKey(config); if (table == null) { - table = config == null ? null : config.getTable(); + table = config.getTable(); } if (method == null) { - method = config == null ? GET : config.getMethod(); + method = config.getMethod(); } if (role == null) { - role = config == null ? UNKNOWN : config.getRole(); + role = config.getRole(); } + String visitorIdKey = getVisitorIdKey(config); + Object requestId; switch (role) { case LOGIN://verifyRole通过就行 @@ -1087,14 +1091,23 @@ public static <t, M extends Map<string, Object>, L extends List> M parse
 
 		// 判断不允许传的key<<<<<<<<<<<<<<<<<<<<<<<<< for (String rk : rkset) { + if (rk == null) { // 无效的key + real.remove(rk); + continue; + } + if (refuseSet.contains(rk)) { // 不允许的字段 throw new IllegalArgumentException(method + "请求," + name + " 里面不允许传 " + rk + " 等" + StringUtil.get(refuseSet) + "内的任何字段!"); } - if (rk == null) { // 无效的key - real.remove(rk); - continue; + if (KEY_COMBINE.equals(rk)) { + throw new UnsupportedOperationException(method + " 请求," + rk + " 不合法!" + + "非开放请求不允许传 " + KEY_COMBINE + ":value !"); + } + if (KEY_KEY.equals(rk)) { + throw new UnsupportedOperationException(method + " 请求," + rk + " 不合法!" + + "非开放请求不允许传 " + KEY_KEY + ":value !"); } Object rv = real.get(rk); From 5139e81a8385c12d7e68bdc3c3c3ec03a5b4fc3d Mon Sep 17 00:00:00 2001 From: TommyLemon <1184482681@qq.com>
Date: Wed, 3 Sep 2025 00:36:31 +0800
Subject: [PATCH 16/26] =?UTF-8?q?=E6=96=B0=E5=A2=9E=E6=94=AF=E6=8C=81?=
 =?UTF-8?q?=E5=88=86=E5=BA=93=E5=88=86=E8=A1=A8=E4=B8=AD=E9=97=B4=E4=BB=B6?=
 =?UTF-8?q?=20ShardingSphere=20=E7=9A=84=E8=AF=B4=E6=98=8E=EF=BC=9Ahttps:/?=
 =?UTF-8?q?/github.com/Tencent/APIJSON=3Ftab=3Dreadme-ov-file#--apijson?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
 README.md &#124; 1 +
 1 file changed, 1 insertion(+)
diff --git a/README.md b/README.md
index 4efda7507..f727c773f 100644
--- a/README.md
+++ b/README.md
@@ -66,6 +66,7 @@ This source code is licensed under the Apache License Version 2.0 <br/>
 <a href="https://github.com/APIJSON/APIJSON-Demo/blob/master/APIJSON-Java-Server/APIJSONDemo/pom.xml#L48-L52"></a>
 <a href="https://github.com/APIJSON/APIJSON-Demo/blob/master/APIJSON-Java-Server/APIJSONFinal/pom.xml#L59-L68"></a>
 <a href="https://github.com/vincent109/apijson-nutz"></a>
+ <a href="https://github.com/APIJSON/APIJSON-Demo/tree/master/APIJSON-Java-Server/APIJSONDemo-ShardingSphere"></a>
 </p>
 <p>
 <a href="https://github.com/APIJSON/APIJSON-Demo/tree/master/APIJSON-Android"></a>
From 0d235f3ba41de331d8f33889c7a29a0c62753378 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=E6=97=A0=E7=A5=9EV?=
 <72117341+wu-sv@users.noreply.github.com>
Date: 2025年9月16日 09:24:12 +0800
Subject: [PATCH 17/26] =?UTF-8?q?=E4=BF=AE=E5=A4=8DgetConnectionKey?=
 =?UTF-8?q?=E6=96=B9=E6=B3=95=E8=B0=83=E7=94=A8=E5=8F=82=E6=95=B0=E5=90=8D?=
 =?UTF-8?q?=E7=A7=B0=E9=94=99=E8=AF=AF=E7=9A=84=E9=97=AE=E9=A2=98?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
https://gitee.com/Tencent/APIJSON/pulls/10
---
 APIJSONORM/src/main/java/apijson/orm/AbstractSQLExecutor.java &#124; 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)
diff --git a/APIJSONORM/src/main/java/apijson/orm/AbstractSQLExecutor.java b/APIJSONORM/src/main/java/apijson/orm/AbstractSQLExecutor.java
index 4d6d28c02..797ac3dee 100755
--- a/APIJSONORM/src/main/java/apijson/orm/AbstractSQLExecutor.java
+++ b/APIJSONORM/src/main/java/apijson/orm/AbstractSQLExecutor.java
@@ -1315,7 +1315,7 @@ public Connection getConnection(@NotNull SQLConfig<t, M, L> config) throws Excep
 	}
 
 	public String getConnectionKey(@NotNull SQLConfig<t, M, L> config) {
-		return getConnectionKey(config.getNamespace(), config.getCatalog(), config.getDatasource(), config.getDatabase());
+		return getConnectionKey(config.getDatabase(), config.getDatasource(), config.getNamespace(), config.getCatalog());
 	}
 	public String getConnectionKey(String database, String datasource, String namespace, String catalog) {
 		return database + "-" + datasource + "-" + namespace + "-" + catalog;
@@ -1541,3 +1541,4 @@ public int executeUpdate(@NotNull SQLConfig<t, M, L> config, String sql) throws
 
 
 }
+
From 0a7f858c0f6304ee2f8b0bbdf55fdf6445622910 Mon Sep 17 00:00:00 2001
From: TommyLemon <1184482681@qq.com>
Date: 2025年9月28日 23:19:10 +0800
Subject: [PATCH 18/26] =?UTF-8?q?=E5=B7=A5=E7=A8=8B=E8=BD=BB=E9=87=8F?=
 =?UTF-8?q?=E5=B0=8F=E5=B7=A7=20(=E6=97=A0=E7=AC=AC=E4=B8=89=E6=96=B9?=
 =?UTF-8?q?=E4=BE=9D=E8=B5=96=EF=BC=8CJar=20=E4=BB=85=20263KB=EF=BC=8CJava?=
 =?UTF-8?q?=20=E6=96=87=E4=BB=B6=E4=BB=85=2068=20=E4=B8=AA=E5=85=B1=201486?=
 =?UTF-8?q?4=20=E8=A1=8C=E4=BB=A3=E7=A0=81=EF=BC=8C=E4=BE=8B=E5=A6=82=20AP?=
 =?UTF-8?q?IJSONORM=208.1.0)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
https://github.com/Tencent/APIJSON?tab=readme-ov-file#%E4%B8%BA%E4%BB%80%E4%B9%88%E9%80%89%E6%8B%A9-apijson
---
 README.md &#124; 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)
diff --git a/README.md b/README.md
index f727c773f..ddd56c25c 100644
--- a/README.md
+++ b/README.md
@@ -192,7 +192,7 @@ https://github.com/Tencent/APIJSON/wiki
 * **解决十大痛点** (可帮前后端开发大幅提振开发效率、强力杜绝联调扯皮、巧妙规避文档缺陷、非常节省流量带宽)
 * **开发提速很大** (CRUD 零代码热更新全自动,APIJSONBoot 对比 SSM、SSH 等保守估计可提速 20 倍以上)
 * **腾讯官方开源** (使用 GitHub、Gitee、工蜂 等平台的官方账号开源,微信公众号、腾讯云+社区 等官方公告)
-* **社区影响力大** (GitHub 17K+ Star 在 400W Java 项目排名前 100,远超 FLAG, BAT 等国内外绝大部分开源项目)
+* **社区影响力大** (GitHub 18K+ Star 在 400W Java 项目排名前 100,远超 FLAG, BAT 等国内外绝大部分开源项目)
 * **各项荣誉成就** (腾讯内外 5 个奖项、腾讯开源前五、腾讯后端 Star 第一、Trending 日周月榜大满贯 等)
 * **多样用户案例** (腾讯内有互娱、音乐、微信、云与智慧,外部有华为、华能、百度、快手、中兴、圆通、传音等)
 * **适用场景广泛** (社交聊天、阅读资讯、影音娱乐、办公学习 等各种 App、网站、小程序、公众号 等非金融类项目)
@@ -203,7 +203,7 @@ https://github.com/Tencent/APIJSON/wiki
 * **灵活定制业务** (在后端编写 远程函数,可以拿到 session、version、当前 JSON 对象 等,然后自定义处理)
 * **高质可靠代码** (代码严谨规范,蚂蚁集团源伞 Pinpoint 代码扫描分析报告平均每行代码 Bug 率低至 0.15%)
 * **兼容各种项目** (协议不限 HTTP,与其它库无冲突,对各类 Web 框架集成友好且提供 SpringBoot, JFinal 的示例)
-* **工程轻量小巧** (仅依赖 fastjson,Jar 仅 280KB,Java 文件仅 59 个共 13719 行代码,例如 APIJSONORM 4.3.1)
+* **工程轻量小巧** (无第三方依赖,Jar 仅 263KB,Java 文件仅 68 个共 14864 行代码,例如 APIJSONORM 8.1.0)
 * **多年持续迭代** (自 2016 年起已连续维护 8 年多,70+ 贡献者、100+ 发版、3000+ 提交,不断更新迭代中...)
 
 **按照一般互联网中小型项目情况可得出以下对比表格:**
From bd6e17fdbdfd6726f59233b7474aa0604d1acc46 Mon Sep 17 00:00:00 2001
From: TommyLemon <1184482681@qq.com>
Date: Thu, 9 Oct 2025 21:18:37 +0800
Subject: [PATCH 19/26] =?UTF-8?q?=E6=96=B0=E5=A2=9E=20APIJSON=20=E7=9A=84?=
 =?UTF-8?q?=20jackson=20=E6=8F=92=E4=BB=B6=EF=BC=8C=E7=AE=80=E5=8C=96?=
 =?UTF-8?q?=E4=BD=BF=E7=94=A8=EF=BC=9Ahttps://github.com/APIJSON/apijson-j?=
 =?UTF-8?q?ackson?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
创作不易,右上角点 ⭐Star 来支持/收藏下吧,谢谢 ^_^
---
 README.md &#124; 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)
diff --git a/README.md b/README.md
index ddd56c25c..c42cdcad2 100644
--- a/README.md
+++ b/README.md
@@ -643,10 +643,12 @@ Issue/问卷 一般解答顺序:贡献者> 帮助他人的用户> 提供任
 
 [apijson-column](https://github.com/APIJSON/apijson-column) APIJSON 的字段插件,支持 字段名映射 和 !key 反选字段
 
-[apijson-gson](https://github.com/APIJSON/apijson-gson) APIJSON 的 gson 插件,简化使用
+[apijson-jackson](https://github.com/APIJSON/apijson-jackson) APIJSON 的 jackson 插件,简化使用
 
 [apijson-fastjson2](https://github.com/APIJSON/apijson-fastjson2) APIJSON 的 fastjson2 插件,简化使用
 
+[apijson-gson](https://github.com/APIJSON/apijson-gson) APIJSON 的 gson 插件,简化使用
+
 [apijson-milvus](https://github.com/APIJSON/apijson-milvus) APIJSON 的 Milvus AI 向量数据库插件
 
 [apijson-influxdb](https://github.com/APIJSON/apijson-influxdb) APIJSON 的 InfluxDB 物联网时序数据库插件
From 7b43721aa6cd1171698c2e713406769046086f42 Mon Sep 17 00:00:00 2001
From: TommyLemon <1184482681@qq.com>
Date: 2025年10月27日 11:12:35 +0800
Subject: [PATCH 20/26] =?UTF-8?q?=E7=94=9F=E6=80=81=E6=96=B0=E5=A2=9E=20AP?=
 =?UTF-8?q?IJSON=20=E7=9A=84=20Rust=20=E7=89=88=EF=BC=8C=E4=B8=80=E4=B8=AA?=
 =?UTF-8?q?=E4=BC=98=E9=9B=85=E3=80=81=E9=AB=98=E6=80=A7=E8=83=BD=E7=9A=84?=
 =?UTF-8?q?=20Rust=20=E5=A4=9A=E6=95=B0=E6=8D=AE=E6=BA=90=E7=AE=A1?=
 =?UTF-8?q?=E7=90=86=E7=B3=BB=E7=BB=9F=EF=BC=8C=E6=94=AF=E6=8C=81=20MySQL?=
 =?UTF-8?q?=20=E5=92=8C=20PostgreSQL?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
创作不易,右上角点亮 ⭐ Star 收藏/支持下吧,谢谢 ^_^
https://gitee.com/digithub/panda-base
---
 README.md &#124; 2 ++
 1 file changed, 2 insertions(+)
diff --git a/README.md b/README.md
index c42cdcad2..281462b98 100644
--- a/README.md
+++ b/README.md
@@ -689,6 +689,8 @@ Issue/问卷 一般解答顺序:贡献者> 帮助他人的用户> 提供任
 
 [uliweb-apijson](https://github.com/zhangchunlin/uliweb-apijson) Python 版 APIJSON,支持 MySQL, PostgreSQL, SQL Server, Oracle, SQLite 等
 
+[panda-base](https://gitee.com/digithub/panda-base) APIJSON 的 Rust 版,一个优雅、高性能的 Rust 多数据源管理系统,支持 MySQL 和 PostgreSQL
+
 [APIJSONParser](https://github.com/Zerounary/APIJSONParser) 第三方 APIJSON 解析器,将 JSON 动态解析成 SQL
 
 [FfApiJson](https://gitee.com/own_3_0/ff-api-json) 用 JSON 格式直接生成 SQL,借鉴 APIJSON 支持多数据源
From 115794ca212bbd62d48537d2bf2aaa557c0cb726 Mon Sep 17 00:00:00 2001
From: TommyLemon <1184482681@qq.com>
Date: 2025年11月15日 16:57:03 +0800
Subject: [PATCH 21/26] =?UTF-8?q?=E6=96=B0=E5=A2=9E=E6=94=AF=E6=8C=81=20Da?=
 =?UTF-8?q?taBend-=E5=B8=A6=20AI=20=E7=9A=84=E4=BA=91=E5=8E=9F=E7=94=9F?=
 =?UTF-8?q?=E6=95=B0=E6=8D=AE=E6=B9=96=E4=BB=93(Snowflake=20=E5=BC=80?=
 =?UTF-8?q?=E6=BA=90=E6=9B=BF=E4=BB=A3)=20=E7=9A=84=E8=AF=B4=E6=98=8E?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
https://github.com/APIJSON/APIJSON-Demo/blob/master/APIJSON-Java-Server/APIJSONBoot-MultiDataSource
---
 README.md &#124; 1 +
 1 file changed, 1 insertion(+)
diff --git a/README.md b/README.md
index 281462b98..e3793602b 100644
--- a/README.md
+++ b/README.md
@@ -50,6 +50,7 @@ This source code is licensed under the Apache License Version 2.0 <br/>
 <a href="https://github.com/APIJSON/APIJSON-Demo/tree/master/TDengine"></a>
 <a href="https://github.com/APIJSON/APIJSON-Demo/tree/master/PostgreSQL"></a>
 
+ <a href="https://github.com/APIJSON/APIJSON-Demo/tree/master/APIJSON-Java-Server/APIJSONBoot-MultiDataSource"></a>
 </p>
 <p>
 <a href="https://github.com/APIJSON/APIJSON-Demo/tree/master/APIJSON-Java-Server"></a>
From af347bca178da94f6605244be98790ab966a9ea3 Mon Sep 17 00:00:00 2001
From: TommyLemon <1184482681@qq.com>
Date: 2025年11月29日 19:15:47 +0800
Subject: [PATCH 22/26] =?UTF-8?q?=E7=99=BB=E8=AE=B0=E6=96=87=E7=AB=A0=20[A?=
 =?UTF-8?q?PIJSON=EF=BC=9A=E9=87=8D=E6=96=B0=E5=AE=9A=E4=B9=89=E5=90=8E?=
 =?UTF-8?q?=E7=AB=AF=E5=BC=80=E5=8F=91=E4=BD=93=E9=AA=8C=E7=9A=84=E9=9B=B6?=
 =?UTF-8?q?=E4=BB=A3=E7=A0=81ORM=E6=A1=86=E6=9E=B6](https://blog.csdn.net/?=
 =?UTF-8?q?gitblog=5F01177/article/details/155216163)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
感谢文章作者的贡献,大家 点赞、收藏、转发 支持热心的 TA 吧〜
---
 README.md &#124; 2 ++
 1 file changed, 2 insertions(+)
diff --git a/README.md b/README.md
index e3793602b..caadbc9fc 100644
--- a/README.md
+++ b/README.md
@@ -633,6 +633,8 @@ Issue/问卷 一般解答顺序:贡献者> 帮助他人的用户> 提供任
 
 [springboot整合APIJSON——零代码万能通用 API(附源码)](https://blog.csdn.net/longzhutengyue/article/details/150579233)
 
+[APIJSON:重新定义后端开发体验的零代码ORM框架](https://blog.csdn.net/gitblog_01177/article/details/155216163)
+
 ### 生态项目
 [APIJSON-Demo](https://github.com/APIJSON/APIJSON-Demo) APIJSON 各种语言、各种框架 的 使用示例项目、上手文档、测试数据 SQL 文件 等
 
From 78c77a4f3e47e44a50aeb10ea88312562f586473 Mon Sep 17 00:00:00 2001
From: TommyLemon <1184482681@qq.com>
Date: Sun, 7 Dec 2025 19:54:39 +0800
Subject: [PATCH 23/26] =?UTF-8?q?=E5=8D=87=E7=BA=A7=E7=89=88=E6=9C=AC?=
 =?UTF-8?q?=E4=B8=BA=208.1.0?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
 APIJSONORM/pom.xml &#124; 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/APIJSONORM/pom.xml b/APIJSONORM/pom.xml
index bd340fa5f..13c5d0bfd 100644
--- a/APIJSONORM/pom.xml
+++ b/APIJSONORM/pom.xml
@@ -5,7 +5,7 @@
 
 	<groupid>com.github.Tencent</groupid>
 	<artifactid>APIJSON</artifactid>
-	<version>8.0.2</version>
+	<version>8.1.0</version>
 	<packaging>jar</packaging>
 
 	<name>APIJSONORM</name>
From 200be8ffb6e714e8526a9b85b7ef1a3309f7a958 Mon Sep 17 00:00:00 2001
From: TommyLemon <1184482681@qq.com>
Date: 2025年12月20日 23:21:19 +0800
Subject: [PATCH 24/26] =?UTF-8?q?=E6=96=B0=E5=A2=9E=E6=96=87=E7=AB=A0=20AP?=
 =?UTF-8?q?I=E8=87=AA=E5=8A=A8=E7=94=9F=E6=88=90=E8=BF=99=E4=B9=88?=
 =?UTF-8?q?=E7=88=BD=EF=BC=9F=E5=AE=9E=E6=B5=8B=E8=85=BE=E8=AE=AFAPIJSON?=
 =?UTF-8?q?=EF=BC=8C=E9=9B=B6=E4=BB=A3=E7=A0=81=E5=B0=B1=E8=83=BD=E7=8E=A9?=
 =?UTF-8?q?=E8=BD=AC=E5=90=8E=E7=AB=AF=E6=8E=A5=E5=8F=A3=EF=BC=81?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
感谢 诗远治愈馆 的贡献,点赞、收藏、转发支持下热心的文章作者吧 ^_^
https://mp.weixin.qq.com/s/DmMIGHHcZ783KobGecMxGg
---
 README.md &#124; 2 ++
 1 file changed, 2 insertions(+)
diff --git a/README.md b/README.md
index caadbc9fc..db0f10449 100644
--- a/README.md
+++ b/README.md
@@ -635,6 +635,8 @@ Issue/问卷 一般解答顺序:贡献者> 帮助他人的用户> 提供任
 
 [APIJSON:重新定义后端开发体验的零代码ORM框架](https://blog.csdn.net/gitblog_01177/article/details/155216163)
 
+[API自动生成这么爽?实测腾讯APIJSON,零代码就能玩转后端接口!](https://mp.weixin.qq.com/s/DmMIGHHcZ783KobGecMxGg)
+
 ### 生态项目
 [APIJSON-Demo](https://github.com/APIJSON/APIJSON-Demo) APIJSON 各种语言、各种框架 的 使用示例项目、上手文档、测试数据 SQL 文件 等
 
From 54f7da08899ff4933fc3c8bf32e2aec9c0469550 Mon Sep 17 00:00:00 2001
From: TommyLemon <tommylemon@qq.com>
Date: Fri, 2 Jan 2026 22:27:26 +0800
Subject: [PATCH 25/26] =?UTF-8?q?=E6=96=B0=E5=A2=9E=E5=85=B3=E9=94=AE?=
 =?UTF-8?q?=E8=AF=8D=20@string=20=E6=8A=8A=E5=AD=97=E6=AE=B5=E8=BD=AC?=
 =?UTF-8?q?=E4=B8=BA=20String=20=E8=BE=93=E5=85=A5=EF=BC=9BKEY=5FDEFULT=20?=
 =?UTF-8?q?=E9=87=8D=E5=91=BD=E5=90=8D=E4=B8=BA=20KEY=5FDEFAULT=EF=BC=9B?=
 =?UTF-8?q?=E5=8D=87=E7=BA=A7=E7=89=88=E6=9C=AC=E4=B8=BA=208.1.3?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
 APIJSONORM/pom.xml &#124; 2 +-
 APIJSONORM/src/main/java/apijson/JSONMap.java &#124; 89 ++++++++++++-------
 .../src/main/java/apijson/JSONResponse.java &#124; 2 +-
 APIJSONORM/src/main/java/apijson/Log.java &#124; 2 +-
 .../apijson/orm/AbstractObjectParser.java &#124; 20 ++++-
 .../java/apijson/orm/AbstractVerifier.java &#124; 41 +++++----
 6 files changed, 100 insertions(+), 56 deletions(-)
diff --git a/APIJSONORM/pom.xml b/APIJSONORM/pom.xml
index 13c5d0bfd..8b36d0da4 100644
--- a/APIJSONORM/pom.xml
+++ b/APIJSONORM/pom.xml
@@ -5,7 +5,7 @@
 
 	<groupid>com.github.Tencent</groupid>
 	<artifactid>APIJSON</artifactid>
-	<version>8.1.0</version>
+	<version>8.1.3</version>
 	<packaging>jar</packaging>
 
 	<name>APIJSONORM</name>
diff --git a/APIJSONORM/src/main/java/apijson/JSONMap.java b/APIJSONORM/src/main/java/apijson/JSONMap.java
index 29d88f756..3b93d69d2 100755
--- a/APIJSONORM/src/main/java/apijson/JSONMap.java
+++ b/APIJSONORM/src/main/java/apijson/JSONMap.java
@@ -109,19 +109,32 @@ public static boolean isTableArray(String key) {
 	public static String KEY_USER_ID = "userId";
 	public static String KEY_USER_ID_IN = KEY_USER_ID + "{}";
 
+	default String getIdKey() {
+		return KEY_ID;
+	}
+	default String getIdInKey() {
+		return KEY_ID_IN;
+	}
+	default String getUserIdKey() {
+		return KEY_USER_ID;
+	}
+	default String getUserIdInKey() {
+		return KEY_USER_ID_IN;
+	}
+
 	/**set "id":id in Table layer
 	 * @param id
 	 * @return
 	 */
 	default JSONMap<m, L> setId(Long id) {
-		return puts(KEY_ID, id);
+		return puts(getIdKey(), id);
 	}
 	/**set "id{}":[] in Table layer
 	 * @param list
 	 * @return
 	 */
 	default JSONMap<m, L> setIdIn(List list) {
-		return puts(KEY_ID_IN, list);
+		return puts(getIdInKey(), list);
 	}
 
 	/**set "userId":userId in Table layer
@@ -129,14 +142,14 @@ default JSONMap<m, L> setIdIn(List list) {
 	 * @return
 	 */
 	default JSONMap<m, L> setUserId(Long id) {
-		return puts(KEY_USER_ID, id);
+		return puts(getUserIdKey(), id);
 	}
 	/**set "userId{}":[] in Table layer
 	 * @param list
 	 * @return
 	 */
 	default JSONMap<m, L> setUserIdIn(List list) {
-		return puts(KEY_USER_ID_IN, list);
+		return puts(getUserIdInKey(), list);
 	}
 
 
@@ -150,36 +163,37 @@ default JSONMap<m, L> setUserIdIn(List list) {
 
 
 	//@key关键字都放这个类 <<<<<<<<<<<<<<<<<<<<<< - String KEY_TRY = "@try"; //尝试,忽略异常 - String KEY_CATCH = "@catch"; //TODO 捕捉到异常后,处理方式 null-不处理;DEFAULT-返回默认值;ORIGIN-返回请求里的原始值 - String KEY_DROP = "@drop"; //丢弃,不返回,TODO 应该通过 fastjson 的 ignore 之类的机制来处理,避免导致下面的对象也不返回 - // String KEY_KEEP = "@keep"; //一定会返回,为 null 或 空对象时,会使用默认值(非空),解决其它对象因为不关联的第一个对为空导致也不返回 - String KEY_DEFULT = "@default"; //TODO 自定义默认值 { "@default":true },@default 可完全替代 @keep - String KEY_NULL = "@null"; //值为 null 的键值对 "@null":"tag,pictureList",允许 is NULL 条件判断, SET tag = NULL 修改值为 NULL 等 - String KEY_CAST = "@cast"; //类型转换 cast(date AS DATE) - - String KEY_ROLE = "@role"; //角色,拥有对某些数据的某些操作的权限 - String KEY_DATABASE = "@database"; //数据库类型,默认为MySQL - String KEY_DATASOURCE = "@datasource"; //数据源 - String KEY_NAMESPACE = "@namespace"; //命名空间,Table 在非默认 namespace 内时需要声明 - String KEY_CATALOG = "@catalog"; //目录,Table 在非默认 catalog 内时需要声明 - String KEY_SCHEMA = "@schema"; //数据库,Table 在非默认 schema 内时需要声明 - String KEY_EXPLAIN = "@explain"; //分析 true/false - String KEY_CACHE = "@cache"; //缓存 RAM/ROM/ALL - String KEY_COLUMN = "@column"; //查询的Table字段或SQL函数 - String KEY_FROM = "@from"; //FROM语句 - String KEY_COMBINE = "@combine"; //条件组合,每个条件key前面可以放&,&#124;,!逻辑关系 "id!{},&sex,!name&$" - String KEY_GROUP = "@group"; //分组方式 - String KEY_HAVING = "@having"; //聚合函数条件,一般和@group一起用 - String KEY_HAVING_AND = "@having&"; //聚合函数条件,一般和@group一起用 - String KEY_SAMPLE = "@sample"; //取样方式 - String KEY_LATEST = "@latest"; //最近方式 - String KEY_PARTITION = "@partition"; //分区方式 - String KEY_FILL = "@fill"; //填充方式 - String KEY_ORDER = "@order"; //排序方式 + String KEY_TRY = "@try"; // 尝试,忽略异常 + String KEY_CATCH = "@catch"; // TODO 捕捉到异常后,处理方式 null-不处理;DEFAULT-返回默认值;ORIGIN-返回请求里的原始值 + String KEY_DROP = "@drop"; // 丢弃,不返回,TODO 应该通过 fastjson 的 ignore 之类的机制来处理,避免导致下面的对象也不返回 + // String KEY_KEEP = "@keep"; // 一定会返回,为 null 或 空对象时,会使用默认值(非空),解决其它对象因为不关联的第一个对为空导致也不返回 + String KEY_DEFAULT = "@default"; // TODO 自定义默认值 { "@default":true },@default 可完全替代 @keep + String KEY_NULL = "@null"; // 值为 null 的键值对 "@null":"tag,pictureList",允许 is NULL 条件判断, SET tag = NULL 修改值为 NULL 等 + String KEY_CAST = "@cast"; // 类型转换 cast(date AS DATE) + + String KEY_ROLE = "@role"; // 角色,拥有对某些数据的某些操作的权限 + String KEY_DATABASE = "@database"; // 数据库类型,默认为MySQL + String KEY_DATASOURCE = "@datasource"; // 数据源 + String KEY_NAMESPACE = "@namespace"; // 命名空间,Table 在非默认 namespace 内时需要声明 + String KEY_CATALOG = "@catalog"; // 目录,Table 在非默认 catalog 内时需要声明 + String KEY_SCHEMA = "@schema"; // 数据库,Table 在非默认 schema 内时需要声明 + String KEY_EXPLAIN = "@explain"; // 分析 true/false + String KEY_CACHE = "@cache"; // 缓存 RAM/ROM/ALL + String KEY_COLUMN = "@column"; // 查询的 Table 字段或 SQL 函数 + String KEY_FROM = "@from"; // FROM语句 + String KEY_COMBINE = "@combine"; // 条件组合,每个条件 key 前面可以放 &,&#124;,! 逻辑关系 "id!{},&sex,!name&$" + String KEY_GROUP = "@group"; // 分组方式 + String KEY_HAVING = "@having"; // 聚合函数条件,一般和 @group 一起用 + String KEY_HAVING_AND = "@having&"; // 聚合函数条件,一般和 @group 一起用 + String KEY_SAMPLE = "@sample"; // 取样方式 + String KEY_LATEST = "@latest"; // 最近方式 + String KEY_PARTITION = "@partition"; // 分区方式 + String KEY_FILL = "@fill"; // 填充方式 + String KEY_ORDER = "@order"; // 排序方式 String KEY_KEY = "@key"; // key 映射,year:left(date,4);name_tag:(name,tag) String KEY_RAW = "@raw"; // 自定义原始 SQL 片段 - String KEY_JSON = "@json"; //SQL Server 把字段转为 JSON 输出 + String KEY_JSON = "@json"; // 把字段转为 JSON 输出 + String KEY_STRING = "@string"; // 把字段转为 String 输入 String KEY_METHOD = "@method"; // json 对象配置操作方法 String KEY_GET = "@get"; // json 对象配置操作方法 String KEY_GETS = "@gets"; // json 对象配置操作方法 @@ -214,6 +228,7 @@ default JSONMap<m, L> setUserIdIn(List list) {
 			KEY_KEY,
 			KEY_RAW,
 			KEY_JSON,
+			KEY_STRING,
 			KEY_METHOD,
 			KEY_GET,
 			KEY_GETS,
@@ -255,7 +270,7 @@ default JSONMap<m, L> setDrop(Boolean drop) {
 	 * @return this
 	 */
 	default JSONMap<m, L> setDefault(Boolean hasDefault) {
-		return puts(KEY_DEFULT, hasDefault);
+		return puts(KEY_DEFAULT, hasDefault);
 	}
 
 
@@ -525,6 +540,14 @@ default JSONMap<m, L> setJson(String keys) {
 		return puts(KEY_JSON, keys);
 	}
 
+	/**set keys to cast to string
+	 * @param keys "key0,key1,key2..."
+	 * @return
+	 */
+	default JSONMap<m, L> setString(String keys) {
+		return puts(KEY_STRING, keys);
+	}
+
 	//JSONObject内关键词 key>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>
 
 
diff --git a/APIJSONORM/src/main/java/apijson/JSONResponse.java b/APIJSONORM/src/main/java/apijson/JSONResponse.java
index c39aa1ace..7527adffb 100755
--- a/APIJSONORM/src/main/java/apijson/JSONResponse.java
+++ b/APIJSONORM/src/main/java/apijson/JSONResponse.java
@@ -119,7 +119,7 @@ public static String getMsg(Map<string, Object> response) {
 	 */
 	default long getId() {
 		try {
-			return JSON.getLongValue(this, KEY_ID);
+			return JSON.getLongValue(this, getIdKey());
 		} catch (Exception e) {
 			//empty
 		}
diff --git a/APIJSONORM/src/main/java/apijson/Log.java b/APIJSONORM/src/main/java/apijson/Log.java
index ba1a03bd5..9cbacd0ac 100755
--- a/APIJSONORM/src/main/java/apijson/Log.java
+++ b/APIJSONORM/src/main/java/apijson/Log.java
@@ -14,7 +14,7 @@ public class Log {
 
 	public static boolean DEBUG = true;
 
-	public static final String VERSION = "8.0.2";
+	public static final String VERSION = "8.1.3";
 	public static final String KEY_SYSTEM_INFO_DIVIDER = "\n---&#124;-----APIJSON SYSTEM INFO-----&#124;---\n";
 
 	public static final String OS_NAME;
diff --git a/APIJSONORM/src/main/java/apijson/orm/AbstractObjectParser.java b/APIJSONORM/src/main/java/apijson/orm/AbstractObjectParser.java
index 4d56499a0..0e6aaa784 100755
--- a/APIJSONORM/src/main/java/apijson/orm/AbstractObjectParser.java
+++ b/APIJSONORM/src/main/java/apijson/orm/AbstractObjectParser.java
@@ -61,6 +61,7 @@ public AbstractObjectParser<t, M, L> setParser(Parser<t, M, L> parser) {
 	 * TODO Parser内要不因为 非 TYPE_ITEM_CHILD_0 的Table 为空导致后续中断。
 	 */
 	protected final boolean drop;
+	private List<string> stringKeyList;
 
 	/**for single object
 	 */
@@ -103,7 +104,12 @@ public AbstractObjectParser(@NotNull M request, String parentPath, SQLConfig<t, String raw = getString(request, JSONMap.KEY_RAW); String[] rks = StringUtil.split(raw); rawKeyList = rks == null &#124;&#124; rks.length <= 0 ? null : Arrays.asList(rks); - } + + String str = getString(request, KEY_STRING); + String[] sks = StringUtil.split(str); + stringKeyList = sks == null &#124;&#124; sks.length <= 0 ? null : Arrays.asList(sks); + request.remove(KEY_STRING); + } } @Override @@ -280,7 +286,13 @@ public AbstractObjectParser<t, M, L> parse(String name, boolean isReuse) throws
 // hasOtherKeyNotFun = true;
 // }
 
-							if (startsWithAt &#124;&#124; key.endsWith("@") &#124;&#124; (key.endsWith("<strong>") && value instanceof Map<?, ?>)) {
+							if (stringKeyList != null && stringKeyList.contains(key)) {
+								// 统一格式 String val = value == null &#124;&#124; value instanceof String ? (String) value : JSON.toJSONString(value);
+								if (onParse(key, JSON.toJSONString(value)) == false) {
+									invalidate();
+								}
+							}
+							else if (startsWithAt &#124;&#124; key.endsWith("@") &#124;&#124; (key.endsWith("<strong>") && value instanceof Map<?, ?>)) {
 								if (onParse(key, value) == false) {
 									invalidate();
 								}
@@ -1227,7 +1239,9 @@ public void recycle() {
 		if (drop) {
 			request.put(KEY_DROP, drop);
 		}
-
+		if (stringKeyList != null) { // 避免被全局关键词覆盖 && ! stringKeyList.isEmpty()) {
+			request.put(KEY_STRING, StringUtil.get(stringKeyList.toArray()));
+		}
 
 		method = null;
 		parentPath = null;
diff --git a/APIJSONORM/src/main/java/apijson/orm/AbstractVerifier.java b/APIJSONORM/src/main/java/apijson/orm/AbstractVerifier.java
index 44b2d7f1d..55eeff408 100755
--- a/APIJSONORM/src/main/java/apijson/orm/AbstractVerifier.java
+++ b/APIJSONORM/src/main/java/apijson/orm/AbstractVerifier.java
@@ -6,8 +6,7 @@
 package apijson.orm;
 
 import static apijson.JSON.*;
-import static apijson.JSONMap.KEY_COMBINE;
-import static apijson.JSONMap.KEY_KEY;
+import static apijson.JSONMap.*;
 import static apijson.RequestMethod.DELETE;
 import static apijson.RequestMethod.GET;
 import static apijson.RequestMethod.GETS;
@@ -923,6 +922,16 @@ public static <t, M extends Map<string, Object>, L extends List> M parse
 			return null;
 		}
 
+		Object _if = target.get(IF.name());
+		boolean ifIsStr = _if instanceof String && StringUtil.isNotEmpty(_if, true);
+		M ifObj = ifIsStr == false && _if instanceof Map<?,?> ? (M) _if : null;
+//				: (_if instanceof String ? new apijson.JSONMap((String) _if, "" /* "throw new Error('')" */ ) : null);
+		if (ifObj == null && _if != null && ifIsStr == false) {
+//			if (_if instanceof List<?>) {
+//			}
+			throw new IllegalArgumentException(name + ": { " + IF.name() + ": value } 中 value 类型错误!只允许 String, JSONRequest!");
+		}
+
 		// 获取配置<<<<<<<<<<<<<<<<<<<<<<<<<<<< M type = JSON.get(target, TYPE.name()); M verify = JSON.get(target, VERIFY.name()); @@ -936,21 +945,8 @@ public static <t, M extends Map<string, Object>, L extends List> M parse
 		String must = StringUtil.get(getString(target, MUST.name()));
 		String refuse = StringUtil.get(getString(target, REFUSE.name()));
 
-		Object _if = target.get(IF.name());
-		boolean ifIsStr = _if instanceof String && StringUtil.isNotEmpty(_if, true);
-		M ifObj = ifIsStr == false && _if instanceof Map<?,?> ? (M) _if : null;
-//				: (_if instanceof String ? new apijson.JSONMap((String) _if, "" /* "throw new Error('')" */ ) : null);
-		if (ifObj == null && _if != null && ifIsStr == false) {
-//			if (_if instanceof List<?>) {
-//			}
-			throw new IllegalArgumentException(name + ": { " + IF.name() + ": value } 中 value 类型错误!只允许 String, JSONRequest!");
-		}
-
 //		Object code = target.get(CODE.name());
 
-		String allowPartialUpdateFail = StringUtil.get(getString(target, ALLOW_PARTIAL_UPDATE_FAIL.name()));
-
-
 		// 移除字段<<<<<<<<<<<<<<<<<<< String[] removes = StringUtil.split(remove); if (removes != null && removes.length> 0) {
@@ -976,6 +972,8 @@ public static <t, M extends Map<string, Object>, L extends List> M parse
 		}
 		// 判断必要字段是否都有>>>>>>>>>>>>>>>>>>>
 
+		String[] sks = StringUtil.split(getString(real, KEY_STRING));
+		List<string> stringKeyList = sks == null &#124;&#124; sks.length <= 0 ? null : Arrays.asList(sks); Set<string> objKeySet = new HashSet<string>(); // 不能用tableKeySet,仅判断 Table:{} 会导致 key:{ Table:{} } 绕过判断
 
@@ -991,6 +989,10 @@ public static <t, M extends Map<string, Object>, L extends List> M parse
 				}
 Object tvalue = entry.getValue();
 Object rvalue = real.get(key);
+				if (rvalue != null && stringKeyList != null && stringKeyList.contains(key)) {
+					rvalue = JSON.toJSONString(rvalue);
+				}
+
 				if (callback.onParse(key, tvalue, rvalue) == false) {
 					continue;
 				}
@@ -1091,8 +1093,8 @@ public static <t, M extends Map<string, Object>, L extends List> M parse
 
 		// 判断不允许传的key<<<<<<<<<<<<<<<<<<<<<<<<< for (String rk : rkset) { - if (rk == null) { // 无效的key - real.remove(rk); + if (rk == null &#124;&#124; KEY_STRING.equals(rk)) { + // ConcurrentModificationException real.remove(rk); continue; } @@ -1111,6 +1113,9 @@ public static <t, M extends Map<string, Object>, L extends List> M parse
 			}
 
 			Object rv = real.get(rk);
+			if (rv != null && stringKeyList != null && stringKeyList.contains(rk)) {
+				rv = JSON.toJSONString(rv);
+			}
 
 			// 不允许传远程函数,只能后端配置
 			if (rk.endsWith("()") && rv instanceof String) {
@@ -1192,6 +1197,7 @@ public static <t, M extends Map<string, Object>, L extends List> M parse
 		// 校验重复>>>>>>>>>>>>>>>>>>>
 
 		// 校验并配置允许批量增删改部分失败<<<<<<<<<<<<<<<<<<< + String allowPartialUpdateFail = StringUtil.get(getString(target, ALLOW_PARTIAL_UPDATE_FAIL.name())); String[] partialFails = StringUtil.split(allowPartialUpdateFail); if (partialFails != null && partialFails.length> 0) {
 			for (String key : partialFails) {
@@ -1300,6 +1306,7 @@ public static <t, M extends Map<string, Object>, L extends List> M parse
 				}
 			}
 		}
+
 		Log.i(TAG, "parse return real = " + JSON.toJSONString(real));
 		return real;
 	}
From abcf2974ade386599670180d44931194bf8a7deb Mon Sep 17 00:00:00 2001
From: TommyLemon <1184482681@qq.com>
Date: Fri, 2 Jan 2026 22:57:49 +0800
Subject: [PATCH 26/26] =?UTF-8?q?=E6=96=B0=E5=A2=9E=20Rust=20=E7=89=88=20A?=
 =?UTF-8?q?PIJSON=20-=20=E4=B8=80=E4=B8=AA=E4=BC=98=E9=9B=85=E3=80=81?=
 =?UTF-8?q?=E9=AB=98=E6=80=A7=E8=83=BD=E7=9A=84=E5=A4=9A=E6=95=B0=E6=8D=AE?=
 =?UTF-8?q?=E6=BA=90=E7=AE=A1=E7=90=86=E7=B3=BB=E7=BB=9F=EF=BC=8C=E6=94=AF?=
 =?UTF-8?q?=E6=8C=81=20MySQL,=20PostgreSQL=20=E7=9A=84=E7=BB=9F=E4=B8=80?=
 =?UTF-8?q?=E7=AE=A1=E7=90=86=E5=92=8C=E6=93=8D=E4=BD=9C?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
创作不易,右上角点亮 ⭐️ Star 支持下热心的作者吧 ^_^
---
 README.md &#124; 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)
diff --git a/README.md b/README.md
index db0f10449..46d3ecda3 100644
--- a/README.md
+++ b/README.md
@@ -60,6 +60,7 @@ This source code is licensed under the Apache License Version 2.0 <br/>
 <a href="https://github.com/kvnZero/hyperf-APIJSON"></a>
 <a href="https://github.com/kevinaskin/apijson-node"></a>
 <a href="https://github.com/zhangchunlin/uliweb-apijson"></a>
+ <a href="https://gitee.com/APIJSON/panda-base"></a>
 <a href="https://github.com/APIJSON/APIJSON-Demo/tree/master/APIJSON-Java-Server/APIJSONDemo-Script"></a>
 </p>
 <p>
@@ -694,7 +695,7 @@ Issue/问卷 一般解答顺序:贡献者> 帮助他人的用户> 提供任
 
 [uliweb-apijson](https://github.com/zhangchunlin/uliweb-apijson) Python 版 APIJSON,支持 MySQL, PostgreSQL, SQL Server, Oracle, SQLite 等
 
-[panda-base](https://gitee.com/digithub/panda-base) APIJSON 的 Rust 版,一个优雅、高性能的 Rust 多数据源管理系统,支持 MySQL 和 PostgreSQL
+[apijson-rust](https://gitee.com/APIJSON/panda-base) APIJSON 的 Rust 版,一个优雅、高性能的 Rust 多数据源管理系统,支持 MySQL 和 PostgreSQL
 
 [APIJSONParser](https://github.com/Zerounary/APIJSONParser) 第三方 APIJSON 解析器,将 JSON 动态解析成 SQL
 
</div><div class="naked_ctrl">
<form action="/index.cgi/contrast" method="get" name="gate">
<p><a href="http://altstyle.alfasado.net">AltStyle</a> によって変換されたページ <a href="https://GITHUB.COM/GeXin97/APIJSON/compare/master...Tencent:APIJSON:master.patch">(-&gt;オリジナル)</a>
/ <label>アドレス: <input type="text" name="naked_post_url" value="https://GITHUB.COM/GeXin97/APIJSON/compare/master...Tencent:APIJSON:master.patch" size="22" /></label> <label>モード: <select name="naked_post_mode">
<option value="default">デフォルト</option>
<option value="speech">音声ブラウザ</option>
<option value="ruby">ルビ付き</option>
<option value="contrast" selected="selected">配色反転</option>
<option value="larger-text">文字拡大</option>
<option value="mobile">モバイル</option>
</select>
<input type="submit" value="表示" />
</p>
</form>
</div>