light-databoard/docs/通用列表查询.md

# 通用列表查询方法

请求参数:
```json
{
	"method":"xxx/xxx/list",
	"params":{
		"page":1,
		"limit":10,
		"field":[
			"id","name"
		],
		"and":{
			"id":["1","2"],
			"name":["name1","name2"]
		},
		"or":{
			"id":["1","2"],
			"name":["name1","name2"]
		},
		"like":{
				"id":["1","2"],
				"name":["name1","name2"]
			},
		"orderby":[
			{"id":"asc"},
			{"name":"desc"},
			{"created_at":"desc"}
		],
		"where":[{
            "field":"job_id",  
            "operator":"=",
            "value":"2" 
        },{
			"field":"departments",  
			"operator":"find_in_set",
			"value":[1,2] 
		},]
	}
}
```
参数说明:
- page: 分页记录，默认不填为1，page不能小于1（小于1的数均会改写成1）
- limit: 每页显示的记录数，默认不填为10,当limit小于0时 会返回所有数据记录
- field: 自定义需要查询的字段，不填默认返回所有记录
- and: 与运算条件。示例中会生成如下sql查询语句: select .....  where id in(1,2) and name in ("name1","name2")
- or: 或运算条件。示例中会生成如下sql查询语句: select .....  where id in(1,2) or name in ("name1","name2")
- like: 模糊查询条件。
- orderby: 排序 根据数组顺序区分 首序、次序
- where: 自定义where条件 传入condition对象 的数组 
- condition.field 指定字段
- condition.operator 操作符  例：= != > >= < <= in notin 等
<font color="red">特殊操作符： find_in_set：一对多关联查询</font> 例如：
```json
{
   	"field": "departments",
    "operator": "find_in_set",
   	"value": [1]
}
```
- condition.value 值

成功返回参数:
```json
{
	"result":{
		"count":100,
		"rows":[
			{},{},{}
		]
	}
}
```
参数说明:
- count: 总记录数
- rows: 查询出的记录数组