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

MyBatis与 Springboot 的集成

news 2025/7/9 19:11:36

MyBatis 是一个优秀的持久层框架，专注于 SQL 语句的灵活控制，与 Spring Boot 集成可以简化数据库操作，提升开发效率。Spring Boot 提供了与 MyBatis 无缝集成的支持，使得 MyBatis 可以轻松与 Spring Boot 应用结合使用。

一、MyBatis 与 Spring Boot 集成的优势

将 MyBatis 与 Spring Boot 集成的主要优势包括：

  1. 简化配置：Spring Boot 提供了自动配置，减少了手动配置 MyBatis 的工作量。
  2. 简洁的开发模式：通过 @Mapper 注解，MyBatis 的 Mapper 接口可以自动注入到 Spring 的上下文中，简化开发。
  3. 便捷的事务管理：Spring Boot 支持基于注解的事务管理，使得 MyBatis 的事务操作更加容易控制。

二、集成步骤

以下是 MyBatis 与 Spring Boot 集成的详细步骤。

1. 引入依赖

在集成 MyBatis 与 Spring Boot 之前，需要在项目的 pom.xml 中引入相关依赖。Spring Boot 提供了一个 mybatis-spring-boot-starter 起步依赖，包含了所有必须的 MyBatis 集成内容。

<dependencies><!-- Spring Boot Starter --><dependency><groupId>org.springframework.boot</groupId><artifactId>spring-boot-starter</artifactId></dependency><!-- MyBatis Starter for Spring Boot --><dependency><groupId>org.mybatis.spring.boot</groupId><artifactId>mybatis-spring-boot-starter</artifactId><version>2.2.0</version> <!-- 具体版本可根据项目需要调整 --></dependency><!-- MySQL Driver (或其他数据库驱动) --><dependency><groupId>mysql</groupId><artifactId>mysql-connector-java</artifactId><scope>runtime</scope></dependency>
</dependencies>
2. 配置数据源

MyBatis 需要一个数据库数据源。Spring Boot 可以通过 application.properties 或 application.yml 来配置数据源。这里以 MySQL 数据库为例，假设我们使用 application.yml 文件。

在 src/main/resources/application.yml 中，添加数据库的配置：

spring:datasource:url: jdbc:mysql://localhost:3306/mydatabase?useUnicode=true&characterEncoding=utf8&useSSL=false&serverTimezone=UTCusername: rootpassword: yourpassworddriver-class-name: com.mysql.cj.jdbc.Drivermybatis:mapper-locations: classpath:mapper/*.xmltype-aliases-package: com.example.demo.model
  • spring.datasource.*：配置数据库连接的信息，包括 JDBC URL、用户名、密码和驱动类。
  • mybatis.mapper-locations：指定 MyBatis XML 映射文件的位置，Spring Boot 会自动扫描该路径下的 Mapper 文件。
  • mybatis.type-aliases-package：指定实体类所在的包，MyBatis 可以自动识别这些类的别名。
3. 创建数据库实体类

假设我们有一个 User 表，并在项目中创建对应的实体类。实体类通常用于映射数据库表中的字段。

package com.example.demo.model;public class User {private Long id;private String name;private String email;// Getters and Setterspublic Long getId() {return id;}public void setId(Long id) {this.id = id;}public String getName() {return name;}public void setName(String name) {this.name = name;}public String getEmail() {return email;}public void setEmail(String email) {this.email = email;}
}
4. 创建 Mapper 接口

Mapper 接口是 MyBatis 中用于定义 SQL 操作的接口。每个方法对应一个 SQL 语句，方法的参数和返回值与 SQL 操作密切相关。

package com.example.demo.mapper;import com.example.demo.model.User;
import org.apache.ibatis.annotations.*;import java.util.List;@Mapper
public interface UserMapper {@Select("SELECT * FROM users WHERE id = #{id}")User findById(Long id);@Select("SELECT * FROM users")List<User> findAll();@Insert("INSERT INTO users(name, email) VALUES(#{name}, #{email})")@Options(useGeneratedKeys = true, keyProperty = "id")void insert(User user);@Update("UPDATE users SET name = #{name}, email = #{email} WHERE id = #{id}")void update(User user);@Delete("DELETE FROM users WHERE id = #{id}")void delete(Long id);
}

在这个接口中，我们使用了 MyBatis 的注解 @Select、@Insert、@Update 和 @Delete 来定义 SQL 操作：

  • @Select：用于执行查询操作。
  • @Insert：用于插入数据，使用 @Options 注解将自动生成的主键返回给实体对象。
  • @Update：用于更新数据。
  • @Delete：用于删除数据。
5. 使用 XML 文件定义 SQL

除了在 Mapper 接口中使用注解定义 SQL 语句外，MyBatis 也支持通过 XML 文件进行 SQL 定义。为了演示，假设我们想通过 XML 文件定义 SQL 查询。

创建 UserMapper.xml 文件，并将其放在 resources/mapper/ 目录下。

<?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="com.example.demo.model.User">SELECT * FROM users</select><!-- 根据 ID 查询用户 --><select id="findById" parameterType="Long" resultType="com.example.demo.model.User">SELECT * FROM users WHERE id = #{id}</select><!-- 插入新用户 --><insert id="insert" parameterType="com.example.demo.model.User" useGeneratedKeys="true" keyProperty="id">INSERT INTO users (name, email)VALUES (#{name}, #{email})</insert><!-- 更新用户 --><update id="update" parameterType="com.example.demo.model.User">UPDATE users SET name = #{name}, email = #{email} WHERE id = #{id}</update><!-- 删除用户 --><delete id="delete" parameterType="Long">DELETE FROM users WHERE id = #{id}</delete></mapper>

在这个 XML 文件中，我们定义了与 UserMapper 接口对应的 SQL 语句。通过 XML 定义 SQL 语句的方式适用于复杂的 SQL 逻辑或需要动态生成 SQL 的场景。

6. 编写 Service 层

在业务逻辑层（Service）中，使用 UserMapper 来执行数据库操作。Service 层通常包含事务管理和业务逻辑的处理。

package com.example.demo.service;import com.example.demo.mapper.UserMapper;
import com.example.demo.model.User;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.stereotype.Service;
import org.springframework.transaction.annotation.Transactional;import java.util.List;@Service
public class UserService {@Autowiredprivate UserMapper userMapper;public User findById(Long id) {return userMapper.findById(id);}public List<User> findAll() {return userMapper.findAll();}@Transactionalpublic void insert(User user) {userMapper.insert(user);}@Transactionalpublic void update(User user) {userMapper.update(user);}@Transactionalpublic void delete(Long id) {userMapper.delete(id);}
}

这里，我们使用了 @Service 注解标记业务层，并通过 @Autowired 注入了 UserMapper。同时，通过 @Transactional 注解，管理事务操作。

7. 创建控制器

最后，创建一个控制器来处理 HTTP 请求，并调用业务逻辑层执行数据库操作。

package com.example.demo.controller;import com.example.demo.model.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 {@Autowiredprivate UserService userService;@GetMapping("/{id}")public User getUserById(@PathVariable Long id) {return userService.findById(id);}@GetMappingpublic List<User> getAllUsers() {return userService.findAll();}@PostMappingpublic void addUser(@RequestBody User user) {userService.insert(user);}@PutMappingpublic void updateUser(@RequestBody User user) {userService.update(user);}@DeleteMapping("/{id}")public void deleteUser(@PathVariable Long id) {userService.delete(id);}
}

控制器通过 @RestController 注解定义 RESTful API，接收客户端请求，调用 UserService 执行相关的数据库操作。

三、事务管理

Spring Boot 自动集成了事务管理，我们只需要在需要事务控制的方法上加上 @Transactional 注解即可。所有标记为 @Transactional 的方法会自动受到 Spring 的事务管理控制，确保操作的一致性和原子性。

例如，以下代码展示了在插入和更新时的事务管理：

@Service
public class UserService {@Autowiredprivate UserMapper userMapper;@Transactionalpublic void insertAndUpdate(User newUser, User existingUser) {userMapper.insert(newUser);userMapper.update(existingUser);}
}

四、总结

通过集成 MyBatis 与 Spring Boot，我们能够高效地处理数据库操作。Spring Boot 的自动配置减少了大量的样板代码，同时 MyBatis 的灵活性允许我们轻松处理复杂的 SQL 语句。通过注解和 XML 文件，我们可以根据项目需求选择合适的方式进行 SQL 映射，并结合 Spring 的事务管理，构建稳定、高效的数据库操作层。

http://www.lryc.cn/news/445827.html

相关文章：

  • 迁移学习和外推关系
  • 小程序-生命周期与WXS脚本
  • 828华为云征文 | 云服务器Flexus X实例，Docker集成搭建FC-web模拟器
  • _RET_IP_ 和_THIS_IP_ 作用
  • Spring Boot 点餐系统：高效餐饮服务
  • RtspServer:轻量级RTSP服务器和推流器
  • 为什么结构化 Prompt 如此有效？
  • 无人机飞手培训校企合作特训技术详解
  • 从零开始的软件开发详解：数字药店系统源码与医保购药APP
  • 【记录】在返回值类型为BigDecimal情况下末尾小数位为0的会省略不显示
  • 通信工程高级职称评审条件详细解读
  • yolov8环境安装
  • C语言中易混淆概念的关键字
  • 网络资源模板--Android Studio 零食工坊（商城）
  • 百度高德坐标系相互转换
  • 免费下载6组简历模板，让HR一眼相中你！
  • 设计模式之模版方法模式
  • 解析！文档扫描 SDK 中的高级图像处理技术
  • 线性判别分析（LDA）中求协方差矩阵示例
  • Maven的详细解读和配置
  • 在vue2项目中使用dart-sass
  • 【机器学习】过拟合与欠拟合——如何优化模型性能
  • 二进制日志gtid模式
  • 华硕主板开启TPM 2.0
  • Linux 一键部署Mysql 8.0.37
  • Elasticsearch可视化工具ElasticHD
  • Chrome截取网页全屏
  • Why Is Prompt Tuning for Vision-Language Models Robust to Noisy Labels?
  • C++ 折叠表达式
  • 双控开关接入NVBoard