Spring Boot集成Mybatis操作多数据源（Xml文件）

在Spring Boot应用中，集成Mybatis来操作多数据源是一项常见的需求，特别是在处理分布式系统或者高可用场景下。本文将详细讲解如何在Spring Boot项目中整合Mybatis，并使用XML文件来配置多数据源。 我们需要理解Spring Boot的核心是简化Spring的应用开发，它通过自动配置和起步依赖使得创建一个基于Spring的应用变得极其简单。Mybatis则是一个轻量级的持久层框架，它主要负责SQL的编写和执行，与Spring结合可以实现灵活的数据访问。 1. **添加依赖**： 在`pom.xml`文件中，我们需要引入Spring Boot的starter-web和starter-data-jpa依赖，以及Mybatis和其Spring Boot的starter。同时，为了支持XML配置，还需要引入mybatis-spring和mybatis-spring-boot-starter。例如： ```xml <dependencies> <dependency> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-web</artifactId> </dependency> <dependency> <groupId>org.mybatis.spring.boot</groupId> <artifactId>mybatis-spring-boot-starter</artifactId> <version>2.2.2</version> </dependency> <dependency> <groupId>org.mybatis.spring.boot</groupId> <artifactId>mybatis-spring-boot-starter-test</artifactId> <version>2.2.2</version> <scope>test</scope> </dependency> <!-- 数据源依赖 --> <dependency> <groupId>com.zaxxer</groupId> <artifactId>HikariCP</artifactId> </dependency> </dependencies> ``` 2. **配置多数据源**： 在`application.yml`或`application.properties`中，我们为每个数据源定义配置。例如，定义两个数据源`primary`和`secondary`： ```yaml spring: datasource: primary: url: jdbc:mysql://localhost:3306/primary_db?useUnicode=true&characterEncoding=utf8 username: root password: password driver-class-name: com.mysql.jdbc.Driver secondary: url: jdbc:mysql://localhost:3306/secondary_db?useUnicode=true&characterEncoding=utf8 username: root password: password driver-class-name: com.mysql.jdbc.Driver ``` 3. **配置Mybatis**： 在`application.yml`中，配置Mybatis的相关设置，如Mapper文件的位置： ```yaml mybatis: mapper-locations: classpath:mapper/*.xml ``` 4. **创建数据源配置**： 创建一个`DataSourceConfig`类，用于配置和管理多个数据源。使用`@ConfigurationProperties`来自动绑定上面的YAML配置。 ```java @Configuration @ConfigurationProperties(prefix = "spring.datasource") public class DataSourceConfig { private DataSource primary; private DataSource secondary; // getters and setters } ``` 5. **配置SqlSessionFactory**： 使用`@Bean`注解创建两个`SqlSessionFactory`，分别对应两个数据源。 ```java @Configuration public class MybatisConfig { @Autowired private DataSourceConfig dataSourceConfig; @Bean(name = "primarySqlSessionFactory") public SqlSessionFactory primarySqlSessionFactory() throws Exception { SqlSessionFactoryBean factoryBean = new SqlSessionFactoryBean(); factoryBean.setDataSource(dataSourceConfig.getPrimary()); return factoryBean.getObject(); } @Bean(name = "secondarySqlSessionFactory") public SqlSessionFactory secondarySqlSessionFactory() throws Exception { SqlSessionFactoryBean factoryBean = new SqlSessionFactoryBean(); factoryBean.setDataSource(dataSourceConfig.getSecondary()); return factoryBean.getObject(); } } ``` 6. **配置Mapper扫描**： 配置Mybatis的Mapper扫描器，使其能找到所有的Mapper接口。 ```java @Configuration @MapperScan(basePackages = {"com.example.mapper.primary", "com.example.mapper.secondary"}, sqlSessionFactoryRefs = {"primarySqlSessionFactory", "secondarySqlSessionFactory"}) public class MapperScannerConfig { } ``` 7. **编写Mapper XML文件**： 在`mapper`目录下，为每个数据源创建对应的XML文件，例如`UserMapper.xml`和`OrderMapper.xml`，并编写SQL语句。 8. **创建Mapper接口**： 对应于每个XML文件，创建相应的Java接口，例如`UserMapper`和`OrderMapper`，并使用`@Mapper`注解。 9. **使用多数据源**： 在Service层，通过@Autowired注解注入不同的Mapper接口，然后调用其方法来操作对应数据源的数据。 通过以上步骤，我们已经成功地在Spring Boot应用中集成了Mybatis，并配置了多数据源。在实际开发中，可以根据业务逻辑选择合适的数据源进行操作，提高系统的灵活性和可扩展性。记得在实际运行时，确保STS（Spring Tool Suite）正确导入项目，所有依赖都已生效，这样就可以顺利地运行和测试这个多数据源的Spring Boot项目了。