Spring Boot 整合mybatis

2025/4/3

向全栈工程师迈进！！！

配置文件在实际开发中如何使用呢，接下去将通过Spring Boot整合mybatis来看配置文件如何在实际开发中被使用。

一、引入mybatis起步依赖

在pom.xml中引入mybatis的起步依赖，如下。

在这个起步依赖的内部，还会自动把一些会被使用到的bean对象注入到IOC容器中。但是想用让mybatis正确的去操作数据库，那就还需要在配置文件中编写相应的配置文件。

二、测试案例

当如上都正确的配置好的，就可以正常的去编写controller层、service层、mapper层。浏览器按着下图依次访问，数据在依次传到浏览器上。

 2.1添加起步依赖

pom.xml文件中添加下图的起步依赖，包括mysql的起步依赖，因为是让mybatis去操作mysql的。

 由于是操作mysql，所以需要去配置文件（application.yml）写mysql的相关信息，加上要操作的数据库。以及数据库的密码信息等。

spring:
  datasource:
    driver-class-name: com.mysql.cj.jdbc.Driver
    url: jdbc:mysql://localhost:3306/你的数据库名字?serverTimezone=Asia/Shanghai&useUnicode=true&characterEncoding=utf-8
    username: root
    password: 123456

2.2 编写相应的代码

先编写一个User实体类，要和数据库的中的字段相对应，其User数据库如下

编写的实体类如下：

package com.example.demo.entity;

public class User {

    private int id;
    private String name;
    private int age;
    private String sex;

    public User() {

    }

    public User(int id, String name, int age, String sex) {
        this.id = id;
        this.name = name;
        this.age = age;
        this.sex = sex;
    }

    public int getId() {
        return id;
    }

    public void setId(int id) {
        this.id = id;
    }

    public String getName() {
        return name;
    }

    public void setName(String name) {
        this.name = name;
    }

    public int getAge() {
        return age;
    }

    public void setAge(int age) {
        this.age = age;
    }

    public String getSex() {
        return sex;
    }

    public void setSex(String sex) {
        this.sex = sex;
    }

    @Override
    public String toString() {
        return "User{" +
                "id=" + id +
                ", name='" + name + '\'' +
                ", age=" + age +
                ", sex='" + sex + '\'' +
                '}';
    }
}

 编写mapper层，直接和数据库交互的层。

package com.example.demo.mapper;

import com.example.demo.entity.User;
import org.apache.ibatis.annotations.Mapper;
import org.apache.ibatis.annotations.Select;

@Mapper
public interface UserMapper {

    @Select("SELECT * FROM test WHERE id = #{id}")
    public User getUserById(int id);
}

编写service接口：

package com.example.demo.service;

import com.example.demo.entity.User;

public interface UserSerivce {

    public User getUserById(int id);
}

编写service的实现类

package com.example.demo.service.impl;

import com.example.demo.entity.User;
import com.example.demo.mapper.UserMapper;
import com.example.demo.service.UserSerivce;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.stereotype.Service;

@Service
public class UserSerivceImpl implements UserSerivce {

    @Autowired
    private UserMapper userMapper;

    @Override
    public User getUserById(int id){
        return userMapper.getUserById(id);
    }
}

编写controller 层，和浏览器之间交互的层。

package com.example.demo.controller;

import com.example.demo.entity.User;
import com.example.demo.service.UserSerivce;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RestController;

@RestController
public class UserController {

    @Autowired
    private UserSerivce userSerivce;

    @RequestMapping("/getById")
    public User getUserById(int id) {
        return userSerivce.getUserById(id);
    }
}

编写完成后，我们就可以启动这个程序运行起来，看看效果。

三、在运行过程中可能会出现的问题

3.1 版本不兼容 

Spring Boot 和 MyBatis 的版本兼容性，我使用的Spring Boot 是3.4.4 版本，而MyBatis Spring Boot Starter 使用的是 3.0.0 版本，在运行的时候就导致出错了，所以如下将Spring Boot改成了3.2.3，然后MyBatis Spring Boot Starter 使用的是 3.0.3的 版本。

<?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>
        <!--boot工程的父工程 用于管理起步依赖的版本-->
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-parent</artifactId>
        <version>3.2.3</version>
        <relativePath/> <!-- lookup parent from repository -->
    </parent>
    <groupId>com.example</groupId>
    <artifactId>demo1</artifactId>
    <version>0.0.1-SNAPSHOT</version>
    <name>demo1</name>
    <description>demo1</description>
    <url/>
    <licenses>
        <license/>
    </licenses>
    <developers>
        <developer/>
    </developers>
    <scm>
        <connection/>
        <developerConnection/>
        <tag/>
        <url/>
    </scm>
    <properties>
        <java.version>17</java.version>
        <mybatis.version>3.0.3</mybatis.version>
    </properties>
    <dependencies>
        <dependency>
            <!--web起步依赖 并没有写版本号-->
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-web</artifactId>
        </dependency>

        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-test</artifactId>
            <scope>test</scope>
        </dependency>

        <dependency>
            <groupId>com.mysql</groupId>
            <artifactId>mysql-connector-j</artifactId>
            <scope>runtime</scope>
        </dependency>

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

    <build>
        <plugins>
            <plugin>
                <groupId>org.springframework.boot</groupId>
                <artifactId>spring-boot-maven-plugin</artifactId>
            </plugin>
        </plugins>
    </build>

</project>

2025/4/3 

保持好奇......