SpringBoot 手写 CRUD 01 · 项目骨架与分层架构

785 字

4 分钟

SpringBoot 手写 CRUD 01 · 项目骨架与分层架构

2026-08-03

SpringBoot

/

分层架构

/

后端基础

核心：一次请求 = 浏览器 → Controller → Service接口 → ServiceImpl → Mapper → MySQL，所有 SpringBoot 项目都是这条链的变体。

技术栈与项目结构#

1
技术栈：SpringBoot 3.5.16 + Java 17 + MyBatis-Plus 3.5.17 + MySQL 8.4 + Lombok
2
包名：ad.ovo.demo2

1
src/main/java/ad/ovo/demo2/
2
├── DemoApplication.java               # 启动类
3
├── common/
4
│   ├── result/
5
│   │   ├── Result.java                # 统一返回封装（泛型盒子）
6
│   │   └── ResultCode.java            # 错误码枚举清单
7
│   └── exception/
8
│       ├── BizException.java          # 业务异常（带错误码）
9
│       └── GlobalExceptionHandler.java# 全局异常安全网
10
├── controller/
11
│   ├── HelloController.java           # 测试接口
12
│   └── SysUserController.java         # 用户 CRUD 接口
13
├── entity/
14
│   └── SysUser.java                   # 用户实体 ↔ sys_user 表
15
├── mapper/
16
│   └── SysUserMapper.java             # 继承 BaseMapper 白送增删改查
17
└── service/
18
    ├── SysUserService.java            # Service 接口（服务契约）
19
    └── impl/
20
        └── SysUserServiceImpl.java    # Service 实现（业务逻辑）

数据库表 sys_user：

1
CREATE TABLE sys_user (
2
    id          BIGINT       NOT NULL AUTO_INCREMENT COMMENT '主键',
3
    username    VARCHAR(64)  NOT NULL COMMENT '登录用户名',
4
    password    VARCHAR(128) NOT NULL DEFAULT '' COMMENT '密码',
5
    nickname    VARCHAR(64)  NULL COMMENT '昵称',
6
    status      TINYINT      NOT NULL DEFAULT 0 COMMENT '状态: 0-正常 1-停用',
7
    create_time DATETIME     NOT NULL DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
8
    update_time DATETIME     NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '更新时间',
9
    PRIMARY KEY (id),
10
    UNIQUE KEY uk_username (username)
11
) ENGINE = InnoDB COMMENT = '系统用户表';

启动类 DemoApplication#

文件：src/main/java/ad/ovo/demo2/DemoApplication.java

1
package ad.ovo.demo2;
2

3
import org.springframework.boot.SpringApplication;
4
import org.springframework.boot.autoconfigure.SpringBootApplication;
5

6
@SpringBootApplication
7
public class DemoApplication {
8

9
    public static void main(String[] args) {
10
        SpringApplication.run(DemoApplication.class, args);
11
    }
12
}

逐行讲解#

代码	含义
`package ad.ovo.demo2;`	包名：给代码”归个类”，必须和目录结构一致
`import ...SpringApplication;`	引入 Spring 的启动器工具类
`@SpringBootApplication`	核心注解：项目启动入口的”标签”
`public class DemoApplication`	类名，必须和文件名一致
`SpringApplication.run(...)`	启动整个 SpringBoot 引擎

面试考点：@SpringBootApplication 是什么？#

它一个顶三个（复合注解）：

组合注解	作用
`@SpringBootConfiguration`	声明这是个配置类
`@EnableAutoConfiguration`	自动配置：根据 pom 依赖自动配好（装 MP 就自动配数据源）
`@ComponentScan`	组件扫描：扫描本包及子包，找到 `@Service`/`@Controller` 等标签的类注册进容器

这就是 SpringBoot”约定大于配置”的核心——不写一堆 XML，框架按约定自动干活。

分层职责（写进脑子）#

层	职责
Controller	请求入口：只接请求、转发、包 Result——不写业务逻辑
Service 接口	服务契约：只声明”提供什么服务”
ServiceImpl	业务实现：真正的业务逻辑，`@Service` 注册
Mapper	数据访问：`extends BaseMapper<实体>` 继承增删改查
Entity	表映射：一个类对应一张表，`@TableName("表名")` 映射

一次请求的完整旅程（串联所有层）#

1
浏览器 GET /user/1
2
  ↓
3
① SysUserController.getById(1)          # @PathVariable 取出 id=1
4
  ↓ sysUserService.getById(1L)
5
② SysUserService 接口                    # 契约：声明有 getById 服务
6
  ↓
7
③ SysUserServiceImpl.getById(1L)        # 实现：真正执行
8
  ↓ sysUserMapper.selectById(1L)
9
④ SysUserMapper（extends BaseMapper）    # 翻译官：Java 方法 → SQL
10
  ↓
11
⑤ MySQL: SELECT ... FROM sys_user WHERE id=1
12
  ↓ 返回数据，原路返回
13
⑥ Controller 包成 Result.success(user)
14
  ↓
15
⑦ 浏览器收到 {"code":200,"message":"操作成功","data":{...},"timestamp":...}