苍穹外卖(二)新增员工及项目细节

news2025/2/24 17:56:35

我们实现员工管理功能:

新增员工
员工分页查询
启用禁用员工账号
编辑员工
导入分类模块功能代码

员工管理效果：

1. 新增员工

1.1 需求分析和设计

接口设计

明确新增员工接口的请求路径、请求方式、请求参数、返回数据。

表设计

新增员工，其实就是将我们新增页面录入的员工数据插入到employee表。

1.2 代码开发

1.2.1 设计DTO类

根据新增员工接口设计对应的DTO

前端传递参数列表：

**思考：**是否可以使用对应的实体类来接收呢？

结论 : 当前端提交的数据和实体类中对应的属性差别比较大时，建议使用DTO来封装数据

由于上述传入参数和实体类有较大差别，所以自定义DTO类。

1.2.2 Controller层

EmployeeController中创建新增员工方法

/**
     * 新增员工
     * @param employeeDTO
     * @return
     */
    @PostMapping
    @ApiOperation("新增员工")
    public Result save(@RequestBody EmployeeDTO employeeDTO){
        log.info("新增员工：{}",employeeDTO);
        employeeService.save(employeeDTO);//该方法后续步骤会定义
        return Result.success();
    }

1.2.3 Service层接口

在EmployeeService接口中声明新增员工方法

1.2.4 Service层实现类

在EmployeeServiceImpl中实现新增员工方法

/**
     * 新增员工
     *
     * @param employeeDTO
     */
    public void save(EmployeeDTO employeeDTO) {
        Employee employee = new Employee();

        //对象属性拷贝
        BeanUtils.copyProperties(employeeDTO, employee);

        //设置账号的状态，默认正常状态 1表示正常 0表示锁定
        employee.setStatus(StatusConstant.ENABLE);

        //设置密码，默认密码123456
        employee.setPassword(DigestUtils.md5DigestAsHex(PasswordConstant.DEFAULT_PASSWORD.getBytes()));

        //设置当前记录的创建时间和修改时间
        employee.setCreateTime(LocalDateTime.now());
        employee.setUpdateTime(LocalDateTime.now());

        //设置当前记录创建人id和修改人id
        employee.setCreateUser(10L);//目前写个假数据，后期修改
        employee.setUpdateUser(10L);

        employeeMapper.insert(employee);//后续步骤定义
    }

1.2.5 Mapper层

在EmployeeMapper中声明insert方法

/**
     * 插入员工数据
     * @param employee
     */
    @Insert("insert into employee (name, username, password, phone, sex, id_number, create_time, update_time, create_user, update_user,status) " +
            "values " +
            "(#{name},#{username},#{password},#{phone},#{sex},#{idNumber},#{createTime},#{updateTime},#{createUser},#{updateUser},#{status})")
    void insert(Employee employee);

细节一 : @Data

使用lombok简化操作

只需要加入下面依赖就可以达成操作

细节二: Mybatis

(1) 在Sky_take_out数据库中建立employee表

(2) 在Springboot工程中引入起步依赖

application.yml文件中配置数据库连接信息

(3) Mapper中以注解方式编写SQL语句

完成引入mybatis操作

注意 : 若以XML方式配置映射文件须遵守一下要求

细节三: @ConfigurationProperties

当我们把四个参数传给yml属性配置文件进行集中的配置管理

如果我们想在工具类中使用这四个参数就要在类中变量上加上注解来注入这四个参数

但这样无疑很繁琐

@Component： 标注Spring管理的Bean，使用@Component注解在一个类上，表示将此类标记为Spring容器中的一个Bean。

改进办法:

使用@ConfigurationProperties注解来指定前缀

条件:

1. yml 文件和类中变量名必须一致

2. 加入@Data注解方便调用类中变量, 设置类中变量

3. 加入@Component 将这个类交给IOC容器管理

4. 加入@ConfigurationProperties 补全前缀

改进结果:

只在对象上需要加上@Autowired 注入上面这个Bean对象, 再调用 Get()方法就可拿到参数值

两种方法对比:

@Component
@ConfigurationProperties(prefix = "sky.jwt")
@Data
public class JwtProperties {

    /**
     * 管理端员工生成jwt令牌相关配置
     */
    private String adminSecretKey;
    private long adminTtl;
    private String adminTokenName;

    /**
     * 用户端微信用户生成jwt令牌相关配置
     */
    private String userSecretKey;
    private long userTtl;
    private String userTokenName;

}

细节四: ThreadLocal

描述：新增员工时，创建人id和修改人id设置为固定值

//当前设置的id为固定值10//
        employee.setCreateUser(10L);
        employee.setUpdateUser(10L);
        //

解决：

通过某种方式动态获取当前登录员工的id。

员工登录成功后会生成JWT令牌并响应给前端：

        claims.put(JwtClaimsConstant.EMP_ID, employee.getId());
        String token = JwtUtil.createJWT(
                jwtProperties.getAdminSecretKey(),
                jwtProperties.getAdminTtl(),
                claims);

后续请求中，前端会携带JWT令牌，通过JWT令牌可以解析出当前登录员工id：

JwtTokenAdminInterceptor.java

            Claims claims = JwtUtil.parseJWT(jwtProperties.getAdminSecretKey(), token);
            Long empId = Long.valueOf(claims.get(JwtClaimsConstant.EMP_ID).toString());

**思考：**解析出登录员工id后，如何传递给Service的save方法？

答 : ThreadLocal

介绍：

ThreadLocal 并不是一个Thread，而是Thread的局部变量。 ThreadLocal为每个线程提供单独一份存储空间，具有线程隔离的效果，只有在线程内才能获取到对应的值，线程外则不能访问。

常用方法：

public void set(T value) 设置当前线程的线程局部变量的值
public T get() 返回当前线程所对应的线程局部变量的值
public void remove() 移除当前线程的线程局部变量

对ThreadLocal有了一定认识后，接下来继续解决问题

在拦截器中解析出当前登录员工id，并放入线程局部变量中：

public class JwtTokenAdminInterceptor implements HandlerInterceptor {

    @Autowired
    private JwtProperties jwtProperties;

    /**
     * 校验jwt
     */
    public boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler) throws Exception {
        
        //.............................
        //2、校验令牌
        try {
            //.................
            Claims claims = JwtUtil.parseJWT(jwtProperties.getAdminSecretKey(), token);
            Long empId = Long.valueOf(claims.get(JwtClaimsConstant.EMP_ID).toString());
            log.info("当前员工id：", empId);
            /将用户id存储到ThreadLocal
            threadLocal.set(empId);
            
            //3、通过，放行
            return true;
        } catch (Exception ex) {
            //......................
        }
    }
}

在Service中获取线程局部变量中的值：

 /**
     * 新增员工
     *
     * @param employeeDTO
     */
    public void save(EmployeeDTO employeeDTO) {
        //.............................

        //设置当前记录创建人id和修改人id
        employee.setCreateUser(threadLocal.get());//目前写个假数据，后期修改
        employee.setUpdateUser(threadLocal.get());

        employeeMapper.insert(employee);
    }