Spring Boot 3整合MyBatis和Druid实现会计记账表CRUD实例

脚本专家

随着Spring Boot 3的发布，许多开发者开始将项目升级至此版本。本文通过一个会计记账表（accounting）的增删改查示例，演示如何在Spring Boot 3中整合MyBatis和Druid数据源。

环境要求：JDK 17+、Spring Boot 3.x。

1. 添加项目依赖
在pom.xml中引入核心依赖：

2. <!-- Spring Boot Starter Web -->
3. <dependency>
4.     <groupId>org.springframework.boot</groupId>
5.     <artifactId>spring-boot-starter-web</artifactId>
6. </dependency>
7. <!-- MyBatis Spring Boot Starter -->
8. <dependency>
9.     <groupId>org.mybatis.spring.boot</groupId>
10.     <artifactId>mybatis-spring-boot-starter</artifactId>
11.     <version>3.0.2</version>
12. </dependency>
13. <!-- Druid Spring Boot Starter -->
14. <dependency>
15.     <groupId>com.alibaba</groupId>
16.     <artifactId>druid-spring-boot-3-starter</artifactId>
17.     <version>1.2.20</version>
18. </dependency>
19. <!-- MySQL Connector -->
20. <dependency>
21.     <groupId>com.mysql</groupId>
22.     <artifactId>mysql-connector-j</artifactId>
23.     <scope>runtime</scope>
24. </dependency>

复制代码

注意：Druid在Spring Boot 3下需使用druid-spring-boot-3-starter，否则可能不兼容。

2. 配置数据源和MyBatis
在application.yml中配置Druid数据源以及MyBatis映射路径：

2. spring:
3.   datasource:
4.     url: jdbc:mysql://localhost:3306/test?useUnicode=true&characterEncoding=utf8&serverTimezone=Asia/Shanghai
5.     username: root
6.     password: your_password
7.     driver-class-name: com.mysql.cj.jdbc.Driver
8.     type: com.alibaba.druid.pool.DruidDataSource
9.     druid:
10.       initial-size: 5
11.       min-idle: 5
12.       max-active: 20
13.       max-wait: 60000
14.       stat-view-servlet:
15.         enabled: true
16.         url-pattern: /druid/*
17. mybatis:
18.   mapper-locations: classpath:mapper/*.xml
19.   type-aliases-package: com.example.entity
20.   configuration:
21.     map-underscore-to-camel-case: true

复制代码

这里开启了下划线到驼峰的自动映射，便于实体类属性与数据库字段对应。

3. 数据库表结构
原文提供了accounting表，采用InnoDB引擎、utf8_general_ci字符集。建表语句如下：

2. -- 会计记账表
3. DROP TABLE IF EXISTS `accounting`;
4. CREATE TABLE `accounting` (
5.   `acc_ID` varchar(50) NOT NULL COMMENT 'ID',
6.   `acc_Category` varchar(50) COMMENT '类型（餐饮、交通等）',
7.   `acc_Item` varchar(50) DEFAULT NULL COMMENT '支付行为',
8.   `acc_Name` varchar(50) DEFAULT NULL COMMENT '名称',
9.   `acc_Amount` decimal(8,2) COMMENT '金额',
10.   `acc_Type` bit COMMENT '账单类型（1收入/0支出）',
11.   `acc_ByTime` date COMMENT '发生日期',
12.   `acc_Notes` varchar(2000) DEFAULT NULL COMMENT '备注',
13.   `acc_Count` double DEFAULT NULL COMMENT '数量',
14.   `acc_AtTime` datetime COMMENT '操作日期',
15.   PRIMARY KEY (`acc_ID`) USING BTREE
16. ) ENGINE=InnoDB DEFAULT CHARSET=utf8 COLLATE=utf8_general_ci COMMENT='会计记账';

复制代码

注意：原表主键字段为`accID`，建表语句中写的`acc_ID`，实际以SQL为准。

4. 实体类
创建对应实体，字段使用下划线转驼峰命名：

2. package com.example.entity;
4. import java.math.BigDecimal;
5. import java.time.LocalDate;
6. import java.time.LocalDateTime;
8. public class Accounting {
9.     private String accId;
10.     private String accCategory;
11.     private String accItem;
12.     private String accName;
13.     private BigDecimal accAmount;
14.     private Boolean accType;  // true收入，false支出
15.     private LocalDate accByTime;
16.     private String accNotes;
17.     private Double accCount;
18.     private LocalDateTime accAtTime;
19.     // getter/setter省略（可用lombok @Data简化）
20. }

复制代码

5. Mapper接口和XML
新建Mapper接口：

2. package com.example.mapper;
4. import com.example.entity.Accounting;
5. import org.apache.ibatis.annotations.Mapper;
6. import java.util.List;
8. @Mapper
9. public interface AccountingMapper {
10.     List<Accounting> findAll();
11.     Accounting findById(String id);
12.     int insert(Accounting accounting);
13.     int update(Accounting accounting);
14.     int deleteById(String id);
15. }

复制代码

在resources/mapper/下创建AccountingMapper.xml：

2. <?xml version="1.0" encoding="UTF-8" ?>
3. <!DOCTYPE mapper PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN"
4.         "http://mybatis.org/dtd/mybatis-3-mapper.dtd">
5. <mapper namespace="com.example.mapper.AccountingMapper">
6.     <resultMap id="BaseResultMap" type="Accounting">
7.         <id column="acc_ID" property="accId" />
8.         <result column="acc_Category" property="accCategory" />
9.         <result column="acc_Item" property="accItem" />
10.         <result column="acc_Name" property="accName" />
11.         <result column="acc_Amount" property="accAmount" />
12.         <result column="acc_Type" property="accType" />
13.         <result column="acc_ByTime" property="accByTime" />
14.         <result column="acc_Notes" property="accNotes" />
15.         <result column="acc_Count" property="accCount" />
16.         <result column="acc_AtTime" property="accAtTime" />
17.     </resultMap>
19.     <select id="findAll" resultMap="BaseResultMap">
20.         SELECT * FROM accounting
21.     </select>
23.     <select id="findById" resultMap="BaseResultMap" parameterType="String">
24.         SELECT * FROM accounting WHERE acc_ID = #{id}
25.     </select>
27.     <insert id="insert" parameterType="Accounting">
28.         INSERT INTO accounting (acc_ID, acc_Category, acc_Item, acc_Name, acc_Amount, acc_Type, acc_ByTime, acc_Notes, acc_Count, acc_AtTime)
29.         VALUES (#{accId}, #{accCategory}, #{accItem}, #{accName}, #{accAmount}, #{accType}, #{accByTime}, #{accNotes}, #{accCount}, #{accAtTime})
30.     </insert>
32.     <update id="update" parameterType="Accounting">
33.         UPDATE accounting
34.         SET acc_Category = #{accCategory},
35.             acc_Item = #{accItem},
36.             acc_Name = #{accName},
37.             acc_Amount = #{accAmount},
38.             acc_Type = #{accType},
39.             acc_ByTime = #{accByTime},
40.             acc_Notes = #{accNotes},
41.             acc_Count = #{accCount},
42.             acc_AtTime = #{accAtTime}
43.         WHERE acc_ID = #{accId}
44.     </update>
46.     <delete id="deleteById" parameterType="String">
47.         DELETE FROM accounting WHERE acc_ID = #{id}
48.     </delete>
49. </mapper>

复制代码

6. Service层和Controller
Service接口：

2. public interface AccountingService {
3.     List<Accounting> findAll();
4.     Accounting findById(String id);
5.     void save(Accounting accounting);
6.     void update(Accounting accounting);
7.     void delete(String id);
8. }

复制代码

实现类（使用@Transactional）：

2. @Service
3. @Transactional
4. public class AccountingServiceImpl implements AccountingService {
5.     @Autowired
6.     private AccountingMapper mapper;
8.     @Override
9.     public List<Accounting> findAll() {
10.         return mapper.findAll();
11.     }
13.     @Override
14.     public Accounting findById(String id) {
15.         return mapper.findById(id);
16.     }
18.     @Override
19.     public void save(Accounting accounting) {
20.         mapper.insert(accounting);
21.     }
23.     @Override
24.     public void update(Accounting accounting) {
25.         mapper.update(accounting);
26.     }
28.     @Override
29.     public void delete(String id) {
30.         mapper.deleteById(id);
31.     }
32. }

复制代码

Controller层提供REST接口：

2. @RestController
3. @RequestMapping("/accounting")
4. public class AccountingController {
5.     @Autowired
6.     private AccountingService service;
8.     @GetMapping
9.     public List<Accounting> list() {
10.         return service.findAll();
11.     }
13.     @GetMapping("/{id}")
14.     public Accounting get(@PathVariable String id) {
15.         return service.findById(id);
16.     }
18.     @PostMapping
19.     public String add(@RequestBody Accounting accounting) {
20.         service.save(accounting);
21.         return "success";
22.     }
24.     @PutMapping
25.     public String update(@RequestBody Accounting accounting) {
26.         service.update(accounting);
27.         return "success";
28.     }
30.     @DeleteMapping("/{id}")
31.     public String delete(@PathVariable String id) {
32.         service.delete(id);
33.         return "success";
34.     }
35. }

复制代码

7. 测试验证
启动Spring Boot应用后，可用Postman或curl测试。例如插入一条原文示例数据：

2. curl -X POST http://localhost:8080/accounting \
3. -H "Content-Type: application/json" \
4. -d '{
5.   "accId":"1",
6.   "accCategory":"交通",
7.   "accItem":"现金",
8.   "accName":"测试",
9.   "accAmount":88.56,
10.   "accType":true,
11.   "accByTime":"2025-01-23",
12.   "accAtTime":"2025-01-23T10:00:00"
13. }'

复制代码

也可在数据库直接执行原文提供的Insert语句完成数据初始化。

8. 总结
本文基于Spring Boot 3，整合MyBatis和Druid数据源，实现了对会计记账表的完整CRUD操作。关键点包括：使用druid-spring-boot-3-starter兼容Spring Boot 3；MyBatis Mapper XML中字段映射时注意下划线与驼峰转换；Druid监控页面可通过/druid/index.html查看连接池状态。此示例代码可作为后续开发财务相关模块的基础脚手架。

热心网友1

感谢楼主分享这么详细的Spring Boot 3整合教程！从依赖配置到数据源、建表语句都写得很清楚，对升级到Spring Boot 3的同学很有参考价值。 提一个小细节：实体类最后一行 `private Boo` 应该是 `private Boolean accType;` 吧？另外建表语句中主键字段是 `acc_ID`，但实体类按驼峰命名会是 `accId`，如果开启了 `map-underscore-to-camel-case: true` 应该可以自动映射，不过最好确认一下字段名与SQL定义一致。 期待楼主后续补充完整的CRUD代码实现，尤其是MyBatis的Mapper和Service层写法，这对初学者会很有帮助。再次感谢分享！