我们现在能登陆、退出登陆、修改密码，但是这些跟完整的用户管理模块还差着很多。所以本小节我们来做用户模块CRUD操作中的查询功能，我说的查询指的是有条件分页查询。
在user.vue页面中有查询用户记录的条件区域，我们可以设置具体的查询条件，如果什么条件都不设置的话，就是无条件分页查找用户记录。
一、定义模型层
因为查询条件是动态组合的，所以我们在持久层里面编写SQL语句的时候，要判断某个数据不为空，就把它添加到WHERE子句里面充当查询条件。因为是分页查询，所以我们要在TbUserDao.xml文件中编写两条SQL语句，一个是用来查询总记录数，另一个用来查询分页记录。
因为SQL语句超级复杂，这里我先带着同学们从浅入深逐步拆解这个SQL语句。用户表中role字段是JSON数组格式，用户可以拥有多个角色。
SELECT u.username
FROM tb_user u
JOIN tb_role r ON JSON_CONTAINS ( u.role, CONVERT ( r.id, CHAR ) )
WHERE r.role_name="超级管理员"
SELECT u.username,
d.dept_name AS deptName
FROM tb_user u
JOIN tb_role r ON JSON_CONTAINS ( u.role, CONVERT ( r.id, CHAR ) )
LEFT JOIN tb_dept d ON u.dept_id = d.id
WHERE r.role_name="超级管理员"
SELECT GROUP_CONCAT( role_name separator "，" ) FROM tb_role;
用上了GROUP_CONCAT()函数，我们的SQL语句变成了下面的样子
SELECT u.username,
d.dept_name AS deptName,
(
SELECT GROUP_CONCAT( role_name separator "，" )
FROM tb_role
WHERE JSON_CONTAINS ( u.role, CONVERT ( id, CHAR ) )
) AS roles
FROM tb_user u
JOIN tb_role r ON JSON_CONTAINS ( u.role, CONVERT ( r.id, CHAR ) )
LEFT JOIN tb_dept d ON u.dept_id = d.id
WHERE r.role_name="超级管理员"
了解过SQL语句的各种语法之后，下面才是我们正式要写的SQL语句。
<select id="searchUserByPage" parameterType="HashMap" resultType="HashMap">
SELECT
DISTINCT u.id,
u.name,
u.sex,
u.tel,
u.email,
d.dept_name AS dept,
u.hiredate,
u.root,
u.status,
( SELECT GROUP_CONCAT( role_name separator "，" ) FROM tb_role WHERE JSON_CONTAINS ( u.role, CONVERT ( id, CHAR ) ) ) AS roles
FROM tb_user u
JOIN tb_role r ON JSON_CONTAINS ( u.role, CONVERT ( r.id, CHAR ) )
LEFT JOIN tb_dept d ON u.dept_id = d.id
WHERE 1=1
<if test="name!=null">
AND u.name LIKE "%${name}%"
</if>
<if test="sex!=null">
AND u.sex=#{sex}
</if>
<if test="role!=null">
AND r.role_name=#{role}
</if>
<if test="deptId!=null">
AND d.id=#{deptId}
</if>
<if test="status!=null">
AND u.status=#{status}
</if>
LIMIT #{start}, #{length}
</select>
<select id="searchUserCount" parameterType="HashMap" resultType="long">
SELECT
COUNT(DISTINCT u.id)
FROM tb_user u
JOIN tb_role r ON JSON_CONTAINS ( u.role, CONVERT ( r.id, CHAR ) )
WHERE 1=1
<if test="name!=null">
AND u.name LIKE "%${name}%"
</if>
<if test="sex!=null">
AND u.sex=#{sex}
</if>
<if test="role!=null">
AND r.role_name=#{role}
</if>
<if test="deptId!=null">
AND u.dept_id=#{deptId}
</if>
<if test="status!=null">
AND u.status=#{status}
</if>
</select>
在TbUserDao.java接口中声明两个抽象方法。
public interface TbUserDao {
……
public ArrayList<HashMap> searchUserByPage(HashMap param);
public long searchUserCount(HashMap param);
}
二、定义业务层
在UserService.java接口中声明抽象方法。
public interface UserService {
……
public PageUtils searchUserByPage(HashMap param);
}
在UserServiceImpl.java类中实现抽象方法。
public class UserServiceImpl implements UserService {
……
@Override
public PageUtils searchUserByPage(HashMap param) {
ArrayList<HashMap> list = userDao.searchUserByPage(param);
long count = userDao.searchUserCount(param);
int start = (Integer) param.get("start");
int length = (Integer) param.get("length");
PageUtils pageUtils = new PageUtils(list, count, start, length);
return pageUtils;
}
}
三、定义Web层
创建SearchUserByPageForm.java类，保存Ajax提交的数据。
@Data
@Schema(description = "查询用户分页记录表单")
public class SearchUserByPageForm {
@NotNull(message = "page不能为空")
@Min(value = 1, message = "page不能小于1")
@Schema(description = "页数")
private Integer page;
@NotNull(message = "length不能为空")
@Range(min = 10, max = 50, message = "length必须在10~50之间")
@Schema(description = "每页记录数")
private Integer length;
@Pattern(regexp = "^[\\u4e00-\\u9fa5]{1,10}$", message = "name内容不正确")
@Schema(description = "姓名")
private String name;
@Pattern(regexp = "^男$|^女$", message = "sex内容不正确")
@Schema(description = "性别")
private String sex;
@Pattern(regexp = "^[a-zA-Z0-9\\u4e00-\\u9fa5]{2,10}$", message = "role内容不正确")
@Schema(description = "角色")
private String role;
@Min(value = 1, message = "dept不能小于1")
private Integer deptId;
@Min(value = 1, message = "status不能小于1")
private Integer status;
}
在UserController.java类中定义Web方法。
@RestController
@RequestMapping("/user")
@Tag(name = "UserController", description = "用户Web接口")
public class UserController {
……
@PostMapping("/searchUserByPage")
@Operation(summary = "查询用户分页记录")
@SaCheckPermission(value = {"ROOT", "USER:SELECT"}, mode = SaMode.OR)
public R searchUserByPage(@Valid @RequestBody SearchUserByPageForm form) {
int page = form.getPage();
int length = form.getLength();
int start = (page - 1) * length;
HashMap param = JSONUtil.parse(form).toBean(HashMap.class);
param.put("start", start);
PageUtils pageUtils = userService.searchUserByPage(param);
return R.ok().put("page", pageUtils);
}
}