MyBatis配置文件中最常用的設置
更新時間：2025年12月02日 11:54:41 作者：SadSunset
文章主要介紹了MyBatis配置的優(yōu)化方法,包括引用外部的properties配置文件、配置外置以實現(xiàn)環(huán)境解耦、配置文件中最常用的6個核心設置以及三種常用的Mapper注冊方式,感興趣的朋友跟隨小編一起看看吧
MyBatis配置優(yōu)化
mybatis的配置中引用外部的propertis配置文件
1. 創(chuàng)建外部配置文件
比如 db.properties：
jdbc.driver=com.mysql.cj.jdbc.Driver jdbc.url=jdbc:mysql://localhost:3306/mydb?useSSL=false jdbc.username=root jdbc.password=123456
2. 在mybatis-config.xml中引入：
<?xml version="1.0" encoding="UTF-8" ?>
<!DOCTYPE configuration
PUBLIC "-//mybatis.org//DTD Config 3.0//EN"
"http://mybatis.org/dtd/mybatis-3-config.dtd">
<configuration>
<!-- 引入外部 properties 文件 -->
<properties resource="db.properties" />
<environments default="development">
<environment id="development">
<transactionManager type="JDBC"/>
<dataSource type="POOLED">
<property name="driver" value="${jdbc.driver}"/>
<property name="url" value="${jdbc.url}"/>
<property name="username" value="${jdbc.username}"/>
<property name="password" value="${jdbc.password}"/>
</dataSource>
</environment>
</environments>
<mappers>
<mapper resource="mappers/UserMapper.xml"/>
</mappers>
</configuration>? resource="db.properties" 表示從 classpath 根路徑加載（如 src/main/resources/db.properties）
?? 注意事項
- 不要把密碼明文寫在代碼里
生產(chǎn)環(huán)境應使用配置中心（如 Apollo、Nacos）或 K8s Secret，而不是本地.properties。
MyBatis 自動集成，無需手動配mybatis-config.xml。
?? 記住：配置外置 = 環(huán)境解耦 = 上線不改代碼 = DevOps 友好
xml文件標簽的順序
在 MyBatis 的 mybatis-config.xml（主配置文件）中，標簽是有嚴格順序要求的；而在 Mapper XML（如 UserMapper.xml）中，除了 <resultMap> 等定義類標簽建議放前面外，SQL 標簽（<select>、<insert> 等）本身沒有順序限制。
[!NOTE] 補充
很多主流框架的 XML 都有順序要求，因為它們都基于 DTD 或 XSD 定義了嚴格的結構。如 Spring XML 配置（applicationContext.xml）—— 有順序！
MyBatis 別名
兩種用法：
- 單個注冊（適合少量類）
<typeAlias type="com.example.User" alias="User"/>
```
→ Mapper 中可用 `resultType="User"`
2. **包掃描（推薦）**
```xml
<package name="com.example.model"/>
```
→ 自動注冊別名（默認類名首字母小寫，如 `user`）；加 `@Alias("User")` 可自定義。
? 作用：省去全限定類名，簡化 Mapper XML。
### **最常用**的 Java 類型的**默認別名（type alias）**：
|別名（小寫）|對應 Java 類型|
|---|---|
|`string`|`java.lang.String`|
|`int` / `_int`|`int`（基本類型）|
|`integer` / `_integer`|`java.lang.Integer`|
|`long` / `_long`|`long`|
|`double` / `_double`|`double`|
|`boolean` / `_boolean`|`boolean`|
|`map`|`java.util.HashMap`|
|`list`|`java.util.ArrayList`|
|`date`|`java.util.Date`|
|`object`|`java.lang.Object`|
> ? **帶下劃線（如 `_int`）表示基本類型，不帶下劃線（如 `int`）實際映射到包裝類（`Integer`）** —— 這是 MyBatis 的約定。
### 示例：
```xml
<select id="getName" resultType="string">
SELECT name FROM user WHERE id = #{id}
</select>
<select id="getIds" resultType="_int">
SELECT id FROM user
</select>?? 記住：開發(fā)中優(yōu)先用包裝類別名（如 integer），避免基本類型 null 問題。這些別名全局可用，不用額外配置。
配置文件中最常用和最重要的設置
以下是必須掌握的 6 個核心配置（按優(yōu)先級排序）：
? 1.mapUnderscoreToCamelCase（強烈推薦開啟）
<setting name="mapUnderscoreToCamelCase" value="true"/>
- 作用：自動將數(shù)據(jù)庫下劃線字段（如
user_name）映射到 Java 駝峰屬性（userName）。 - 不設的后果：需手動寫
<resultMap>，代碼爆炸。
? 2.logImpl（開發(fā)必備）
<setting name="logImpl" value="SLF4J"/>
- 作用：指定日志框架（SLF4J、LOG4J 等），方便查看 SQL 執(zhí)行。
- 不設的后果：看不到執(zhí)行的 SQL，調試困難。
? 3.cacheEnabled（默認 true，通常不動）
<setting name="cacheEnabled" value="true"/>
- 作用：開啟二級緩存（Mapper 級別）。
- 注意：生產(chǎn)環(huán)境慎用，容易因緩存不一致引發(fā) Bug；多數(shù)團隊用 Redis 替代。
? 4.lazyLoadingEnabled+aggressiveLazyLoading
<setting name="lazyLoadingEnabled" value="true"/> <setting name="aggressiveLazyLoading" value="false"/>
- 作用：開啟懶加載（關聯(lián)對象按需查詢）。
aggressiveLazyLoading=false：只在訪問具體屬性時才加載（推薦）。
? 5.useGeneratedKeys（常在 XML 中局部設，全局也可）
<setting name="useGeneratedKeys" value="true"/>
- 作用：插入后自動回填數(shù)據(jù)庫自增主鍵（配合
keyProperty）。 - 更常見做法：在
<insert>標簽里單獨設置（更精準）。
? 6.defaultExecutorType（批量操作時注意）
<setting name="defaultExecutorType" value="REUSE"/> <!-- 或 BATCH -->
- 默認是
SIMPLE BATCH：用于大批量插入/更新（配合SqlSession手動提交）。
?? 避坑建議：
- 不要亂開二級緩存（
cacheEnabled雖默認開，但實際常禁用）。 - 務必開
mapUnderscoreToCamelCase—— 這是 MyBatis 最香的功能之一。 - 日志實現(xiàn)（
logImpl）要和項目日志體系一致（Spring Boot 默認集成好，可不設）。
?? 極簡推薦配置（90% 場景夠用）：
<settings> <setting name="mapUnderscoreToCamelCase" value="true"/> <setting name="logImpl" value="SLF4J"/> </settings>
其他設置按需調整，**先掌握這兩個。
Mapper（映射器）
三種常用方式，按推薦度排序如下：
? 方式一：通過 Mapper 接口注冊（最推薦）
<mappers> <package name="com.example.mapper"/> </mappers>
- 要求：XML 文件名和接口名一致，且在同一包下（如
UserMapper.java+UserMapper.xml）。 - 優(yōu)點：批量注冊，簡潔；配合 Spring Boot 自動掃描更高效。
- 適用：主流開發(fā)方式（接口 + XML）。
? 方式二：通過 XML 文件路徑注冊
<mappers> <mapper resource="mappers/UserMapper.xml"/> </mappers>
- 說明：
resource從 classpath 根路徑開始寫。 - 適用：純 MyBatis 項目，或 XML 與接口不在同包時。
? 方式三：通過 Mapper 接口全限定類名注冊（不推薦）
<mappers> <mapper class="com.example.mapper.UserMapper"/> </mappers>
- 要求：SQL 必須用 注解 寫在接口里（如
@Select），不能搭配 XML（除非 XML 路徑也正確且同名）。 - 適用：簡單 SQL 用注解的場景。
?? 注意：
- 方式一（
<package>）是大廠最常用，尤其配合 Maven/Gradle 標準目錄結構。 - 如果同時用 XML 和接口，必須保證命名和路徑匹配，否則報錯“找不到 mapper”。
- 在 Spring / Spring Boot 中，通常用
@MapperScan("com.example.mapper")，無需在mybatis-config.xml里配<mappers>。
?? 一句話總結：
優(yōu)先用
<package>掃描接口包；純 XML 用resource；注解 Mapper 用class。
到此這篇關于MyBatis配置文件的文章就介紹到這了,更多相關mybatis配置文件內容請搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關文章希望大家以后多多支持腳本之家！
相關文章
在多線程編程中,為了確保多個線程在訪問共享資源時不會發(fā)生沖突,我們通常需要使用 鎖 來同步對資源的訪問,本文將深入探討如何優(yōu)雅地使用 ReentrantLock,避免常見的坑點,并提升代碼的可維護性,需要的朋友可以參考下2025-04-04
SpringSecurity身份驗證實現(xiàn)完整指南
本文介紹了如何使用SpringSecurity實現(xiàn)基于表單的登錄認證,包括配置SecurityConfig、自定義登錄頁面、處理認證成功和失敗的場景、獲取當前登錄用戶、實現(xiàn)登出功能,幫助開發(fā)者理解和應用SpringSecurity的核心功能和最佳實踐,感興趣的朋友跟隨小編一起看看吧2025-12-12
RabbitMQ開啟SSL與SpringBoot連接測試的配置方法
本文基于 CentOS 7 + Git + OpenSSL + yum 安裝的 RabbitMQ，需要讀者提交安裝好。其他方式也可變通參考本文。對RabbitMQ開啟SSL與SpringBoot連接測試相關知識感興趣的朋友一起看看吧2022-01-01
mybatis spring配置SqlSessionTemplate的使用方式
這篇文章主要介紹了mybatis spring配置SqlSessionTemplate的使用方式，具有很好的參考價值，希望對大家有所幫助。如有錯誤或未考慮完全的地方，望不吝賜教2021-08-08
在本篇內容里小編給大家分享的是一篇關于python和java哪個學起來更簡單的相關內容，有興趣的朋友們參考下。2020-06-06
這篇文章主要介紹了JAVA如何使用Math類操作數(shù)據(jù),文中通過示例代碼介紹的非常詳細，對大家的學習或者工作具有一定的參考學習價值,需要的朋友可以參考下2020-04-04
centos下GitLab+Jenkins持續(xù)集成環(huán)境搭建(安裝jenkins)
這篇文章主要為大家詳細介紹了centos下搭建GitLab+Jenkins持續(xù)集成環(huán)境，安裝jenkins的方法，具有一定的參考價值，感興趣的小伙伴們可以參考一下2018-04-04
Java中使用Levenshtein距離實現(xiàn)字符串相似度匹配方式
這篇文章主要介紹了Java中使用Levenshtein距離實現(xiàn)字符串相似度匹配方式,具有很好的參考價值,希望對大家有所幫助,如有錯誤或未考慮完全的地方,望不吝賜教2025-06-06
Java 實戰(zhàn)項目錘煉之在線美食網(wǎng)站系統(tǒng)的實現(xiàn)流程
讀萬卷書不如行萬里路，只學書上的理論是遠遠不夠的，只有在實戰(zhàn)中才能獲得能力的提升，本篇文章手把手帶你用java+SSM+jsp+mysql+maven實現(xiàn)一個在線美食網(wǎng)站系統(tǒng),大家可以在過程中查缺補漏，提升水平2021-11-11
今天小編就為大家分享一篇關于MyBatis Map結果的Key轉為駝峰式，小編覺得內容挺不錯的，現(xiàn)在分享給大家，具有很好的參考價值，需要的朋友一起跟隨小編來看看吧2018-12-12