Spring Boot 2.x整合Mybatis的方式有哪些

# Spring Boot 2.x整合Mybatis的方式有哪些

## 前言

MyBatis作为一款优秀的持久层框架，在Spring Boot生态中有着广泛的应用。Spring Boot 2.x版本提供了多种与MyBatis整合的方式，开发者可以根据项目需求选择最适合的整合方案。本文将详细介绍三种主流整合方式及其实现细节。

## 一、官方starter整合（推荐方式）

### 1. 引入依赖

```xml
<!-- Spring Boot MyBatis官方starter -->
<dependency>
    <groupId>org.mybatis.spring.boot</groupId>
    <artifactId>mybatis-spring-boot-starter</artifactId>
    <version>2.2.0</version>
</dependency>

<!-- 数据库驱动（以MySQL为例） -->
<dependency>
    <groupId>mysql</groupId>
    <artifactId>mysql-connector-java</artifactId>
    <scope>runtime</scope>
</dependency>

2. 配置数据源

# application.yml
spring:
  datasource:
    url: jdbc:mysql://localhost:3306/test_db
    username: root
    password: 123456
    driver-class-name: com.mysql.cj.jdbc.Driver

mybatis:
  mapper-locations: classpath:mapper/*.xml  # XML映射文件位置
  type-aliases-package: com.example.model   # 实体类包路径

3. 创建Mapper接口

@Mapper // 关键注解
public interface UserMapper {
    @Select("SELECT * FROM users WHERE id = #{id}")
    User findById(Long id);
}

4. 特点分析

• 自动配置：自动创建SqlSessionFactory和SqlSessionTemplate
• 简化开发：无需手动编写MyBatis配置
• 生产推荐：适合大多数标准项目场景

二、注解方式整合（无XML配置）

1. 核心注解说明

2. 完整示例

@Mapper
public interface ProductMapper {
    
    @Insert("INSERT INTO products(name,price) VALUES(#{name},#{price})")
    @Options(useGeneratedKeys = true, keyProperty = "id")
    int insert(Product product);
    
    @Select("SELECT * FROM products WHERE id = #{id}")
    @Results({
        @Result(property = "id", column = "id"),
        @Result(property = "name", column = "name"),
        @Result(property = "price", column = "price")
    })
    Product selectById(Long id);
}

3. 适用场景

• 简单CRUD操作
• 不希望维护XML文件的场景
• 快速原型开发

三、XML配置方式整合

1. 项目结构

src/main/resources
├── application.yml
└── mapper
    ├── UserMapper.xml
    └── ProductMapper.xml

2. XML映射文件示例

<!-- UserMapper.xml -->
<mapper namespace="com.example.mapper.UserMapper">
    <resultMap id="BaseResultMap" type="User">
        <id column="id" property="id" />
        <result column="username" property="username" />
    </resultMap>
    
    <select id="selectAll" resultMap="BaseResultMap">
        SELECT * FROM users
    </select>
</mapper>

3. 接口与XML配合

public interface UserMapper {
    List<User> selectAll(); // 方法名与XML中的id对应
}

4. 配置项说明

mybatis:
  config-location: classpath:mybatis-config.xml # 全局配置文件（可选）
  mapper-locations: classpath:mapper/**/*.xml    # 支持通配符

四、混合模式整合

1. 实现方式

@Mapper
public interface OrderMapper {
    // 注解方式
    @Select("SELECT * FROM orders WHERE id = #{id}")
    Order findSimpleOrder(Long id);
    
    // XML方式
    Order findComplexOrderWithDetails(Long id);
}

<!-- OrderMapper.xml -->
<select id="findComplexOrderWithDetails" resultMap="OrderDetailResult">
    <!-- 复杂关联查询 -->
</select>

2. 最佳实践建议

• 简单查询使用注解
• 复杂查询（动态SQL、关联查询）使用XML
• 保持风格一致性

五、高级整合技巧

1. 分页插件整合

<dependency>
    <groupId>com.github.pagehelper</groupId>
    <artifactId>pagehelper-spring-boot-starter</artifactId>
    <version>1.4.1</version>
</dependency>

2. 多数据源配置

@Configuration
@MapperScan(basePackages = "com.example.db1", sqlSessionTemplateRef = "db1SqlSessionTemplate")
public class Db1Config {
    // 配置第一个数据源...
}

@Configuration
@MapperScan(basePackages = "com.example.db2", sqlSessionTemplateRef = "db2SqlSessionTemplate")
public class Db2Config {
    // 配置第二个数据源...
}

六、总结对比

最终建议：对于新项目推荐使用官方starter+注解为主、XML为辅的混合模式，既能保证开发效率，又能应对复杂查询需求。 “`

注：本文示例代码基于Spring Boot 2.5.x + MyBatis 3.5.x版本，实际使用时请根据具体版本调整依赖和配置。