定义#

部门新增功能用于保存新的部门数据。前端以 JSON 格式传递部门名称，后端通过 @RequestBody 注解将 JSON 数据绑定到实体对象，完成数据持久化。

接口描述#

• 请求方式：POST
• 请求路径：/depts
• 请求参数：JSON 格式 {"name":"研发部"}
• 响应数据：Result（统一响应结果）

实现思路#

• Controller 层：接收前端 JSON 请求参数，调用 Service 保存部门
• Service 层：补全基础属性（创建时间、修改时间），调用 Mapper 保存
• Mapper 层：执行 INSERT SQL 语句

JSON 参数接收#

前端传递 JSON 格式参数时，使用实体对象接收。

规则：JSON 数据的键名与方法形参对象的属性名相同，并使用 @RequestBody 注解标识。

如上图，JSON {"name":"研发部"} 通过 @RequestBody 绑定到 Dept 对象的 name 属性。

代码实现#

1
@PostMapping("/depts")
2
public Result save(@RequestBody Dept dept) {
3
    System.out.println("新增部门, dept=" + dept);
4
    deptService.save(dept);
5
    return Result.success();
6
}

1
// DeptService 接口
2
void save(Dept dept);
3

4
// DeptServiceImpl 实现
5
public void save(Dept dept) {
6
    // 补全基础属性
7
    dept.setCreateTime(LocalDateTime.now());
8
    dept.setUpdateTime(LocalDateTime.now());
9
    // 保存部门
10
    deptMapper.insert(dept);
11
}

1
@Insert("insert into dept(name, create_time, update_time) values(#{name}, #{createTime}, #{updateTime})")
2
void insert(Dept dept);

常见场景#

• 表单提交新增记录，前端发送 JSON 请求体
• 批量导入时循环调用新增接口

注意事项#

• @RequestBody 注解必须加在 Controller 方法形参前，否则无法绑定 JSON
• JSON 的 key 必须与实体类属性名一致
• #{...} 中应填写 Java 对象的属性名（驼峰命名），而非数据库字段名
• Service 层负责补全非业务字段（如时间戳），保持 Controller 层简洁

相关链接#

• 开发规范与工程搭建
• 部门查询功能
• 部门删除功能
• 部门修改功能