文章目录
- 一、新增员工
- 1.1、需求分析
- 1.2、数据模型
- 1.3、代码开发
- 二、员工信息分页查询
- 2.1、需求分析
- 2.2、代码开发
- 2.3、分页插件
- 2.4、员工信息分页查询
- 三、启用/禁用员工账号
- 3.1、需求分析
- 3.2、代码开发
- 3.3、根据id修改员工信息
- 3.4、代码修复
- 4、编辑员工信息
- 4.1、功能需求
- 4.2、代码开发
- 总结
一、新增员工
1.1、需求分析
后台系统中可以管理员工信息,通过新增员工来添加后台系统用户。点击 添加员工 按钮跳转到新增页面,如下:
1.2、数据模型
新增员工,其实就是将我们新增页面录入的员工数据插入到employee表。需要注意,employee表中对username字段加入了唯一约束,因为username是员工的登录账号,必须是唯一的
1.3、代码开发
在开发代码之前,需要梳理一下整个程序的执行过程:
页面发送ajax请求,将新增员工页面中输入的数据以json的形式提交到服务端
服务端Controller接收页面提交的数据并调用Service将数据进行保存
Service调用Mapper操作数据库,保存数据
这里需要注意表中的设置时间等字段不是在前端页面输入,需要我们自己加入表中。
踩坑
这里用的mybatis-x生成的实体类employee中的createTime与setUpdateTime是Data类型 我们需要手动修改为LocalDateTime类型
//新增员工@PostMappingpublic R<String> save(@RequestBody Employee employee,HttpServletRequest request){log.info("新增员工,员工信息:{}",employee.toString());//设置初始密码,需要进行MD5加密处理employee.setPassword(DigestUtils.md5DigestAsHex("123456".getBytes()));
// //设置时间
// employee.setCreateTime(LocalDateTime.now());
// employee.setUpdateTime(LocalDateTime.now());
//
// //获得当前登录用户的id
// Long empId = (Long) request.getSession().getAttribute("employee");
//
// employee.setCreateUser(empId);
// employee.setUpdateUser(empId);employeeService.save(employee);return R.success("新增员工成功");}
新增员工编写完成,但是如果新增的用户名是一致的则会报错,因为在数据库表中给该字段添加了唯一性约束
我们可以通过try-catch来解决 但是这一类的类型我们都可以使用异常处理器来统一管理,来减少代码冗余
@ControllerAdvice
指定要拦截的类 RestController.class, Controller.class 这就是指定拦截有RestController与Controller注解的类
@ControllerAdvice(annotations = {RestController.class, Controller.class})
@ResponseBody
@Slf4j
public class GlobalExceptionHandler {//进行异常处理方法@ExceptionHandler(SQLIntegrityConstraintViolationException.class)public R<String> exceptionHandler(SQLIntegrityConstraintViolationException ex){log.error(ex.getMessage());if(ex.getMessage().contains("Duplicate entry")){String[] split = ex.getMessage().split(" ");String msg=split[2]+"已存在";return R.error(msg);}return R.error("未知错误");}
}
二、员工信息分页查询
2.1、需求分析
系统中的员工很多的时候,如果在一个页面中全部展示出来会显得比较乱,不便于查看,所以一般的系统中都会以分页的方式来展示列表数据。
2.2、代码开发
在开发代码之前,需要梳理一下整个程序的执行过程:
页面发送ajax请求,将分页查询参数(page.pageSize、name)提交到服务端
服务端Controller接收页面提交的数据并调用Service查询数据
Service调用Mapper操作数据库,查询分页数据
Controller将查询到的分页数据响应给页面
页面接收到分页数据并通过ElementUI的Table组件展示到页面上
2.3、分页插件
首先要配置mybatis-plus中的分页插件
@Configuration
public class MybaitsPlusConfig {@Beanpublic MybatisPlusInterceptor mybatisPlusInterceptor(){MybatisPlusInterceptor mybatisPlusInterceptor=new MybatisPlusInterceptor();mybatisPlusInterceptor.addInnerInterceptor(new PaginationInnerInterceptor());return mybatisPlusInterceptor;}}
2.4、员工信息分页查询
注意 按照逻辑admin用户不应该出现在这个页面被修改 所以我们需要添加条件queryWrapper.ne(Employee::getUsername,“admin”);
将用户名为admin的用户排除
//员工信息分页查询@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> queryWrapper=new LambdaQueryWrapper();//添加过虑条件queryWrapper.like(StringUtils.isNotEmpty(name),Employee::getName,name);//添加排序条件queryWrapper.orderByDesc(StringUtils.isNotEmpty(name),Employee::getUpdateTime);queryWrapper.ne(Employee::getUsername,"admin");//执行查询employeeService.page(pageinfo,queryWrapper);return R.success(pageinfo);}
效果展示
三、启用/禁用员工账号
3.1、需求分析
在员工管理列表页面,可以对某个员工账号进行启用或者禁用操作。账号禁用的员工不能登录系统,启用后的员工可以正常登录。
需要注意,只有管理员(admin用户)可以对其他普通用户进行启用、禁用操作,所以普通用户登录系统后启用、禁用按钮不显示。
3.2、代码开发
前端页面中是怎么做到只有管理员admin能够看到启用、禁用按钮的?
可以看到这里首先通过localStorage,getItem获取了浏览器中员工的账号信息并赋值, 然后通过v-if判断该用户是否为admin是则展示否则不展示
程序的执行过程
1、页面发送ajax请求,将参数(id、 status)提交到服务端
2、服务端Controller接收页面提交的数据并调用Service更新数据
3、Service调用Mapper操作数据库
页面中的ajax请求是如何发送的?
可以看到这里在点击编辑之后会跳转到statusHandle方法 ,在弹出的界面中点击确定则会执行then中方法 会将id与status动态传给后端
然后根据后端返回来进行下一步操作
3.3、根据id修改员工信息
@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("员工信息修改成功");
}
测试过程中没有报错,但是功能并没有实现,查看数据库中的数据也没有变化。观察控制台输出的SQL:
SQL执行的结果是更新的数据行数为0,仔细观察id的值,和数据库中对应记录的id值并不相同
3.4、代码修复
通过观察控制台输出的SQL发现页面传递过来的员工id的值和数据库中的id值不一致,这是怎么回事呢?
分页查询时服务端响应给页面的数据中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数据的转换
@Override
protected void extendMessageConverters(List<HttpMessageConverter<?>> converters) {//创建消息转换器MappingJackson2HttpMessageConverter messageConverter = new MappingJackson2HttpMessageConverter();//设置对象转换器,底层使用Jackson将Java转换为jsonmessageConverter.setObjectMapper(new JacksonObjectMapper());//将上面的消息转换器对象追加到mvc框架的转换器集合中converters.add(0,messageConverter);super.extendMessageConverters(converters);
}
这里要注意我们使用add方法是需要加一个索引0,是我们添加的转换器优先级为最高。
4、编辑员工信息
4.1、功能需求
在员工管理列表页面点击编辑按钮,跳转到编辑页面,在编辑页面回显员工信息并进行修改,最后点击保存按钮完成编辑操作
4.2、代码开发
1、点击编辑按钮时,页面跳转到add.html,并在url中携带参数[员工id]
2、在add.html页面获取url中的参数[员工id]
3、发送ajax请求,请求服务端,同时提交员工id参数
4、服务端接收请求,根据员工id查询员工信息,将员工信息以json形式响应给页面(这样就能让编辑页面拥有初始数据)
//根据id查询员工信息
@GetMapping("/{id}")
public R<Employee> getById(@PathVariable String id){log.info("根据id查对象");Employee emp = employeeService.getById(id);if(emp!=null){return R.success(emp);}return R.error("没有查询到该用户信息");
}
5、页面接收服务端响应的json数据,通过VUE的数据绑定进行员工信息回显
6、点击保存按钮,发送ajax请求,将页面中的员工信息以json方式提交给服务端
7、服务端接收员工信息,并进行处理,完成后给页面响应
8、页面接收到服务端响应信息后进行相应处理
注意:add.html页面为公共页面,新增员工和编辑员工都是在此页面操作,所以该代码部分与之前添加员工代码对应,不需要重写。
总结
day2完成的是新增员工与员工信息的编辑功能主要学习到的有
1、当程序出现某一类异常时,如何进行统一管理
2、分页插件的配置与使用
3、js对long型数据进行处理时丢失精度该如何处理