目录
5.3、代码完善(将long型数据统一转为String字符串)
3、新增员工信息
3.1、需求分析
--后台系统中可以管理员工信息,通过新增员工来添加后台系统用户。从数据库表中得知唯一约束(主键)为username,其必须是唯一的。
1、根据产品原型明确业务需求
2、重点分析数据的流转过程和数据格式
3、通过debug断点调试跟踪程序执行过程
3.2、代码实现
--根据前端调试结果得:请求路径,方式,和参数。然后在后端controller中编写添加方法。
--操作如下:
根据前端请求的employee内容知:缺密码和CreateUser UpdateUser,密码直接set默认值,CreateUser UpdateUser通过request来获取。
/**
* 新增员工
* @param employee
* @return
*/
@PostMapping
public R<String> save(HttpServletRequest request,@RequestBody Employee employee){
//因password,createTime,updateTime,createUser,updateUser均为空,所以需在后端设置
log.info("新增员工,信息为:{}",employee.toString());
//设置默认密码
employee.setPassword(DigestUtils.md5DigestAsHex("123456".getBytes()));
//设置createTime,updateTime为当前系统时间
employee.setCreateTime(LocalDateTime.now());
employee.setUpdateTime(LocalDateTime.now());
//createUser,updateUser创建/修改人为当前用户--bigint类型 所以应为id
long empId = (long) request.getSession().getAttribute("employee");
employee.setCreateUser(empId);
employee.setUpdateUser(empId);
//employeeService调用添加方法
employeeService.save(employee);
return R.success("添加用户成功");
}
3.3、代码完善(异常捕获)
--在新增员工时输入的账号已经存在,由于employee表中对该字段加入了唯一约束,此时程序会抛出异常:
java.sql.SQLIntegrityConstraintViolationException: Duplicate entry 'heniang' for key 'idx_username'
--对于此异常,我们采用异常处理器进行全局异常捕获。
操作如下:
@RestControllerAdvice注解是用来指定捕获哪里出现的异常 @ExceptionHandler指定异常类型,然后通过形参进行捕获
@RestControllerAdvice(annotations = {RestController.class, Controller.class})
@ResponseBody
@Slf4j
public class GlobalExceptionHandler{
//指定异常类型
@ExceptionHandler(SQLIntegrityConstraintViolationException.class)
//获取异常
public R<String> exceptionHandler(SQLIntegrityConstraintViolationException ex){
log.info(ex.getMessage());
//处理异常
if (ex.getMessage().contains("Duplicate entry")){ //确定异常信息是否包含Duplicate entry,把异常具体化处理
String[] split = ex.getMessage().split(" "); //以空格为标准截取信息,放到数组中
String msg = split[2] + "已存在"; //选取第三条信息输出
return R.error(msg);
}
return R.error("存在异常");
}
}
4、员工信息分页查询
4.1、需求分析
一般情况需要展示的信息很多,系统中都会以分页的方式来展示列表数据。
4.2、代码开发
--在开发代码之前,需要梳理一下整个程序的执行过程:
- 页面发送ajax请求,将分页查询参数(page、pageSize、name)提交到服务端
- 服务端Controller接收页面提交的数据并调用Service查询数据
- Service调用Mapper操作数据库,查询分页数据
- Controller将查询到的分页数据响应给页面
- 页面接收到分页数据并通过ElementUI的Table组件(前端内容)展示到页面
--配置MP分页拦截器
/**
* 创建拦截器,用于添加分页拦截器
*/
@Configuration
public class MybatisPlusConfig {
@Bean
public MybatisPlusInterceptor mybatisPlusInterceptor(){
MybatisPlusInterceptor mpInterceptor = new MybatisPlusInterceptor();
mpInterceptor.addInnerInterceptor(new PaginationInnerInterceptor());
return mpInterceptor;
}
}
--controller方法中编写分页查询方法(参数(page、pageSize、name)由客户端提交到服务器)
其中page和pageSize分别为当前页码和页码显示条数、name为查询另加条件,用LambdaQueryWrapper实现查询,查询结束后通过修改时间排序在客户端进行展示。
/**
* 分页查询
* @param page
* @param pageSize
* @param name
* @return
*/
@GetMapping("/page")
public R<Page> page(int page,int pageSize,String name){
log.info("请求查询page{},pageSize{},name{}",page,pageSize,name);
//创建分页构造器
Page pageInfo = new Page (page,pageSize);
//创建查询构造器
LambdaQueryWrapper<Employee> qw = new LambdaQueryWrapper<>();
//添加查询条件
qw.like(StringUtils.isNotEmpty(name),Employee::getName,name);
//添加排序条件
qw.orderByDesc(Employee::getCreateTime);
//执行分页查询
employeeService.page(pageInfo,qw);
//返回查询信息到客户端
return R.success(pageInfo);
}
5、启用/禁用员工账号
5.1、需求分析
--在员工管理列表页面,可以对某个员工账号进行启用或者禁用操作。账号禁用的员工不能登录系统,启用后的员工可以正常登录。
--需要注意,只有管理员(admin用户)可以对其他普通用户进行启用、禁用操作,所以普通用户登录系统后启用、禁用按钮不显示。
5.2、代码开发
在开发代码之前,需要梳理一下整个程序的执行过程:
1、页面发送ajax请求,将参数(id、 status)提交到服务端
2、服务端Controller接收页面提交的数据并调用Service更新数据
3、Service调用Mapper操作数据库(修改状态码操作在前端代码已实现)
--操作如下:
/**
* 修改员工信息--将员工状态设为禁用或者启用(前端逻辑已写,我们在此处仅需修改更新时间和人)
* @param request
* @param employee
* @return
*/
@PutMapping
public R<String> update(HttpServletRequest request,@RequestBody Employee employee){
log.info(employee.toString());
long empId = (long) request.getSession().getAttribute("employee");
employee.setUpdateTime(LocalDateTime.now());
employee.setUpdateUser(empId);
employeeService.updateById(employee);
return R.success("修改成功");
}
5.3、代码完善(将long型数据统一转为String字符串)
--分析:
分页查询时服务端响应给页面的数据中id的值为19位数字,类型为long,页面中js处理long型数字只能精确到前16位,所以最终通过ajax请求提交给服务端的时候id就改变了
js对long型数据进行处理时丢失精度,导致提交的id和数据库中的id不一致。
解决方案:在服务端给页面响应json数据时进行处理,将long型数据统一转为String字符串。
--操作如下:
提供对象转换器JacksonobjectMapper,基于Jackson进行Java对象到json数据的转换
代码是事先给好的,此对象映射器应该不需自己写
/**
* 对象映射器:基于jackson将Java对象转为json,或者将json转为Java对象
* 将JSON解析为Java对象的过程称为 [从JSON反序列化Java对象]
* 从Java对象生成JSON的过程称为 [序列化Java对象到JSON]
*/
public class JacksonObjectMapper extends ObjectMapper {
public static final String DEFAULT_DATE_FORMAT = "yyyy-MM-dd";
public static final String DEFAULT_DATE_TIME_FORMAT = "yyyy-MM-dd HH:mm:ss";
public static final String DEFAULT_TIME_FORMAT = "HH:mm:ss";
public JacksonObjectMapper() {
super();
//收到未知属性时不报异常
this.configure(FAIL_ON_UNKNOWN_PROPERTIES, false);
//反序列化时,属性不存在的兼容处理
this.getDeserializationConfig().withoutFeatures(DeserializationFeature.FAIL_ON_UNKNOWN_PROPERTIES);
SimpleModule simpleModule = new SimpleModule()
.addDeserializer(LocalDateTime.class, new LocalDateTimeDeserializer(DateTimeFormatter.ofPattern(DEFAULT_DATE_TIME_FORMAT)))
.addDeserializer(LocalDate.class, new LocalDateDeserializer(DateTimeFormatter.ofPattern(DEFAULT_DATE_FORMAT)))
.addDeserializer(LocalTime.class, new LocalTimeDeserializer(DateTimeFormatter.ofPattern(DEFAULT_TIME_FORMAT)))
.addSerializer(BigInteger.class, ToStringSerializer.instance)
.addSerializer(Long.class, ToStringSerializer.instance)
.addSerializer(LocalDateTime.class, new LocalDateTimeSerializer(DateTimeFormatter.ofPattern(DEFAULT_DATE_TIME_FORMAT)))
.addSerializer(LocalDate.class, new LocalDateSerializer(DateTimeFormatter.ofPattern(DEFAULT_DATE_FORMAT)))
.addSerializer(LocalTime.class, new LocalTimeSerializer(DateTimeFormatter.ofPattern(DEFAULT_TIME_FORMAT)));
//注册功能模块 例如,可以添加自定义序列化器和反序列化器
this.registerModule(simpleModule);
}
}
在WebMvcConfig配置类中扩展Spring mvc的消息转换器,在此消息转换器中使用提供的对象转换器进行Java对象到json数据的转换
/**
* 扩展mvc框架的消息转换器
* @param converters
*/
@Override
protected void extendMessageConverters(List<HttpMessageConverter<?>> converters) {
log.info("扩展消息转换器");
//创建消息转换器对象
MappingJackson2HttpMessageConverter messageConverter = new MappingJackson2HttpMessageConverter();
//设置对象转换器,底层使用Jackson将Java对象转为json
messageConverter.setObjectMapper(new JacksonObjectMapper());
//将上面的消息转换器对象追加到mvc框架的转换器集合中,索引为0时 优先使用自定义消息转换器
converters.add(0,messageConverter);
}
6、编辑员工信息
6.1、需求分析
在员工管理列表页面点击编辑按钮,跳转到编辑页面,在编辑页面回显员工信息并进行修改,最后点击保存按钮完成编辑操作
6.2、代码开发
--在开发代码之前需要梳理一下操作过程和对应的程序的执行流程:
页面回显-保存直接自动提交(直接使用上一个功能进行更改用户信息)
1、点击编辑按钮时,页面跳转到add.html,并在url中携带参数[员工id]
2、在add.html页面获取url中的参数[员工id]
3、发送ajax请求,请求服务端,同时提交员工id参数
4、服务端接收请求,根据员工id查询员工信息,将员工信息以json形式响应给页面
--操作如下:
-回显:根据客户端返回的id值进行查询,然后返回查询到的信息
/**
* 修改员工信息
* @param id
* @return
*/
@GetMapping("/{id}")
public R<Employee> update(@PathVariable long id){
log.info("根据id查询用户信息,进行回显员工信息");
Employee employee = employeeService.getById(id);
return R.success(employee);
}
5、页面接收服务端响应的json数据,通过VUE的数据绑定进行员工信息回显
6、点击保存按钮,发送ajax请求,将页面中的员工信息以json方式提交给服务端
7、服务端接收员工信息,并进行处理,完成后给页面响应
8、页面接收到服务端响应信息后进行相应处理
-点击保存:因add.html页面为公共页面,新增员工和编辑员工都是在此页面操作,所以该代码部分与之前添加员工代码对应,不需要重写。