目录
- 1. 单数据源配置
- 1.1 单数据源配置概述
- 1.2 数据源配置步骤
- 1.3 Spring Boot 自动配置
- 2. 多数据源配置
- 2.1 多数据源配置概述
- 2.2 多数据源配置步骤
- 2.3 配置数据源和事务管理器
- 2.4 动态切换数据源
- 3. 自动配置与手动配置的区别
- 3.1 自动配置
- 3.2 手动配http://www.devze.com置
- 4. 总结
在使用 MyBATis-Plus（MP）进行开发时，正确配置和管理数据源是非常重要的一步。MyBatis-Plus 不仅支持 单数据源 的配置，还支持 多数据源 的配置和切换，适用于分布式系统中不同的数据库管理和访问场景。
本文将介绍 MyBatis-Plus 数据库配置与数据源整合 的常见方法，包括单数据源与多数据源的配置、配置文件与 Spring 配置类的使用、以及如何进行数据源切换和管理。
1. 单数据源配置
1.1 单数据源配置概述
在大多数应用中，通常只需要一个数据源进行数据库的操作。MyBatis-Plus 支持通过 Spring Boot 自动配置来简化单数据源的配置。
1.2 数据源配置步骤
- 添加数据库依赖
首先，在 pom.XML 文件中添加 MyBatis-Plus 和数据库相关的依赖。
例如，使用 H2 数据库作为示例：
<dependencies>
<!-- MyBatis-Plus 核心依赖 -->
<dependency>
<groupId>com.baomidou</groupId>
<artifactId>mybatis-plus-core</artifactId>
<version>3.4.3</version>
</dependency>
<!-- Spring Boot MyBatis starter -->
<dependency>
<groupId>org.mybatis.spring.boot</groupId>
<artifactId>mybatis-spring-boot-starter</artifactId>
<version>2.2.0</version>
</dependency>
<!-- 数据库连接池（H2 示例） -->
<dependency>
<groupId>com.h2database</groupId>
<artifactId>h2</artifactId>
<scope>runtime</scope>
</dependency>
</dependencies>
- 配置数据库连接
在 application.properties 或 application.yml 配置文件中添加数据源配置。
application.properties 配置示例：
# 数据库连接配置 spring.datasource.url=jdbc:h2:mem:testdb spring.datasource.driverClassName=org.h2.Driver spring.datasource.username=sa spring.datasource.password=password spring.datasource.hibernate.ddl-auto=update # MyBatis-Plus 配置 mybatis-plus.mapperjs-locations=classpath:/mappers/**/*.xml mybatis-plus.type-aliases-package=com.example.domain
在该配置中：
spring.datasource用于配置数据库的连接信息。mybatis-plus配置了 MyBatis-Plus 的基础配置。
- 数据源自动配置
Spring Boot 会自动加载数据源和 MyBatis-Plus 配置，无需手动创建 DataSource 和 SqlSessionFactory 等对象。你只需要创建 Mapper 接口和实体类即可。
1.3 Spring Boot 自动配置
MyBatis-Plus 提供了开箱即用的自动配置。只要在 Spring Boot 项目中配置好数据源，MyBatis-Plus 会自动进行配置，无需额外的手动配置。
2. 多数据源配置
2.1 多数据源配置概述
在一些复杂的应用中，可能需要连接多个数据库源。比如，可能需要一个主数据库和多个副本数据库，或者在分布式系统中连接不同的数据库。
MyBatis-Plus 支持多数据源的配置和切换，具体可以通过配置不同的 DataSource 来实现。
2.2 多数据源配置步骤
- 添加数据库依赖
首先，确保你已在 pom.xml 文件中添加所需数据库的依赖。
- 配置多个数据源
在 application.yml 中定义多个数据源配置。
例如，配置一个 主数据源 和一个 副数据源：
spring:
datasource:
# 主数据源配置
primary:
url: jdbc:mysql://localhost:3306/primarydb
driver-class-name: com.mysql.cj.jdbc.Driver
username: root
password: root
# 副数据源配置
secondary:
url: jdbc:mysql://localhost:3306/secondarydb
driver-class-name: com.mysql.cj.jdbc.Driver
username: root
password: root
2.3 配置数据源和事务管理器
你需要在配置类中为每个数据源配置 DataSource、SqlSessionFactory 和 TransactionManager。
@Configuration
@EnableTransactionManagement
@MapperScan(basePackages = "com.example.mapper")
public class DataSourceConfig {
@Bean(name = "primaryDataSource")
@Primary
@ConfigurationProperties(prefix = "spring.datasource.primary")
public DataSource dataSourcePrimary() {
return DataSourceBuilder.create().build();
}
@Bean(name = "secondaryDataSource")
@ConfigurationProperties(prefix = "spring.datasource.secondary")
public DataSource dataSourceSecondary() {
return DataSourceBuilder.create().build();
}
// 配置主数据源的事务管理器
@Bean(name = "transactionManagerPrimary")
@Primary
public DataSourceTransactionManager transactionManagerPrimary(@Qualifier("primaryDataSource") DataSource dataSource) {
return new DataSourceTransactionManager(dataSource);
}
// 配置副数据源的事务管理器
@Bean(name = "transactionManagerSecondary")
public DataSourceTransactionManager transactionManagerSecondary(@Qualifier("secondaryDataSource") DataSource dataSource) {
return new DataSourceTransactionManager(dataSource);
}
// 配置主数据源的 SqlSessionFactory
@Bean(name = "sqlSessionFactoryPrimary")
@Primary
public SqlSessionFactory sqlSessionFactoryPrimary(@Qualifier("primaryDataSource") DataSource dataSource) throws Exception {
SqlSessionFactoryBean factoryBean = new SqlSessionFactoryBean();
factoryBean.setDataSource(dataSource);
return factoryBean.getObject();
}
// 配置副数据源的 SqlSessionFactory
@Bean(name = "sqlSessionFactorySecondary")
public SqlSessionFactory sqlSessionFactorySecondary(@Qualifier("secondaryDataSource") DataSource dataSource) throws Exception {
SqlSessionFactoryBean factoryBean = new SqlSessionFactoryBean();
factoryBean.setDataSource(dataSource);
return factoryBean.getObject();
}
}
2.4 动态切换数据源
在应用中使用动态数据源切换，Spring 提供了 @Primary 和 @Qualifier 注解来指定哪个数据源为主数据源，哪一个为副数据源。在进行操作时，通过动态切编程换数据源来控制操作目标。
public class DynamicDataSourceContextHolder {
private static final ThreadLocal<String> contextHolder = new ThreadLocal<>();
public static void setDataSohttp://www.devze.comurce(String dataSource) {
contextHolder.set(dataSource);
}
public static String getDataSource() {
return contextHolder.get();
}
public static void clearDataSource() {
contextHolder.remove();
}
}
切换数据源时：
DynamicDataSourceContextHolder.setDataSource("primary"); // 切换到主数据源
3. 自动配置与手动配置的区别
3.1 自动配置
Spring Boot 提供了自动配置功能，MyBatis-Plus 默认会通过配置文件自动配置数据源、SqlSessionFactory 和事务管理器等组件。如果项目只涉及单一数据源，Spring Boot 会根据 application.properties 或 application.yml 中的配置自动进行数据源配置。
自动配置的好处
- 减少配置：只需在配置文件中http://www.devze.com配置数据源，Spring Boot 会自动完成其余的配置工作。
- 简化管理：对于单数据源应用，使用自动配置更为简单，开发者只需关注业务代码。
自动配置示例
spring.datasource.url=jdbc:mysql://localhost:3306/mydb spring.datasource.username=root spring.datasource.password=root
Spring Boot 会根据以上配置自动初始化 DataSource、SqlSessionFactory、TransactionManager 等组件。
3.2 手动配置
对于复杂的项目，尤其是涉及多数据源的情况，开发者通常需要手动配置数据源、SqlSessionFactory、事务管理器等。
这种方式提供了更大的灵活性，可以在不同的数据源之间进行细粒度的控制和切换。
手动配置的好处
- 灵活性：可以手动控制每个数据源的配置，例如动态数据源切换、多个数据库连接等。
- 扩展性：适用于需要自定义配置、插件等场景。
手动配置示例
@Configuration
public class MyBatisConfig {
@Bean
public DataSource dataSource() {
return DataSourceBuilder.create().url("jdbc:mysql://localhost:3306/mydb")
.username("root")
.password("root")
.build();
}
@Bean
public SqlSessionFactory sqlSessionFactory(@Qualifier("dataSource") DataSource dataSource) throws Exception {
SqlSessionFactoryBean factoryBean = new SqlSessionFactoryBean();
factoryBean.setDataSource(dataSource);
return factoryBean.getObject();
}
}
4. 总结
- 单数据源配置：对于大多数应用，MyBatis-Plus 配置单数据源时，可以通过 Spring Boot 的自动配置功能快速完成。
- 多数据源配置：在复杂的应用场景中，可以手动配置多个数据源，通过动态切换实现数据库的负载均衡和高可用性。
- 自动配置与手动配置的区别：自动配置适用于单数据源的场景，简化了配置过程，而手动配置则提供了更大的灵活性，适用于多数据源的管理和动态切换。
通过合适的配置和管理，MyBatis-Plus 可以帮助开发者在 Spring Boot 应用中高效管理数据源、简化数据库操作，并根据需求实现更加复杂的数据库架构。
以上为个人经验，希望能给大家一个参考，也希望大家多多支持编程客栈(www.devze.com)。
加载中,请稍侯......
精彩评论