SSM企業版：多數據源+事務

前言

之前博客中《SSM+nginx+tomcat+maven+mysql+redis環境搭建及工程全套配置，實現前後端動靜分離》只是初級版的SSM體系建設，在這篇文章之前，可參照：https://blog.csdn.net/qq_36632174/article/details/102461255

來了解前博客內容。本篇對上一篇做一個升級，配置多數據源，加入事務、定時任務、流程組件activity。

多數據源

基礎配置參照前言中提到的之前寫的博客，這次直接加入多數據源部分，多數據源的實現首先在spring-mybatis.xml中添加基礎配置：

<!-- 數據源1與數據源2的url相同，數據源3和數據源4都分別有自己連接的數據連接url。四個數據源分別是不同數據庫，賬號密碼都不相同-->

<!-- 數據源1 -->
    <bean id="dataSource1" class="org.apache.commons.dbcp.BasicDataSource"
        destroy-method="close">
        <property name="driverClassName" value="${driver}" />
        <property name="url" value="${url}" />
        <property name="username" value="${username1}" />
        <property name="password" value="${password1}" />
        <!-- 從池中獲取連接前進行驗證 -->
        <property name="testOnBorrow" value="false" />
        <!-- 向池中還回連接前進行驗證 -->
        <property name="testOnReturn" value="false" />
        <!-- 連接空閒時驗證 -->
        <property name="testWhileIdle" value="true" />
        <!-- 運行判斷連接超時任務(evictor)的時間間隔，單位爲毫秒，默認爲-1，即不執行任務。 -->
        <property name="timeBetweenEvictionRunsMillis" value="300000" />
        <!-- 連接的超時時間，設定爲三小時。 -->
        <property name="minEvictableIdleTimeMillis" value="10800000" />
        <!-- 每次evictor啓動檢查的空閒連接數，-2標識1/2的總空閒連接 -->
        <property name="numTestsPerEvictionRun" value="-1"></property>
        <!-- 初始化連接大小 -->
        <property name="initialSize" value="${initialSize}"></property>
        <!-- 連接池最大數量 -->
        <property name="maxActive" value="${maxActive}"></property>
        <!-- 連接池最大空閒 -->
        <property name="maxIdle" value="${maxIdle}"></property>
        <!-- 連接池最小空閒 -->
        <property name="minIdle" value="${minIdle}"></property>
        <!-- 獲取連接最大等待時間 -->
        <property name="maxWait" value="${maxWait}"></property>
    </bean>
    <!-- 數據源2 -->
    <bean id="dataSource2" class="org.apache.commons.dbcp.BasicDataSource"
        destroy-method="close">
        <property name="driverClassName" value="${driver}" />
        <property name="url" value="${url}" />
        <property name="username" value="${username2}" />
        <property name="password" value="${password2}" />
        <!-- 從池中獲取連接前進行驗證 -->
        <property name="testOnBorrow" value="false" />
        <!-- 向池中還回連接前進行驗證 -->
        <property name="testOnReturn" value="false" />
        <!-- 連接空閒時驗證 -->
        <property name="testWhileIdle" value="true" />
        <!-- 運行判斷連接超時任務(evictor)的時間間隔，單位爲毫秒，默認爲-1，即不執行任務。 -->
        <property name="timeBetweenEvictionRunsMillis" value="300000" />
        <!-- 連接的超時時間，設定爲三小時。 -->
        <property name="minEvictableIdleTimeMillis" value="10800000" />
        <!-- 每次evictor啓動檢查的空閒連接數，-2標識1/2的總空閒連接 -->
        <property name="numTestsPerEvictionRun" value="-1"></property>
        <!-- 初始化連接大小 -->
        <property name="initialSize" value="${initialSize}"></property>
        <!-- 連接池最大數量 -->
        <property name="maxActive" value="${maxActive}"></property>
        <!-- 連接池最大空閒 -->
        <property name="maxIdle" value="${maxIdle}"></property>
        <!-- 連接池最小空閒 -->
        <property name="minIdle" value="${minIdle}"></property>
        <!-- 獲取連接最大等待時間 -->
        <property name="maxWait" value="${maxWait}"></property>
    </bean>
    <!-- 數據源3-->
    <bean id="dataSource3" class="org.apache.commons.dbcp.BasicDataSource"
        destroy-method="close">
        <property name="driverClassName" value="${driver}" />
        <property name="url" value="${url_3}" />
        <property name="username" value="${username3}" />
        <property name="password" value="${password3}" />
        <!-- 從池中獲取連接前進行驗證 -->
        <property name="testOnBorrow" value="false" />
        <!-- 向池中還回連接前進行驗證 -->
        <property name="testOnReturn" value="false" />
        <!-- 連接空閒時驗證 -->
        <property name="testWhileIdle" value="true" />
        <!-- 運行判斷連接超時任務(evictor)的時間間隔，單位爲毫秒，默認爲-1，即不執行任務。 -->
        <property name="timeBetweenEvictionRunsMillis" value="300000" />
        <!-- 連接的超時時間，默認爲半小時。 -->
        <property name="minEvictableIdleTimeMillis" value="10800000" />
        <!-- 每次evictor啓動檢查的空閒連接數，-2標識1/2的總空閒連接 -->
        <property name="numTestsPerEvictionRun" value="-1"></property>
        <!-- 初始化連接大小 -->
        <property name="initialSize" value="${initialSize}"></property>
        <!-- 連接池最大數量 -->
        <property name="maxActive" value="${maxActive}"></property>
        <!-- 連接池最大空閒 -->
        <property name="maxIdle" value="${maxIdle}"></property>
        <!-- 連接池最小空閒 -->
        <property name="minIdle" value="${minIdle}"></property>
        <!-- 獲取連接最大等待時間 -->
        <property name="maxWait" value="${maxWait}"></property>
    </bean>
    <!-- 數據源4，鏈接人員數據庫-->
    <bean id="dataSource4" class="org.apache.commons.dbcp.BasicDataSource"
        destroy-method="close">
        <property name="driverClassName" value="${driver}" />
        <property name="url" value="${url4}" />
        <property name="username" value="${username4}" />
        <property name="password" value="${password4}" />
        <!-- 從池中獲取連接前進行驗證 -->
        <property name="testOnBorrow" value="false" />
        <!-- 向池中還回連接前進行驗證 -->
        <property name="testOnReturn" value="false" />
        <!-- 連接空閒時驗證 -->
        <property name="testWhileIdle" value="true" />
        <!-- 運行判斷連接超時任務(evictor)的時間間隔，單位爲毫秒，默認爲-1，即不執行任務。 -->
        <property name="timeBetweenEvictionRunsMillis" value="300000" />
        <!-- 連接的超時時間，默認爲半小時。 -->
        <property name="minEvictableIdleTimeMillis" value="10800000" />
        <!-- 每次evictor啓動檢查的空閒連接數，-2標識1/2的總空閒連接 -->
        <property name="numTestsPerEvictionRun" value="-1"></property>
        <!-- 初始化連接大小 -->
        <property name="initialSize" value="${initialSize}"></property>
        <!-- 連接池最大數量 -->
        <property name="maxActive" value="${maxActive}"></property>
        <!-- 連接池最大空閒 -->
        <property name="maxIdle" value="${maxIdle}"></property>
        <!-- 連接池最小空閒 -->
        <property name="minIdle" value="${minIdle}"></property>
        <!-- 獲取連接最大等待時間 -->
        <property name="maxWait" value="${maxWait}"></property>
    </bean>

<!-- 3個數據源自動切換 -->
    <bean id="dynamicDataSource" class="com.dlg.common_utils.utils.dynamicds.DynamicDataSource">
        <property name="targetDataSources">
            <map key-type="java.lang.String">
                <!-- 指定lookupKey和與之對應的數據源，由於數據源3和數據源4的特殊性，下面會有其它處理-->
                <entry key="dataSource1" value-ref="dataSource1"></entry>
                <entry key="dataSource2" value-ref="dataSource2"></entry>
                <entry key="dataSource3" value-ref="dataSource3"></entry>
            </map>
        </property>
    </bean>

<!-- 數據源3和數據源4開啓的另外的bean -->

<bean id="sqlSessionFactory3" class="org.mybatis.spring.SqlSessionFactoryBean">
      <property name="dataSource" ref="dataSource3" />
      <property name="mapperLocations">
        <list>
            <value>classpath*:com/dlg/**/sqlmap/GWorkflowRequestlogMapper.xml</value> <!-- 映射到mapper.xml文件-->
            <value>classpath*:com/dlg/**/sqlmap/GOaUserMapper.xml</value> <!-- 映射到mapper.xml文件-->
        </list>
      </property>
    </bean>
    <bean id="sqlSessionFactory4" class="org.mybatis.spring.SqlSessionFactoryBean">
      <property name="dataSource" ref="dataSource4" />
      <property name="mapperLocations">
        <list>
            <value>classpath*:com/dlg/**/sqlmap/JKDeptMapper.xml</value> <!-- 映射到mapper.xml文件-->
            <value>classpath*:com/dlg/**/sqlmap/PersCardMapper.xml</value>
            <value>classpath*:com/dlg/**/sqlmap/RyddMapper.xml</value>
            <value>classpath*:com/dlg/**/sqlmap/TugUsercheckMapper.xml</value>
        </list>
      </property>
    </bean>

<bean class="org.mybatis.spring.mapper.MapperScannerConfigurer">
        <property name="basePackage" value="com.3" />
        <property name="sqlSessionFactoryBeanName" value="sqlSessionFactory3"></property>
    </bean>
    <bean class="org.mybatis.spring.mapper.MapperScannerConfigurer">
        <property name="basePackage" value="com.4" />
        <property name="sqlSessionFactoryBeanName" value="sqlSessionFactory4"></property>
    </bean>

以上，spring-mybatis.xml文件就配置完成，由於使用的是spring框架體系，所以採用註解的形式來實現數據源的自動切換和指定，還需要在工具類中定義好註解：

1、首先定義註解類：DataSource.java，以後在Dao層文件中，指定數據源使用@DataSource註解

import java.lang.annotation.ElementType;
import java.lang.annotation.Retention;
import java.lang.annotation.RetentionPolicy;
import java.lang.annotation.Target;

/**
 * 切換數據源自定義註解
 */
@Target({ ElementType.METHOD, ElementType.TYPE }) // 定義註解應用於類（Type）和方法（method）
@Retention(RetentionPolicy.RUNTIME) // 註解的@Retention爲RUNTIME時，才能夠通過運行時的反射機制來處理註解
public @interface DataSource {
    String value();
}

2、接下來是兩個基礎類，分別：

數據源控制類：DynamicDataSourceHolder.java

數據源標識獲取類：DynamicDataSource.java，讓數據源註解通過參數指定數據源。

DynamicDataSourceHolder.java如下：

/**
 * 數據源的控制
 *
 */
public class DynamicDataSourceHolder {
    /*數據源標識保存在線程變量中，避免多線程操作數據源時互相干擾*/
    private static final ThreadLocal<String> THREAD_DATA_SOURCE = new ThreadLocal<String>();
    
    public static String getDataSource() {
        return THREAD_DATA_SOURCE.get();
    }
    public static void setDataSource(String dataSource) {
        THREAD_DATA_SOURCE.set(dataSource);
    }
    
    public static void clearDataSource() {
        THREAD_DATA_SOURCE.remove();
    }
}

DynamicDataSource.java如下：

import org.springframework.jdbc.datasource.lookup.AbstractRoutingDataSource;

/**
 * 數據源標識獲取
 */
public class DynamicDataSource extends AbstractRoutingDataSource{

    @Override
    protected Object determineCurrentLookupKey() {
        // 從自定義的位置獲取數據源標識
        return DynamicDataSourceHolder.getDataSource();
    }
}

3、基礎類準備後，是解析類，讓註解生效

DataSourceAspect.java如下：

import java.lang.reflect.Method;

import org.aspectj.lang.JoinPoint;
import org.aspectj.lang.reflect.MethodSignature;

public class DataSourceAspect {

    /**
     * 攔截目標方法，獲取由@DataSource指定的數據源標識，設置到線程存儲中以便切換數據源
     *
     * @param point
     * @throws Exception
     */
    public void intercept(JoinPoint point) throws Exception {
        Class<?> target = point.getTarget().getClass();
        MethodSignature signature = (MethodSignature) point.getSignature();
        for (Class<?> clazz : target.getInterfaces()) {
            resolveDataSource(clazz, signature.getMethod());
        }
        resolveDataSource(target, signature.getMethod());
    }

    /**
     * 提取目標對象方法註解和類型註解中的數據源標識
     *
     * @param clazz
     * @param method
     */
    private void resolveDataSource(Class<?> clazz, Method method) {
        try {
            Class<?>[] types = method.getParameterTypes();
            // 默認使用類型註解，解析DataSource註解
            if (clazz.isAnnotationPresent(DataSource.class)) {
                DataSource source = clazz.getAnnotation(DataSource.class);
                DynamicDataSourceHolder.setDataSource(source.value());
            }
            // 方法註解可以覆蓋類型註解
            Method methodtype = clazz.getMethod(method.getName(), types);
            if (methodtype != null
                    && methodtype.isAnnotationPresent(DataSource.class)) {
                DataSource dataSource = clazz.getAnnotation(DataSource.class);
                DynamicDataSourceHolder.setDataSource(dataSource.value());
            }
        } catch (Exception e) {
            System.out.println(clazz + ":" + e.getMessage());
        }
    }
}

4、最後回到spring-mybatis.xml添加切面，指定切面位置：

<!-- 加入攔截規則，比如攔截service或者dao層的所有方法 -->
    <bean id="dataSourceAspect" class="com.dlg.common_utils.utils.dynamicds.DataSourceAspect">
    </bean>
    <aop:config>
        <aop:aspect ref="dataSourceAspect">
            <!-- 攔截所有dao方法 -->
            <aop:pointcut id="dataSourcePointcut"
                expression="execution(* com.dlg.*.dao.*.*(..))" />
            <aop:before pointcut-ref="dataSourcePointcut" method="intercept" />
        </aop:aspect>
    </aop:config>

5、以上準備完成後，在Dao文件中的使用，參數必須是在spring-mybatis.xml文件中聲明過的才生效

@DataSource("dataSource1")
public interface MRMaterialShipWarehouseDao {

。。。。。。

}

添加事務

多數據源已經配置完成，也需要開啓多數據源的事務spring-mybatis.xml：

<tx:annotation-driven transaction-manager="transactionManager1" />
    <bean id="transactionManager1"
        class="org.springframework.jdbc.datasource.DataSourceTransactionManager">
        <property name="dataSource" ref="dataSource1" />
    </bean>

<tx:annotation-driven transaction-manager="transactionManager2" />
    <bean id="transactionManager2"
        class="org.springframework.jdbc.datasource.DataSourceTransactionManager">
        <property name="dataSource" ref="dataSource2" />
    </bean>

xml文件配置完成後，在service實現類的方法級別可直接使用註解@Transactional，例：

 @Override
    @Transactional(propagation=Propagation.REQUIRED)
    public boolean addApply(SYSUser user, JSONObject object) {
。。。。。。。。}