MyBatis SqlMapConfig.xml 核心配置詳解

1. Properties 屬性載入

支援 resource（classpath）、url（網路路徑）外部檔案，亦可內聯 <property>。載入優先順序：property → resource/url → parameterType（後讀覆蓋前值）。

2. Settings 全域參數

常用開關：cacheEnabled（二級快取）、lazyLoadingEnabled（延遲載入）、mapUnderscoreToCamelCase（下劃線轉駝峰）等。

3. TypeAliases 別名定義

單個定義

<typeAlias alias="User" type="com.example.domain.User"/>

批量掃描包

<package name="com.example.domain"/>

別名預設為類名（大小寫不敏感）。

4. TypeHandlers 類型轉換器

內建支援基本型別、Date、Enum 等，極少需自訂；若需擴充實作 TypeHandler<T> 介面並註冊。

5. Environments 環境配置

單獨使用 MyBatis 時配置 DataSource、TransactionManager；整合 Spring 後由 Spring 管理，此節點廢棄。

6. Mappers 映射器載入

三種方式

• resource：XML 路徑
• url：完整 URL
• class：Mapper 介面類（需同目錄同名 XML）

批量掃描

<package name="com.example.mapper"/>

前提：介面與 XML 同包同名，採用 class 方式載入。