当前位置： 首页 > news >正文

springboot3 mybatis 数据库操控入门与实战

news 2025/9/30 11:02:28

springboot3 mybatis 数据库操控入门与实战

Mybatis 项目

https://gitee.com/supervol/loong-springboot-study

（记得给个start，感谢）

Mybatis 概述

        在 Spring Boot 3 环境中，MyBatis 作为一款轻量级持久层框架，凭借其对 SQL 的灵活控制和与 Spring 生态的良好兼容性，成为数据访问层的常用选择。

Mybatis 核心

        MyBatis 专注于解决 JDBC 操作的痛点（如手动处理连接、结果集映射等），同时保留开发者对 SQL 的直接控制权，核心特性包括：

  • SQL 与代码解耦：通过 XML 或注解定义 SQL，避免硬编码；
  • 灵活的映射机制：支持对象与数据库表的自动映射（如下划线转驼峰），也可手动配置复杂映射（一对一、一对多关联）；
  • 动态 SQL：通过标签（if、choose、foreach 等）根据条件动态生成 SQL，简化复杂查询；
  • 轻量级：无侵入性，核心依赖少，性能接近原生 JDBC；
  • 与 Spring 无缝集成：通过 mybatis-spring-boot-starter 快速整合到 Spring Boot 3 中，无需手动管理 SqlSession 等组件。

Mybatis 对比

        MyBatis 和 JPA（Java Persistence API）是 Java 生态中最常用的两种持久层技术，它们的设计理念和适用场景有显著差异。

1. 定位与理念

维度MyBatisJPA
定位半自动 ORM 框架（SQL 与对象映射分离）ORM 规范（通常指 Hibernate 等实现，全自动 ORM）
设计理念聚焦 SQL 控制，保留开发者对 SQL 的直接管理权聚焦对象模型，通过面向对象的方式操作数据库
核心目标简化 JDBC 操作，同时不丢失 SQL 的灵活性消除 SQL 依赖，让开发者以 "操作对象" 的方式操作数据库

2. 核心功能对比

（1）SQL 控制能力

  • MyBatis：完全开放 SQL 控制权，支持 手写 SQL（XML 或注解），开发者可直接编写优化后的原生 SQL、存储过程、复杂联合查询等。例：通过 XML 或 @Select 注解直接定义 SQL：

  • JPA：屏蔽 SQL 细节，通过 JPQL（面向对象的查询语言） 或 Criteria API 操作数据，SQL 由框架（如 Hibernate）自动生成。例：通过 JPQL 查询：

    @Query("SELECT u FROM User u WHERE u.age > :minAge ORDER BY u.createTime DESC")
List findByAgeGreaterThan(@Param("minAge") int minAge);

    复杂场景下也可手写原生 SQL，但违背 JPA "屏蔽 SQL" 的设计初衷。

（2）映射关系

  • MyBatis：需手动配置 结果映射（ResultMap） 处理对象关联（一对一、一对多等），灵活性高但配置繁琐。例：一对多映射：

  • JPA：通过注解（@OneToOne、@OneToMany 等）自动维护关联关系，框架会自动生成关联查询的 SQL。例：一对多映射：

    @Entity
public class User {@Idprivate Long id;@OneToMany(mappedBy = "user") // 自动关联 Order 中的 user 字段private List orders;
}

（3）开发效率

  • MyBatis：

    • 简单 CRUD 需手动编写 SQL（或通过代码生成工具生成），开发速度较慢；
    • 复杂查询时，手写 SQL 反而更高效（避免框架生成冗余 SQL）。

  • JPA：

    • 基于 Spring Data JPA 时，通过继承 JpaRepository 可直接获得 CRUD、分页、排序等功能，无需编写实现；
    • 例：public interface UserRepository extends JpaRepository<User, Long> 即可直接调用 findAll()、save() 等方法；
    • 简单业务场景下开发效率极高，复杂场景需额外配置（如自定义 JPQL）。

（4）性能与优化

  • MyBatis：

    • 性能接近原生 JDBC，因为 SQL 可控，可针对性优化（如索引利用、查询字段精简）；
    • 无额外缓存（需手动集成 Redis 等），但避免了框架级缓存的复杂性。

  • JPA（以 Hibernate 为例）：

    • 自动生成的 SQL 可能存在冗余（如关联查询过度加载），需通过 fetch = FetchType.LAZY 等配置优化；
    • 内置一级缓存（Session 级）和二级缓存（全局），可减少重复查询，但缓存配置不当易引发数据一致性问题。

（5）学习曲线

  • MyBatis：门槛低，对熟悉 SQL 的开发者友好，核心只需掌握 Mapper 接口、XML 映射规则即可。

  • JPA：门槛较高，需理解 ORM 核心概念（如持久化上下文、脏检查）、JPQL 语法、关联映射策略等，初期学习成本高。

3. 适用场景

框架适用场景不适用场景
MyBatis1. 需精细控制 SQL（如复杂报表、多表联合查询）；2. 数据库设计不规范（字段名与对象属性差异大）；3. 团队熟悉 SQL 优化；4. 对性能要求极高的场景。1. 快速开发简单 CRUD 业务；2. 团队更擅长面向对象编程而非 SQL。
JPA1. 业务简单（以 CRUD 为主），需快速迭代；2. 数据库设计规范，适合 ORM 映射；3. 团队偏好面向对象编程，希望减少 SQL 编写。1. 复杂 SQL 场景（如多表嵌套查询、存储过程）；2. 需深度优化 SQL 性能的场景。

Mybatis 示例

        请参考项目地址中 springboot-orm/springboot-mybatis 模块代码。

Mybatis 集成

1. 添加依赖

        在 pom.xml 中引入核心依赖：


org.springframework.bootspring-boot-starter-parent3.2.0

org.springframework.bootspring-boot-starter-weborg.mybatis.spring.bootmybatis-spring-boot-starter3.0.3 com.mysqlmysql-connector-jruntimecom.zaxxerHikariCPorg.springframework.bootspring-boot-starter-testtest

2. 核心配置

        在 src/main/resources/application.yaml 中配置：

spring:datasource:driver-class-name: com.mysql.cj.jdbc.Driverurl: jdbc:mysql://localhost:3306/test_db?useSSL=false&serverTimezone=UTC&allowPublicKeyRetrieval=trueusername: rootpassword: 123456hikari: # HikariCP 配置maximum-pool-size: 10 # 最大连接数minimum-idle: 5 # 最小空闲连接
mybatis:mapper-locations: classpath:mybatis/mappers/*.xml # Mapper XML 文件位置type-aliases-package: com.example.demo.entity # 实体类别名包（简化 XML 中的类名）configuration:map-underscore-to-camel-case: true # 开启下划线转驼峰（如数据库字段 user_name → 实体类 userName）log-impl: org.apache.ibatis.logging.stdout.StdOutImpl # 打印 SQL 日志（开发环境用）

3. 创建实体类

package com.example.demo.entity;
public class User {private Long id;private String username; // 对应数据库 user_name（下划线转驼峰生效）private Integer age;// 省略 getter、setter、toString
}

4. 创建 Mapper 接口

        定义数据操作方法：

package com.example.demo.mapper;
import com.example.demo.entity.User;
import org.apache.ibatis.annotations.Mapper;
import java.util.List;
// @Mapper 标识为 MyBatis 映射接口（或在启动类用 @MapperScan 批量扫描）
@Mapper
public interface UserMapper {// 查询所有用户List findAll();// 根据 ID 查询User findById(Long id);// 新增用户int insert(User user);// 更新用户int update(User user);// 删除用户int deleteById(Long id);
}

5. 编写 Mapper XML

        在 src/main/resources/mybatis/mappers/UserMapper.xml 中编写 SQL：

INSERT INTO user (username, age) VALUES (#{username}, #{age})UPDATE user SET username = #{username}, age = #{age} WHERE id = #{id}DELETE FROM user WHERE id = #{id}

6. 编写核心代码

// Service 层（业务逻辑）
package com.example.demo.service;
import com.example.demo.entity.User;
import com.example.demo.mapper.UserMapper;
import org.springframework.stereotype.Service;
import java.util.List;
@Service
public class UserService {private final UserMapper userMapper;// 构造器注入（Spring Boot 3 推荐）public UserService(UserMapper userMapper) {this.userMapper = userMapper;}public List getAllUsers() {return userMapper.findAll();}public User getUserById(Long id) {return userMapper.findById(id);}public void addUser(User user) {userMapper.insert(user);}
}
// Controller 层（接口暴露）
package com.example.demo.controller;
import com.example.demo.entity.User;
import com.example.demo.service.UserService;
import org.springframework.web.bind.annotation.*;
import java.util.List;
@RestController
@RequestMapping("/users")
public class UserController {private final UserService userService;public UserController(UserService userService) {this.userService = userService;}@GetMappingpublic List getAll() {return userService.getAllUsers();}@GetMapping("/{id}")public User getById(@PathVariable Long id) {return userService.getUserById(id);}@PostMappingpublic String add(@RequestBody User user) {userService.addUser(user);return "新增成功，ID：" + user.getId();}
}

7. 启动类与测试

package com.example.demo;
import org.mybatis.spring.annotation.MapperScan;
import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
// @MapperScan 批量扫描 Mapper 接口（替代每个接口加 @Mapper）
@SpringBootApplication
@MapperScan("com.example.demo.mapper")
public class DemoApplication {public static void main(String[] args) {SpringApplication.run(DemoApplication.class, args);}
}

启动后，访问 http://localhost:8080/users 即可测试接口。

Mybatis 高级

1. 动态 SQL

        通过 <if>、<choose>、<foreach> 等标签动态生成 SQL：

2. 分页查询

        添加依赖：

com.github.pagehelperpagehelper-spring-boot-starter1.4.6

        使用方式：

// Service 中
public PageInfo getUsersByPage(int pageNum, int pageSize) {PageHelper.startPage(pageNum, pageSize); // 分页拦截List users = userMapper.findAll();return new PageInfo<>(users); // 封装分页信息
}

3. 事务管理

        通过 Spring 的 @Transactional 注解控制事务：

@Service
public class UserService {// ...@Transactional // 方法内所有操作要么全成功，要么全回滚public void batchAdd(List users) {for (User user : users) {userMapper.insert(user);}}
}

4. 多数据源配置

        通过 @Configuration 配置多个数据源，配合 @MapperScan 指定不同 Mapper 对应的数据源：

@Configuration
public class DataSourceConfig {@Primary // 默认数据源@Bean@ConfigurationProperties("spring.datasource.first")public DataSource firstDataSource() {return DataSourceBuilder.create().build();}@Bean@ConfigurationProperties("spring.datasource.second")public DataSource secondDataSource() {return DataSourceBuilder.create().build();}
}

Mybatis 注意

  1. 版本兼容性：MyBatis-Spring-Boot-Starter 需使用 3.x 版本（适配 Spring Boot 3）；
  2. 包名迁移：Spring Boot 3 基于 Jakarta EE，若使用 javax.persistence 相关注解，需替换为 jakarta.persistence；
  3. Mapper 扫描：确保 @Mapper 或 @MapperScan 正确配置，否则会出现 "No qualifying bean" 错误；
  4. SQL 日志：生产环境建议关闭 log-impl 配置，避免性能损耗。

http://www.hskmm.com/?act=detail&tid=21304

相关文章：

  • 解决winform调用wpf窗体时原窗体缩小的问题
  • 重构 Java 系统服务！JBoltAI 框架以 AIGS 方案开启企业数智化转型
  • 本土化优势凸显：Gitee如何成为中国开发团队的效率引擎
  • Linux系统OOM终止Oracle进程
  • Filebeat写ElasticSearch故障排查思路（上） - 教程
  • 数字化转型浪潮下，CI/CD工具如何成为企业软件开发效率的加速器？
  • linux 删除服务
  • Verl实验
  • 适配 20 + 主流 AI 模型！JBoltAI 框架让 Java AI 应用兼容性拉满
  • 告别 “一刀切” 管理！MyEMS 为不同行业定制专属能源优化方案
  • Fourier Features Let Networks Learn High Frequency Functions in Low Dimensional Domains
  • 「突发奇想，灵光乍现」 - hello
  • jenkins 用户权限 管理配置
  • DirectX- DLL修复工具 免费下载！绿色单文件版！安装使用教程
  • 测试集成CI/CD的五大实践：构建高效质量保障体系
  • DirectX修复工具官方中文增强版下载！下载安装教程（附安装包），0xc000007b错误解决办法
  • 死锁的处理策略-避免死锁
  • 7、微服务中 DTO、VO、PO、BO 的设计规范 - 指南
  • Gitee崛起：中国代码托管平台的自主创新之路
  • 9-30
  • 探索 Nim 中的 sequtils 与箭头语法 —— 立即计算与惰性计算的那些事
  • 250930
  • Gitee：中国开发者生态中的本土化代码托管领导者
  • 价值博弈白箱：元人文AI的可审计未来
  • 八段锦
  • Gitee崛起：中国开发者生态的破局者与赋能引擎
  • 【VMware Workstation】Debian 13 桌面版安装
  • B树，B+树技术分享
  • 无管理员权限电脑完成MySQL数据库创建流程
  • 机台设备数据管理：提升生产效率的关键策略