Skip to main content

快速创建表服务端方法

执行系统：最新版本（2023.05.15后升级的）

开发系统：最新版本（2023.05.15后升级的）

1. 准备工作​

在开发系统构件中，创建一个 tb 表，字段如下：

表编码 tb
字段字段类型
id文本
userName文本
sex文本
age整数

2. 生成 API 方法​

在表设计中，勾选 “是否生成 api 方法”，并且按需勾选生成对应的api方法。

img

勾选后，开发系统会生成对应的服务端方法，这些方法默认是输出的，且不能修改。

img

3. 数据表操作api​

3.1 查询表结构

（1）请求参数和返回值
img
（2）请求示例 
方法一：直接访问地址调用接口，查看效果，格式为 /webapi/构件编码/API_表编码_fields
http://127.0.0.1:8080/webapi/ydg_api/API_tb_fields
方法二：在 WebApi 中直接调试效果
img

3.2 查询单条记录

（1）请求参数和返回值
img
（2）请求示例 
方法一：直接访问地址调用接口，查看效果，格式为 /webapi/构件编码/API_表编码_findById
http://127.0.0.1:8080/webapi/ydg_api/API_tb_findById?id=001
方法二：在 WebApi 中直接调试效果
img

3.3 批量查询记录

（1）请求参数
img
（2）返回值
img
（3）请求示例 
方法一：直接访问地址调用接口，查看效果，格式为 /webapi/构件编码/API_表编码_find
http://127.0.0.1:8080/webapi/ydg_api/API_tb_find?
pageNumber=1&pageSize=10&fields=id,userName,age,sex&
filters=[
{"logical":null,"leftbracket":"(","field":"age","operator":"lt","value":"30","rightbracket":")"},
{"logical":"or","leftbracket":"(","field":"userName","operator":"like","value":"张","rightbracket":")"}
]&sorts=[{"field":"id","type":"asc"}]
方法二：在 WebApi 中直接调试效果
img

3.4 创建记录

（1）请求参数和返回值
img
（2）请求示例 
方法一：直接访问地址调用接口，查看效果，格式为 /webapi/构件编码/API_表编码_create
http://127.0.0.1:8080/webapi/ydg_api/API_tb_create?
id=004&userName=赵六&sex=0&age=16
方法二：在 WebApi 中直接调试效果
img
img

3.5 批量创建

（1）请求参数和返回值
img
（2）请求示例 
方法一：直接访问地址调用接口，查看效果，格式为 /webapi/构件编码/API_表编码_batchCreate
http://127.0.0.1:8080/webapi/ydg_api/API_tb_batchCreate?
datas=[
{"id":"005","userName":"张一一","sex":"女","age":10},
{"id":null,"userName":"张二二","sex":"女","age":15},
]
方法二：在 WebApi 中直接调试效果
img
img

3.6 更新记录

（1）请求参数和返回值
img
（2）请求示例 
方法一：直接访问地址调用接口，查看效果，格式为 /webapi/构件编码/API_表编码_update
http://127.0.0.1:8080/webapi/ydg_api/API_tb_update?id=004&userName=赵六&sex=女&age=55
方法二：在 WebApi 中直接调试效果
img
img

3.7 批量更新

（1）请求参数和返回值
img
（2）请求示例 
方法一：直接访问地址调用接口，查看效果，格式为 /webapi/构件编码/API_表编码_batchUpdate
http://127.0.0.1:8080/webapi/ydg_api/API_tb_batchUpdate?
datas=[
{"id":"004","userName":"张一一","sex":"男","age":25},
{"id":"005","userName":"赵六","sex":"男","age":26}
]
方法二：在 WebApi 中直接调试效果
img
img

3.8 删除记录

（1）请求参数和返回值
img
（2）请求示例 
方法一：直接访问地址调用接口，查看效果，格式为 /webapi/构件编码/API_表编码_delete
http://127.0.0.1:8080/webapi/ydg_api/API_tb_delete?id=001
方法二：在 WebApi 中直接调试效果
img

3.9 批量删除

（1）请求参数和返回值
img
（2）请求示例 
方法一：直接访问地址调用接口，查看效果，格式为 /webapi/构件编码/API_表编码_batchDelete
http://127.0.0.1:8080/webapi/ydg_api/API_tb_batchDelete?datas=[{"id":"002"},{"id":"003"}]
方法二：在 WebApi 中直接调试效果
img

3.10 新增或更新记录

（1）请求参数和返回值
img
（2）请求示例 
方法一：直接访问地址调用接口，查看效果，格式为 /webapi/构件编码/API_表编码_insertOrUpdate
http://127.0.0.1:8080/webapi/ydg_api/API_tb_insertOrUpdate?id=3&userName=张三三
方法二：在 WebApi 中直接调试效果
img
img

3.11 批量新增或更新

（1）请求参数
img
（2）返回值
img
（3）请求示例 
方法一：直接访问地址调用接口，查看效果，格式为 /webapi/构件编码/API_表编码_batchInsertOrUpdate
http://127.0.0.1:8080/webapi/ydg_api/API_tb_batchInsertOrUpdate?
datas=[
{"id":"3","userName":"张三三","sex":"女"},
{"id":"4","userName":"李四四","sex":"男","age":18}
]&isIgnoreEmptyId=False
方法二：在 WebApi 中直接调试效果
img
img

4. 调用方法​

自动生成的数据表操作api与手动创建的服务端方法一致。

img

5. 删除自动生成的服务端方法​

在表设计中取消勾选 “是否生成api方法” 并保存后，这些方法会自动被删除。

img