詳解MyBatis的SqlSession獲取流程

更新時(shí)間：2023年07月10日 10:15:58 作者：半夏之沫

SqlSession的獲取是通過SqlSessionFactory的openSession() 方法，那么具體的獲取流程是什么，所以本文就給大家詳細(xì)講解一下MyBatis的SqlSession獲取流程,需要的朋友可以參考下

前言

已知在MyBatis的使用中，使用MyBatis時(shí)會(huì)先讀取配置文件mybatis-config.xml為字符流或者字節(jié)流，然后通過SqlSessionFactoryBuilder基于配置文件的字符流或字節(jié)流來構(gòu)建SqlSessionFactory，然后再通過SqlSessionFactory的openSession() 方法獲取SqlSession，示例代碼如下所示。

public static void main(String[] args) throws Exception {
    String resource = "mybatis-config.xml";
    SqlSessionFactory sqlSessionFactory = new SqlSessionFactoryBuilder()
            .build(Resources.getResourceAsStream(resource));
    SqlSession sqlSession = sqlSessionFactory.openSession();
}

上述示例代碼中的SqlSessionFactory實(shí)際為DefaultSqlSessionFactory，本篇文章將對(duì)DefaultSqlSessionFactory獲取SqlSession的流程進(jìn)行學(xué)習(xí)。

正文

DefaultSqlSessionFactory的openSession() 方法如下所示。

public SqlSession openSession() {
    return openSessionFromDataSource(configuration.getDefaultExecutorType(), null, false);
}

繼續(xù)看openSessionFromDataSource() 方法的實(shí)現(xiàn)，如下所示。

private SqlSession openSessionFromDataSource(ExecutorType execType, 
                                             TransactionIsolationLevel level, 
                                             boolean autoCommit) {
    Transaction tx = null;
    try {
        // Environment中包含有事務(wù)工廠和數(shù)據(jù)源
        final Environment environment = configuration.getEnvironment();
        // 獲取事務(wù)工廠
        // 如果配置了JDBC事務(wù)，則獲取JDBC事務(wù)工廠，否則獲取MANAGED事務(wù)工廠
        final TransactionFactory transactionFactory = getTransactionFactoryFromEnvironment(environment);
        // 創(chuàng)建事務(wù)
        tx = transactionFactory.newTransaction(environment.getDataSource(), level, autoCommit);
        // 創(chuàng)建執(zhí)行器
        final Executor executor = configuration.newExecutor(tx, execType);
        // 構(gòu)建DefaultSqlSession并返回
        return new DefaultSqlSession(configuration, executor, autoCommit);
    } catch (Exception e) {
        closeTransaction(tx);
        throw ExceptionFactory.wrapException("Error opening session.  Cause: " + e, e);
    } finally {
        ErrorContext.instance().reset();
    }
}

openSessionFromDataSource() 方法會(huì)先從Configuration中將Environment獲取出來，Environment中包含有事務(wù)工廠和數(shù)據(jù)源，Environment是在MyBatis配置文件中進(jìn)行配置并會(huì)在加載MyBatis配置文件時(shí)被添加到Configuration中。

MyBatis的配置文件中可以配置兩種事務(wù)工廠，為JDBC事務(wù)工廠和MANAGED事務(wù)工廠，它們分別可以創(chuàng)建JDBC事務(wù)和MANAGED事務(wù)，類圖如下所示。

獲取事務(wù)工廠的getTransactionFactoryFromEnvironment() 方法如下所示。

private TransactionFactory getTransactionFactoryFromEnvironment(Environment environment) {
    if (environment == null || environment.getTransactionFactory() == null) {
        // 配置了事務(wù)工廠則使用配置的事務(wù)工廠
        // MyBatis可以配置JDBC和MANAGED這兩種事務(wù)工廠
        return new ManagedTransactionFactory();
    }
    // 沒做配置的情況下使用MANAGED事務(wù)工廠
    return environment.getTransactionFactory();
}

MyBatis中如果使用JDBC事務(wù)，則事務(wù)的管理由java.sql.Connection完成，如果使用MANAGED事務(wù)，則MyBatis會(huì)將事務(wù)的管理交由WEB容器（Tomcat，JBoss等）來完成。以commit() 和rollback() 方法為例，看下JdbcTransaction和ManagedTransaction對(duì)這兩個(gè)方法的實(shí)現(xiàn)，如下所示。

public class JdbcTransaction implements Transaction {
    // ......
    @Override
    public void commit() throws SQLException {
        if (connection != null && !connection.getAutoCommit()) {
            if (log.isDebugEnabled()) {
                log.debug("Committing JDBC Connection [" + connection + "]");
            }
            connection.commit();
        }
    }
    @Override
    public void rollback() throws SQLException {
        if (connection != null && !connection.getAutoCommit()) {
            if (log.isDebugEnabled()) {
                log.debug("Rolling back JDBC Connection [" + connection + "]");
            }
            connection.rollback();
        }
    }
    // ......
}
public class ManagedTransaction implements Transaction {
    // ......
    @Override
    public void commit() throws SQLException {
        // 不做任何事情
    }
    @Override
    public void rollback() throws SQLException {
        // 不做任何事情
    }
    // ......
}

回到openSessionFromDataSource() 方法，創(chuàng)建好事務(wù)后，會(huì)構(gòu)建執(zhí)行器Executor，看一下newExecutor(Transaction transaction, ExecutorType executorType) 方法的實(shí)現(xiàn)，如下所示。

public Executor newExecutor(Transaction transaction, ExecutorType executorType) {
    executorType = executorType == null ? defaultExecutorType : executorType;
    executorType = executorType == null ? ExecutorType.SIMPLE : executorType;
    Executor executor;
    // 根據(jù)ExecutorType的枚舉值創(chuàng)建對(duì)應(yīng)類型的Executor
    if (ExecutorType.BATCH == executorType) {
        executor = new BatchExecutor(this, transaction);
    } else if (ExecutorType.REUSE == executorType) {
        executor = new ReuseExecutor(this, transaction);
    } else {
        executor = new SimpleExecutor(this, transaction);
    }
    // 如果MyBatis配置文件中開啟了二級(jí)緩存
    if (cacheEnabled) {
        // 創(chuàng)建CachingExecutor作為Executor的裝飾器，為Executor增加二級(jí)緩存功能
        executor = new CachingExecutor(executor);
    }
    // 將插件邏輯添加到Executor中
    executor = (Executor) interceptorChain.pluginAll(executor);
    return executor;
}

在上面構(gòu)建執(zhí)行器Executor的方法中，主要是做了三件事情，解釋如下。

第一件事情，根據(jù)ExecutorType的枚舉值創(chuàng)建對(duì)應(yīng)類型的Executor，ExecutorType枚舉值如下所示。

public enum ExecutorType {
    SIMPLE, REUSE, BATCH
}

MyBatis提供了三種類型的Executor，分別為BatchExecutor，ReuseExecutor和SimpleExecutor，類圖如下所示。

在BaseExecutor中定義了四個(gè)抽象方法，如下所示。

protected abstract int doUpdate(MappedStatement ms, Object parameter) throws SQLException;
protected abstract List<BatchResult> doFlushStatements(boolean isRollback) throws SQLException;
protected abstract <E> List<E> doQuery(MappedStatement ms, Object parameter, RowBounds rowBounds, ResultHandler resultHandler, BoundSql boundSql)
    throws SQLException;
protected abstract <E> Cursor<E> doQueryCursor(MappedStatement ms, Object parameter, RowBounds rowBounds, BoundSql boundSql)
    throws SQLException;

BaseExecutor提供的方法中會(huì)調(diào)用這四個(gè)抽象方法，同時(shí)這四個(gè)抽象方法需要由BatchExecutor，ReuseExecutor和SimpleExecutor根據(jù)各自的功能進(jìn)行實(shí)現(xiàn)，所以Executor的設(shè)計(jì)使用了模板設(shè)計(jì)模式。

第二件事情，如果在MyBatis配置文件中開啟了二級(jí)緩存，則為Executor創(chuàng)建裝飾器CachingExecutor，以增加對(duì)二級(jí)緩存功能的支持。CachingExecutor與Executor的關(guān)系如下所示。

CachingExecutor實(shí)現(xiàn)了Executor接口，同時(shí)CachingExecutor持有Executor的引用，這是裝飾器模式的應(yīng)用。關(guān)于MyBatis中的緩存，會(huì)在后續(xù)的文章中進(jìn)行介紹。

第三件事情，如果配置了插件，則將插件的邏輯添加到Executor中。關(guān)于MyBatis中的插件，會(huì)在后續(xù)的文章中進(jìn)行介紹。

回到openSessionFromDataSource() 方法，創(chuàng)建好Executor后，就會(huì)調(diào)用DefaultSqlSession的構(gòu)造方法創(chuàng)建一個(gè)DefaultSqlSession并返回，在DefaultSqlSession的構(gòu)造方法中只是進(jìn)行了簡單的賦值，如下所示。

public DefaultSqlSession(Configuration configuration, Executor executor, boolean autoCommit) {
    this.configuration = configuration;
    this.executor = executor;
    this.dirty = false;
    this.autoCommit = autoCommit;
}

至此，SqlSession就創(chuàng)建出來了。

總結(jié)

SqlSession的獲取是通過SqlSessionFactory的openSession() 方法，SqlSession的創(chuàng)建過程主要先是創(chuàng)建事務(wù)管理器，然后基于事務(wù)管理器創(chuàng)建執(zhí)行器Executor，最后基于Executor創(chuàng)建SqlSession。

通常，SqlSessionFactory為DefaultSqlSessionFactory，創(chuàng)建出來的SqlSession為DefaultSqlSession。

整體的一個(gè)流程圖如下所示。