一、项目概述

本次项目使用Spring Boot + MyBatis + SQL Server构建了一个完整的用户管理 RESTful API，实现了用户的增删改查（CRUD）功能。

项目结构：

pet_web_crud/ ├── src/main/java/com/example/ │ ├── PetWebCrudApplication.java // 启动类 │ ├── controller/ │ │ └── UserController.java // 控制器层（RESTful接口） │ ├── service/ │ │ ├── UserService.java // 业务接口 │ │ └── impl/ │ │ └── UserServiceImpl.java // 业务实现 │ ├── mapper/ │ │ └── UserMapper.java // 数据访问层 │ └── pojo/ │ ├── User.java // 实体类 │ └── Result.java // 统一返回结果 ├── src/main/resources/ │ └── application.properties // 配置文件 └── pom.xml // 依赖管理

二、RESTful 风格的理解与实践

什么是 RESTful？

RESTful 是一种 API 设计规范，核心思想是：

• 用 URL 表示资源（名词，复数形式）

• 用 HTTP 方法表示操作（GET/POST/PUT/DELETE）

• 用状态码表示结果（200/404/500）

我的 RESTful 接口设计

传统风格 vs RESTful 风格对比

RESTful 核心注解使用

java

@RestController // 标识为REST控制器，返回JSON @RequestMapping("/api/users") // 统一资源路径 @GetMapping // 处理GET请求 @PostMapping // 处理POST请求 @PutMapping // 处理PUT请求 @DeleteMapping // 处理DELETE请求 @PathVariable // 获取URL路径参数 @RequestBody // 获取请求体JSON数据 @RequestParam // 获取URL查询参数

三、开发过程中的问题与解决

环境与配置问题

数据库连接问题

后端代码问题

前端页面问题

项目名问题

SQL Server 保留关键字冲突

现象：

SQL: SELECT * FROM user ORDER BY id DESC Cause: 关键字 'user' 附近有语法错误

原因：user是 SQL Server 的保留关键字，不能直接作为表名

解决：两种方案

1. 表名加方括号：SELECT * FROM [user]

2. 表名改为复数：user→users

我选择了方案2，并统一使用[users]避免冲突

收获：学习了 SQL Server 保留关键字问题，以及[]的转义用法

前后端接口路径不匹配

现象：访问/userfindAll返回404，实际接口是/api/users

原因：前端请求路径和后端Controller路径不一致

解决：

• 统一使用/api/users作为基础路径

• 利用@RequestMapping("/api/users")统一管理

收获：理解了前后端分离中接口路径统一的重要性

静态页面无数据

现象：页面显示了，但表格是空的

原因：静态HTML不会自动获取数据，需要前后端联动

解决：

• 后端提供 RESTful API 接口

• 前端通过 fetch/AJAX 调用接口获取数据

收获：理解了前后端分离的工作模式

三、CRUD 功能完整流程

查询（Readext）

用户打开页面 → Vue mounted() → axios.get('/api/users') → UserController.list() → UserService.search() → UserMapper.findAll() → SQL查询 → 返回JSON → 表格渲染

新增（Create）

点击"新增用户" → 跳转 user_insert.html → 填写表单 → 点击"确认新增" → axios.post('/api/users', data) → UserController.add() → UserService.insert() → UserMapper.insert() → SQL插入 → 跳转回列表页

修改（Update）

点击"修改" → 跳转 user_edit.html?id=1 → 加载数据回显 → 修改表单 → 点击"保存修改" → axios.put('/api/users', data) → UserController.update() → UserService.update() → UserMapper.update() → SQL更新 → 跳转回列表页

删除（Delete）

点击"删除" → 跳转 user_delete.html?id=1 → 显示确认信息 → 点击"确认删除" → axios.delete('/api/users/1') → UserController.delete() → UserService.delete() → UserMapper.delete() → SQL删除 → 跳转回列表页

四、核心知识点

1. Spring Boot 注解

2. MyBatis 注解

3. Vue.js 核心

4. HTTP 请求方法对应 CRUD

五、各层之间的链接关系

完整请求流程

浏览器/Apifox ↓ (GET /api/users) [Controller层] UserController ↓ 调用 userService.search(keyword) [Service层] UserServiceImpl ↓ 调用 userMapper.search(keyword) [Mapper层] UserMapper ↓ 执行 SQL: SELECT * FROM [users] WHERE ... [数据库] SQL Server ↓ 返回数据 List<User> [Mapper层] 将数据封装为 User 对象 ↓ 返回数据 [Service层] 处理业务逻辑 ↓ 返回 List<User> [Controller层] 封装为 Result.success(users) ↓ 返回 JSON 浏览器/Apifox (收到JSON数据)

各层职责说明

数据流转过程

java

// 1. 前端发送请求 GET /api/users // 2. Controller 接收请求 @GetMapping public Result list(@RequestParam(required = false) String keyword) { // 3. 调用 Service List<User> users = userService.search(keyword); // 6. 返回统一格式响应 return Result.success(users); } // 4. Service 处理业务逻辑 @Override public List<User> search(String keyword) { // 5. 调用 Mapper 操作数据库 return userMapper.search(keyword); } // 7. Mapper 执行 SQL @Select("SELECT * FROM [users] WHERE username LIKE CONCAT('%', #{keyword}, '%')") List<User> search(String keyword);

统一响应格式

json

{ "code": 200, "message": "success", "data": [ { "id": 1, "username": "admin", "name": "管理员", "role": "管理员", "phone": "13800000000", "email": "admin@example.com", "address": "北京市" } ] }

各环节的详细链接

前端 → 后端（HTTP 请求）

javascript

// 前端 (user_list.html) axios.get('/api/users') .then(res => { this.userList = res.data.data; }); java // 后端 (UserController.java) @GetMapping("/api/users") public Result list() { return Result.success(userService.findAll()); }

Controller → Service（依赖注入）

java

// UserController.java @Autowired // ← Spring 自动注入 private UserService userService; // UserServiceImpl.java @Service // ← 标记为 Service 组件 public class UserServiceImpl implements UserService { ... }

Service → Mapper（数据访问）

java

// UserServiceImpl.java @Autowired // ← 自动注入 Mapper private UserMapper userMapper; // UserMapper.java @Mapper // ← 标记为 MyBatis Mapper public interface UserMapper { ... }

Mapper → 数据库（SQL 执行）

java

@Select("SELECT * FROM [users] ORDER BY id DESC") List<User> findAll();

六、关键技术栈总结

七、学习收获

1. RESTful 设计规范

• URL 使用名词复数表示资源

• HTTP 方法表示操作（GET/POST/PUT/DELETE）

• 路径参数传递资源ID

2. Spring Boot 分层架构

• Controller → Service → Mapper 三层结构

• 每层职责清晰，便于维护和测试

3. 前后端分离模式

• 后端只提供 JSON 数据接口

• 前端通过 AJAX/fetch 获取数据并渲染

4. 异常处理与调试

• 学会通过错误日志定位问题

• 理解 SQL 语法错误、路径错误、表名错误等常见问题

八、测试验证

所有接口通过 Apifox 测试验证通过：

最终效果

添加用户

删除用户

改用户信息

查找用户