DBAPI如何使用复杂多层嵌套JSON作为请求参数
DBAPI作为一款后端低代码接口快速开发工具,不仅能实现简单的字段传参给SQL,也可以实现复杂的JSON传参。下面我们就来看一个实际的例子。
背景需求
- 假设我们现在MySql有一张GDP表,内容如下:
- 我们的请求参数格式是这样的:
{
"province": {
"name": "广东",
"cities": [{
"name": "深圳",
"code": "518000"
}, {
"name": "广州",
"code": "510000"
}
]
}
}
- 这是一个复杂的嵌套的JSON,那如何才能把参数中的两个城市深圳和广州取出来,作为参数传递给SQL呢?
- 先定一个目标:查询参数中的城市的GDP。接下来开始操作。
实操
- 第1步,创建数据源,将mysql账户地址填上并创建
- 第2步,创建一个分组
- 第3步,在分组上创建API
注意在基本信息的Content Type
中一定要选择application/json
,然后将json参数填入其中。
在执行器中选择刚才创建的数据源,并填写sql,注意sql中的参数我们这样获取:
#{province.cities[0].name} #{province.cities[1].name}
- 保存并发布API
验证
- 最后我们来验证数据,我们来到请求测试页面,点击发送请求,可以看到查询到了深圳和广州的数据。完成!
- 是不是很方便呢
解释
- json取值就是通过“.”符号来取字段值,如果是数组类型,可以用“[下标]”的方式来取出对应的元素。
扩展
-
有同学又问了,如果json参数中的cities数组不是2个元素,是3个元素怎么办呢?那SQL不就只能接收2个参数了吗?能否根据参数数组中的个数自动接收参数呢?
-
当然可以!那就要用到类似Mybatis的动态SQL语法了!我们修改API,修改SQL为以下内容,然后保存并发布API。
select * from gdp where city in
<foreach open="(" close=")" collection="province.cities" separator="," item="city" index="index">
#{city.name}
</foreach>
- 接下来修改参数为3个城市,发送请求,可以看到查询结果正确!
-
那么这一段动态SQL如何解释呢
-
collection="province.cities"
表示将province.cities
取出来,它是一个数组,对这个数组进行循环遍历 -
item="city"
表示循环遍历的时候对每个元素进行命名为city -
所以最后取值的时候用
#{city.name}
来取值 -
不熟悉的同学可以学习下mybatis动态SQL语法喔!
总结
- 作为一款API低代码快速开发工具,DBAPI是不是很方便呢?
- 欢迎关注DBAPI微信公众号以及官网地址https://www.51dbapi.com