新增员工
需求分析
需求 |
---|
点击新增员工,可以输入员工信息,并将信息保存到员工表中 |
设置员工初始密码为123456 |
员工的账号唯一,如果添加相同账号会报异常,系统需要处理这个异常 |
代码开发
步骤 | 过程 |
---|---|
1 | 页面发送ajax请求,将新增页面数据以json形式提交到服务端 |
2 | 服务端controller接收请求,调用service进行数据的保存 |
3 | service调用mapper操作数据库 |
4 | 如果发生唯一冲突异常,调用异常处理器,返回错误信息 |
EmployeeController.java
/**
* 新增员工
* @return 返回result类
*/
@PostMapping
public Result addEmployee(HttpServletRequest request,@RequestBody Employee employee){
//获取创建和更新的用户的id
Long empId = (Long) request.getSession().getAttribute("employee");
//传入service进行添加操作
boolean flag = employeeService.addEmployee(employee,empId);
//根据返回的flag注入code和msg的值
Integer code = flag?Code.OK:Code.ERR;
String msg = flag?"添加成功":"添加失败";
return new Result(code,msg);
}
EmployeeService.java
/**
* 新增员工
* @param employee
* @return
*/
public boolean addEmployee(Employee employee,Long id);
EmployeeServiceImpl.java
/**
* TODO 新增员工
* @param employee
* @return
*/
@Override
public boolean addEmployee(Employee employee, Long id) {
//为要添加的用户注入数据
//注入添加用户的人的id
employee.setCreateUser(id);
employee.setUpdateUser(id);
//设置创建时间
employee.setCreateTime(LocalDateTime.now());
employee.setUpdateTime(LocalDateTime.now());
//设置初始密码123456并加密,并重新注入
String password = DigestUtils.md5DigestAsHex("123456".getBytes());
employee.setPassword(password);
int insert = employeeMapper.insert(employee);
//insert>0代表添加成功,等于0代表添加失败
return insert>0;
}
GlobalExecptionHandler.java(全局异常处理器)
这里的这种实现方法,耦合度过高,个人认为不妥,之后会进行优化
package com.cjgn.contorller;
import lombok.extern.slf4j.Slf4j;
import org.springframework.web.bind.annotation.ExceptionHandler;
import org.springframework.web.bind.annotation.RestControllerAdvice;
import java.sql.SQLIntegrityConstraintViolationException;
/**
* 全局异常处理器
*/
@RestControllerAdvice
@Slf4j
public class GlobalExecptionHandler {
/**
* 异常处理方法
* @param ex
* @return
*/
@ExceptionHandler(SQLIntegrityConstraintViolationException.class)
public Result doExecption(SQLIntegrityConstraintViolationException ex){
//输出异常信息
log.error(ex.getMessage());
String msg;
//如果异常信息里包含'Duplicate entry'
if(ex.getMessage().contains("Duplicate entry")){
//提取出信息中的按空格分隔后的第三个字符串,也就是账号信息
String[] split = ex.getMessage().split(" ");
//提示信息为' '+已存在
msg = split[2]+"已存在";
}else {
//否则是未知错误
msg = "未知错误";
}
//返回一个Result全局对象
return new Result(Code.ERR,msg);
}
}
员工信息分页查询
需求分析
需求 |
---|
在主页中,员工的信息以分页的形式展现列表数据 |
可以通过修改每页的展示条数来改变数据的数量 |
可以更换页数,或者直接输入页数来跳转某一页数据 |
代码开发
步骤 | 过程 |
---|---|
1 | 页面发送ajax请求,将(page,pageSize,name)等信息发送到服务端 |
2 | 服务端Controller接收请求并调用Service查询 |
3 | Service调用Mapper查询 |
4 | Controller将查询的数据返回给页面 |
5 | 页面接收数据并通过ElementUI的Table组件展示到页面 |
config包下创建MpConfig
类
MpConfig.java
package com.cjgn.config;
import com.baomidou.mybatisplus.extension.plugins.MybatisPlusInterceptor;
import com.baomidou.mybatisplus.extension.plugins.inner.PaginationInnerInterceptor;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
/**
* 配置MybatisPlus的拦截器功能
*/
@Configuration
public class MpConfig {
@Bean
public MybatisPlusInterceptor mpInterceptor(){
//定义MybatisPlus拦截器
MybatisPlusInterceptor mpInterceptor = new MybatisPlusInterceptor();
//添加分页功能的拦截器
mpInterceptor.addInnerInterceptor(new PaginationInnerInterceptor());
return mpInterceptor;
}
}
EmployeeController.java
/**
* 分页查询功能
* @param page 当前页数
* @param pageSize 页面大小
* @param name 查询的名字
* @return
*/
@GetMapping("/page")
public Result getByPage(int page,int pageSize,String name){
log.info("page="+page+";pageSize="+pageSize+";name="+name);
//调用service查询数据
Page page1 = employeeService.selectByPage(page, pageSize, name);
//查询结果是可能为空的,所以如果不发生异常,统一返回成功
Integer code = Code.OK;
String msg = "查询成功";
return new Result(page1,code,msg);
}
EmployeeService.java
/**
* 分页查询功能
* @param page
* @param pageSize
* @param name
* @return
*/
public Page selectByPage(int page, int pageSize, String name);
EmployeeServiceImpl.java
/**
* 分页查询功能
* @param page
* @param pageSize
* @param name
* @return 返回值为Page对象
*/
@Override
public Page selectByPage(int page, int pageSize, String name) {
Page iPage = new Page(page,pageSize);
//设置分页查询的条件
LambdaQueryWrapper<Employee> wrapper =new LambdaQueryWrapper<Employee>();
//当name有值时设置like条件
wrapper.like(name!=null,Employee::getName,name);
//设置按照创建时间的降序排序
wrapper.orderByDesc(Employee::getCreateTime);
//查询数据
employeeMapper.selectPage(iPage,wrapper);
return iPage;
}
启用/禁用员工账号
需求分析
需求 |
---|
管理员登录账号可以对所有员工账号进行启用和禁用 |
如果员工账号状态为正常,显示"禁用";如果员工账号状态为已禁用,显示"启用" |
普通用户登录后,启用、禁用按钮不显示 |
管理员界面
普通员工界面
代码开发
步骤 | 过程 |
---|---|
1 | 页面发送ajax请求,将参数{id,param}提交到服务器 |
2 | 服务端Controller接收数据,调用Service进行更新 |
3 | Service调用Mapper进行更新 |
- 在修改数据时,会出现前端返回的id数据和数据库id不匹配的问题,这到底是怎么回事呢?
- 原因:前端对于雪花算法生成的19位id丢失了精度,只处理到了16位
- 解决方法:后端在查询数据展现到前端时,将id转化为String类型再传输,接收数据时,将String类型转化为Long类型后再进行对比。
common包下创建JacksonObjectMapper
类
JacksonObjectMapper.java
package com.cjgn.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]
*/
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.java
/**
* 扩展json消息转换器
* @param converters
*/
@Override
public void extendMessageConverters(List<HttpMessageConverter<?>> converters) {
//创建消息转化器对象
MappingJackson2HttpMessageConverter messageConverter = new MappingJackson2HttpMessageConverter();
//设置对象转化器,底层用Jackson将Java对象转化为json
messageConverter.setObjectMapper(new JacksonObjectMapper());
//将上面转换器追加到mvc框架中的第一位
converters.add(0,messageConverter);
}
EmployeeController.java
/**
* 修改员工状态
* @param request
* @param employee 传入的数据
* @return
*/
@PutMapping
public Result updateStatus(HttpServletRequest request,@RequestBody Employee employee){
//获取管理员id
Long empId = (Long) request.getSession().getAttribute("employee");
//进行状态修改
boolean flag = employeeService.updateStatus(empId,employee);
//注入code和msg
Integer code = flag?Code.OK:Code.ERR;
String msg = flag?"修改成功":"修改失败";
return new Result(code,msg);
}
EmployeeService.java
/**
* 修改员工状态
* @param empId 管理员的id
* @param employee 员工修改为什么值
* @return
*/
public boolean updateStatus(Long empId,Employee employee);
EmployeeServiceImpl.java
/**
* 修改员工状态
* @param empId 管理员的id
* @param employee 员工修改为什么值
* @return
*/
@Override
public boolean updateStatus(Long empId,Employee employee) {
//设置修改值的管理员的id
employee.setUpdateUser(empId);
//注入修改时间
employee.setUpdateTime(LocalDateTime.now());
//更新状态
int i = employeeMapper.updateById(employee);
return i>0;
}
编辑员工信息
需求分析
需求 |
---|
点击编辑按钮后,可以对员工的信息进行修改 |
修改后保存到数据库中,并展示到前端页面 |
代码开发
步骤 | 过程 |
---|---|
1 | 点击修改按钮,页面跳转到add.html,并在url中携带员工 |
2 | 在add.html页面获取参数 |
3 | 发送ajax请求,在服务端处理后返回员工信息的json数据 |
4 | 前端通过Vue将员工数据展现在表单中 |
5 | 用户修改数据后,点击保存,数据传输到服务端 |
6 | 服务端将数据储存到数据库中,并给页面响应 |
EmployeeController.java
/**
* 按照id查询
* @param id
* @return
*/
@GetMapping("/{id}")
public Result getById(@PathVariable Long id){
//查询数据
Employee employee = employeeService.getById(id);
//注入code和msg
Integer code = employee!=null?Code.OK:Code.ERR;
String msg = employee!=null?"修改成功":"修改失败";
//返回result对象
return new Result(employee,code,msg);
}
EmployeeService.java
/**
* 按照id查询
* @param id
* @return
*/
public Employee getById(Long id);
EmployeeServiceImpl.java
/**
* 按照id查询
* @param id 用户的id
* @return
*/
@Override
public Employee getById(Long id) {
Employee employee = employeeMapper.selectById(id);
return employee;
}
总结
至此,员工模块的开发全部完毕,在开发过程中,要注意以下几个重点。
- 全局异常拦截器:当出现异常时,放入全局异常进行处理。例如数据库添加数据时的唯一性冲突异常,有人认为在添加前在服务端去判断数据库是否有重复数据就好了,但显然没有异常处理的简洁性。
- 雪花算法的丢失精度问题:需要重写一个对象转json的消息转换器,并在配置类中配置此转换器,将Long型的id转换为String类型保存在前端。
- 分页查询:分页查询不要忘记添加MybatisPlus的分页拦截器。