RuoYi学习-druid添加多数据源

RuoYi 自带 Druid 多数据源和 @DataSource 注解：

• master：默认 MySQL（系统、定时任务等）
• sqlserver：新增 SQL Server
• 用 @DataSource("sqlserver") 在 Service/Mapper 上切换库

1.1 添加 SQL Server 数据源

1.1.1 第一步：加 SQL Server 驱动

在 ruoyi-admin/pom.xml（推荐） 或 ruoyi-common/pom.xml 加入：

<!-- SQL Server 驱动 -->
<dependency>
    <groupId>com.microsoft.sqlserver</groupId>
    <artifactId>mssql-jdbc</artifactId>
    <version>13.2.1.jre11</version>
</dependency>

1.1.2 第二步：改 application-druid.yml

保留原有 master（MySQL），新增 sqlserver 节点：

# 数据源配置
spring:
    datasource:
        type: com.alibaba.druid.pool.DruidDataSource
        driverClassName: com.mysql.cj.jdbc.Driver
        druid:
            # 主库数据源
            master:
                url: jdbc:mysql://localhost:3306/ry-vue?useUnicode=true&characterEncoding=utf8&zeroDateTimeBehavior=convertToNull&useSSL=true&serverTimezone=GMT%2B8
                username: root
                password: password
            # 从库数据源
            slave:
                # 从数据源开关/默认关闭
                enabled: false
                url: 
                username: 
                password:
            # 新增：SQL Server 数据源（CAS库）
            sqlserver-cas:
                enabled: true  # 必须开启
                url: jdbc:sqlserver://localhost:1433;DatabaseName=SQLServer_CAS;encrypt=true;trustServerCertificate=true
                username: sa
                password: password
                driver-class-name: com.microsoft.sqlserver.jdbc.SQLServerDriver

1.1.3 第三步：添加DataSourceType枚举

package com.ruoyi.common.enums;

public enum DataSourceType
{
    /**
     * 主库
     */
    MASTER,

    /**
     * 从库
     */
    SLAVE,
    /**
     * SQL Server （CAS库）
     */
    SQLSERVER_CAS,
}

1.1.4 第四步：注册多数据源

DruidConfig.java

    @Bean
    @ConfigurationProperties("spring.datasource.druid.sqlserver-cas")
    @ConditionalOnProperty(prefix = "spring.datasource.druid.sqlserver-cas", name = "enabled", havingValue = "true")
    public DataSource sqlserverCasDataSource(DruidProperties druidProperties)
    {
        DruidDataSource dataSource = DruidDataSourceBuilder.create().build();
        return druidProperties.dataSource(dataSource);
    }

    @Bean(name = "dynamicDataSource")
    @Primary
    public DynamicDataSource dataSource(DataSource masterDataSource)
    {
        Map<Object, Object> targetDataSources = new HashMap<>();
        targetDataSources.put(DataSourceType.MASTER.name(), masterDataSource);
        setDataSource(targetDataSources, DataSourceType.SLAVE.name(), "slaveDataSource");
        setDataSource(targetDataSources, DataSourceType.SQLSERVER_CAS.name(), "sqlserverCasDataSource");
        return new DynamicDataSource(masterDataSource, targetDataSources);
    }

1.1.5 第五步：添加ruoyi-sqlserver模块

• 第一步：IDEA 新建模块（Maven 模块）

1. 项目右键 → New → Module
2. 选择 Maven → next
3. 模块名输入：ruoyi-sqlserver
4. 包名：com.ruoyi.sqlserver
   创建完成。

• 第二步：配置 ruoyi-sqlserver/pom.xml

  [!TIP]
  参考 ruoyi-quartz/pom.xml。

    <dependencies>

        <!-- 通用工具-->
        <dependency>
            <groupId>com.ruoyi</groupId>
            <artifactId>ruoyi-common</artifactId>
        </dependency>

    </dependencies>

• 第三步：根目录 pom.xml 加入ruoyi-sqlserver模块

    <!-- 依赖声明 -->
    <dependencyManagement>
        <dependencies>
            <!-- sqlserver 模块-->
            <dependency>
                <groupId>com.ruoyi</groupId>
                <artifactId>ruoyi-sqlserver</artifactId>
                <version>${ruoyi.version}</version>
            </dependency>

        </dependencies>
    </dependencyManagement>
    <modules>
        <module>ruoyi-sqlserver</module>
    </modules>

• 第四步：ruoyi-admin 依赖 ruoyi-sqlserver
  在 ruoyi-admin/pom.xml 加入：

    <dependencies>
        <!-- SQL Server 业务模块 -->
        <dependency>
            <groupId>com.ruoyi</groupId>
            <artifactId>ruoyi-sqlserver</artifactId>
        </dependency>
    </dependencies>

1.1.6 第六步：在ruoyi-sqlserver模块里添加访问SQL Server的相关代码

[!TIP]
参考 ruoyi-quartz的结构。

ruoyi-sqlserver结构：

com.ruoyi.sqlserver
 ├ controller      // 接口（可选）
 ├ service         // 业务类
 │  └ impl
 ├ mapper          // MyBatis
 └ domain          // 实体

CAS_UserServiceImpl.java使用DataSource示例：

package com.ruoyi.sqlserver.service.impl;

import com.ruoyi.common.annotation.DataSource;
import com.ruoyi.common.enums.DataSourceType;
import com.ruoyi.sqlserver.domain.CAS_User;
import com.ruoyi.sqlserver.mapper.CAS_UserMapper;
import com.ruoyi.sqlserver.service.ICAS_UserService;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.stereotype.Service;

import java.util.List;

@Service
@DataSource(value = DataSourceType.SQLSERVER_CAS)
public class CAS_UserServiceImpl implements ICAS_UserService
{
    @Autowired
    private CAS_UserMapper casUserMapper;