员工管理

1. 新增员工  2-5

1.1 需求分析  2-5

后台系统中可以管理员工信息，通过新增员工来添加后台系统用户，点击【添加员工】按钮转到新增页面如下：

新增员工，其实就是将我们新增页面录入的员工数据插入到employee表。需要注意, employee表 中对username字段加入了唯一约束,因为username是员工的登录账号，必须是唯一的

1.2 代码开发 2-6

在开发代码之前，需要梳理一下整个程序的执行过程:

1、页面发送ajax请求，将新增员工页面中输入的数据以json的形式提交到服务端

2、服务端Controller接收页面提交的数据并调用Service将数据进行保存

3、Service调用Mapper操作数据库，保存数据

员工控制类EmployeeController

这里解释@PostMapping后面为真么不用加路径，因为点击添加按钮后发起的路径是

http://localhost:8080/employee 而这个employee我们在EmployeeController类上面加了

@RequestMapping("/employee")注解，会自动添加employee的

//保存员工信息  2-7
    @PostMapping
    public R save(HttpServletRequest request,@RequestBody Employee employee){
        log.info("新增员工，员工信息：{}",employee.toString());

        //设置初始密码123456，需要进行md5加密处理
        employee.setPassword(DigestUtils.md5DigestAsHex("123456".getBytes()));

        employee.setCreateTime(LocalDateTime.now());
        employee.setUpdateTime(LocalDateTime.now());

        //获得当前登录用户的id,这个id是管理员的id因为只有管理员右权限增加员工
        Long empId = (Long) request.getSession().getAttribute("employee");

        employee.setCreateUser(empId);
        employee.setUpdateUser(empId);

        employeeService.save(employee);

        return R.success("新增员工成功");
    }

测试

1.3 解决员工同名异常问题  2-8

前面的程序还存在一个问题， 就是当我们在新增员工时输入的账号已经存在，由于employee表中对该字段加入了唯一约束，此时程序会抛出异常:

1.3.1 解决方法  2-8

此时需要我们的程序进行异常捕获,通常有两种处理方式:

1、在Controller方法中加入try、catch进行异常捕获

2、使用异常处理器进行全局异常捕获  2-8  2-9

异常处理类GlobalExceptionHandler

package com.itheima.reggie.common;

import lombok.extern.slf4j.Slf4j;
import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.ControllerAdvice;
import org.springframework.web.bind.annotation.ExceptionHandler;
import org.springframework.web.bind.annotation.ResponseBody;
import org.springframework.web.bind.annotation.RestController;

import java.sql.SQLIntegrityConstraintViolationException;

/**
 * 全局异常处理   2-8
 */
//@ControllerAdvice注解的作用就是拦截，例如拦截加了RestController注解和Controller注解的类
@ControllerAdvice(annotations = {RestController.class, Controller.class})
@ResponseBody//返回结果封装成json
@Slf4j
public class GlobalExceptionHandler {

    /**
     * 异常处理方法2-8
     * @return
     */
    //处理SQLIntegrityConstraintViolationException异常
    @ExceptionHandler(SQLIntegrityConstraintViolationException.class)
    public R<String> exceptionHandler(SQLIntegrityConstraintViolationException ex){
        log.error(ex.getMessage());

        //2-9
        if(ex.getMessage().contains("Duplicate entry")){
            String[] split = ex.getMessage().split(" ");
            String msg = split[2] + "已存在";
            return R.error(msg);
        }

        return R.error("未知错误");
    }
}

2. 阶段总结  2-10

3. 员工信息分页查询  2-11

3.1 需求分析  2-11

系统中的员工很多的时候，如果在一个页面中全部展示出来会显得比较乱，不便于查看,所以一般的系统中都会以分页的方式来展示列表数据。

3.2 代码开发  2-12

在开发代码之前，需要梳理一下整个程序的执行过程:

1、页面发送ajax请求,将分页查询参数(page. pageSize、 name)提交到服务端

2、服务端Controller接收页面提交的数据并调用Service查询数据

3、Service调用Mapper操作数据库，查询分页数据

4、Controller将查询到的分页数据响应给页面

5、页面接收到分页数据并通过ElementUl的Table组件展示到页面上

代码实现  2-13

配置MP的分页插件 MybatisPlusConfig

package com.itheima.reggie.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;

/**
 * 配置MP的分页插件  2-13
 */
@Configuration
public class MybatisPlusConfig {

    @Bean
    public MybatisPlusInterceptor mybatisPlusInterceptor(){
        MybatisPlusInterceptor mybatisPlusInterceptor = new MybatisPlusInterceptor();
        mybatisPlusInterceptor.addInnerInterceptor(new PaginationInnerInterceptor());
        return mybatisPlusInterceptor;
    }
}

接口设计

前端注意事项

EmployeeController  2-13   2-14

 //员工信息分页查询 2-13 2-14
    @GetMapping("/page")
    public R<Page> page(int page,int pageSize,String name){//page第几页，pageSize查询几条
        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(Employee::getUpdateTime);

        //执行查询
        employeeService.page(pageInfo,queryWrapper);
        return R.success(pageInfo);
    }

4. 启用、禁用员工账号  2-17

无非就是修改status，0禁用，1启用

4.1 需求分析

在员工管理列表页面，可以对某个员工账号进行启用或者禁用操作。账号禁用的员工不能登录系统，启用后的员工可以正常登录。

需要注意，只有管理员(admin用户)可以对其他普通用户进行启用、禁用操作，所以普通用户登录系统后启用、禁用按钮不显示。

4.2 代码开发  2-19

开发流程  2-20

在开发代码之前，需要梳理一下整个程序的执行过程:

1、页面发送ajax请求,将参数(id、status)提交到服务端

2、服务端Controller接收页面提交的数据并调用Service更新数据

3、Service调 用Mapper操作数据库

启用、禁用员工账号,本质上就是一个更新操作，也就是对status状态字段进行操作在Controller中创建update方法，此方法是一个通用的修改员工信息的方法

EmployeeController  2-20

 //根据id来修改员工信息  2-20
    //启用禁用员工  2-20
    @PutMapping
    public R<String> update(HttpServletRequest request,@RequestBody Employee employee){
        log.info(employee.toString());

        //从session中取出更新人id
        Long empId = (Long) request.getSession().getAttribute("employee");
        employee.setUpdateTime(LocalDateTime.now());//更新时间
        employee.setUpdateUser(empId);//更新人id

        employeeService.updateById(employee);
        return R.success("员工信息修改成功");
    }

结果数据库并没有更新成功

代码修复  2-21

前面我们已经发现了问题的原因，即js对long型 数据进行处理时丢失精度,导致提交的id和数据库中的id不一致。（js只能保证前16位精准，但是我们的id是19位的）

如何解决这个问题?

我们可以在服务端给页面响应json数据时进行处理，将long型数据统一转为String字符串,效果如下:

具体实现步骤:  2-21

1)提供对象转换器JacksonObjectMapper,基于Jackson进行Java对象到json数据的转换(资料中已经提供，直接复制到项目中使用)

2)在WebMvcConfig配置类中扩展Spring mvc的消息转换器,在此消息转换器中使用提供的对象转换器进行Java对象到json数据的转换

对象映射器JacksonObjectMapper   2-21

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对象   2-21
 * 将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配置类  2-21

/**
     * 扩展mvc框架的消息转换器  2-21
     * @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);
    }

测试成功

5. 编辑员工信息  2-23

5.1 需求分析   2-23

5.2 代码开发  2-23

在开发代码之前需要梳理一下操作过程和对应的程序的执行流程:

1、点击编辑按钮时，页面跳转到add.html, 并在url中携带参数[员Iid]

2、在add.html页 面获取url中的参数[员Iid]

3、发送ajax请求,请求服务端，同时提交员工id参数

4、服务端接收请求，根据员工id查询员工信息，将员工信息以json形式响应给页面

5、页面接收服务端响应的json数据，通过VUE的数据绑定进行员工信息回显

6、点击保存按钮，发送ajax请求,将页面中的员工信息以json方式提交给服务端

7、服务端接收员工信息，并进行处理，完成后给页面响应

8、页面接收到服务端响应信息后进行相应处理

注意: add.html页面为公共页面，新增员工和编辑员工都是在此页面操作

很明显这是一个restful风格的路径 ，需要使用@PathVariable获取路径中的值

编辑员工信息

EmployeeController  2-25

 /**
     * 根据id查询员工信息
     * @param id
     * @return
     */
    @GetMapping("/{id}")//restful风格
    public R<Employee> getById(@PathVariable Long id){
        log.info("根据id查询员工信息...");

        Employee employee = employeeService.getById(id);
        if(employee != null){
            return R.success(employee);
        }
        return R.error("没有查询到对应员工信息");
    }

修改名字并保存（这里提示这个保存其实用的方法和启用禁用那里的代码是一个，本质上都是修改）