点击上方“青年码农”关注
回复“源码”可获取各种资料
APIJSON 是一种专为 API 而生的 JSON 网络传输协议 以及 基于这套协议实现的 ORM 库。为各种增删改查提供了完全自动化的万能 API,零代码实时满足千变万化的各种新增和变更需求。能大幅降低开发和沟通成本,简化开发流程,缩短开发周期。
之前的一篇文章讲解了 APIJSON 的简单用法,链接:APIJSON-零代码接口和文档JSON 协议 与 ORM 库 ,今天说说复杂查询是如何实现的。
在演示查询之前我们先建几个表,Test_user、Test_user_moent_ref(关联表)、Test_moment,关联关系如图
随便添加几条数据,必须保证关联关系是正确的。
我们先用 SQL 查询,查询结果如下
一 单表查询 - 单条数据
1 单条数据
单表查询返回一条数据,用 Test_user 做示例,请求格式如下,
{
"Test_user": {}
}
APIJSON 会转换为
SELECT * FROM test_user LIMIT 1 OFFSET
返回格式如下
2 过滤数据
也可以过滤,比如 id=2 的数据
{
"Test_user": {
"id":"2"
}
}
3 判断是否存在
{
"Test_user": {
"id}{@": {
"from": "Test_user_moent_ref",
"Test_user_moent_ref": {
"id": 1
}
}
}
}
}{ 表示 EXISTS,@ 后面是 子查询 对象,from 为目标表 Table 的名称;
二 单表查询 - 多条数据
1 多条数据
单表查询返回多条数据,用 Test_user 做示例,请求格式如下,
{
"[]":{
"Test_user": {}
}
}
返回结果
2 分页查询
{
"[]": {
"count": 10,
"page": 0,
"Test_user": {
"second_name": "唐三"
}
}
}
查询结果
3 过滤字段
{
"[]":{
"Test_user": {
"second_name":"唐三"
}
}
}
过滤second_name=唐三的数据
4 模糊查询
{
"[]": {
"count": 10,
"page": 0,
"Test_user": {
"second_name$": "唐%"
}
}
}
%表示任意字符,上面搜索是以唐开始,可以是任意SQL搜索表达式字符串,如 %key%(包含key), key%(以key开始), %k%e%y%(包含字母k,e,y) 等。
5 正则表达式
{
"[]": {
"count": 10,
"page": 0,
"Test_user": {
"second_name~": "\u5510"
}
}
}
正则也很简单,就是把汉字唐转化ASCII码,搜索包含唐的数据
6 连续范围
{
"[]": {
"count": 10,
"page": 0,
"Test_user": {
"id%": "1,9"
}
}
}
可以查询范围内的,由于我这边数据比较少,所以用 id 查
7 控制返回字段
{
"[]": {
"count": 10,
"page": 0,
"Test_user": {
"@column":"second_name",
"id%": "1,9"
}
}
}
只返回second_name字段
8 给返回字段设置别名
{
"[]": {
"count": 10,
"page": 0,
"Test_user": {
"@column":"second_name:s_name",
"id%": "1,9"
}
}
}
second_name设置别名为s_name
9 比较运算
{
"[]": {
"count": 10,
"page": 0,
"Test_user": {
"id>": "1"
}
}
}
比较运算符>, <, >=, <=都支持,不支持key=和key!=这两种,而是使用更为简单的 "key":Object 和 "key!":Object 替代。
10 逻辑运算
{
"[]": {
"count": 10,
"page": 0,
"Test_user": {
"id&{}": ">1,<3"
}
}
}
逻辑运算符&, |, !都支持,但是使用场景不同
& 可用于"key&{}":"条件"等
| 可用于"key|{}":"条件", "key|{}":[]等,一般可省略
! 可单独使用,如"key!":Object,也可像&,|一样配合其他功能符使用
三 两张表-一对一关联查询
用Test_user和Test_user_moent_ref做示例,通过Test_user的id字段和Test_user_moent_ref的entity_id字段关联
{
"Test_user": {},
"Test_user_moent_ref":{
"entity_id@":"/Test_user/id"
}
}
返回两个表的所有字段
可以指定返回字段
四 两张表-一对多关联查询
还是Test_user和Test_user_moent_ref做示例,通过Test_user的id字段和Test_user_moent_ref的entity_id字段关联
{
"Test_user": {},
"Test_user_moent_ref[]":{
"Test_user_moent_ref":{
"entity_id@":"Test_user/id"
}
}
}
返回数据如下
五 两张表-数组内一对一关联查询
通过 Test_user 的 id 字段和 Test_user_moent_ref 的 entity_id 字段关联
{
"[]":{
"Test_user": {},
"Test_user_moent_ref":{
"entity_id@":"[]/Test_user/id"
}
}
}
其中
"entity_id@":"[]/Test_user/id
要根据 Test_user 在数组中的位置 index 来动态改变
请求返回格式
六 两张表-数组内一对多关联查询
通过 Test_user 的 id 字段和 Test_user_moent_ref 的 entity_id 字段关联
{
"[]":{
"Test_user": {},
"Test_user_moent_ref[]":{
"Test_user_moent_ref":{
"entity_id@":"[]/Test_user/id"
}
}
}
}
注意事项和上面一样,返回格式如下
七 三张表及以上查询
通过 Test_user 的 id 字段和 Test_user_moent_ref 的 entity_id 字段关联,Test_user_moent_ref 的 component_id 字段和 Test_monent 的 id 字段关联,查询方式和上面大同小异。
{
"[]": {
"join": "
数据是返回了,但是有点小问题
用 SQL 查询应该是这个样子的,但是返回的数据有点区别。
后续研究透彻再详细讲解多表查询吧,如果有大佬能提供思路,也是非常感谢!