1. 员工账号状态管理
1.1 需求分析
在员工管理列表页面,可以对某个员工账号进行启用或者禁用操作。账号禁用的员工不能登录系统,启用后的员工可以正常登录。如果某个员工账号状态为正常,则按钮显示为 "禁用",如果员工账号状态为已禁用,则按钮显示为"启用"。
只有管理员(admin用户)可以对其他普通用户进行启用、禁用操作,普通用户登录系统后启用、禁用按钮不显示。
A. admin 管理员登录
B. 普通用户登录
1.2 程序执行流程
1.2.1 页面按钮动态展示
只有管理员(admin用户)可以对其他普通用户进行启用、禁用操作,所以普通用户登录系统后启用、禁用按钮不显示:
1). 在列表页面(list.html)加载时, 触发钩子函数created, 在钩子函数中, 会从localStorage中获取到用户登录信息, 然后获取到用户名
2). 在页面中, 通过Vue指令v-if进行判断,如果登录用户为admin将展示 启用/禁用 按钮, 否则不展示
1.2.2 执行流程分析
1). 当管理员admin点击 "启用" 或 "禁用" 按钮时, 调用方法statusHandle
scope.row : 获取到的是这一行的数据信息 ;
2). statusHandle方法中进行二次确认, 然后发起ajax请求, 传递id、status参数
最终发起异步请求, 请求服务端, 请求信息如下:
请求 | 说明 |
---|---|
请求方式 | PUT |
请求路径 | /employee |
请求参数 | {"id":xxx,"status":xxx} |
{...params} : 三点是ES6中出现的扩展运算符。作用是遍历当前使用的对象能够访问到的所有属性,并将属性放入当前对象中。
1.3 员工账号状态管理程序流程
A.页面发送ajax请求,将参数(id、status)提交到服务端
B. 服务端Controller接收页面提交的数据并调用Service更新数据
C. Service调用Mapper操作数据库
1.4 员工账号状态管理代码实现
启用、禁用员工账号,本质即对status状态字段进行更新操作。在Controller中创建update方法,此方法是一个通用的修改员工信息的方法。
package com.itheima.reggie.controller;import com.baomidou.mybatisplus.core.conditions.query.LambdaQueryWrapper;
import com.baomidou.mybatisplus.extension.plugins.pagination.Page;
import com.itheima.reggie.common.R;
import com.itheima.reggie.entity.Employee;
import com.itheima.reggie.service.EmployeeService;
import lombok.extern.slf4j.Slf4j;
import org.apache.commons.lang.StringUtils;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.util.DigestUtils;
import org.springframework.web.bind.annotation.*;import javax.servlet.http.HttpServletRequest;
import java.time.LocalDateTime;@Slf4j
@RestController
@RequestMapping("/employee")
public class EmployeeController {@Autowiredprivate EmployeeService employeeService;@PostMapping("/login")public R<Employee> login(HttpServletRequest request, @RequestBody Employee employee){/**@Description: 员工登陆* @param @RequestBody 传入的是json 故需要将其转化为实体类,json中的类名与实体类名对应才可以封装* A. 由于需求分析时, 我们看到前端发起的请求为post请求, 所以服务端需要使用注解 @PostMapping* B. 由于前端传递的请求参数为json格式的数据, 这里使用Employee对象接收, 但是将json格式数据封装到实体类中, 在形参前需要加注解@RequestBody* @return com.itheima.reggie.common.R<com.itheima.reggie.entity.Employee>* @version v1.0* @author LiBiGo* @date 2022/8/12 11:32*/// ①. 将页面提交的密码password进行md5加密处理, 得到加密后的字符串String password = employee.getPassword();password = DigestUtils.md5DigestAsHex(password.getBytes());// ②. 根据页面提交的用户名username查询数据库中员工数据信息LambdaQueryWrapper<Employee> queryWrapper = new LambdaQueryWrapper<>();queryWrapper.eq(Employee::getUsername,employee.getUsername());Employee emp = employeeService.getOne(queryWrapper); //在数据库中用户名是唯一的,所以可以用getone()// ③. 如果没有查询到, 则返回登录失败结果if (emp == null){return R.error("用户名不存在");}// ④. 密码比对,如果不一致, 则返回登录失败结果if(!emp.getPassword().equals(password)){return R.error("密码失败");}// ⑤. 查看员工状态,如果为已禁用状态,则返回员工已禁用结果if(emp.getStatus() == 0){return R.error("账户已禁用");}// ⑥. 登录成功,将员工id存入Session, 并返回登录成功结果request.getSession().setAttribute("employee",emp.getId());return R.success(emp);}@PostMapping("/logout")public R<String> logout(HttpServletRequest request){/**@Description: /employee/logout 员工退出* @author LiBiGo* @date 2022/8/12 12:09*/// 清理Session中保存的当前登录员工的idrequest.getSession().removeAttribute("employee");// 返回结果return R.success("退出成功");}@PostMappingpublic R<String> save(HttpServletRequest request,@RequestBody Employee employee){/**@Description: 用于保存用户员工信息。** B. 在组装员工信息时, 还需要封装创建时间、修改时间,创建人、修改人信息(从session中获取当前登录用户)。* @author LiBiGo* @date 2022/8/12 17:25*/log.info("新增员工,员工信息:{}",employee.toString());// A. 在新增员工时,设置初始密码,需要进行MD5加密处理employee.setPassword(DigestUtils.md5DigestAsHex("123456".getBytes()));// B. 在组装员工信息时, 需封装创建时间、修改时间,创建人、修改人信息(从session中获取当前登录用户)。employee.setCreateTime(LocalDateTime.now());employee.setUpdateTime(LocalDateTime.now());//获得当前登录员工用户的idLong empId = (Long) request.getSession().getAttribute("employee");employee.setCreateUser(empId); // 创建员工信息的人employee.setUpdateUser(empId); // 最后一次更新信息的人employeeService.save(employee); // 因为employeeService继承了,所以不用写,直接用log.info("新增员工成功");return R.success("新增员工成功");}@GetMapping("page")public R<Page> page(int page,int pageSize,String name){/**@Description: 员工分页查询* @param page 当前查询页码* @param pageSize 每页展示记录数* @param name 员工姓名 - 可选参数* @author LiBiGo* @date 2022/8/13 9:51*/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); // 当name不为null,则进行添加过滤//排序条件queryWrapper.orderByDesc(Employee::getUpdateTime);//执行查询employeeService.page(pageInfo,queryWrapper); //结果自动放入 pageInfo,不需要传参return R.success(pageInfo);}@PutMappingpublic R<String> update(HttpServletRequest request,@RequestBody Employee employee){/**@Description: 根据id修改员工信息,传入员工的所有信息,再根据员工id进行数据库的替换* @author LiBiGo* @date 2022/8/13 10:53*/log.info("更新的用户信息{}",employee.toString()); // 传入的Long empId = (Long)request.getSession().getAttribute("employee"); //获取emp的idemployee.setUpdateTime(LocalDateTime.now()); //设置更新时间employee.setUpdateUser(empId); // 设置更新人employeeService.updateById(employee);return R.success("员工信息修改成功");}}
1.5 功能测试
重启工程,访问前端页面, 进行 "启用" 或 "禁用" 的测试。
测试过程中没有报错,但是功能并没有实现,查看数据库中的数据也没有变化。但是从控制台输出的日志, 可以看出确实没有更新成功。
而在我们的数据库表结构中, 并不存在该ID, 数据库的ID为1420038345634918401
2 对象转换器+扩展Spring mvc的消息转换器
2.1 原因分析
2.1.1 现象
通过观察控制台输出的SQL发现页面传递过来的员工id的值和数据库中的id值不一致
在分页查询时,服务端会将返回的R对象进行json序列化,转换为json格式的数据,而员工的ID是一个Long类型的数据,而且是一个长度为 19 位的长整型数据, 该数据返回给前端是没有问题的。
2.1.2 具体的问题原因
前端JS对长度较长的长整型数据进行处理时,会损失精度,从而导致提交的id和数据库中的id不一致。
2.1.3 解决方案
解决方案:将js处理的ID数据类型转为字符串类型, 这样不损失精度。
在业务中, 让分页查询返回的json格式数据库中long类型的属性, 不直接转换为数字类型, 而转换为字符串类型就可以解决这个问题 , 最终返回的结果为 :
2.2 代码修复
由于在SpringMVC中, 将Controller方法返回值转换为json对象, 是通过jackson来实现的, 涉及到SpringMVC中的一个消息转换器MappingJackson2HttpMessageConverter, 因此需要对该消息转换器的功能进行拓展。
2.2.1 具体实现步骤:
1). 提供对象转换器JacksonObjectMapper,基于Jackson进行Java对象到json数据的转换
2). 在WebMvcConfig配置类中扩展Spring mvc的消息转换器,在此消息转换器中使用提供的对象转换器进行Java对象到json数据的转换
1). 引入JacksonObjectMapper
package com.itheima.reggie.common;import com.fasterxml.jackson.databind.DeserializationFeature;
import com.fasterxml.jackson.databind.ObjectMapper;
import com.fasterxml.jackson.databind.module.SimpleModule;
import com.fasterxml.jackson.databind.ser.std.ToStringSerializer;
import com.fasterxml.jackson.datatype.jsr310.deser.LocalDateDeserializer;
import com.fasterxml.jackson.datatype.jsr310.deser.LocalDateTimeDeserializer;
import com.fasterxml.jackson.datatype.jsr310.deser.LocalTimeDeserializer;
import com.fasterxml.jackson.datatype.jsr310.ser.LocalDateSerializer;
import com.fasterxml.jackson.datatype.jsr310.ser.LocalDateTimeSerializer;
import com.fasterxml.jackson.datatype.jsr310.ser.LocalTimeSerializer;
import java.math.BigInteger;
import java.time.LocalDate;
import java.time.LocalDateTime;
import java.time.LocalTime;
import java.time.format.DateTimeFormatter;
import static com.fasterxml.jackson.databind.DeserializationFeature.FAIL_ON_UNKNOWN_PROPERTIES;/*** 对象映射器:基于jackson将Java对象转为json,或者将json转为Java对象* 将JSON解析为Java对象的过程称为 [从JSON反序列化Java对象]* 从Java对象生成JSON的过程称为 [序列化Java对象到JSON]* * 该自定义的对象转换器, 主要指定在进行json数据序列化及反序列化时, LocalDateTime、LocalDate、LocalTime的处理方式, * 以及BigInteger及Long类型数据,直接转换为字符串。*/
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) // 将long转化为string,可以解决前端页面不能正确显示超过固定尾位数的数字.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);}
}
2). 在WebMvcConfig中重写方法extendMessageConverters
package com.itheima.reggie.config;import com.itheima.reggie.common.JacksonObjectMapper;
import lombok.extern.slf4j.Slf4j;
import org.springframework.context.annotation.Configuration;
import org.springframework.http.converter.HttpMessageConverter;
import org.springframework.http.converter.json.MappingJackson2HttpMessageConverter;
import org.springframework.web.servlet.config.annotation.ResourceHandlerRegistry;
import org.springframework.web.servlet.config.annotation.WebMvcConfigurationSupport;import java.util.List;//配置类
@Slf4j
@Configuration
public class WebMvcConfig extends WebMvcConfigurationSupport {/**@Description: 设置静态资源的映射* @param * @return* @version v1.0* @author LiBiGo* @date 2022/8/11 23:41*/@Overrideprotected void addResourceHandlers(ResourceHandlerRegistry registry) {log.info("静态资源开始映射......");registry.addResourceHandler("/backend/**").addResourceLocations("classpath:/backend/");registry.addResourceHandler("/front/**").addResourceLocations("classpath:/front/");log.info("静态资源映射成功");}@Overrideprotected void extendMessageConverters(List<HttpMessageConverter<?>> converters) {/**@Description: 扩展mvc框架的消息转换器,项目启动时即调用,* @author LiBiGo* @date 2022/8/13 11:16*/log.info("扩展消息转换器...");// 创建消息转换器MappingJackson2HttpMessageConverter messageConverter = new MappingJackson2HttpMessageConverter();// 设置对象转换器,底层使用将jackson将java对象转化为jsonmessageConverter.setObjectMapper(new JacksonObjectMapper());// 将上面的消息转化器对象追加到mvc的转化器集合中converters.add(0,messageConverter); // 将我们的转化器放在最前面,实现优先使用}
}