摘要：本文通過方法來用執行帶參數的命令，來介紹執行的大致過程。三是返回值的類型。返回值的類型包括兩部分，一是返回結果本身的類型，二是返回結果的每個字段各是什么類型用于轉換。對象是一個很復雜的對象，涵蓋了執行命令需要的所有東西。

本文通過 main() 方法來用 mybatis 執行帶參數的 SQL 命令，來介紹 mybatis 執行 SQL 的大致過程。

準備一個 MySQL 數據庫，十分鐘內快速運行起一個 MySQL 的方法可以看這篇文章。

數據庫內創建一張很簡單的表：

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

首先創建一個空的 Maven 項目，加上下面的依賴關系：

  
  
    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
  

在項目中隨便創建一個類，寫一個空的 main() 方法，確認這個方法可以正常運行。

接下來我們在 main() 方法中，一步一步完成這個使用 mybatis 執行 SQL 命令的例子。

要連接數據庫，自然要先準備好數據源對象，這里就不多做解釋了：

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 變量就是準備好的數據源對象。

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();

這個定義分為三部分：

一是命令本身，包括命令的類型、ID、語句。在 mybatis 中，每條 SQL 命令都有唯一的 ID，因為在 SqlSession 里面，執行哪條 SQL 命令就是通過 ID 來指定的。

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

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

上面這 8 個變量，會在組裝 mybatis 的 SQL 命令過程中用到。

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

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

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

mybatis 當中所有的 SQL 命令最終都是一個 MappedStatement 對象。但要構建它可不簡單，我們要把前面定義的 SQL 命令三部分分別構建相應的對象，然后再組裝成 MappedStatement 對象。

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

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

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

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

看得出，因為構建起來很復雜，所以 mybatis 定義了大量 Builder 類來用。

configuration.addMappedStatement(mappedStatement);

所有的 MappedStatement 都要放入 Configuration。

這一步相信熟悉 mybatis 的同學都會用，就不多解釋了。

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