MyBatis中的十個(gè)寶藏技巧！
前言
說到 MyBatis，很多小伙伴都會(huì)用，但未必用得“驚艷”。
實(shí)際上，這個(gè)輕量級(jí)的持久層框架還有很多隱藏的“寶藏技巧”。
如果你能掌握這些技巧，不但能讓開發(fā)更高效，還能避免掉入一些常見的“坑”。
今天就從淺入深，分享 10 個(gè)讓人眼前一亮的 MyBatis 開發(fā)技巧，每一個(gè)都配上具體的場(chǎng)景和代碼示例，務(wù)求通俗易懂，希望對(duì)你會(huì)有所幫助。
1. 靈活使用動(dòng)態(tài) SQL
很多小伙伴在寫 SQL 的時(shí)候，喜歡直接用拼接字符串的方式，比如：
String sql = "SELECT * FROM user WHERE 1=1";
if (name != null) {
sql += " AND name = '" + name + "'";
}這種寫法不僅麻煩，而且安全性很差（容易引發(fā) SQL 注入）。
MyBatis 的動(dòng)態(tài) SQL 是專門為解決這種問題設(shè)計(jì)的，你可以用 if、choose、foreach 等標(biāo)簽來動(dòng)態(tài)構(gòu)造 SQL。
示例：動(dòng)態(tài)條件查詢
<select id="findUser" resultType="User">
SELECT * FROM user
WHERE 1=1
<if test="name != null and name != ''">
AND name = #{name}
</if>
<if test="age != null">
AND age = #{age}
</if>
</select>這個(gè)代碼的好處是，SQL 邏輯清晰，不會(huì)因?yàn)槟硞€(gè)參數(shù)為空就導(dǎo)致整個(gè) SQL 報(bào)錯(cuò)。
2. 善用 resultMap 自定義結(jié)果映射
有些小伙伴會(huì)遇到這樣的問題：數(shù)據(jù)庫表字段是下劃線命名，但 Java 對(duì)象是駝峰命名。比如 user_name 對(duì)應(yīng) userName。如果直接用默認(rèn)的 resultType，MyBatis 是無法自動(dòng)映射的。
這個(gè)時(shí)候，用 resultMap 就能完美解決。
示例：自定義結(jié)果映射
<resultMap id="userResultMap" type="User">
<id column="id" property="id"/>
<result column="user_name" property="userName"/>
<result column="age" property="age"/>
</resultMap>
<select id="getUserById" resultMap="userResultMap">
SELECT id, user_name, age FROM user WHERE id = #{id}
</select>有了 resultMap，再復(fù)雜的字段映射都可以輕松搞定。
3. 利用 foreach 實(shí)現(xiàn)批量操作
有些小伙伴可能會(huì)遇到這種需求：傳入一個(gè) ID 列表，查詢所有匹配的用戶信息。如果用拼接字符串的方式生成 IN 條件，不但代碼丑，還容易踩坑。
MyBatis 提供了 foreach 標(biāo)簽，可以優(yōu)雅地處理這種場(chǎng)景。
示例：批量查詢
<select id="findUsersByIds" resultType="User">
SELECT * FROM user WHERE id IN
<foreach item="id" collection="idList" open="(" separator="," close=")">
#{id}
</foreach>
</select>傳入的 idList 是一個(gè) List 或數(shù)組，MyBatis 會(huì)自動(dòng)幫你展開為 IN (1, 2, 3) 這樣的格式，完全不用擔(dān)心語法問題。
4. MyBatis-Plus 的分頁功能
很多小伙伴在做分頁的時(shí)候，習(xí)慣自己寫 LIMIT 的 SQL，這樣不僅麻煩，還容易出錯(cuò)。
其實(shí)，用 MyBatis-Plus 的分頁插件能省不少事。
示例：MyBatis-Plus 分頁功能
Page<User> page = new Page<>(1, 10); // 第 1 頁，每頁 10 條
IPage<User> userPage = userMapper.selectPage(page, null);
System.out.println("總記錄數(shù)：" + userPage.getTotal());
System.out.println("當(dāng)前頁數(shù)據(jù)：" + userPage.getRecords());只需引入分頁插件，就能輕松完成分頁操作，簡(jiǎn)直不要太爽。
5. 使用 @Mapper的接口代理
有些小伙伴覺得 XML 文件太多太麻煩，其實(shí) MyBatis 支持純注解的開發(fā)模式，尤其是對(duì)于簡(jiǎn)單的 SQL，非常方便。
示例：注解方式查詢
@Mapper
public interface UserMapper {
@Select("SELECT * FROM user WHERE id = #{id}")
User getUserById(int id);
@Insert("INSERT INTO user(name, age) VALUES(#{name}, #{age})")
void addUser(User user);
}用這種方式，可以完全省掉 XML 配置，代碼更加簡(jiǎn)潔。
6. 二級(jí)緩存
MyBatis 內(nèi)置了一級(jí)緩存（SqlSession 范圍內(nèi)），但對(duì)于多次查詢的場(chǎng)景，可以開啟二級(jí)緩存來提升性能。
示例：開啟二級(jí)緩存
<configuration>
<settings>
<setting name="cacheEnabled" value="true"/>
</settings>
</configuration>
<mapper namespace="com.example.mapper.UserMapper">
<cache/>
<select id="getUserById" resultType="User">
SELECT * FROM user WHERE id = #{id}
</select>
</mapper>開啟二級(jí)緩存后，同一個(gè) Mapper 下的查詢會(huì)自動(dòng)命中緩存，大幅提高性能。
7. 動(dòng)態(tài)表名切換
有些多租戶系統(tǒng)需要在運(yùn)行時(shí)切換表名，比如按租戶分表。這種情況下，可以用 MyBatis 的動(dòng)態(tài) SQL 特性來實(shí)現(xiàn)。
示例：動(dòng)態(tài)表名
<select id="getDataFromDynamicTable" resultType="Map">
SELECT * FROM ${tableName} WHERE id = #{id}
</select>在調(diào)用時(shí)傳入 tableName 參數(shù)，MyBatis 會(huì)動(dòng)態(tài)替換表名。
8. 用 typeHandler 自定義類型處理
有些小伙伴可能遇到過這種場(chǎng)景：數(shù)據(jù)庫存的是 1/0，但在代碼里想用 true/false 表示。
這種情況可以通過自定義 typeHandler 來實(shí)現(xiàn)。
示例：自定義 TypeHandler
@MappedTypes(Boolean.class)
@MappedJdbcTypes(JdbcType.INTEGER)
public class BooleanTypeHandler extends BaseTypeHandler<Boolean> {
@Override
public void setNonNullParameter(PreparedStatement ps, int i, Boolean parameter, JdbcType jdbcType) throws SQLException {
ps.setInt(i, parameter ? 1 : 0);
}
@Override
public Boolean getNullableResult(ResultSet rs, String columnName) throws SQLException {
return rs.getInt(columnName) == 1;
}
}在 MyBatis 配置中注冊(cè)這個(gè) typeHandler，就可以實(shí)現(xiàn)自動(dòng)類型轉(zhuǎn)換了。
9. 日志調(diào)試，快速排查問題
開發(fā)中經(jīng)常需要排查 SQL 執(zhí)行的問題，這時(shí) MyBatis 的日志功能非常好用。
通過配置，可以輕松打印出完整的 SQL 和參數(shù)。
示例：開啟日志
<configuration>
<settings>
<setting name="logImpl" value="STDOUT_LOGGING"/>
</settings>
</configuration>日志會(huì)輸出類似下面的內(nèi)容：
==> Preparing: SELECT * FROM user WHERE id = ?
==> Parameters: 1(Integer)
<== Total: 1有了這些日志，排查問題再也不頭疼了。
10. 多數(shù)據(jù)源支持
當(dāng)系統(tǒng)需要連接多個(gè)數(shù)據(jù)庫時(shí)，可以通過 MyBatis 的多數(shù)據(jù)源配置輕松搞定。
示例：配置多數(shù)據(jù)源
@Configuration
@MapperScan(basePackages = "com.example.mapper", sqlSessionTemplateRef = "sqlSessionTemplate1")
public class DataSourceConfig1 {
@Bean(name = "dataSource1")
public DataSource dataSource() {
return DataSourceBuilder.create().build();
}
@Bean(name = "sqlSessionFactory1")
public SqlSessionFactory sqlSessionFactory(@Qualifier("dataSource1") DataSource dataSource) throws Exception {
SqlSessionFactoryBean bean = new SqlSessionFactoryBean();
bean.setDataSource(dataSource);
return bean.getObject();
}
@Bean(name = "sqlSessionTemplate1")
public SqlSessionTemplate sqlSessionTemplate(@Qualifier("sqlSessionFactory1") SqlSessionFactory sqlSessionFactory) {
return new SqlSessionTemplate(sqlSessionFactory);
}
}通過類似的配置，就可以輕松切換多個(gè)數(shù)據(jù)源。
總結(jié)
MyBatis 的魅力在于簡(jiǎn)單、高效，但很多時(shí)候我們用得太“基礎(chǔ)”，沒有發(fā)揮它的全部潛力。
希望這 10 個(gè)技巧能幫你更高效地使用 MyBatis，也讓你的代碼看起來更“驚艷”。
