Spring Boot后端开发结构学习笔记

最新推荐文章于 2025-12-17 14:06:07 发布

原创最新推荐文章于 2025-12-17 14:06:07 发布 · 1.6k 阅读

33 ·

CC 4.0 BY-SA版权

文章标签：

#spring boot #学习 #笔记

Spring Boot 后端开发结构学习笔记

在开始编写 Spring Boot 后端代码前，系统梳理开发结构是非常重要的一步。清晰的项目结构能让后续开发更有条理，也便于代码维护和功能扩展。以下是我在学习 Spring Boot 后端开发结构时整理的笔记，记录了核心的分层思想和各模块的作用。

整体架构设计思想

Spring Boot 项目普遍采用 “分层架构” 设计，这种思想将代码按功能职责划分为不同层次，每个层次专注于特定的任务，层次间通过明确的接口交互，实现低耦合高内聚。这种设计的好处很明显：开发时可以分工协作，不同开发者负责不同层次；后期维护时，修改某一层次的代码不会对其他层次造成太大影响。

标准的 Spring Boot 项目目录结构遵循 Maven 或 Gradle 规范，主要分为三大块：src/main/java存放核心源代码，src/main/resources存放配置文件和静态资源，src/test/java用于编写测试代码。刚开始接触时可能觉得目录复杂，但理解每个目录的职责后，就能快速找到需要操作的文件位置。

核心分层及职责

在src/main/java的根包下，通常会按功能划分出多个子包，每个子包对应一个核心层次，这些层次共同构成了后端项目的骨架。

控制层（controller）是后端与前端交互的门户，主要职责是接收前端请求、校验参数、调用业务层处理逻辑，最后将结果返回给前端。这一层的类需要用@RestController注解标识，通过@RequestMapping、@GetMapping、@PostMapping等注解定义接口路径和请求方式。比如用户登录接口就放在控制层，接收用户名和密码参数后，调用业务层的登录方法。
业务层（service）是处理核心业务逻辑的地方，这一层通常分为接口和实现两部分：service包定义业务接口，service.impl包实现这些接口。业务层需要处理各种业务规则，比如用户注册时的用户名唯一性校验、密码加密处理等，同时协调数据访问层完成数据操作。业务层的实现类用@Service注解标识，通过依赖注入调用数据访问层的方法。
数据访问层（mapper）负责与数据库交互，提供数据的增删改查操作。在使用 MyBatis 框架时，这一层由 Mapper 接口组成，通过注解或 XML 文件编写 SQL 语句。数据访问层将数据库操作细节封装起来，业务层不需要关心 SQL 如何编写，只需调用接口方法即可。比如查询用户信息的selectByUsername方法、插入数据的insert方法都定义在这一层。
实体层（entity）用于定义数据模型，实体类的属性通常与数据库表字段对应，是数据在各层之间传递的载体。实体类需要定义私有属性，并提供 getter 和 setter 方法用于数据封装。比如用户实体类会包含 id、用户名、密码等属性，对应数据库表中的字段，方便数据的读取和存储。

关键文件

application.yml（或application.properties）是项目的核心配置文件，位于src/main/resources目录下，几乎所有项目参数都在这里配置。服务器端口号、数据库连接信息、框架参数、日志设置等都可以通过这个文件调整。比如设置server.port=8080指定项目运行端口，配置数据库 URL、用户名和密码实现数据库连接。

启动类是项目的入口，通常命名为XXXApplication，位于根包下，类上标注@SpringBootApplication注解。这个注解包含了自动配置、组件扫描等功能，运行启动类的main方法就能启动整个 Spring Boot 项目。刚开始开发时，一定要确保启动类的位置正确，否则可能出现组件扫描不到的问题。

pom.xml是 Maven 项目的依赖管理文件，通过引入不同的 starter 依赖，可以快速集成各种功能。比如引入spring-boot-starter-web实现 Web 开发功能，引入mybatis-spring-boot-starter集成 MyBatis 框架。Maven 会自动下载依赖包并管理版本，不需要手动导入 jar 包，极大简化了项目依赖管理。