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

JAVA-springboot整合Mybatis

backend 2025/7/15 2:37:20

SpringBoot从入门到精通-第15章 MyBatis框架

学习MyBatis心路历程

2022年学习java基础时候，想着怎么使用java代码操作数据库，咨询了项目上开发W同事，没有引用框架，操作数据库很麻烦，就帮我写好多行代码，就实现了一个查询语句，至今我也忘记了那些代码大概是个什么样。

2025年果断入手一本SpringBoot从入门到精通纸质版书，纸质版书籍个人理解：

1、有版权，案例有保障；
2、系统性，把前后顺序会设计好；
3、想翻的时候，翻起来有感觉；
4、就是案例比较单一。
然后就是一看就会，一做就废。但是最终只有一个解决方案，那就是动手敲，动手实现，实现过，心里就有底，才能说服自己这个我操作过。以下是我根据案例实操的步骤和结果，展示一下吧。

一、MyBatis简介

Mybatis是一款半自动化的持久层框架，所谓半自动化，就是MyBatis不仅需要程序开发人员手动编写SQL语句，而且需要手动设置SQL语句与实体类的映射关系。

MyBatis和Hibernate
MyBatis和Hibernate都是Java领域中流行的对象关系映射（ORM）框架，它们都旨在简化数据库操作和对象模型之间的交互。尽管它们都提供了类似的解决方案，但在设计理念、使用方式、性能和灵活性等方面存在一些关键差别。

结论
选择MyBatis还是Hibernate主要取决于项目的具体需求、开发团队的偏好以及特定的项目要求。如果项目需要高度定制的SQL并且团队成员熟悉SQL，那么MyBatis可能是更好的选择。如果项目更倾向于减少直接编写SQL的需要并希望减少数据库层面的复杂性，那么Hibernate可能更合适。在实践中，很多团队也会根据项目的不同部分选择使用这两种技术的一个组合，以平衡灵活性和易用性。

二、在Spring Boot项目中整合MyBatis

0、整体结构
在这里插入图片描述

1、整体步骤：

pom.xml添加MyBatis依赖
pom.xml添加数据库驱动依赖
application配置文件添加datasource配置项
创建mapper映射器
在SpringBoot启动类添加用于表示映射器扫描的@MapperScan(basePackages = “com.mr._20250602spring_mybatis”)注解
实现数据库的基本事物，即编写实体类（对应数据库表）
测试类编写测试方法
启动测试类方法测试

2、步骤附代码

pom.xml添加MyBatis依赖

 <dependency><groupId>org.mybatis.spring.boot</groupId><artifactId>mybatis-spring-boot-starter</artifactId><version>2.2.0</version></dependency>

pom.xml添加数据库驱动依赖

<dependency><groupId>mysql</groupId><artifactId>mysql-connector-java</artifactId><version>8.0.16</version>
<!--            <scope>runtime</scope>--></dependency>

application配置文件添加datasource配置项

spring.application.name=20250602spring_mybatis
spring.datasource.url=jdbc:mysql://10.0.0.132:1588/db_video?useUnicode=true&characterEncoding=UTF-8&useSSL=false&serverTimezone=Asia/Shanghai&zeroDateTimeBehavior=CONVERT_TO_NULL&allowPublicKeyRetrieval=true
spring.datasource.username=sun
spring.datasource.password=Sun@123

整体pom.xml文件

<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 https://maven.apache.org/xsd/maven-4.0.0.xsd"><modelVersion>4.0.0</modelVersion>
<!--    <parent>-->
<!--        <groupId>org.springframework.boot</groupId>-->
<!--        <artifactId>spring-boot-starter-parent</artifactId>-->
<!--        <version>3.5.0</version>-->
<!--        <relativePath/> &lt;!&ndash; lookup parent from repository &ndash;&gt;-->
<!--    </parent>--><parent><groupId>org.springframework.boot</groupId><artifactId>spring-boot-starter-parent</artifactId><version>2.5.4</version><relativePath /> <!-- lookup parent from repository --></parent><groupId>com.mr</groupId><artifactId>_20250602spring_mybatis</artifactId><version>0.0.1-SNAPSHOT</version><name>20250602spring_mybatis</name><description>20250602spring_mybatis</description>
<!--    <url/>-->
<!--    <licenses>-->
<!--        <license/>-->
<!--    </licenses>-->
<!--    <developers>-->
<!--        <developer/>-->
<!--    </developers>-->
<!--    <scm>-->
<!--        <connection/>-->
<!--        <developerConnection/>-->
<!--        <tag/>-->
<!--        <url/>-->
<!--    </scm>-->
<!--    <properties>-->
<!--        <java.version>17</java.version>-->
<!--    </properties>--><properties><java.version>11</java.version></properties><dependencies><dependency><groupId>org.springframework.boot</groupId><artifactId>spring-boot-starter-web</artifactId></dependency><dependency><groupId>org.mybatis.spring.boot</groupId><artifactId>mybatis-spring-boot-starter</artifactId><version>2.2.0</version></dependency><!--        <dependency>-->
<!--            <groupId>mysql</groupId>-->
<!--            <artifactId>mysql-connector-java</artifactId>-->
<!--            <scope>runtime</scope>-->
<!--        </dependency>--><dependency><groupId>mysql</groupId><artifactId>mysql-connector-java</artifactId><version>8.0.16</version>
<!--            <scope>runtime</scope>--></dependency><dependency><groupId>org.springframework.boot</groupId><artifactId>spring-boot-starter-test</artifactId><scope>test</scope></dependency></dependencies><build><plugins><plugin><groupId>org.springframework.boot</groupId><artifactId>spring-boot-maven-plugin</artifactId></plugin></plugins></build></project>

创建mapper映射器

package com.mr._20250602spring_mybatis.mapper;import org.apache.ibatis.annotations.Insert;
import org.apache.ibatis.annotations.Select;
import com.mr._20250602spring_mybatis.pojo.T_video;
public interface EmpMapper {
//    @Select("select name from t_video where id = 10")
//    boolean selectAll();@Insert("insert into t_video values(33,'springboot','sun',22)")boolean insertData();
}

在SpringBoot启动类添加用于表示映射器扫描的@MapperScan(basePackages = “com.mr._20250602spring_mybatis”)注解

package com.mr._20250602spring_mybatis;import org.mybatis.spring.annotation.MapperScan;
import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
@MapperScan(basePackages = "com.mr._20250602spring_mybatis")
@SpringBootApplication
public class Application {public static void main(String[] args) {SpringApplication.run(Application.class, args);}}

实现数据库的基本事物，即编写实体类（对应数据库表）

package com.mr._20250602spring_mybatis.pojo;public class T_video {private Integer id;private String name;private String author;private int video_view;public T_video(Integer id, String name, String author, int video_view) {this.id = id;this.name = name;this.author = author;this.video_view = video_view;}public T_video() {}@Overridepublic String toString() {return "T_video{" +"id=" + id +", name='" + name + '\'' +", author='" + author + '\'' +", video_view=" + video_view +'}';}public Integer getId() {return id;}public void setId(Integer id) {this.id = id;}public String getName() {return name;}public void setName(String name) {this.name = name;}public String getAuthor() {return author;}public void setAuthor(String author) {this.author = author;}public int getVideo_view() {return video_view;}public void setVideo_view(int video_view) {this.video_view = video_view;}
}

测试类编写测试方法

package com.mr._20250602spring_mybatis;import com.mr._20250602spring_mybatis.mapper.EmpMapper;
import org.junit.jupiter.api.Test;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.boot.test.context.SpringBootTest;@SpringBootTest
class ApplicationTests {
@AutowiredEmpMapper mapper;@Testvoid contextLoads() {
//        System.out.println("查询id=10 的name");System.out.println("增加一条数据");boolean result;if (mapper.insertData()) result = true;else result = false;System.out.println(result);}}

启动测试类方法测试

增加一条数据
2025-06-02 08:06:34.599  INFO 12944 --- [           main] com.zaxxer.hikari.HikariDataSource       : HikariPool-1 - Starting...
2025-06-02 08:06:34.962  INFO 12944 --- [           main] com.zaxxer.hikari.HikariDataSource       : HikariPool-1 - Start completed.
true

三、SQL语句中添加占位符

package com.mr._20250602spring_mybatis.mapper;import org.apache.ibatis.annotations.Insert;
import org.apache.ibatis.annotations.Select;
import com.mr._20250602spring_mybatis.pojo.T_video;
public interface EmpMapper {
//    @Select("select name from t_video where id = 10")
//    boolean selectAll();@Insert("insert into t_video values(33,'springboot','sun',22)")boolean insertData();@Select("select  name from t_video where id = #{id}")String selectAll(int id);
}

修改测试类

package com.mr._20250602spring_mybatis;import com.mr._20250602spring_mybatis.mapper.EmpMapper;
import org.junit.jupiter.api.Test;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.boot.test.context.SpringBootTest;@SpringBootTest
class ApplicationTests {
@AutowiredEmpMapper mapper;@Testvoid contextLoads() {
//        System.out.println("查询id=10 的name");System.out.println("增加一条数据");boolean result;if (mapper.insertData()) result = true;else result = false;System.out.println(result);}//    @Test
//    void selectData(){
//        System.out.println("查询id=10的name");
//        System.out.println(mapper.selectAll());
//    }
@Test
void selectData(){System.out.println("查询id=10的name");System.out.println(mapper.selectAll(10));
}}

执行测试方法

查询id=10的name
2025-06-02 09:48:46.929  INFO 124 --- [           main] com.zaxxer.hikari.HikariDataSource       : HikariPool-1 - Starting...
2025-06-02 09:48:47.281  INFO 124 --- [           main] com.zaxxer.hikari.HikariDataSource       : HikariPool-1 - Start completed.
零基础学Java

9.数据库表


CREATE DATABASE db_video;
USE db_video;SET FOREIGN_KEY_CHECKS=0;-- ----------------------------
-- Table structure for `t_video`
-- ----------------------------
DROP TABLE IF EXISTS `t_video`;
CREATE TABLE `t_video` (`id` int(11) NOT NULL AUTO_INCREMENT,`name` varchar(100) NOT NULL,`author` varchar(20) DEFAULT NULL,`video_view` int(11) NOT NULL,PRIMARY KEY (`id`)
) ENGINE=InnoDB AUTO_INCREMENT=5 DEFAULT CHARSET=utf8;-- ----------------------------
-- Records of t_video
-- ----------------------------
INSERT INTO `t_video` VALUES ('10', '零基础学Java', '张工程师', '100000');
INSERT INTO `t_video` VALUES ('20', '如何做鱼香肉丝', '李厨师', '80000');
INSERT INTO `t_video` VALUES ('30', '职场日常妆', '王女士', '76000');
INSERT INTO `t_video` VALUES ('40', '动作电影剪辑', '老赵', '66000');

四、引入Controller

mapper接口内容

package com.mr._20250602spring_mybatis.mapper;import org.apache.ibatis.annotations.Insert;
import org.apache.ibatis.annotations.Select;
import com.mr._20250602spring_mybatis.pojo.T_video;
public interface EmpMapper {
//    @Select("select name from t_video where id = 10")
//    boolean selectAll();@Insert("insert into t_video values(33,'springboot','sun',22)")boolean insertData();@Select("select  name from t_video where id = #{id}")String selectAll(int id);
}

Controller类文件内容

package com.mr._20250602spring_mybatis.controller;import com.mr._20250602spring_mybatis.mapper.EmpMapper;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RequestParam;
import org.springframework.web.bind.annotation.RestController;@RestController
@RequestMapping("/springboot")public class a {@AutowiredEmpMapper mapper;@GetMapping("t_video")String video(@RequestParam Integer id){
//        return mapper.selectAll(10);return mapper.selectAll(id);}
}

浏览器访问测试
http://localhost:8080/springboot/t_video?id=10

零基础学Java
在这里插入图片描述

五、引入R类，返回数据库表所有数据

1、引入R类

package com.mr._20250602spring_mybatis.controller;public class R { // 通用返回值类private Boolean bool; // boolean型对象private Object obj; // 实体类对象private String str; // 字符串信息// 为通用返回值类添加无参构造方法和有参构造方法public R() {}public R(Boolean flag) {this.bool = flag;}public R(Boolean flag, Object data) {this.bool = flag;this.obj = data;}public R(Boolean flag, String msg) {this.bool = flag;this.str = msg;}public R(String msg) {this.str = msg;}// 分别为上述的3个属性添加Getter/Setter方法public Boolean getFlag() {return bool;}public void setFlag(Boolean flag) {this.bool = flag;}public Object getData() {return obj;}public void setData(Object data) {this.obj = data;}public String getMsg() {return str;}public void setMsg(String msg) {this.str = msg;}}

2、mapper接口增加select * from t_video

package com.mr._20250602spring_mybatis.mapper;import org.apache.ibatis.annotations.Insert;
import org.apache.ibatis.annotations.Select;
import com.mr._20250602spring_mybatis.pojo.T_video;import java.util.List;public interface EmpMapper {
//    @Select("select name from t_video where id = 10")
//    boolean selectAll();@Insert("insert into t_video values(33,'springboot','sun',22)")boolean insertData();@Select("select  name from t_video where id = #{id}")String selectAll(int id);@Select("select * from t_video")List<T_video> selectall();
}

3、Controller类增加映射路径all

package com.mr._20250602spring_mybatis.controller;import com.mr._20250602spring_mybatis.mapper.EmpMapper;
import com.mr._20250602spring_mybatis.pojo.T_video;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RequestParam;
import org.springframework.web.bind.annotation.RestController;import java.util.List;@RestController
@RequestMapping("/springboot")public class a {@AutowiredEmpMapper mapper;@GetMapping("t_video")String video(@RequestParam Integer id){
//        return mapper.selectAll(10);return mapper.selectAll(id);}@GetMapping("all")public R selectVideo(){return new R(true, mapper.selectall());}
}

4、启动项目，访问测试
在这里插入图片描述

六、遇到的问题

1、依赖版本问题

这里采用的是书本自带的案例库进行了比对，版本对不上的复制了书本案例的版本，比如下面这个是我在IDEA创建项目时生成的spring-boot-starter-parent版本3.5.0，但是有了接口文件后启动项目时候报错了

   <parent><groupId>org.springframework.boot</groupId><artifactId>spring-boot-starter-parent</artifactId><version>3.5.0</version><relativePath/> <!-- lookup parent from repository --></parent>

替换成2.5.4版本后启动成功

<parent> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-parent</artifactId> <version>2.5.4</version> <relativePath />  </parent>
2、SQL语句问题
mapper接口中使用注解方式写sql语句时，字符串值用单引号，避免和注解的整体sql语句的双引号冲突。这里如果写错，启动程序时也会提示sql语句某个位置有异常。比如

@Insert("insert into t_video values(33,'springboot','sun',22)")boolean insertData();

3、步骤前后顺序问题
比如，引用了Mybatis依赖，application配置文件就得有数据库连接信息，不然启动报错

大佬们，小试牛刀，见笑了。更多精彩内容，敬请期待！

查看全文

http://www.xdnf.cn/news/10658.html

Linux 系统 Docker Compose 安装

Spring Cloud 2025 正式发布啦

Vue基础(12)_Vue.js循环语句用法：列表渲染

超声波测距三大算法实测对比

字节跳动开源图标库：2000+图标一键换肤的魔法

深度剖析：AI 建站的现状、局限与未来展望-AI编程建站实战系列预告优雅草卓伊凡

5.RV1126-OPENCV 图形计算面积

Ubuntu22.04 安装 CUDA12.8

SQL Transactions（事务）、隔离机制

Python发送天气预报到企业微信解决方案

A. We Need the Zero

LangGraph framework

《Linux 包管理实战手册：RPM 精准操作与 YUM 自动化部署从入门到精通》

软件测评师第9章基于质量特性的测试与评价笔记

SQL 中的 `CASE WHEN` 如何使用？

CUDA与OpenGL混合编程图形渲染

【Python 算法零基础 4.排序 ⑦ 桶排序】

【算法训练营Day05】哈希表part1

《软件项目管理》第二章（项目准备与启动）期末周复习总结笔记

uniapp中view标签使用范围

Kotlin 中companion object {} 什么时候触发

C语言：内存函数

前端面试高频问题通关指南--通用性问题

Python----目标检测（使用YOLO 模型进行线程安全推理和流媒体源）

SQL：窗口滑动（Sliding Window）

数学建模期末速成最短路径

23. Merge k Sorted Lists

Alist Win 基本用法

JavaSE知识总结（集合篇） ~个人笔记以及不断思考~持续更新

Python中使用pandas