Spring Boot分层架构详解：从Controller到Service再到Mapper的完整流程

最新推荐文章于 2025-04-09 15:49:54 发布

Leaton Lee

最新推荐文章于 2025-04-09 15:49:54 发布

阅读量5.6k

点赞数 33

文章标签： spring boot 架构后端 java

本文链接：https://blog.csdn.net/2301_78858041/article/details/145834241

版权

引言：为什么学习Spring Boot分层架构？

在现代企业级应用开发中，分层架构是至关重要的。它不仅提高了代码的可维护性，还使得团队协作更加高效。Spring Boot作为Java后端开发的事实标准，其分层架构模式几乎贯穿了所有企业级应用的开发流程。

本文将以一个实际案例（用户管理系统）为例，详细解析 Spring Boot 中 Controller、POJO、Mapper、Service、ServiceImpl 等层的关系，并展示从前端发送请求到后端处理的完整流程。无论你是刚刚接触 Spring Boot 的新手，还是希望深入理解其架构的开发者，这篇文章都将为你提供全面的指导。

第一部分：Spring Boot的整体架构

1.1 分层架构的核心思想

Spring Boot 应用通常采用经典的三层架构：

Controller 层：负责处理 HTTP 请求，接收前端数据并将其传递给 Service 层。
Service 层：负责处理业务逻辑，协调数据操作。
Mapper 层：负责与数据库交互，执行 CRUD 操作。

此外，还包括以下辅助组件：

POJO（Plain Old Java Object）：用于数据传递和存储。
Config 配置类：用于配置应用的各种参数。
XML 文件：用于配置数据源、事务等信息。

第二部分：各层的功能与关系

2.1 Controller 层

功能：
Controller 层是应用的入口，负责接收前端发送的 HTTP 请求，并将其转换为具体的业务逻辑调用。

示例代码：

@RestController 
@RequestMapping("/api/users")
public class UserController {
 
    @Autowired 
    private UserService userService;
 
    @PostMapping 
    public ResponseEntity<User> createUser(@RequestBody User user) {
        User createdUser = userService.createUser(user); 
        return ResponseEntity.status(HttpStatus.CREATED).body(createdUser); 
    }
}

解释：

@RestController 和 @RequestMapping 注解将该类标识为控制器。
@Autowired 自动注入 UserService 实例。
@PostMapping 处理 POST 请求，并将请求体中的 JSON 数据绑定到 User 对象。

2.2 POJO（实体类）

功能：
POJO 是数据传输的载体，用于封装数据库中的记录。它通常包含属性、getter 和 setter 方法。

示例代码：

@Data 
public class User {
    private Long id;
    private String username;
    private String email;
    private String password;
}

解释：

@Data 注解自动生成 getter 和 setter 方法。
属性对应数据库中的字段。

2.3 Mapper 层

功能：
Mapper 层负责与数据库交互，执行 CRUD 操作。它通常使用 MyBatis 或 JPA 进行实现。

示例代码（MyBatis）：

@Repository 
public interface UserMapper {
    @Insert("INSERT INTO users (username, email, password) VALUES (#{username}, #{email}, #{password})")
    void insert(User user);
 
    @Select("SELECT * FROM users WHERE id = #{id}")
    User selectById(Long id);
}

解释：

@Repository 标识这是一个数据访问层组件。
使用 MyBatis 的注解 @Insert 和 @Select 定义 SQL 操作。

2.4 Service 层

功能：
Service 层负责处理业务逻辑，协调 Mapper 层和 Controller 层之间的数据流。

示例代码：

@Service 
public interface UserService {
    User createUser(User user);
}

实现类：

@Service 
public class UserServiceImpl implements UserService {
 
    @Autowired 
    private UserMapper userMapper;
 
    @Override 
    public User createUser(User user) {
        userMapper.insert(user); 
        return user;
    }
}

解释：

@Service 标识这是一个业务逻辑层组件。
@Autowired 自动注入 UserMapper 实例。
createUser 方法调用 Mapper 层的 insert 方法，并返回创建的用户对象。

第三部分：配置类与XML文件的作用

3.1 配置类

功能：
配置类用于定义应用的各种参数和行为。

示例代码：

@SpringBootApplication 
public class UserManagementApplication {
    public static void main(String[] args) {
        SpringApplication.run(UserManagementApplication.class,  args);
    }
}

解释：

@SpringBootApplication 是 Spring Boot 的核心注解，表示这是一个主类。

自定义配置类：

@Configuration 
public class DatabaseConfig {
 
    @Bean 
    public DataSource dataSource() {
        return new EmbeddedDatabaseBuilder()
                .setType(EmbeddedDatabaseType.H2)
                .addScript("schema.sql") 
                .build();
    }
}

解释：

@Configuration 标识这是一个配置类。
dataSource() 方法定义了一个嵌入式的 H2 数据源。

3.2 XML 文件

功能：
XML 文件用于配置数据源、事务管理等信息。

示例代码：

<?xml version="1.0" encoding="UTF-8"?>
<beans xmlns="http://www.springframework.org/schema/beans" 
       xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
       xsi:schemaLocation="http://www.springframework.org/schema/beans  
                           http://www.springframework.org/schema/beans/spring-beans.xsd"> 
 
    <bean id="dataSource" class="org.springframework.jdbc.datasource.DriverManagerDataSource"> 
        <property name="driverClassName" value="org.h2.Driver"/>
        <property name="url" value="jdbc:h2:mem:testdb"/>
        <property name="username" value="sa"/>
        <property name="password" value=""/>
    </bean>
 
</beans>

解释：

配置了一个 H2 数据源。
定义了数据库驱动、URL、用户名和密码。

第四部分：从前端到后端的完整流程

4.1 前端发送请求

假设前端发送一个 POST 请求到 /api/users 端点，请求体中包含用户数据：

{
    "username": "john_doe",
    "email": "john@example.com", 
    "password": "secret123"
}

4.2 Controller 层处理请求

UserController 的 createUser 方法接收请求并调用 userService.createUser(user) 。

4.3 Service 层处理业务逻辑

UserService 的 createUser 方法调用 UserMapper 的 insert 方法。

4.4 Mapper 层执行数据库操作

UserMapper 的 insert 方法将用户数据插入到数据库中。

4.5 返回响应

最终，Controller 将创建的用户对象返回给前端。

第五部分：完整的项目结构

以下是项目的完整结构：

src/
├── main/
│   ├── java/
│   │   └── com/
│   │       └── example/
│   │           ├── controller/
│   │           │   └── UserController.java  
│   │           ├── service/
│   │           │   ├── UserService.java  
│   │           │   └── UserServiceImpl.java  
│   │           ├── mapper/
│   │           │   └── UserMapper.java  
│   │           ├── model/
│   │           │   └── User.java  
│   │           └── config/
│   │               └── DatabaseConfig.java  
│   └── resources/
│       ├── application.properties  
│       └── schema.sql  
└── test/
    └── java/
        └── com/
            └── example/
                └── UserManagementApplicationTests.java