SpringBoot集成Mybatis 【图文教程】

于 2025-06-30 09:22:50 发布
阅读量1.0k 收藏 23
点赞数 35
CC 4.0 BY-SA版权
分类专栏： SpringBoot教程 文章标签： spring boot mybatis 后端
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/hugejiletuhugejiltu/article/details/149009642

文章目录

在这里插入图片描述

一，SpringBoot 与 MyBatis 介绍

SpringBoot 是 Spring 框架的扩展，它简化了 Spring 应用的初始搭建和开发过程，通过自动配置和起步依赖，让开发者可以更专注于业务逻辑。

MyBatis 是一款优秀的持久层框架，它支持自定义 SQL、存储过程以及高级映射，避免了几乎所有的 JDBC 代码和手动设置参数以及获取结果集的过程。

MyBatis 核心优势在于平衡了 SQL 的灵活性与 ORM 的便捷性。与全自动 ORM 框架相比，MyBatis 允许开发者直接编写原生 SQL，支持复杂查询、存储过程和数据库特定优化，避免了过度封装带来的性能损耗。通过 XML 或注解实现结果集映射，它能处理复杂对象关系，同时保持对查询逻辑的精确控制。

二，集成步骤

  1. 添加依赖
    在pom.xml中添加 SpringBoot 和 MyBatis 的依赖：
<dependencies>
    <!-- SpringBoot Starter -->
    <dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-web</artifactId>
    </dependency>
    
    <!-- MyBatis Starter -->
    <dependency>
        <groupId>org.mybatis.spring.boot</groupId>
        <artifactId>mybatis-spring-boot-starter</artifactId>
        <version>3.0.2</version>
    </dependency>
    
    <!-- 数据库驱动 -->
    <dependency>
        <groupId>mysql</groupId>
        <artifactId>mysql-connector-java</artifactId>
        <scope>runtime</scope>
    </dependency>
    
    <!-- 其他依赖 -->
    <dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-test</artifactId>
        <scope>test</scope>
    </dependency>
</dependencies>
  1. 配置数据源
    在application.properties中配置数据库连接信息：
# 数据源配置
spring.datasource.url=jdbc:mysql://localhost:3306/yourdbname?useSSL=false&serverTimezone=UTC&allowPublicKeyRetrieval=true
spring.datasource.username=root
spring.datasource.password=yourpassword
spring.datasource.driver-class-name=com.mysql.cj.jdbc.Driver

# MyBatis配置
mybatis.mapper-locations=classpath:mapper/*.xml
mybatis.type-aliases-package=com.example.demo.entity
  1. 创建实体类
package com.example.demo.entity;

public class User {
    private Long id;
    private String username;
    private String password;
    
    // getters and setters
    public Long getId() { return id; }
    public void setId(Long id) { this.id = id; }
    public String getUsername() { return username; }
    public void setUsername(String username) { this.username = username; }
    public String getPassword() { return password; }
    public void setPassword(String password) { this.password = password; }
}
  1. 创建 Mapper 接口
package com.example.demo.mapper;

import com.example.demo.entity.User;
import org.apache.ibatis.annotations.Mapper;
import java.util.List;

@Mapper
public interface UserMapper {
    List<User> findAll();
    User findById(Long id);
    int insert(User user);
    int update(User user);
    int delete(Long id);
}
  1. 创建 Mapper XML 文件
    在resources/mapper目录下创建UserMapper.xml：
<?xml version="1.0" encoding="UTF-8" ?>
<!DOCTYPE mapper PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN" 
"http://mybatis.org/dtd/mybatis-3-mapper.dtd">
<mapper namespace="com.example.demo.mapper.UserMapper">
    
    <select id="findAll" resultType="User">
        SELECT * FROM user
    </select>
    
    <select id="findById" parameterType="Long" resultType="User">
        SELECT * FROM user WHERE id = #{id}
    </select>
    
    <insert id="insert" parameterType="User">
        INSERT INTO user(username, password)
        VALUES (#{username}, #{password})
    </insert>
    
    <update id="update" parameterType="User">
        UPDATE user
        SET username = #{username},
            password = #{password}
        WHERE id = #{id}
    </update>
    
    <delete id="delete" parameterType="Long">
        DELETE FROM user WHERE id = #{id}
    </delete>
</mapper>
  1. 创建 Service 和 Controller
// Service层
package com.example.demo.service;

import com.example.demo.entity.User;
import com.example.demo.mapper.UserMapper;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.stereotype.Service;
import java.util.List;

@Service
public class UserService {
    
    @Autowired
    private UserMapper userMapper;
    
    public List<User> findAll() {
        return userMapper.findAll();
    }
    
    public User findById(Long id) {
        return userMapper.findById(id);
    }
    
    public int insert(User user) {
        return userMapper.insert(user);
    }
    
    public int update(User user) {
        return userMapper.update(user);
    }
    
    public int delete(Long id) {
        return userMapper.delete(id);
    }
}

// Controller层
package com.example.demo.controller;

import com.example.demo.entity.User;
import com.example.demo.service.UserService;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.web.bind.annotation.*;
import java.util.List;

@RestController
@RequestMapping("/users")
public class UserController {
    
    @Autowired
    private UserService userService;
    
    @GetMapping
    public List<User> findAll() {
        return userService.findAll();
    }
    
    @GetMapping("/{id}")
    public User findById(@PathVariable Long id) {
        return userService.findById(id);
    }
    
    @PostMapping
    public int insert(@RequestBody User user) {
        return userService.insert(user);
    }
    
    @PutMapping
    public int update(@RequestBody User user) {
        return userService.update(user);
    }
    
    @DeleteMapping("/{id}")
    public int delete(@PathVariable Long id) {
        return userService.delete(id);
    }
}
  1. 主应用类
package com.example.demo;

import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;

@SpringBootApplication
public class DemoApplication {
    public static void main(String[] args) {
        SpringApplication.run(DemoApplication.class, args);
    }
}

三，注意事项

1. Mapper 接口与 XML 映射
确保 Mapper 接口与 XML 文件中的 namespace 一致方法名和 SQL 语句的 id 保持一致注意参数类型和返回类型的匹配

2. 事务管理
在 Service 层的方法上使用@Transactional注解管理事务确保事务方法在 Service 层而不是 Controller 层

3. SQL 注入问题
使用#{}而不是${}来防止 SQL 注入对于需要动态表名或列名的情况，要手动做好参数校验

4. 分页处理

可以使用 MyBatis 分页插件如 PageHelper 简化分页操作
注意分页插件的配置和使用方式

5. 配置优先级
注意 Java 配置和 XML 配置的优先级，避免冲突推荐使用 Java 配置为主，XML 配置为辅

6. 日志配置
配置 MyBatis 的日志以便调试，可在application.properties中添加：

# properties
logging.level.com.example.demo.mapper=DEBUG

7.性能优化
合理配置缓存，避免过度使用缓存复杂查询使用 ResultMap 进行结果映射批量操作使用标签

8. 注解方式
可以使用@Select、@Insert等注解替代 XML 文件复杂 SQL 建议还是使用 XML 配置

四，利用 idea springboot 集成 mybatis

1. 创建 Spring Boot 项目
请参考 ：https://blog.csdn.net/hugejiletuhugejiltu/article/details/148891905?spm=1011.2124.3001.6209

添加以下依赖：
Spring Web
Spring Data JPA
MySQL Driver（或其他数据库驱动）
MyBatis Framework
在这里插入图片描述
在这里插入图片描述

在这里插入图片描述

2. 配置数据库连接
在application.properties或application.yml中添加数据库配置：

spring.datasource.url=jdbc:mysql://localhost:3306/yourdbname
spring.datasource.username=root
spring.datasource.password=yourpassword
spring.datasource.driver-class-name=com.mysql.cj.jdbc.Driver
# MyBatis配置
mybatis.mapper-locations=classpath:mapper/*.xml
mybatis.type-aliases-package=com.example.demo.entity

3. 创建实体类
创建与数据库表对应的实体类：

package com.example.demo.entity;

public class User {
    private Long id;
    private String username;
    private String password;
    // getters and setters
}

4. 创建 Mapper 接口
定义数据库操作方法：

package com.example.demo.mapper;

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

import java.util.List;

@Mapper
public interface UserMapper {
    List<User> findAll();
    User findById(Long id);
    int insert(User user);
    int update(User user);
    int delete(Long id);
}

5. 创建 Mapper XML 文件
在resources/mapper目录下创建UserMapper.xml：

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE mapper PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN" 
"http://mybatis.org/dtd/mybatis-3-mapper.dtd">
<mapper namespace="com.example.demo.mapper.UserMapper">
    <select id="findAll" resultType="User">
        SELECT * FROM user
    </select>
    
    <select id="findById" parameterType="Long" resultType="User">
        SELECT * FROM user WHERE id = #{id}
    </select>
    
    <insert id="insert" parameterType="User">
        INSERT INTO user(username, password)
        VALUES (#{username}, #{password})
    </insert>
    
    <update id="update" parameterType="User">
        UPDATE user
        SET username = #{username},
            password = #{password}
        WHERE id = #{id}
    </update>
    
    <delete id="delete" parameterType="Long">
        DELETE FROM user WHERE id = #{id}
    </delete>
</mapper>

6. 创建 Service 层

package com.example.demo.service;

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

import java.util.List;

@Service
public class UserService {
    @Autowired
    private UserMapper userMapper;
    
    public List<User> findAll() {
        return userMapper.findAll();
    }
    
    public User findById(Long id) {
        return userMapper.findById(id);
    }
    
    public int insert(User user) {
        return userMapper.insert(user);
    }
    
    public int update(User user) {
        return userMapper.update(user);
    }
    
    public int delete(Long id) {
        return userMapper.delete(id);
    }
}

7. 创建 Controller 层

package com.example.demo.controller;

import com.example.demo.entity.User;
import com.example.demo.service.UserService;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.web.bind.annotation.*;

import java.util.List;

@RestController
@RequestMapping("/users")
public class UserController {
    @Autowired
    private UserService userService;
    
    @GetMapping
    public List<User> findAll() {
        return userService.findAll();
    }
    
    @GetMapping("/{id}")
    public User findById(@PathVariable Long id) {
        return userService.findById(id);
    }
    
    @PostMapping
    public int insert(@RequestBody User user) {
        return userService.insert(user);
    }
    
    @PutMapping
    public int update(@RequestBody User user) {
        return userService.update(user);
    }
    
    @DeleteMapping("/{id}")
    public int delete(@PathVariable Long id) {
        return userService.delete(id);
    }
}

8. 运行项目
启动 Spring Boot 应用，测试 API 接口。你可以使用 Postman 或浏览器访问：

GET http://localhost:8080/users
GET http://localhost:8080/users/1
POST http://localhost:8080/users
PUT http://localhost:8080/users
DELETE http://localhost:8080/users/1

9. 注意事项
确保数据库已创建并正确配置，检查 Mapper 接口和 XML 文件的命名空间匹配
添加@MapperScan注解到主应用类（如果 MyBatis 接口未被自动扫描）：

@SpringBootApplication
@MapperScan("com.example.demo.mapper")
public class DemoApplication {
    public static void main(String[] args) {
        SpringApplication.run(DemoApplication.class, args);
    }
}

五，总结

在 IntelliJ IDEA 中集成 MyBatis 到 Spring Boot 项目，可按以下步骤高效完成：首先通过 Spring Initializr 创建项目，添加 Spring Web、MyBatis Framework、数据库驱动等依赖。接着配置application.properties中的数据库连接信息与 MyBatis 映射文件位置。创建实体类映射数据库表结构，定义 Mapper 接口声明数据库操作方法并添加@Mapper注解。在 resources 目录创建对应 XML 文件实现 SQL 语句，通过 namespace 关联接口。再创建 Service 层调用 Mapper 方法，Controller 层暴露 RESTful 接口。最后运行项目测试接口。注意确保依赖完整、配置无误，必要时添加@MapperScan注解指定扫描路径。

Eclipse中实现SpringBoot与Mybatis整合（图文教程带源码）
BADAO_LIUMANG_QIZHI的博客
03-18 3769
场景 数据库中数据 实现效果 项目结构 前面参照 Eclipse中新建SpringBoot项目并输出HelloWorld https://blog.csdn.net/BADAO_LIUMANG_QIZHI/article/details/88359953 Eclipse中新建SpringBoot项目完成对json、pojo、map、list的请求 https://blo...
SpringBoot 系列教程 Mybatis+xml 整合篇
程序员高级码农的博客
01-08 1950
MyBatis 是一款优秀的持久层框架，它支持定制化 SQL、存储过程以及高级映射。MyBatis 避免了几乎所有的 JDBC 代码和手动设置参数以及获取结果集。MyBatis 可以使用简单的 XML 或注解来配置和映射原生类型、接口和 Java 的 POJO（Plain Old Java Objects，普通老式 Java 对象）为数据库中的记录。本文将通过实例方式，介绍下如何整合 SpringBoot + Mybatis，构建一个支持 CRUD 的 demo 工程。
174. SpringBoot 集成 MyBatis
最新发布
weixin_43484713的博客
06-03 899
摘要：本文介绍了SpringBoot集成MyBatis的基础配置方法。首先需要在项目中引入MyBatis Spring Boot Starter和数据库驱动依赖，并注意版本兼容性。其次在application.yml中配置数据源信息，包括数据库URL、用户名、密码等核心参数，并可优化连接池设置。文章还指出了常见配置误区，如驱动类名错误、时区问题和SSL警告等，并给出了完整的配置示例。对于需要高级功能的项目，可选择性配置MyBatis核心文件或使用分页插件等扩展组件。
SpringBoot——SpringBoot集成MyBatis
贝尔摩德苦艾酒
05-15 9557
SpringBoot——SpringBoot集成MyBatis
Springboot 集成Mybatis
lay_lu的博客
07-26 2992
MyBatis 是一个灵活且强大的数据持久化框架，它允许开发者控制 SQL 执行并提供了多种映射功能。与 Spring Boot 集成后，能够利用 Spring Boot 的自动配置和便利性，简化配置和开发过程。通过以上步骤，你可以快速地将 MyBatis 集成到 Spring Boot 项目中，充分发挥两者的优势，提高开发效率和系统的可维护性。
Spring Boot 集成MyBatis
dawuafang
12-27 856
Spring Boot 集成MyBatis 在集成MyBatis前，我们先配置一个druid数据源。 Spring Boot 集成druid druid有很多个配置选项，使用Spring Boot 的配置文件可以方便的配置druid。 在application.yml配置文件中写上： spring: datasource: name: test ...
SpringBoot整合Mybatis
江哈哈的博客
03-30 302
SpringBoot整合Mybatis 文章目录SpringBoot整合Mybatis0、创建SpringbootMaven工程1、添加Mybatis的起步依赖2 、添加数据库驱动坐标3 、添加数据库连接信息4 、创建user表5 、创建实体Bean6、 编写Mapper7、 配置Mapper映射文件8 、在application.properties中添加mybatis的信息9 、编写测试Controller10 、测试 0、创建SpringbootMaven工程 创建SpringbootMaven工程
SpringBoot结合MyBatis 【超详细】
热门推荐
m0_65563175的博客
10-16 12万+
Spring Boot与MyBatis框架集合实践。内置MyBatis大部分使用技巧，而Spring Boot起到个快速入门的效果。其中MyBatis内容涉及到业务层与数据访问层的传参知识、企业常用的动态SQL拼接、高级映射及延迟加载、以及缓存机制、最后包括PageHelper分页插件
SpringBoot整合Mybatis（详解，一看就会）
m0_67267524的博客
05-19 7147
在resource创建好之后，我们在resource目录下创建application.yml，创建完之后写数据库配置文件，根据自己的 数据库和数据库账号和密码进行更改，改成自己的，以及端口，我这边端口是8081，根据自己可以修改端口，默认是 8080。注：本类中不要忘记写@service，以及依赖注入UserMapper，刚开始可以直接复制我的代码，后面自己去慢慢理解。至此我们的SpringBoot+Mybatis已经整合完毕了 我们运行项目，显示如下，我们已经运行完毕且没有错误。delete用于删除。
intellij IDEA配置springboot的图文教程
08-27
- MyBatis 集成：MyBatis 是一个 SQL 映射框架，可以通过 MyBatis Generator 自动生成 DAO 层代码。配置 generatorConfig.xml 文件，指定数据库信息和生成规则。 - PageHelper 分页插件：PageHelper 是 MyBatis 的...
Spring Boot 集成mybatis
11-03
Spring Boot 集成mybatis,Spring Boot和mybatis整合的开发
springBoot整合mybatis完整详细版
09-27
springBoot整合mybatis完整详细版，简单清晰明了，适合新手拿来研究训练学习，整合教程博客https://blog.csdn.net/iku5200/article/details/82856621
基于spring boot + MybatisPlus 商城管理系统的Java开源商城系统
m0_61926406的博客
12-22 871
基于spring boot + MybatisPlus 商城管理系统的Java开源商城系统
初识Mybatis，并创建第一个Mybatis项目(详细图文教程)
薛定谔的猫的博客
07-23 4780
Spring 集成了 Mybatis 框架，方便我们更加便捷的使用，但是 Mybatis 也可以单独使用，它和 Spring 没有关系。
springboot整合mybatis
weixin_46666822的博客
11-27 1万+
mapper是一个接口，接口不能实例化，也就是不能干活，想让他干活的话就要用动态代理，找一个代理类帮他干活。mapper.xml有具体的sql，想让它执行就要把mapper接口的方法和xml中的sql关联起来。springboot整合mybaits的问题mapper怎么被spring注册为beanDefinitionmapper怎么被实例化mapper方法怎么被执行。
SpringBoot整合MyBatis的步骤
weixin_44953227的博客
03-04 4万+
目录MyBatis 整合包编写接口和xml编写配置文件 application.properties编写 controller 测试使用所有依赖 MyBatis 整合包 <!-- Mybatis https://mvnrepository.com/artifact/org.mybatis.spring.boot/mybatis-spring-boot-starter --> <dependency> <groupId>org.mybatis.spring.boot&lt
Spring Boot与MyBatis
2303_81146124的博客
11-10 4221
Spring Boot是一个用于创建独立的、基于Spring的生产级应用程序的框架，它简化了Spring应用的初始搭建以及开发过程。MyBatis是一款优秀的持久层框架，它支持定制化SQL、存储过程以及高级映射。将Spring Boot和MyBatis结合使用，可以高效地开发数据驱动的应用程序。
SpringBoot集成MyBatis
CoCo629vanilla的博客
03-19 1456
前言： 今天学习了如何使用SpringBoot集成MyBatis，下面我将项目的过程再现一遍，记录下SpringBoot集成MyBatis的过程。 简单了解下MyBatis，MyBatis是持久层框架，实现了对JDBC的封装，主要用于简化JDBC操作中的一些相对繁琐的步骤，例如参数的映射，结果的映射等。 为什么使用MyBatis实现数据持久层呢？ 1、解耦，SQL可维护性高，可复用性高 2、稳定/灵活（支持动态SQL），功能强大（池/日志/缓存） 3、学习成本低 项目大致流程： 项目搭建-&
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值