SpringBoot项目中,controller 、 entity、mapper和service包的介绍

在Spring Boot项目中,mapperservicecontrollerentity 是标准的代码分层目录,每个目录有明确的职责划分。以下是它们的详细说明和文件存储规范:


1. controller 目录

  • 作用 :存放 控制器类(接收HTTP请求并返回响应)。

  • 文件类型

    • 普通Java类(.java文件)
  • 关键注解

    • @RestController(REST API)
    • @Controller(传统MVC)
    • @RequestMapping@GetMapping
  • 示例

    复制代码
    复制代码
    // src/main/java/com/example/controller/UserController.java
    @RestController
    @RequestMapping("/api/users")
    public class UserController {
        @Autowired
        private UserService userService;
    
        @GetMapping
        public List<User> listUsers() {
            return userService.getAllUsers();
        }
    }

2. service 目录

  • 作用 :存放 业务逻辑层代码(处理复杂业务规则)。

  • 文件类型

    • 接口(UserService.java
    • 实现类(UserServiceImpl.java,放在impl子目录下)
  • 关键注解

    • @Service(标记实现类)
  • 示例

    复制代码
    复制代码
    // src/main/java/com/example/service/UserService.java
    public interface UserService {
        List<User> getAllUsers();
    }
    
    // src/main/java/com/example/service/impl/UserServiceImpl.java
    @Service
    public class UserServiceImpl implements UserService {
        @Autowired
        private UserMapper userMapper;
    
        @Override
        public List<User> getAllUsers() {
            return userMapper.selectAll();
        }
    }

3. mapper 目录

  • 作用 :存放 数据访问层接口(直接操作数据库的代码)。

  • 文件类型

    • 接口(.java文件)
    • 配套的XML映射文件(MyBatis)或使用JPA接口
  • 关键注解

    • @Mapper(MyBatis)
    • @Repository(可选,Spring会自动识别)
  • 示例

    复制代码
    复制代码
    // src/main/java/com/example/mapper/UserMapper.java
    @Mapper
    public interface UserMapper {
        List<User> selectAll();
        User selectById(Long id);
    }
    
    <!-- src/main/resources/mapper/UserMapper.xml -->
    <mapper namespace="com.example.mapper.UserMapper">
        <select id="selectAll" resultType="com.example.entity.User">
            SELECT * FROM t_user
        </select>
    </mapper>


4. entity 目录

  • 作用 :存放 数据实体类(与数据库表直接映射的Java对象)。

  • 文件类型

    • 普通Java类(.java文件)
    • 使用注解标记与数据库的映射关系(如JPA或MyBatis注解)
  • 关键注解

    • @Entity(JPA)
    • @Table(name = "表名")
    • @Id(主键)
  • 示例

    复制代码
    // src/main/java/com/example/entity/User.java
    @Entity
    @Table(name = "t_user")
    public class User {
        @Id
        @GeneratedValue(strategy = GenerationType.IDENTITY)
        private Long id;
        private String username;
        // getter/setter省略
    }

分层架构流程图

复制代码
flowchart LR
    Client --> Controller --> Service --> Mapper --> Database
    Database --> Entity

各层职责总结

目录 职责 是否必须 典型依赖
entity 定义数据结构
mapper 数据库CRUD操作 entity
service 业务逻辑处理 推荐 mapper + 其他Service
controller 处理HTTP请求/响应 service

最佳实践建议

  1. 严格分层调用

    • Controller → Service → Mapper
    • 禁止跨层调用(如Controller直接调用Mapper)
  2. 命名规范

    • 实体类:User.java
    • Mapper接口:UserMapper.java
    • Service接口:UserService.java
    • Service实现类:UserServiceImpl.java
    • Controller:UserController.java
  3. 使用接口分离

    • Service和Mapper层建议使用接口+实现类的形式,便于扩展和Mock测试。

通过这种分层设计,代码可维护性和可测试性会显著提升。

相关推荐
就是帅我不改2 分钟前
告别996!高可用低耦合架构揭秘:SpringBoot + RabbitMQ 让订单系统不再崩
java·后端·面试
hhzz15 分钟前
Maven项目中settings.xml终极优化指南
java·jdk·maven
hqxstudying38 分钟前
MyBatis 和 MyBatis-Plus对比
java·数据库·mysql·mybatis
源码哥_博纳软云1 小时前
JAVA国际版多商户运营版商城系统源码多商户社交电商系统源码支持Android+IOS+H5
android·java·ios·微信·微信小程序·小程序·uni-app
猿java1 小时前
为什么复杂的架构一定要做分层设计?
java·面试·架构
whitepure1 小时前
万字详解常用数据结构(Java版)
java·数据结构·后端
天天摸鱼的java工程师1 小时前
你们公司的 QPS 是怎么统计出来的?这 5 种常见方法我踩过一半的坑
java·后端·面试
whitepure1 小时前
万字详解常用算法(Java版)
java·后端·算法
莹莹啦1 小时前
聊一聊Java定时任务框架选型
java·后端
MrSYJ1 小时前
AuthorizationFilter过滤器的功能
java·spring boot·后端