苍穹外卖 day 02（新增员工）记录

1. 需求分析和设计：
接口设计：

数据库设计：

2.代码开发
根据新增员工接口设计对应的DTO

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

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

package com.sky.dto;

import lombok.Data;

import java.io.Serializable;

@Data
public class EmployeeDTO implements Serializable {

    private Long id;

    private String username;

    private String name;

    private String phone;

    private String sex;

    private String idNumber;

}

2).mployeeController中创建新增员工方法

进入到sky-server模块中，在com.sky.controller.admin包下，在EmployeeController中创建新增员工方法，接收前端提交的参数。

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

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

在sky-server模块中,com.sky.server.EmployeeService
 

	/**
     * 新增员工
     * @param employeeDTO
     */
    void save(EmployeeDTO employeeDTO);

在EmployeeServiceImpl中实现新增员工方法

com.sky.server.impl.EmployeeServiceImpl中创建方法

@Override
    /**
     * 新增员工
     * @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
        //TODO后期改为当前登录用户的id
        employee.setCreateUser(10L);
        employee.setUpdateUser(10L);
        //性别默认值
        employee.setSex("1");
        employeeMapper.insert(employee);
    }

在sky-common模块com.sky.constants包下已定义StatusConstant.java

package com.sky.constant;

/**
 * 状态常量，启用或者禁用
 */
public class StatusConstant {

    //启用
    public static final Integer ENABLE = 1;

    //禁用
    public static final Integer DISABLE = 0;
}

在EmployeeMapper中声明insert方法

com.sky.EmployeeMapper中添加方法
 

	/**
     * 插入员工数据
     * @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);

1.3.1 接口文档测试

**启动服务：**访问http://localhost:8080/doc.html，进入新增员工接口

json数据：

{
  "id": 0,
  "idNumber": "111222333444555666",
  "name": "xiaozhi",
  "phone": "13812344321",
  "sex": "1",
  "username": "小智"
}

使用用户登录添加一个jwt令牌到全局设置，避免400报错。

接口测试：

测试成功。

前后端联调测试

启动nginx,访问 http://localhost

登录–>员工管理–>添加员工

添加成功.

注意：由于开发阶段前端和后端是并行开发的，后端完成某个功能后，此时前端对应的功能可能还没有开发完成，
导致无法进行前后端联调测试。所以在开发阶段，后端测试主要以接口文档测试为主。

🌟 新增员工功能流程总结

一、前端提交数据

• 用户在页面填写新增员工信息并提交表单。

• 表单字段（如姓名、账号、手机号等）与后端实体不完全一致，因此后端采用了 DTO 来接收数据。

---

二、Controller 层接收并转发请求

• Controller 接收前端 JSON 数据，封装到 EmployeeDTO 对象中。

• 记录日志并调用 Service 层的新增方法。

---

三、Service 接口定义行为

• 接口中定义了 save(EmployeeDTO employeeDTO) 方法。

• 仅作为行为声明，具体实现由实现类负责。

---

四、Service 实现层处理业务逻辑

• 将 EmployeeDTO 转换为 Employee 实体对象。

• 设置初始值：

  • 默认状态为启用（1）

  • 初始密码为“123456”并加密处理

  • 记录创建时间、修改时间

  • 设置创建人、修改人为固定值（后期会动态获取）

• 调用 Mapper 层完成数据库插入操作。

---

五、Mapper 层执行数据库操作

• 通过注解形式执行 INSERT 语句，将员工信息写入数据库表。

• 利用 MyBatis 的驼峰映射自动匹配字段名（如 idNumber ↔ id_number）。

---

六、统一结果返回

• 操作完成后通过 Result.success() 返回统一格式的响应。

• 若出现异常，可使用 Result.error() 封装错误信息。

---

七、配置支持

• application.yml 中已开启驼峰命名映射配置。

• 常量类中已定义启用/禁用状态，供业务逻辑使用。

---

✅ 关键特点

• 使用 DTO 解耦前端和数据库实体

• 多层结构清晰分工（Controller → Service → Mapper）

• 使用统一响应格式类 Result 提高接口一致性

• 合理使用常量类与时间设置

• 具备良好的可扩展性（如登录用户动态获取、校验、日志等）