定义#

部门查询功能用于查询所有部门数据并展示在部门管理页面中。基于 SpringBoot 三层架构（Controller → Service → Mapper）实现，涉及 MyBatis 字段映射、驼峰命名规则、请求方式限定以及前后端联调。

实现思路#

三层架构每一层的职责：

• Controller 层：接收前端请求，调用 Service 查询部门数据，响应结果
• Service 层：调用 Mapper 接口方法，查询所有部门数据
• Mapper 层：执行查询所有部门数据的 SQL 操作

代码实现#

1
@RestController
2
public class DeptController {
3

4
    @Autowired
5
    private DeptService deptService;
6

7
    @GetMapping("/depts")
8
    public Result list() {
9
        List<Dept> deptList = deptService.findAll();
10
        return Result.success(deptList);
11
    }
12
}

1
// DeptService 接口
2
public interface DeptService {
3
    public List<Dept> findAll();
4
}
5

6
// DeptServiceImpl 实现
7
@Service
8
public class DeptServiceImpl implements DeptService {
9
    @Autowired
10
    private DeptMapper deptMapper;
11

12
    public List<Dept> findAll() {
13
        return deptMapper.findAll();
14
    }
15
}

1
@Mapper
2
public interface DeptMapper {
3
    @Select("select * from dept")
4
    public List<Dept> findAll();
5
}

数据封装 — 字段映射#

当实体类属性名和数据库表字段名不一致时，MyBatis 不能自动封装。

例如数据库字段 create_time、update_time，实体类属性 createTime、updateTime。

三种解决方案：

1
@Results({
2
    @Result(column = "create_time", property = "createTime"),
3
    @Result(column = "update_time", property = "updateTime")
4
})
5
@Select("select id, name, create_time, update_time from dept")
6
public List<Dept> findAll();

1
@Select("select id, name, create_time createTime, update_time updateTime from dept")
2
public List<Dept> findAll();

1
mybatis:
2
  configuration:
3
    map-underscore-to-camel-case: true

前后端联调#

前端工程通过 Nginx 反向代理访问后端 Tomcat 服务器。

请求访问流程：

Nginx 配置关键指令：

• location：定义匹配特定 URI 请求的规则
• ^~ /api/：精确匹配以 /api/ 开头的路径
• rewrite：重写匹配到的 URI 路径
• proxy_pass：代理转发，将匹配到的请求转发给后端服务器

使用 Nginx 反向代理的原因：

1. 安全：后端 Tomcat 集群不直接暴露给前端
2. 灵活：后端增减服务器对前端无感知，只需修改 Nginx 配置
3. 负载均衡：可方便实现后端 Tomcat 的负载均衡

常见场景#

• 列表页数据加载，一次性查询全部记录并展示
• 前后端分离项目中，通过 Nginx 代理解决跨域和负载均衡
• 数据库下划线字段与 Java 驼峰属性之间的自动映射

注意事项#

• 推荐使用 @GetMapping 等衍生注解限定请求方式，简洁优雅
• 驼峰命名映射是最推荐的字段映射方案，但前提是命名严格遵循规范
• @Results 手动映射仅在字段名无法自动映射时使用
• Nginx 的反向代理使前后端解耦，前端始终请求同一地址

相关链接#

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