目录
3. 员工管理
3.1 分页查询
3.1.1 基础分页
3.1.1.1 需求分析
3.1.1.2 接口文档
3.1.1.3 思路分析
3.1.1.4 功能开发
PageBean
3.1.1.5 功能测试
3.1.1.6 前后端联调
3.1.2 分页插件{分页查询-PageHelper插件}
3.1.2.1 介绍
官网：
3.1.2.2 代码实现
EmpController
EmpService
3.1.2.3 测试
补充：分页插件的两个重要参数：
helperDialect：分页插件会自动检测当前的数据库链接，自动选择合适的分页方式。 你可以配置helperDialect属性来指定分页插件使用哪种方言。配置时，可以使用下面的缩写值：oracle,mysql,mariadb,sqlite,hsqldb,postgresql,db2,sqlserver,informix,h2,sqlserver2012,derby特别注意：使用 SqlServer2012 数据库时，需要手动指定为 sqlserver2012，否则会使用 SqlServer2005 的方式进行分页。你也可以实现 AbstractHelperDialect，然后配置该属性为实现类的全限定名称即可使用自定义的实现方法。
reasonable：分页合理化参数，默认值为false。当该参数设置为 true 时，pageNum<=0 时会查询第一页， pageNum>pages（超过总数时），会查询最后一页。默认false 时，直接根据参数进行查询。
3.2 分页查询(带条件)
3.2.2 条件分页查询 - 思路分析
3.2.3 功能开发
3.2.4 功能测试
3.2.5 前后端联调
3.3 删除员工
3.3.1 需求
3.3.2 接口文档
3.3.3 思路分析
@PathVariable
@DeleteMapping
Mybatis中的动态SQL：foreach
3.3.4 功能开发
响应数据：json格式
EmpController
3.3.5 功能测试
3.3.6 前后端联调
3. 员工管理
完成了部门管理的功能开发之后，我们进入到下一环节员工管理功能的开发。
基于以上原型，我们可以把员工管理功能分为：
-
分页查询
-
带条件的分页查询
-
删除员工
-
新增员工
-
修改员工
那下面我们就先从分页查询功能开始学习。
3.1 分页查询
3.1.1 基础分页
3.1.1.1 需求分析
我们之前做的查询功能，是将数据库中所有的数据查询出来并展示到页面上，试想如果数据库中的数据有很多(假设有十几万条)的时候，将数据全部展示出来肯定不现实，那如何解决这个问题呢？
使用分页解决这个问题。每次只展示一页的数据，比如：一页展示10条数据，如果还想看其他的数据，可以通过点击页码进行查询。
要想从数据库中进行分页查询，我们要使用LIMIT关键字，格式为：limit 开始索引 每页显示的条数
-- 分页查询语法
-- 参数1:起始索引 = (页码 - 1) * 每页展示记录数
-- 参数2:每页展示记录数 = 查询返回记录数
select * from emp limit 0,10;
-- 查询第一页数据,每页展示5条记录
select * from emp limit 0,5;
-- 查询第二页数据,每页展示5条记录
select * from emp limit 5,5;
-- 查询第三页数据,每页展示5条记录
select * from emp limit 10,5;观察以上SQL语句，发现： 开始索引一直在改变 ， 每页显示条数是固定的
开始索引的计算公式： 开 / 起始索引 = (当前页码 - 1) * 每页显示条数
我们继续基于页面原型，继续分析，得出以下结论：
-
前端在请求服务端时，传递的参数
-
当前页码 page
-
每页显示条数 pageSize
-
-
后端需要响应什么数据给前端
-
所查询到的数据列表（因为数据列表有多条记录，因此存储到List 集合当中）
-
总记录数
-
后台给前端返回的数据包含：List集合(数据列表)、total(总记录数)
而这两部分我们通常封装到PageBean对象中，并将该对象转换为json格式的数据响应回给浏览器。
@Data
@NoArgsConstructor
@AllArgsConstructor
public class PageBean {
private Long total; //总记录数
private List rows; //当前页数据列表
}3.1.1.2 接口文档
员工列表查询
-
基本信息
- 请求参数
参数格式：queryString
参数说明：
| 参数名 称 | 是否必 须 | 示例 | 备注 |
| name | 否 | 张 | 姓名 |
| gender | 否 | 1 | 性别 , 1 男 , 2 女 |
| begin | 否 | 2010-01- 01 | 范围匹配的开始时间(入职日期) |
| end | 否 | 2020-01- 01 | 范围匹配的结束时间(入职日期) |
| page | 是 | 1 | 分页查询的页码，如果未指定，默认为1 |
| pageSize | 是 | 10 | 分页查询的每页记录数，如果未指定，默认为10 |
请求数据样例：
2.1.3 响应数据
参数格式：application/json
参数说明：
响应数据样例：
3.1.1.3 思路分析
分页查询需要的数据，封装在PageBean对象中：
3.1.1.4 功能开发
通过查看接口文档：员工列表查询
请求路径：/emps
请求方式：GET
请求参数：跟随在请求路径后的参数字符串。 例：/emps?page=1&pageSize=10
响应数据：json格式
EmpController
package com.gch.controller;
import com.gch.pojo.PageBean;
import com.gch.pojo.Result;
import com.gch.service.EmpService;
import lombok.extern.slf4j.Slf4j;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RequestParam;
import org.springframework.web.bind.annotation.RestController;
/**
员工管理控制器
*/
@Slf4j
@RestController
@RequestMapping("")
public class EmpController {
@Autowired
private EmpService empService;
/**
* 条件分页查询
* @param page => 分页查询的页码
* @param pageSize => 分页查询的每页展示记录数
* 默认值的设置可以通过注解@RequestParam中的defaultValue()属性来指定默认值
* 注意:形参page与pageSize需要于接口文档中的请求参数名保持一致
* @return
*/
@GetMapping("/emps")
public Result page(@RequestParam(defaultValue = "1") Integer page,
@RequestParam(defaultValue = "10") Integer pageSize) {
// 设置默认值,但写法比较繁琐
// if(page == null) {page = 1;}
// if(pageSize == null) {pageSize = 10;}
// 记录日志
log.info("分页查询,参数:{},{}",page,pageSize);
// 调用service分页查询
PageBean pageBean = empService.page(page,pageSize);
// 响应
return Result.success(pageBean);
}
}
- @RequestParam(defaultValue="默认值") //设置请求参数默认值
EmpService
package com.gch.service;
import com.gch.pojo.PageBean;
/**
员工业务规则
*/
public interface EmpService {
/**
* 条件分页查询
* @param page => 分页查询的页码
* @param pageSize => 分页查询的每页展示记录数
* @return
*/
PageBean page(Integer page, Integer pageSize);
}
EmpServiceImpl
package com.gch.service.impl;
import com.gch.mapper.EmpMapper;
import com.gch.pojo.Dept;
import com.gch.pojo.Emp;
import com.gch.pojo.PageBean;
import com.gch.service.EmpService;
import lombok.extern.slf4j.Slf4j;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.stereotype.Service;
import java.util.List;
/**
员工业务实现类
*/
@Slf4j
@Service
public class EmpServiceImpl implements EmpService {
@Autowired
private EmpMapper empMapper;
/**
* 分页查询
* @param page => 分页查询的页码
* @param pageSize => 分页查询的每页展示记录数
* @return
*/
@Override
public PageBean page(Integer page, Integer pageSize) {
// 1.获取总记录数
Long total = empMapper.count();
// 2.获取分页查询的数据列表
List<Emp> rows = empMapper.pageSelect((page - 1) * pageSize,pageSize);
// 3.封装PageBean对象
return new PageBean(total,rows);
}
}
EmpMapper
package com.gch.mapper;
import com.gch.pojo.Emp;
import org.apache.ibatis.annotations.Mapper;
import org.apache.ibatis.annotations.Select;
import java.util.List;
/**
员工管理
*/
@Mapper
public interface EmpMapper {
/**
* 查询总记录数
* @return
*/
@Select("select count(*) from tlias.emp")
public Long count();
/**
* 分页查询,获取数据列表/获取列表数据
* @param startIndex => 起始索引
* @param pageSize => 每页展示记录数
* @return
*/
@Select("select * from tlias.emp limit #{startIndex},#{pageSize}")
public List<Emp> pageSelect(Integer startIndex,Integer pageSize);
}
PageBean
package com.gch.pojo;
import lombok.AllArgsConstructor;
import lombok.Data;
import lombok.NoArgsConstructor;
import java.util.List;
/**
分页查询结果的封装类
*/
@Data
@NoArgsConstructor
@AllArgsConstructor
public class PageBean {
/** 总记录数 */
private Long total;
/** 当前页数据列表 */
private List rows;
}
3.1.1.5 功能测试
功能开发完成后，重新启动项目，使用Postman，发起GET请求：
3.1.1.6 前后端联调
打开浏览器，测试后端功能接口：
总结：
分页查询：
- 请求参数：页码、每页展示记录数
- 响应结果：总记录数 + 查询返回的数据列表 => PageBean
注解：
- 注解@RequestParam的属性defaultValue可以来设置参数的默认值！
3.1.2 分页插件{分页查询-PageHelper插件}
3.1.2.1 介绍
MyBatis框架当中分页查询的插件：PageHelper，通过这款插件就可以来简化分页查询的操作。
前面我们已经完了基础的分页查询，大家会发现：分页查询功能编写起来比较繁琐。
在Mapper接口中定义两个方法执行两条不同的SQL语句：
查询总记录数
查询获取指定页码的数据列表
在Service当中，调用Mapper接口的两个方法，分别获取：总记录数、查询结果列表，然后在将获取的数据结果封装到PageBean对象中。
大家思考下：在未来开发其他项目，只要涉及到分页查询功能(例：订单、用户、支付、商品)，都必须按照以上操作完成功能开发
结论：手动实现的，原始方式的分页查询，存在着"步骤固定"、"代码繁琐"的问题 。
解决方案：可以使用一些现成的分页插件完成。对于Mybatis来讲现在最主流的就是PageHelper。
PageHelper是Mybatis的一款功能强大、方便易用的分页插件，支持任何形式的单表、多表的分页查询。
官网：
MyBatis 分页插件 PageHelper如果你也在用 MyBatis，建议尝试该分页插件，这一定是最方便使用的分页插件。分页插件支持任何复杂的单表、多表分页。
https://pagehelper.github.io/
- 如果我们使用PageHelper这款分页插件来实现分页，我们程序员是不需要手动的去考虑分页的，所有与分页相关的操作插件已经帮我们完成了，所以我们只需要在Mapper接口当中正常的去执行查询就行(select * from xxx)，不用考虑分页(limit、count(*))，所有与分页相关的操作都不用我们做，因为所有与分页相关的操作都是插件帮我们完成的。
在业务层，我们要基于PageHelper进行分页，主要涉及到三步操作：
- 需要调用PageHelper这个插件当中的提供的一个核心类PageHelper，调用PageHelper中的静态方法startPage(page，pageSize)来设置分页参数，告诉PageHelper我要查第几页，每页显示几条数据；
- 此时PageHelper会自动的对紧跟在其后的这条查询语句进行分页操作，查询完毕之后，可以把List集合强转为一个Page类型，这个Page类是PageHelper当中提供的，这个Page当中就封装了所有分页查询的结果，包括总记录数Total，包括结果列表Result；
- 接下来只需要把这两项封装到PageBean当中即可。
总结：如果我们使用PageHelper这个分页插件来进行分页查询，主要的步骤就是：
- 第一步：设置分页参数；
- 第二步：正常的执行查询，然后紧接着拿到查询结果之后把查询结果强转为Page类型；
- 第三步： 然后紧接着再从Page当中拿到分页查询的结果就可以了。
在执行empMapper.list()方法时，就是执行：select * from emp 语句，怎么能够实现分页操作呢？
分页插件帮我们完成了以下操作(PageHelper底层)：
先获取到要执行的SQL语句：select * from emp并拦截
把SQL语句中的字段列表，变为：count(*)，其实底层用的是count(0)
执行SQL语句：select count(*) from emp； // 获取到总记录数
再对要执行的SQL语句：select * from emp 进行改造，在末尾添加 limit ? , ?
执行改造后的SQL语句：select * from emp limit ? , ?
3.1.2.2 代码实现
- 当使用了PageHelper分页插件进行分页，就无需在Mapper中进行手动分页了，在Mapper中我们只需要进行正常的列表查询即可。
- 在Service层中，调用Mapper的方法之前设置分页参数，在调用Mapper方法执行查询之后，解析分页结果，并将结果封装到PageBean对象中返回。
1、在pom.xml引入依赖
<!-- PageHelper分页插件-->
<dependency>
<groupId>com.github.pagehelper</groupId>
<artifactId>pagehelper-spring-boot-starter</artifactId>
<version>1.4.2</version>
</dependency>EmpController
package com.gch.controller;
import com.gch.pojo.PageBean;
import com.gch.pojo.Result;
import com.gch.service.EmpService;
import lombok.extern.slf4j.Slf4j;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RequestParam;
import org.springframework.web.bind.annotation.RestController;
/**
员工管理控制器
*/
@Slf4j
@RestController
@RequestMapping("")
public class EmpController {
@Autowired
private EmpService empService;
/**
* 条件分页查询
* @param page => 分页查询的页码
* @param pageSize => 分页查询的每页展示记录数
* 默认值的设置可以通过注解@RequestParam中的defaultValue()属性来指定默认值
* 注意:形参page与pageSize需要于接口文档中的请求参数名保持一致
* @return
*/
@GetMapping("/emps")
public Result page(@RequestParam(defaultValue = "1") Integer page,
@RequestParam(defaultValue = "10") Integer pageSize) {
// 设置默认值,但写法比较繁琐
// if(page == null) {page = 1;}
// if(pageSize == null) {pageSize = 10;}
// 记录日志
log.info("分页查询,参数:{},{}",page,pageSize);
// 调用service分页查询
PageBean pageBean = empService.page(page,pageSize);
// 响应
return Result.success(pageBean);
}
}
EmpService
package com.gch.service;
import com.gch.pojo.PageBean;
/**
员工业务规则
*/
public interface EmpService {
/**
* 条件分页查询
* @param page => 分页查询的页码
* @param pageSize => 分页查询的每页展示记录数
* @return
*/
PageBean page(Integer page, Integer pageSize);
}
3、EmpServiceImpl
package com.gch.service.impl;
import com.gch.mapper.EmpMapper;
import com.gch.pojo.Emp;
import com.gch.pojo.PageBean;
import com.gch.service.EmpService;
import com.github.pagehelper.Page;
import com.github.pagehelper.PageHelper;
import lombok.extern.slf4j.Slf4j;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.stereotype.Service;
import java.util.List;
/**
员工业务实现类
*/
@Slf4j
@Service
public class EmpServiceImpl implements EmpService {
@Autowired
private EmpMapper empMapper;
/**
* 基于PageHelper分页插件实现分页查询
* @param page => 分页查询的页码
* @param pageSize => 分页查询的每页展示记录数
* @return
*/
@Override
public PageBean page(Integer page,Integer pageSize){
// 1.设置分页参数
PageHelper.startPage(page,pageSize);
// 2.执行查询
List<Emp> empList = empMapper.list();
// 获取分页结果
Page<Emp> p = (Page<Emp>)empList;
// 3.封装PageBean对象
return new PageBean(p.getTotal(),p.getResult());
}
}
2、EmpMapper
package com.gch.mapper;
import com.gch.pojo.Emp;
import org.apache.ibatis.annotations.Mapper;
import org.apache.ibatis.annotations.Select;
import java.util.List;
/**
员工管理
*/
@Mapper
public interface EmpMapper {
/**
* 基于PageHelper进行员工信息分页查询
* @return
*/
@Select("select * from tlias.emp")
public List<Emp> list();
}
3.1.2.3 测试
功能开发完成后，我们重启项目工程，打开Postman，发起GET请求，访问 ：http://localhost:8080/emps?page=1&pageSize=5
后端程序SQL输出：
补充：分页插件的两个重要参数：
-
helperDialect：分页插件会自动检测当前的数据库链接，自动选择合适的分页方式。 你可以配置helperDialect属性来指定分页插件使用哪种方言。配置时，可以使用下面的缩写值：oracle,mysql,mariadb,sqlite,hsqldb,postgresql,db2,sqlserver,informix,h2,sqlserver2012,derby特别注意：使用 SqlServer2012 数据库时，需要手动指定为sqlserver2012，否则会使用 SqlServer2005 的方式进行分页。你也可以实现AbstractHelperDialect，然后配置该属性为实现类的全限定名称即可使用自定义的实现方法。 -
reasonable：分页合理化参数，默认值为false。当该参数设置为true时，pageNum<=0时会查询第一页，pageNum>pages（超过总数时），会查询最后一页。默认false时，直接根据参数进行查询。
在application.properties中配置PageHelper分页插件：
#PageHelper分页插件的配置
#配置数据库方言
pagehelper.helper-dialect=mysql
#分页合理化参数配置
pagehelper.reasonable=true总结：在MyBatis当中实现分页查询的两种方式：
- 手动实现分页查询
- 基于PageHelper分页插件实现分页查询
在项目开发当中，我们都是基于PageHelper分页插件实现分页查询，因为实现起来更加简洁，开发起来更加高效！
3.2 分页查询(带条件)
完了分页查询后，下面我们需要在分页查询的基础上，添加条件。
我们看到页面原型及需求中描述，搜索栏的搜索条件有三个，分别是：
-
姓名：模糊匹配
-
性别：精确匹配
-
入职日期：范围匹配
-- 条件分页查询(分页插件会自动帮我们做分页操作,因此不用写limit)
select *
from emp
where name like concat('%', '?', '%') -- 条件1:根据姓名模糊匹配
and gender = ? -- 条件2:根据性别精准匹配
and entrydate between '?' and '?' -- 条件3:根据入职日期范围查询
order by update_time desc;
而且上述的三个条件，都是可以传递，也可以不传递的，也就是动态的。 我们需要使用前面学习的Mybatis中的动态SQL 。
3.2.2 条件分页查询 - 思路分析
注意：在项目开发当中尽量少使用基本数据类型，而是使用包装类，因为基本类型有默认值！
- 用@DateTimeFormat注解中的pattern属性指定日期时间类型的格式！
3.2.3 功能开发
通过查看接口文档：员工列表查询
请求路径：/emps
请求方式：GET
请求参数：
| 参数名称 | 是否必须 | 示例 | 备注 |
|---|---|---|---|
| name | 否 | 张 | 姓名 |
| gender | 否 | 1 | 性别 , 1 男 , 2 女 |
| begin | 否 | 2010-01-01 | 范围匹配的开始时间(入职日期) |
| end | 否 | 2020-01-01 | 范围匹配的结束时间(入职日期) |
| page | 是 | 1 | 分页查询的页码，如果未指定，默认为1 |
| pageSize | 是 | 10 | 分页查询的每页记录数，如果未指定，默认为10 |
在原有分页查询的代码基础上进行改造：
EmpController
package com.gch.controller;
import com.gch.pojo.PageBean;
import com.gch.pojo.Result;
import com.gch.service.EmpService;
import lombok.extern.slf4j.Slf4j;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.format.annotation.DateTimeFormat;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RequestParam;
import org.springframework.web.bind.annotation.RestController;
import java.time.LocalDate;
/**
员工管理控制器
*/
@Slf4j
@RestController
@RequestMapping("")
public class EmpController {
@Autowired
private EmpService empService;
/**
* 条件分页查询
* @param page 分页查询的页码
* @param pageSize 分页查询的每页展示记录数
* @param name 姓名
* @param gender 性别
* @param begin 入职日期的开始时间
* @param end 入职日期的结束时间
* 默认值的设置可以通过注解@RequestParam中的defaultValue()属性来指定默认值
* 用@DateTimeFormat注解中的pattern属性指定日期时间类型的格式
* 注意:方法签名上的形参变量名需要于接口文档中的请求参数名保持一致
* @return
*/
@GetMapping("/emps")
public Result page(@RequestParam(defaultValue = "1") Integer page,
@RequestParam(defaultValue = "10") Integer pageSize,
String name, Short gender,
@DateTimeFormat(pattern = "yyyy-MM-dd") LocalDate begin,
@DateTimeFormat(pattern = "yyyy-MM-dd") LocalDate end) {
// 记录日志
log.info("条件分页查询,参数:page:{},pageSize:{},name:{},gender:{},begin:{},end:{}",page,pageSize,name,gender,begin,end);
// 调用service分页查询
PageBean pageBean = empService.page(page,pageSize,name,gender,begin,end);
// 响应
return Result.success(pageBean);
}
}
EmpService
package com.gch.service;
import com.gch.pojo.PageBean;
import java.time.LocalDate;
/**
员工业务规则
*/
public interface EmpService {
/**
* 条件分页查询
* @param page => 分页查询的页码
* @param pageSize => 分页查询的每页展示记录数
* @param name => 姓名
* @param gender => 性别
* @param begin => 入职日期的开始时间
* @param end => 入职日期的结束时间
* @return
*/
PageBean page(Integer page, Integer pageSize, String name, Short gender, LocalDate begin, LocalDate end);
}
EmpServiceImpl
package com.gch.service.impl;
import com.gch.mapper.EmpMapper;
import com.gch.pojo.Emp;
import com.gch.pojo.PageBean;
import com.gch.service.EmpService;
import com.github.pagehelper.Page;
import com.github.pagehelper.PageHelper;
import lombok.extern.slf4j.Slf4j;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.stereotype.Service;
import java.time.LocalDate;
import java.util.List;
/**
员工业务实现类
*/
@Slf4j
@Service
public class EmpServiceImpl implements EmpService {
@Autowired
private EmpMapper empMapper;
/**
* 基于PageHelper分页插件实现分页查询
* @param page => 分页查询的页码
* @param pageSize => 分页查询的每页展示记录数
* @param name => 姓名
* @param gender => 性别
* @param begin => 入职日期的开始时间
* @param end => 入职日期的结束时间
* @return
*/
@Override
public PageBean page(Integer page, Integer pageSize, String name, Short gender, LocalDate begin, LocalDate end){
// 1.设置分页参数
PageHelper.startPage(page,pageSize);
// 2.执行条件分页查询
List<Emp> empList = empMapper.list(name,gender,begin,end);
// 获取条件分页查询结果
Page<Emp> p = (Page<Emp>)empList;
// 3.封装PageBean对象并返回
return new PageBean(p.getTotal(),p.getResult());
}
}
EmpMapper
package com.gch.mapper;
import com.gch.pojo.Emp;
import org.apache.ibatis.annotations.Mapper;
import org.apache.ibatis.annotations.Select;
import java.time.LocalDate;
import java.util.List;
/**
员工管理
*/
@Mapper
public interface EmpMapper {
/**
* 基于PageHelper进行员工信息条件分页查询
* 查询条件参数:
* @param name => 姓名
* @param gender => 性别
* @param begin => 入职日期的开始时间
* @param end => 入职日期的结束时间
* @return
*/
public List<Emp> list(String name, Short gender, LocalDate begin, LocalDate end);
}
EmpMapper.xml
<?xml version="1.0" encoding="UTF-8" ?>
<!DOCTYPE mapper
PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN"
"http://mybatis.org/dtd/mybatis-3-mapper.dtd">
<mapper namespace="com.gch.mapper.EmpMapper">
<!-- 动态条件查询操作-->
<select id="list" resultType="com.gch.pojo.Emp">
select id, username, password, name, gender, image, job, entrydate, dept_id, create_time, update_time
from tlias.emp
<where>
<if test="name != null and name != ''">
name like concat('%', #{name}, '%')
</if>
</where>
<if test="gender != null">
and gender = #{gender}
</if>
<if test="begin != null and end != null">
and entrydate between #{begin} and #{end}
</if>
order by update_time desc
</select>
</mapper>
3.2.4 功能测试
功能开发完成后，重启项目工程，打开Postman，发起GET请求：
控制台SQL语句：
3.2.5 前后端联调
打开浏览器，测试后端功能接口：
3.3 删除员工
查询员完成之后，我们继续开发新的功能：删除员工。
3.3.1 需求
当我们勾选列表前面的复选框，然后点击 "批量删除" 按钮，就可以将这一批次的员工信息删除掉了；也可以只勾选一个复选框，仅删除一个员工信息。
问题：我们需要开发两个功能接口吗？一个删除单个员工，一个删除多个员工
答案：不需要。 只需要开发一个功能接口即可（删除多个员工包含只删除一个员工）
- 删除单条记录可以理解为是一种特殊的批量删除，只不过这个批量删除里面只有一个。
3.3.2 接口文档
删除员工
- 基本信息
- 请求参数
参数格式：路径参数
参数说明：
- 响应数据
参数格式：application/json
参数说明：
3.3.3 思路分析
接口文档规定：
前端请求路径：/emps/{ids}
前端请求方式：DELETE
问题1：怎么在controller中接收请求路径中的路径参数？
@PathVariable
问题2：如何限定请求方式是delete？
@DeleteMapping
问题3：在Mapper接口中，执行delete操作的SQL语句时，条件中的id值是不确定的是动态的，怎么实现呢？
Mybatis中的动态SQL：foreach
- 一旦见到路径参数，马上想到@PathVariable注解。
SQL语句：
-- 批量删除
delete from emp where id in(?,?,?);3.3.4 功能开发
通过查看接口文档：删除员工
- 请求路径：/emps/{ids}
- 请求方式：DELETE
- 请求参数：路径参数 {ids}
响应数据：json格式
EmpController
package com.gch.controller;
import com.gch.pojo.PageBean;
import com.gch.pojo.Result;
import com.gch.service.EmpService;
import lombok.extern.slf4j.Slf4j;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.format.annotation.DateTimeFormat;
import org.springframework.web.bind.annotation.*;
import java.time.LocalDate;
import java.util.List;
/**
员工管理控制器
*/
@Slf4j
@RestController
@RequestMapping("/emps")
public class EmpController {
@Autowired
private EmpService empService;
/**
* 条件分页查询
* @param page 分页查询的页码
* @param pageSize 分页查询的每页展示记录数
* @param name 姓名
* @param gender 性别
* @param begin 入职日期的开始时间
* @param end 入职日期的结束时间
* 默认值的设置可以通过注解@RequestParam中的defaultValue()属性来指定默认值
* 用@DateTimeFormat注解中的pattern属性指定日期时间类型的格式
* 注意:方法签名上的形参变量名需要于接口文档中的请求参数名保持一致
* @return
*/
@GetMapping
public Result page(@RequestParam(defaultValue = "1") Integer page,
@RequestParam(defaultValue = "10") Integer pageSize,
String name, Short gender,
@DateTimeFormat(pattern = "yyyy-MM-dd") LocalDate begin,
@DateTimeFormat(pattern = "yyyy-MM-dd") LocalDate end) {
// 记录日志
log.info("条件分页查询,参数:page:{},pageSize:{},name:{},gender:{},begin:{},end:{}",page,pageSize,name,gender,begin,end);
// 调用service分页查询
PageBean pageBean = empService.page(page,pageSize,name,gender,begin,end);
// 响应
return Result.success(pageBean);
}
/**
* 批量删除员工信息
* @param ids 接收前端传递过来的路径参数id数组
* @return
*/
@DeleteMapping("/{ids}")
public Result delete(@PathVariable List<Integer> ids) {
// 记录日志
log.info("批量删除员工,ids:{}",ids);
// 调用service批量删除
empService.delete(ids);
// 响应
return Result.success();
}
}
EmpService
package com.gch.service;
import com.gch.pojo.PageBean;
import java.time.LocalDate;
import java.util.List;
/**
员工业务规则
*/
public interface EmpService {
/**
* 条件分页查询
* @param page => 分页查询的页码
* @param pageSize => 分页查询的每页展示记录数
* @param name => 姓名
* @param gender => 性别
* @param begin => 入职日期的开始时间
* @param end => 入职日期的结束时间
* @return
*/
PageBean page(Integer page, Integer pageSize, String name, Short gender, LocalDate begin, LocalDate end);
/**
* 批量删除员工信息操作
* @param ids 前端传递过来的路径参数id集合
*/
void delete(List<Integer> ids);
}
EmpServiceImpl
package com.gch.service.impl;
import com.gch.mapper.EmpMapper;
import com.gch.pojo.Emp;
import com.gch.pojo.PageBean;
import com.gch.service.EmpService;
import com.github.pagehelper.Page;
import com.github.pagehelper.PageHelper;
import lombok.extern.slf4j.Slf4j;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.stereotype.Service;
import java.time.LocalDate;
import java.util.List;
/**
员工业务实现类
*/
@Slf4j
@Service
public class EmpServiceImpl implements EmpService {
@Autowired
private EmpMapper empMapper;
/**
* 基于PageHelper分页插件实现分页查询
* @param page => 分页查询的页码
* @param pageSize => 分页查询的每页展示记录数
* @param name => 姓名
* @param gender => 性别
* @param begin => 入职日期的开始时间
* @param end => 入职日期的结束时间
* @return
*/
@Override
public PageBean page(Integer page, Integer pageSize, String name, Short gender, LocalDate begin, LocalDate end){
// 1.设置分页参数
PageHelper.startPage(page,pageSize);
// 2.执行条件分页查询
List<Emp> empList = empMapper.list(name,gender,begin,end);
// 获取条件分页查询结果
Page<Emp> p = (Page<Emp>)empList;
// 3.封装PageBean对象并返回
return new PageBean(p.getTotal(),p.getResult());
}
/**
* 批量删除员工信息
* @param ids 前端传递过来的路径参数id集合
*/
@Override
public void delete(List<Integer> ids) {
empMapper.deleteById(ids);
}
}
EmpMapper
package com.gch.mapper;
import com.gch.pojo.Emp;
import org.apache.ibatis.annotations.Mapper;
import org.apache.ibatis.annotations.Select;
import java.time.LocalDate;
import java.util.List;
/**
员工管理
*/
@Mapper
public interface EmpMapper {
/**
* 基于PageHelper进行员工信息条件分页查询
* 查询条件参数:
* @param name => 姓名
* @param gender => 性别
* @param begin => 入职日期的开始时间
* @param end => 入职日期的结束时间
* @return
*/
public List<Emp> list(String name, Short gender, LocalDate begin, LocalDate end);
/**
* 批量删除员工信息
* @param ids 前端传递过来的路径参数id集合
*/
void deleteById(List<Integer> ids);
}
EmpMapper.xml
<?xml version="1.0" encoding="UTF-8" ?>
<!DOCTYPE mapper
PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN"
"http://mybatis.org/dtd/mybatis-3-mapper.dtd">
<mapper namespace="com.gch.mapper.EmpMapper">
<!-- 动态条件查询操作-->
<select id="list" resultType="com.gch.pojo.Emp">
select id, username, password, name, gender, image, job, entrydate, dept_id, create_time, update_time
from tlias.emp
<where>
<if test="name != null and name != ''">
name like concat('%', #{name}, '%')
</if>
</where>
<if test="gender != null">
and gender = #{gender}
</if>
<if test="begin != null and end != null">
and entrydate between #{begin} and #{end}
</if>
order by update_time desc
</select>
<!-- 批量删除操作 (?,?,?)-->
<delete id="deleteById">
delete from emp where id in
<foreach collection="ids" item="id" separator="," open="(" close=")">
#{id}
</foreach>
</delete>
</mapper>
3.3.5 功能测试
功能开发完成后，重启项目工程，打开Postman，发起DELETE请求：
控制台SQL语句：
3.3.6 前后端联调
打开浏览器，测试后端功能接口：
![java八股文面试[java基础]——异常](https://img-blog.csdnimg.cn/c0a4aea23c394ca6aa3085108a5c508d.png)