JAVA-springboot整合Mybatis

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、整体步骤：

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

2、步骤附代码

1. pom.xml添加MyBatis依赖

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

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

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

3. 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>

4. 创建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();
}

5. 在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);}}

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

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;}
}

7. 测试类编写测试方法

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);}}

8. 启动测试类方法测试

增加一条数据
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 /> <!-- lookup parent from repository --> </parent>

• 2、SQL语句问题
  mapper接口中使用注解方式写sql语句时，字符串值用单引号，避免和注解的整体sql语句的双引号冲突。这里如果写错，启动程序时也会提示sql语句某个位置有异常。比如

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

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

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