MyBatis的配置對象Configuration作用及說明

更新時間：2025年03月11日 15:34:54 作者：冰糖心書房

MyBatis的Configuration對象是MyBatis的核心配置對象,它包含了MyBatis運行時所需的幾乎所有配置信息,這個對象負責管理MappedStatement、創(chuàng)建核心組件、提供配置信息的訪問接口以及作為插件機制的入口

MyBatis配置對象Configuration作用

org.apache.ibatis.session.Configuration 是 MyBatis 的核心配置對象，它包含了 MyBatis 運行時所需的幾乎所有配置信息。可以把它理解為 MyBatis 的“大腦”或“配置中心”。

在 MyBatis 的初始化過程中，會解析 XML 配置文件或通過 Java 代碼構建一個 Configuration 對象，MyBatis 的其他組件（如 SqlSessionFactory、Executor、MappedStatement 等）都會依賴這個 Configuration 對象來獲取配置信息和執(zhí)行操作。

Configuration 對象的主要作用

保存全局配置信息: Configuration 對象保存了 MyBatis 的全局配置信息，這些信息通常在 mybatis-config.xml 文件中配置，或者通過 Java 代碼設置。這些信息包括：

Properties: 外部屬性配置（可以通過 <properties> 標簽或 Properties 對象加載）。
Settings: 全局設置，控制 MyBatis 的運行時行為（例如，是否開啟緩存、是否使用延遲加載、是否自動映射等）。
Type Aliases: 類型別名，用于簡化 XML 配置文件中的類型引用。
Type Handlers: 類型處理器，用于處理 Java 類型與 JDBC 類型之間的轉換。
Object Factory: 對象工廠，用于創(chuàng)建結果對象。
Plugins: 插件，用于攔截 MyBatis 的核心執(zhí)行流程（例如，攔截 SQL 執(zhí)行、參數設置、結果映射等）。
Environments: 環(huán)境配置，可以配置多個數據源環(huán)境（例如，開發(fā)環(huán)境、測試環(huán)境、生產環(huán)境）。
DatabaseId Provider: 數據庫廠商標識，用于根據不同的數據庫廠商執(zhí)行不同的 SQL 語句。
Mappers: 映射器配置，用于加載 SQL 映射文件或 Mapper 接口。

管理 MappedStatement: Configuration 對象維護了一個 MappedStatement 的注冊表（Map<String, MappedStatement>）。MappedStatement 對象代表一個 SQL 語句（select、insert、update、delete），它包含了 SQL 語句的 ID、參數類型、結果類型、SQL 語句內容等信息。Configuration 對象通過 MappedStatement 的 ID 來查找和管理 MappedStatement。

創(chuàng)建核心組件: Configuration 對象提供了一些方法來創(chuàng)建 MyBatis 的核心組件，例如：

newExecutor(Transaction tx, ExecutorType executorType): 創(chuàng)建 Executor 對象（執(zhí)行器，負責執(zhí)行 SQL 語句）。
newStatementHandler(...): 創(chuàng)建 StatementHandler 對象（語句處理器，負責處理 JDBC 的 Statement）。
newParameterHandler(...): 創(chuàng)建 ParameterHandler 對象（參數處理器，負責設置 SQL 語句的參數）。
newResultSetHandler(...): 創(chuàng)建 ResultSetHandler 對象（結果集處理器，負責將 ResultSet 映射為 Java 對象）。

提供配置信息的訪問接口: Configuration 對象提供了一系列 getXXX() 方法，用于獲取各種配置信息。例如：

getVariables()：獲取屬性配置
isCacheEnabled(): 獲取是否開啟緩存。
isLazyLoadingEnabled(): 獲取是否開啟延遲加載。
getTypeAliasRegistry(): 獲取類型別名注冊表。
getTypeHandlerRegistry(): 獲取類型處理器注冊表。
getMappedStatement(String id): 根據 ID 獲取 MappedStatement 對象。
getEnvironment():獲取環(huán)境配置

插件機制的入口： Configuration 提供了添加和獲取插件的方法 (addInterceptor(), getInterceptors())，使得插件可以攔截 MyBatis 的核心執(zhí)行流程。

Configuration 對象的創(chuàng)建

Configuration 對象通常由 SqlSessionFactoryBuilder 創(chuàng)建。
SqlSessionFactoryBuilder 可以通過 XML 配置文件或 Java 代碼來構建 Configuration 對象。

// 通過 XML 配置文件創(chuàng)建
String resource = "mybatis-config.xml";
InputStream inputStream = Resources.getResourceAsStream(resource);
SqlSessionFactory sqlSessionFactory = new SqlSessionFactoryBuilder().build(inputStream);
Configuration configuration = sqlSessionFactory.getConfiguration();


// 通過 Java 代碼創(chuàng)建
Configuration configuration = new Configuration();
configuration.setCacheEnabled(true); // 設置緩存
configuration.setLazyLoadingEnabled(false); // 設置延遲加載
configuration.addMapper(UserMapper.class); // 添加 Mapper 接口
// ... 其他配置 ...
SqlSessionFactory sqlSessionFactory = new SqlSessionFactoryBuilder().build(configuration);