Spring Boot 怎么配置 MyBatis 和事务管理

Spring Boot 是一个用于快速开发 Spring 应用程序的框架，它简化了 Spring 应用的配置和部署。MyBatis 是一个优秀的持久层框架，它支持定制化 SQL、存储过程以及高级映射。在 Spring Boot 中集成 MyBatis 并配置事务管理是非常常见的需求。本文将详细介绍如何在 Spring Boot 项目中配置 MyBatis 和事务管理。

1. 添加依赖

首先，我们需要在 pom.xml 文件中添加 MyBatis 和 Spring Boot 的相关依赖。

<dependencies>
    <!-- Spring Boot Starter -->
    <dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter</artifactId>
    </dependency>

    <!-- Spring Boot Starter Web -->
    <dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-web</artifactId>
    </dependency>

    <!-- MyBatis Spring Boot Starter -->
    <dependency>
        <groupId>org.mybatis.spring.boot</groupId>
        <artifactId>mybatis-spring-boot-starter</artifactId>
        <version>2.2.0</version>
    </dependency>

    <!-- MySQL Connector -->
    <dependency>
        <groupId>mysql</groupId>
        <artifactId>mysql-connector-java</artifactId>
        <scope>runtime</scope>
    </dependency>

    <!-- Spring Boot Starter Data JPA (可选，用于事务管理) -->
    <dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-data-jpa</artifactId>
    </dependency>
</dependencies>

2. 配置数据源

在 application.properties 或 application.yml 文件中配置数据源信息。

# 数据源配置
spring.datasource.url=jdbc:mysql://localhost:3306/mydatabase
spring.datasource.username=root
spring.datasource.password=root
spring.datasource.driver-class-name=com.mysql.cj.jdbc.Driver

# MyBatis 配置
mybatis.mapper-locations=classpath*:mapper/*.xml
mybatis.type-aliases-package=com.example.model

3. 配置 MyBatis

在 Spring Boot 中，MyBatis 的配置非常简单。我们只需要在 application.properties 中指定 MyBatis 的 mapper 文件位置和实体类的包路径即可。

3.1 创建实体类

package com.example.model;

public class User {
    private Long id;
    private String name;
    private String email;

    // Getters and Setters
}

3.2 创建 Mapper 接口

package com.example.mapper;

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

import java.util.List;

@Mapper
public interface UserMapper {
    @Select("SELECT * FROM users")
    List<User> findAll();
}

3.3 创建 Mapper XML 文件

在 src/main/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.mapper.UserMapper">
    <select id="findAll" resultType="com.example.model.User">
        SELECT * FROM users
    </select>
</mapper>

4. 配置事务管理

Spring Boot 默认使用 Spring 的事务管理机制。我们可以通过 @Transactional 注解来管理事务。

4.1 启用事务管理

在 Spring Boot 中，事务管理是自动配置的。如果你使用的是 Spring Boot Starter Data JPA，事务管理会自动启用。如果没有使用 JPA，可以通过以下方式手动启用事务管理。

import org.springframework.context.annotation.Configuration;
import org.springframework.transaction.annotation.EnableTransactionManagement;

@Configuration
@EnableTransactionManagement
public class TransactionConfig {
    // 事务管理配置
}

4.2 使用事务管理

在 Service 层使用 @Transactional 注解来管理事务。

import com.example.mapper.UserMapper;
import com.example.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 {

    @Autowired
    private UserMapper userMapper;

    @Transactional
    public List<User> findAllUsers() {
        return userMapper.findAll();
    }
}

5. 测试

最后，我们可以编写一个简单的测试类来验证 MyBatis 和事务管理的配置是否正确。

import com.example.model.User;
import com.example.service.UserService;
import org.junit.jupiter.api.Test;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.boot.test.context.SpringBootTest;

import java.util.List;

@SpringBootTest
public class UserServiceTest {

    @Autowired
    private UserService userService;

    @Test
    public void testFindAllUsers() {
        List<User> users = userService.findAllUsers();
        users.forEach(user -> System.out.println(user.getName()));
    }
}

6. 总结

通过以上步骤，我们成功地在 Spring Boot 项目中集成了 MyBatis 并配置了事务管理。Spring Boot 的自动配置机制大大简化了 MyBatis 和事务管理的配置过程，使得开发者可以更加专注于业务逻辑的实现。希望本文对你有所帮助！