springboot2.0中怎么整合mybatis3

发布时间：2021-07-30 14:20:44 作者：Leah
来源：亿速云阅读：152

# Spring Boot 2.0中怎么整合MyBatis 3

## 前言

在现代Java企业级应用开发中，Spring Boot凭借其"约定优于配置"的理念和快速开发能力已成为事实上的标准框架。而MyBatis作为一款优秀的持久层框架，因其灵活的SQL编写方式和良好的性能表现广受欢迎。本文将详细介绍如何在Spring Boot 2.0项目中整合MyBatis 3，涵盖从环境搭建到高级配置的全过程。

## 一、环境准备

### 1.1 创建Spring Boot项目

首先我们需要创建一个基础的Spring Boot 2.0项目（实际版本建议使用2.0.x系列稳定版）：

```xml
<!-- pom.xml 基础依赖 -->
<parent>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-parent</artifactId>
    <version>2.0.9.RELEASE</version>
</parent>

<dependencies>
    <dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-web</artifactId>
    </dependency>
</dependencies>

1.2 添加MyBatis相关依赖

Spring Boot官方提供了对MyBatis的starter支持：

<dependency>
    <groupId>org.mybatis.spring.boot</groupId>
    <artifactId>mybatis-spring-boot-starter</artifactId>
    <version>1.3.2</version> <!-- 对应MyBatis 3.4.x版本 -->
</dependency>

<!-- 数据库驱动，以MySQL为例 -->
<dependency>
    <groupId>mysql</groupId>
    <artifactId>mysql-connector-java</artifactId>
    <version>8.0.17</version>
</dependency>

二、基础整合配置

2.1 数据源配置

在application.yml中配置数据源：

spring:
  datasource:
    url: jdbc:mysql://localhost:3306/test_db?useSSL=false&serverTimezone=UTC
    username: root
    password: 123456
    driver-class-name: com.mysql.cj.jdbc.Driver

2.2 MyBatis基本配置

mybatis:
  mapper-locations: classpath:mapper/*.xml  # XML映射文件位置
  type-aliases-package: com.example.model    # 实体类包路径
  configuration:
    map-underscore-to-camel-case: true     # 开启驼峰命名转换

三、代码实现

3.1 实体类创建

package com.example.model;

public class User {
    private Long id;
    private String username;
    private String email;
    
    // 省略getter/setter
}

3.2 Mapper接口定义

@Mapper // 重要：必须添加此注解
public interface UserMapper {
    @Select("SELECT * FROM users WHERE id = #{id}")
    User findById(Long id);
    
    @Insert("INSERT INTO users(username,email) VALUES(#{username},#{email})")
    @Options(useGeneratedKeys = true, keyProperty = "id")
    int insert(User user);
    
    // 更多方法...
}

3.3 XML映射文件（可选）

对于复杂SQL，推荐使用XML方式：

<!-- src/main/resources/mapper/UserMapper.xml -->
<mapper namespace="com.example.mapper.UserMapper">
    <select id="selectComplexQuery" resultType="User">
        SELECT * FROM users 
        WHERE username LIKE #{pattern}
        ORDER BY ${orderBy}
    </select>
</mapper>

四、高级配置与优化

4.1 分页插件集成

MyBatis分页推荐使用PageHelper：

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

配置示例：

pagehelper:
  helperDialect: mysql
  reasonable: true
  supportMethodsArguments: true

4.2 多数据源配置

对于多数据源场景，需要自定义配置：

@Configuration
@MapperScan(basePackages = "com.example.mapper.db1", sqlSessionTemplateRef = "db1SqlSessionTemplate")
public class Db1DataSourceConfig {
    
    @Bean(name = "db1DataSource")
    @ConfigurationProperties(prefix = "spring.datasource.db1")
    public DataSource db1DataSource() {
        return DataSourceBuilder.create().build();
    }
    
    @Bean(name = "db1SqlSessionFactory")
    public SqlSessionFactory sqlSessionFactory(@Qualifier("db1DataSource") DataSource dataSource) throws Exception {
        SqlSessionFactoryBean bean = new SqlSessionFactoryBean();
        bean.setDataSource(dataSource);
        bean.setMapperLocations(new PathMatchingResourcePatternResolver()
                .getResources("classpath:mapper/db1/*.xml"));
        return bean.getObject();
    }
    
    // 类似配置第二个数据源...
}

4.3 事务管理

Spring Boot默认已集成事务支持，只需在Service层添加注解：

@Service
public class UserService {
    
    @Autowired
    private UserMapper userMapper;
    
    @Transactional
    public void createUser(User user) {
        userMapper.insert(user);
        // 其他数据库操作...
    }
}

五、常见问题解决

5.1 Mapper接口无法注入

可能原因及解决方案： 1. 忘记添加@Mapper注解 2. 主类缺少@MapperScan扫描 3. MyBatis配置文件中mapper-locations路径错误

5.2 数据库连接问题

检查要点： - 数据库服务是否启动 - 连接URL格式是否正确（注意时区参数） - 用户名密码是否匹配

5.3 缓存配置

MyBatis一级缓存默认开启，二级缓存需要显式配置：

<settings>
    <setting name="cacheEnabled" value="true"/>
</settings>

<!-- 在Mapper.xml中 -->
<cache eviction="LRU" flushInterval="60000" size="512" readOnly="true"/>

六、最佳实践建议

SQL管理：简单SQL使用注解，复杂SQL使用XML
事务粒度：保持事务方法尽可能小
性能监控：集成Druid监控SQL性能
代码生成：使用MyBatis Generator自动生成基础代码
版本控制：保持MyBatis与Spring Boot版本兼容

结语

通过本文的详细介绍，相信您已经掌握了在Spring Boot 2.0中整合MyBatis 3的核心方法。从基础配置到高级特性，MyBatis与Spring Boot的配合能够为项目提供灵活高效的持久层解决方案。实际开发中，建议根据项目规模选择合适的整合方式，并注意遵循MyBatis的最佳实践原则。

注意：本文基于Spring Boot 2.0和MyBatis 3.4编写，不同版本可能存在配置差异，请根据实际情况调整。 “`

这篇文章共计约2350字，采用Markdown格式编写，包含了： 1. 完整的环境搭建步骤 2. 基础配置和代码示例 3. 高级特性和优化建议 4. 常见问题解决方案 5. 最佳实践指导

内容结构清晰，技术点全面，可以直接用于技术博客或开发文档。如需调整细节或补充特定内容，可以进一步修改完善。