Spring Boot项目中的Controller、Service、Mapper和Entity层的作用与联系

效率工具

推荐一个程序员常用的工具网站：程序员常用工具（http://tools.cxyroad.com），有时间戳、JSON格式化、文本对比、HASH生成、UUID生成等常用工具，效率加倍嘎嘎好用。

云服务器

云服务器限时免费领：轻量服务器2核4G
腾讯云：2核2G4M云服务器新老同享99元/年，续费同价
阿里云：2核2G3M的ECS服务器只需99元/年，续费同价

Spring Boot作为一种简化Spring应用开发的框架，提供了一整套约定和配置来帮助开发者快速构建和部署应用。在一个典型的Spring Boot项目中，常见的架构分层包括Controller、Service、Mapper和Entity层。这些层次各自承担不同的职责，并通过紧密协作实现应用功能。本文将详细探讨这些层的作用与联系，帮助开发者更好地理解Spring Boot的分层架构。

一、Entity层

1.1 作用

Entity层主要用于定义数据库表结构的映射实体类。在Spring Boot中，这些类通常用Java Persistence API (JPA)注解进行标注，从而实现对象关系映射（ORM）。每个Entity类对应数据库中的一张表，类的属性对应表中的列。

1.2 示例

以下是一个简单的Entity类示例，代表一个用户实体：

import javax.persistence.Entity;
import javax.persistence.Id;
import javax.persistence.GeneratedValue;
import javax.persistence.GenerationType;@Entity
public class User {@Id@GeneratedValue(strategy = GenerationType.IDENTITY)private Long id;private String name;private String email;// Getters and Setters
}

在这个示例中，@Entity注解表明User类是一个JPA实体，@Id和@GeneratedValue注解用于标识主键及其生成策略。

二、Mapper层

2.1 作用

Mapper层（也称为DAO层或Repository层）负责数据持久化操作，提供对数据库的CRUD（Create、Read、Update、Delete）操作接口。在Spring Data JPA中，Mapper层通常由接口定义，并继承自JpaRepository或CrudRepository接口。

2.2 示例

以下是一个简单的Repository接口示例，用于用户实体的持久化操作：

import org.springframework.data.jpa.repository.JpaRepository;public interface UserRepository extends JpaRepository<User, Long> {
}

通过继承JpaRepository，UserRepository接口自动拥有了常见的CRUD操作方法，如save、findById、findAll、deleteById等。

三、Service层

3.1 作用

Service层负责业务逻辑处理，是应用程序的核心部分。它在Controller层和Mapper层之间起到桥梁作用，调用Mapper层的方法完成具体的数据操作，并处理相关的业务逻辑。Service层通常定义为接口和实现类的形式，以便于单元测试和维护。

3.2 示例

以下是一个简单的Service接口和实现类示例，用于用户业务逻辑处理：

import java.util.List;public interface UserService {User saveUser(User user);User getUserById(Long id);List<User> getAllUsers();void deleteUserById(Long id);
}import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.stereotype.Service;
import java.util.List;@Service
public class UserServiceImpl implements UserService {@Autowiredprivate UserRepository userRepository;@Overridepublic User saveUser(User user) {return userRepository.save(user);}@Overridepublic User getUserById(Long id) {return userRepository.findById(id).orElse(null);}@Overridepublic List<User> getAllUsers() {return userRepository.findAll();}@Overridepublic void deleteUserById(Long id) {userRepository.deleteById(id);}
}

在这个示例中，UserServiceImpl类实现了UserService接口，并通过自动注入（@Autowired）的方式使用UserRepository进行数据库操作。

四、Controller层

4.1 作用

Controller层是应用程序的入口，负责处理客户端的HTTP请求，将请求转发到Service层进行业务逻辑处理，并将处理结果返回给客户端。Controller层通常使用Spring MVC注解来定义RESTful API端点。

4.2 示例

以下是一个简单的Controller类示例，用于处理用户相关的HTTP请求：

import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.web.bind.annotation.*;import java.util.List;@RestController
@RequestMapping("/users")
public class UserController {@Autowiredprivate UserService userService;@PostMappingpublic User createUser(@RequestBody User user) {return userService.saveUser(user);}@GetMapping("/{id}")public User getUserById(@PathVariable Long id) {return userService.getUserById(id);}@GetMappingpublic List<User> getAllUsers() {return userService.getAllUsers();}@DeleteMapping("/{id}")public void deleteUserById(@PathVariable Long id) {userService.deleteUserById(id);}
}

在这个示例中，UserController类使用@RestController注解将其标识为一个RESTful控制器，并通过@RequestMapping定义基础路径/users。具体的CRUD操作通过不同的HTTP方法（如GET、POST、DELETE）映射到相应的Service方法。

五、各层之间的联系

各层之间的联系如下：

Entity层定义数据库表的结构。
Mapper层负责数据库操作，通过调用Entity类与数据库进行交互。
Service层处理业务逻辑，调用Mapper层的方法进行数据操作，并进行业务处理。
Controller层处理客户端请求，调用Service层的业务逻辑方法，并将结果返回给客户端。

各层之间通过依赖注入（DI）和面向接口编程（OOP）的方式进行松耦合设计，确保代码的可维护性和可扩展性。

5.1 依赖注入

Spring的依赖注入机制（通常通过@Autowired注解实现）使得各层之间可以方便地引用彼此，而无需手动实例化对象。这种方式不仅简化了代码，还提升了测试和维护的便利性。

5.2 面向接口编程

面向接口编程是Spring框架的核心设计理念之一，通过接口定义各层的功能，并在实现类中实现具体的逻辑。这样可以在需要时轻松替换实现类，而不影响其他层的代码。

5.3 事务管理

Service层通常是事务管理的核心，通过Spring的@Transactional注解，可以确保在Service层进行的多个数据库操作要么全部成功，要么全部回滚，从而保证数据的一致性。

import org.springframework.transaction.annotation.Transactional;@Service
public class UserServiceImpl implements UserService {@Autowiredprivate UserRepository userRepository;@Transactional@Overridepublic User saveUser(User user) {return userRepository.save(user);}// 其他方法省略
}