Releases · Tencent/APIJSON

14 Jun 17:15

4.7.0

db79168

新增数据源关键词 @Datasource，可由业务完全自定义，感谢腾讯同事 fineday009 #251 ；
去除 JSONResponse 中 KEY_CODE 等常量的 final 关键字，方便业务重新定义 ok、code、msg 字段名，感谢 gujiachun #227 ；

解决 > RIGHT JOIN, ^ SIDE JOIN, ! ANTI JOIN, ) FOREIGN JOIN 等不返回副表数据；
解决 | FULL JOIN 返回的副表数据部分是错的；
分页：解决 query=2 不兼容主表 @column:"fun()" 这种包含 SQL 函数的写法；
SQL 函数：获取右括号 ) 的位置从 indexOf 改为 lastIndexOf，解决多个右括号解析问题；
解决 JOIN 副表有引用赋值外的条件时因为缓存 SQL WHERE 中条件顺序不一致导致多余查询；
解决查询计划 @Explain 不支持增删改方法；在分页详情 info 内返回查询计划 @Explain；
更新为最新的手机号正则表达式匹配，感谢 Rkyzzy #241 ；

log print current time, thanks to Tencent colleague jun0315 #250 ；
优化 system.err.printlin 输出，感谢 kxlv2000 #238 ；
对 JSONResponse.java中的 formatHyphen 方法的优化，感谢 403f #217 ；
使用 entrySet 迭代器替代 keySet 迭代器提高效率，感谢 Rkyzzy #224 ；
Using Arrays.toString() to deal with methods array, thanks to gdjs2 #221 ；
将 StringUtil.java 类中三处字符串直接拼接优化为使用 StringBuilder 拼接，感谢 Rkyzzy #222 ；
Format the code & Replace the Long(String) by Long.valueOf(String), thanks to gdjs2 #225 ；

Update README-English.md, thanks to Tencent colleague Wscats #235 ；
修改 Document 文档 OUTER JOIN 拼写错误，感谢腾讯同事 caohao-php #233 ；

Assets 3

06 Apr 17:35

TommyLemon

4.6.7

8cf170c

优化状态信息和日志打印

AbstractSQLExecutor 优化增删改未成功也未抛异常的 code 和 msg；
AbstractParser 优化请求及响应的日志打印；
AbstractSQLConfig 优化 key$ 的格式校验；
错误码只在最外层返回，逻辑统一，感谢腾讯 CSIG 的同事 fineday009 贡献代码 [#202]；

文档：

生态项目新增 APIJSON 的字段插件，支持字段名映射和 !key 反选字段；
贡献者列表新增腾讯后台工程师 fineday009；

Assets 3

05 Apr 12:10

TommyLemon

4.6.6

8a6672b

SQL 函数白名单新增 length；key$ 模糊搜索不允许连续的 %

SQL 函数白名单新增 length；
key$ 模糊搜索不允许连续的 %；
AbstractSQLExecutor 新增 getKey 方法；
新增待实现关键词 @null；
删除 Structure.java, Operation 中 NECESSARY, DISALLOW 等已废弃的部分代码；

Assets 2

27 Mar 11:44

TommyLemon

4.6.5

786d326

【安全】加强对 JOIN 和 SQL 函数的防护

调用 SQL 函数只允许用后端已配置的，避免 sleep(10) 这种命令函数导致数据库异常或耗时很久；
加强对 JOIN 相关键值对的校验，避免通过特殊符号进行 SQL 注入；
加强对命名的校验，避免用纯数字等非字母开头的表名/字段名导致 SQLException；

新增整合 APIJSON 和微服务框架 light-4j 的 Demo(同时接入了 Redis)；
新增用户发的文章全国行政区划数据抓取与处理；
删除已废弃的 Test 类的相关代码；

Assets 3

20 Mar 08:54

TommyLemon

4.6.1

a32d5f4

解决对 Response 校验只对最外层生效；移除已废弃的 Test 类

解决对 Response 校验只对最外层生效；
移除已废弃的 StructureUtil 和 Test 的相关代码；

Assets 3

31 Jan 16:08

TommyLemon

4.6.0

9cd4487

【性能】大幅提升数组内主表查询性能

解决 bug

解决 "toId%": "0,10" 等连续范围报错 value 类型不合法；
解决 "id{}@": "[]/Moment/praiseUserIdList" 等引用赋值的值有时类型为 List 时报错 ArrayList cannot be cast to JSONArray；
解决 "key<>": "a" 这种包含字符串的格式报错 Data truncation: Invalid JSON text，原来必须里面再用 "" 包装一次，JSON 中还得转义，现在简化成直接写即可；

增强安全

对 MySQL 的 DELETE 和 UPDATE 强制加 LIMIT，限制一次操作记录的数量；

提升性能

通过缓存及复用数组主表 ObjectParser 来大幅提升大量数据的数组内主表的查询性能；
通过减少不必要的 newSQLConfig 及 getSQL 等步骤来大幅提升大量数据的数组内主表的查询性能；

对比 4.5.2 在 Log.DEBUG = true(开启日志)的情况下

TestRecord[] 耗时降低至原来 24%，性能提升 300% 至原来 4 倍；
Moment[] 耗时降低至原来 33%，性能提升 200% 至原来 3 倍；
朋友圈列表耗时降低至原来 77%，性能提升 23% 至原来 1.2 倍。
其中每个数组都按 100 条来测试，如果每页数量更大或每项数据量更大，则提升会更加明显。

腾讯 CSIG 某项目线上生产环境实测 Log.DEBUG = false 时 2.3KW 大表(由两张等量拆分表组成)查询

LIMIT 100 相比原来从 2s 降到 164ms 提升 11 倍；
LIMIT 1000 相比原来从 30s 降到 197ms 提升 151 倍；
LIMIT 10000(一次 /get 到 1W 条记录) 整个网络请求耗时仅 633ms；
LIMIT 1000000(带条件一次 /get 到 12W+ 条记录共 72.5M 数据，CURL 下载速度 20M/s) 整个网络请求仅 5.624s，实际服务执行仅 2s。

兼容性

这个版本重构了几个方法：

1.Parser.createObjectParser

Parser createObjectParser(JSONObject request, String parentPath, String name, SQLConfig arrayConfig, boolean isSubquery) throws Exception;

删除 1 个参数 String name 新增 2 个参数 boolean isTable, boolean isArrayMainTable 后为

Parser createObjectParser(JSONObject request, String parentPath, SQLConfig arrayConfig, boolean isSubquery, boolean isTable, boolean isArrayMainTable) throws Exception;

2.AbstractParser.createObjectParser

AbstractObjectParser createObjectParser(JSONObject request, String parentPath, String name, SQLConfig arrayConfig, boolean isSubquery) throws Exception

删除 1 个参数 String name 新增 2 个参数 boolean isTable, boolean isArrayMainTable 后为

AbstractObjectParser createObjectParser(JSONObject request, String parentPath, SQLConfig arrayConfig, boolean isSubquery, boolean isTable, boolean isArrayMainTable) throws Exception

3.ObjectParser.parse

ObjectParser parse() throws Exception;

新增 2 个参数 String name, boolean isReuse 后为

ObjectParser parse(String name, boolean isReuse) throws Exception;

4.AbstractObjectParser.parse

AbstractObjectParser parse() throws Exception;

新增 2 个参数 String name, boolean isReuse 后为

AbstractObjectParser parse(String name, boolean isReuse) throws Exception;

5.AbstractObjectParser 的构造方法

public AbstractObjectParser(@NotNull JSONObject request, String parentPath, String name, SQLConfig arrayConfig, boolean isSubquery) throws Exception

删除 1 个参数 String name 新增 2 个参数 boolean isTable, boolean isArrayMainTable 后为

public AbstractObjectParser(@NotNull JSONObject request, String parentPath, SQLConfig arrayConfig, boolean isSubquery, boolean isTable, boolean isArrayMainTable) throws Exception

具体见

a406242

Assets 3

24 Jan 15:26

TommyLemon

4.5.2

893d3b3

兼容 JDK 11+；优化性能和代码；完善文档等

APIJSONORM

新增 javax.activation 依赖来兼容 JDK 11+，感谢知乎 sunxiaoguang 的贡献 PR#194；
新增 APIJSON 接口调试实践的链接，感谢腾讯同事贡献 Issue#189；
解决异常情况下未及时释放资源，感谢奇安信代码卫士的贡献 Issue#182-185；
解决某些情况下解析引用赋值出错，其它修复与优化，感谢源伞科技的贡献 Issue#48；

优化全局默认参数的解析性能；