摘要：本文通過(guò)方法來(lái)用執(zhí)行帶參數(shù)的命令，來(lái)介紹執(zhí)行的大致過(guò)程。三是返回值的類型。返回值的類型包括兩部分，一是返回結(jié)果本身的類型，二是返回結(jié)果的每個(gè)字段各是什么類型用于轉(zhuǎn)換。對(duì)象是一個(gè)很復(fù)雜的對(duì)象，涵蓋了執(zhí)行命令需要的所有東西。

本文通過(guò) main() 方法來(lái)用 mybatis 執(zhí)行帶參數(shù)的 SQL 命令，來(lái)介紹 mybatis 執(zhí)行 SQL 的大致過(guò)程。

準(zhǔn)備一個(gè) MySQL 數(shù)據(jù)庫(kù)，十分鐘內(nèi)快速運(yùn)行起一個(gè) MySQL 的方法可以看這篇文章。

數(shù)據(jù)庫(kù)內(nèi)創(chuàng)建一張很簡(jiǎn)單的表：

create database test;
use test;
create table t1(int id);
insert into t1 set id=11;

首先創(chuàng)建一個(gè)空的 Maven 項(xiàng)目，加上下面的依賴關(guān)系：

  
  
    org.mybatis
    mybatis
    3.5.0
  
  
  
    org.apache.commons
    commons-dbcp2
    2.5.0
  
  
  
    mysql
    mysql-connector-java
    8.0.15
  
  
  
    ch.qos.logback
    logback-classic
    1.2.3
  

在項(xiàng)目中隨便創(chuàng)建一個(gè)類，寫一個(gè)空的 main() 方法，確認(rèn)這個(gè)方法可以正常運(yùn)行。

接下來(lái)我們?cè)?main() 方法中，一步一步完成這個(gè)使用 mybatis 執(zhí)行 SQL 命令的例子。

要連接數(shù)據(jù)庫(kù)，自然要先準(zhǔn)備好數(shù)據(jù)源對(duì)象，這里就不多做解釋了：

String url = "jdbc:mysql://localhost/test?serverTimezone=UTC";
String username = "root";
String password = "root123";

org.apache.commons.dbcp2.BasicDataSource dataSource = new BasicDataSource();
dataSource.setUrl(url);
dataSource.setUsername(username);
dataSource.setPassword(password);

dataSource 變量就是準(zhǔn)備好的數(shù)據(jù)源對(duì)象。

SqlCommandType commandType = SqlCommandType.SELECT;
String commandId = "sql1";
String commandStatement = "select * from t1 where id=#{id}";

String parameterName = "id";
Class parameterType = Integer.class;
Object parameterValue = 11;

Class resultType = HashMap.class;
List resultPropertyMappings = Collections.emptyList();

這個(gè)定義分為三部分：

一是命令本身，包括命令的類型、ID、語(yǔ)句。在 mybatis 中，每條 SQL 命令都有唯一的 ID，因?yàn)樵?SqlSession 里面，執(zhí)行哪條 SQL 命令就是通過(guò) ID 來(lái)指定的。

二是參數(shù)，包括參數(shù)的名稱、類型、參數(shù)值。這個(gè)例子中只有一個(gè)參數(shù)，參數(shù)名稱 id 和語(yǔ)句里面的 #{id} 名稱必須保持一致。

三是返回值的類型。返回值的類型包括兩部分，一是返回結(jié)果本身的類型，二是返回結(jié)果的每個(gè)字段各是什么類型（用于轉(zhuǎn)換）。這個(gè)例子當(dāng)中，我們簡(jiǎn)單的將返回結(jié)果包裝為 Map 對(duì)象，所以里面的字段值就不去指定類型轉(zhuǎn)換了，即 resultPropertyMappings 變量是個(gè)空的 List。

上面這 8 個(gè)變量，會(huì)在組裝 mybatis 的 SQL 命令過(guò)程中用到。

mybatis 的所有配置都在 org.apache.ibatis.session.Configuration 對(duì)象當(dāng)中。Configuration 對(duì)象是一個(gè)很復(fù)雜的對(duì)象，涵蓋了執(zhí)行 SQL 命令需要的所有東西。正常使用的情況下，我們要為它配置 XML 路徑、Mapper 所在的包、查詢結(jié)果的類型轉(zhuǎn)換等等。在本文的例子當(dāng)中，我們用不到 XML，所以只做最簡(jiǎn)單的配置：

JdbcTransactionFactory transactionFactory = new JdbcTransactionFactory();
Environment environment = new Environment("default", transactionFactory, dataSource);
Configuration configuration = new Configuration(environment);

可以看出，dataSource 變量是先放入 Environment 對(duì)象，然后再放入 Configuration 對(duì)象的。到這里，mybatis 的數(shù)據(jù)源就配置好了。接下來(lái)我們將之前定義的 SQL 命令加入 mybatis。

mybatis 當(dāng)中所有的 SQL 命令最終都是一個(gè) MappedStatement 對(duì)象。但要構(gòu)建它可不簡(jiǎn)單，我們要把前面定義的 SQL 命令三部分分別構(gòu)建相應(yīng)的對(duì)象，然后再組裝成 MappedStatement 對(duì)象。

// 1. 構(gòu)建 SqlSource 對(duì)象
SqlSource sqlSource = new SqlSourceBuilder(
    configuration
).parse(
    commandStatement, parameterType, null
);

// 2. 構(gòu)建 ResultMap 對(duì)象
String resultMapId = commandId + "-Inline";
ResultMap resultMap = new ResultMap.Builder(
    configuration, resultMapId, resultType, resultPropertyMappings, null
).build();

// 3. 構(gòu)建 ParameterMap 對(duì)象
ParameterMap parameterMap = new ParameterMap.Builder(
    configuration, commandId, null,
    Collections.singletonList(
        new ParameterMapping.Builder(
            configuration, parameterName, Integer.class
        ).build()
    )
).build();

// 4. 將 SqlSource 對(duì)象、 ResultMap 對(duì)象和 ParameterMap 對(duì)象
//    組合成最終的 MappedStatement 對(duì)象
MappedStatement mappedStatement = new MappedStatement.Builder(
    configuration, commandId, sqlSource, commandType
).resultMaps(
    Collections.singletonList(resultMap)
).parameterMap(
    parameterMap
).build();

看得出，因?yàn)闃?gòu)建起來(lái)很復(fù)雜，所以 mybatis 定義了大量 Builder 類來(lái)用。

configuration.addMappedStatement(mappedStatement);

所有的 MappedStatement 都要放入 Configuration。

這一步相信熟悉 mybatis 的同學(xué)都會(huì)用，就不多解釋了。

SqlSessionFactory sqlSessionFactory = new DefaultSqlSessionFactory(configuration);
SqlSession sqlSession = sqlSessionFactory.openSession(true);
List