虛擬化KVM常用命令匯總

作者：編程江湖 2025-08-06 06:40:00

今天這篇文章，我把 MyBatis 從基礎到高級的 25 個實用配置和 SQL 映射案例一次性講透，每個案例都配上真實業務場景的代碼示例，看完讓你對 MyBatis 的使用豁然開朗，開發效率直接翻倍！

還在為 MyBatis 的復雜配置頭疼？SQL 映射總是寫得亂七八糟？分頁查詢、動態 SQL、關聯查詢這些場景總是搞不定？別慌！今天這篇文章，我把 MyBatis 從基礎到高級的 25 個實用配置和 SQL 映射案例一次性講透，每個案例都配上真實業務場景的代碼示例，看完讓你對 MyBatis 的使用豁然開朗，開發效率直接翻倍！

一、基礎配置：搭建 MyBatis 核心環境

1. 核心配置文件 mybatis-config.xml 基礎結構

MyBatis 的全局配置文件，包含數據源、別名、Mapper 注冊等核心配置：

<?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>

   <!-- 環境配置：可配置多個環境，默認使用development -->

   <environments default="development">

       <environment id="development">

           <!-- 事務管理器：JDBC 事務管理 -->

           <transactionManager type="JDBC"/>

           <!-- 數據源：POOLED 表示使用連接池 -->

           <dataSource type="POOLED">

               <property name="driver" value="com.mysql.cj.jdbc.Driver"/>

               <property name="url" value="jdbc:mysql://localhost:3306/mybatis?useSSL=false"/>

               <property name="username" value="root"/>

               <property name="password" value="123456"/>

           </dataSource>

       </environment>

   </environments>

   <!-- 注冊 Mapper 文件 -->

   <mappers>

       <mapper resource="mapper/UserMapper.xml"/>

       <mapper class="com.example.mapper.OrderMapper"/> <!-- 接口映射 -->

   </mappers>

</configuration>

關鍵說明：POOLED 數據源會緩存數據庫連接，避免頻繁創建連接的性能損耗，生產環境必用。

2. 映射文件 Mapper.xml 基礎結構

定義 SQL 語句和結果映射的核心文件，與 Mapper 接口對應：

<?xml version="1.0" encoding="UTF-8" ?>


<!DOCTYPE mapper


       PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN"

       "http://mybatis.org/dtd/mybatis-3-mapper.dtd">


<!-- namespace 必須與 Mapper 接口全類名一致 -->


<mapper namespace="com.example.mapper.UserMapper">


   <!-- 根據 ID 查詢用戶 -->


   <select id="getUserById" parameterType="Long" resultType="com.example.pojo.User">


       SELECT id, username, age FROM user WHERE id = #{id}


   </select>


</mapper>

核心規則：namespace 必須與 Mapper 接口的全類名一致，id 必須與接口方法名一致，參數和返回值類型要匹配。

3. 接口綁定：無需實現類直接調用

MyBatis 最核心的特性之一，通過接口與 XML 映射文件綁定，直接調用接口方法執行 SQL：

// Mapper 接口

public interface UserMapper {


   User getUserById(Long id);


}


// 調用方式

SqlSession sqlSession = MyBatisUtils.getSqlSession();


UserMapper userMapper = sqlSession.getMapper(UserMapper.class);


User user = userMapper.getUserById(1L); // 直接調用接口方法

優勢：告別傳統的 DAO 實現類，代碼量減少 50%，專注于 SQL 編寫。

二、SQL 映射基礎：CRUD 操作實戰

4. 新增用戶并返回自增主鍵

插入數據后需要獲取自動生成的主鍵（如 ID），用 useGeneratedKeys 和 keyProperty 配置：

<!-- 新增用戶并返回自增 ID -->


<insert id="insertUser" useGeneratedKeys="true" keyProperty="id">

   INSERT INTO user (username, age) VALUES (#{username}, #{age})


</insert>

// 調用后 user.getId() 即可獲取自增主鍵

User user = new User();


user.setUsername("張三");


user.setAge(25);


userMapper.insertUser(user);


System.out.println("新增用戶 ID：" + user.getId()); // 輸出插入后的 ID

5. 根據 ID 更新用戶信息

使用 set 標簽處理動態更新，自動忽略空值字段：

<!-- 更新用戶信息（只更新非空字段） -->


<update id="updateUser">

   UPDATE user


   <set>

       <if test="username != null">username = #{username},</if>

       <if test="age != null">age = #{age}</if>

   </set>

   WHERE id = #{id}


</update>

優勢：如果 username 為 null，會自動忽略該字段，避免將字段更新為 null。

6. 根據 ID 刪除用戶

簡單的刪除操作，注意參數傳遞方式：

<!-- 根據 ID 刪除用戶 -->


<delete id="deleteUserById" parameterType="Long">

   DELETE FROM user WHERE id = #{id}


</delete>

userMapper.deleteUserById(1L);


sqlSession.commit(); // 增刪改必須提交事務

7. 批量刪除用戶（傳入 ID 列表）

用 foreach 標簽處理批量刪除，遍歷集合生成 SQL：

<!-- 批量刪除用戶 -->


<delete id="batchDelete">

   DELETE FROM user WHERE id IN


   <foreach collection="list" item="id" open="(" separator="," close=")">

       #{id}


   </foreach>

</delete>

List<Long> ids = Arrays.asList(1L, 2L, 3L);


userMapper.batchDelete(ids); // 一次刪除多個用戶

foreach 參數說明：

collection：集合參數名稱（list、array 或自定義名稱）
item：遍歷的元素變量名
open/close：包裹整個集合的符號（如 ( 和 )）
separator：元素之間的分隔符（如 ,）

三、參數處理：多種參數傳遞方式

8. 單個參數傳遞

直接使用 #{參數名} 接收，參數名可任意（建議與方法參數名一致）：

<!-- 單個參數：根據用戶名查詢 -->


<select id="getUserByUsername" resultType="User">

   SELECT id, username, age FROM user WHERE username = #{username}


</select>

User user = userMapper.getUserByUsername("張三");

9. 多個參數傳遞（@Param 注解）

方法有多個參數時，用 @Param 注解指定參數名稱，避免參數混淆：

// 接口方法（多個參數用 @Param 注解）

User getUserByUsernameAndAge(@Param("username") String username, @Param("age") Integer age);

<!-- 接收多個參數 -->


<select id="getUserByUsernameAndAge" resultType="User">

   SELECT id, username, age FROM user


   WHERE username = #{username} AND age = #{age}


</select>

10. 傳遞 JavaBean 參數

直接傳遞實體類對象，用 #{屬性名} 接收參數：

// 傳遞 User 對象作為參數

List<User> getUsersByCondition(User user);

<!-- 使用 JavaBean 屬性作為參數 -->


<select id="getUsersByCondition" resultType="User">

   SELECT id, username, age FROM user


   WHERE 1=1


   <if test="username != null">AND username LIKE CONCAT('%', #{username}, '%')</if>

   <if test="age != null">AND age = #{age}</if>

</select>

11. 傳遞 Map 參數

靈活傳遞多個零散參數，用 #{key} 接收 Map 中的鍵值對：

// 傳遞 Map 作為參數

List<User> getUsersByMap(Map<String, Object> params);

<!-- 使用 Map 的 key 作為參數 -->


<select id="getUsersByMap" resultType="User">

   SELECT id, username, age FROM user


   WHERE username = #{name} AND age > #{minAge}


</select>

// 調用方式

Map<String, Object> params = new HashMap<>();


params.put("name", "張三");


params.put("minAge", 18);


List<User> users = userMapper.getUsersByMap(params);

四、動態 SQL：靈活處理條件查詢

12. if + where 標簽：動態條件查詢

where 標簽會自動處理多余的 AND/OR，避免 SQL 語法錯誤：

<!-- 動態條件查詢（自動處理 AND） -->


<select id="getUserList" resultType="User">

   SELECT id, username, age FROM user


   <where>

       <if test="username != null">AND username LIKE #{username}</if>

       <if test="age != null">AND age = #{age}</if>

   </where>

</select>

對比傳統 SQL：無需手動拼接 WHERE 1=1，where 標簽會智能判斷是否添加 WHERE 關鍵字，多余的 AND 會自動刪除。

13. choose + when + otherwise：多條件分支判斷

類似 Java 中的 if-else，只執行第一個滿足條件的分支：

<!-- 多條件分支查詢 -->


<select id="getUserByCondition" resultType="User">

   SELECT id, username, age FROM user


   WHERE 1=1


   <choose>

       <when test="id != null">AND id = #{id}</when> <!-- 優先按 ID 查詢 -->

       <when test="username != null">AND username = #{username}</when> <!-- 其次按用戶名查詢 -->

       <otherwise>AND age > 18</otherwise> <!-- 都不滿足時的默認條件 -->

   </choose>

</select>

14. foreach 批量插入

一次性插入多條數據，比循環單條插入效率提升 10 倍：

<!-- 批量插入用戶 -->


<insert id="batchInsert">

   INSERT INTO user (username, age) VALUES


   <foreach collection="list" item="user" separator=",">

       (#{user.username}, #{user.age})


   </foreach>

</insert>

List<User> users = Arrays.asList(


   new User("張三", 20),


   new User("李四", 22)


);


userMapper.batchInsert(users); // 一次插入多條數據

五、結果映射：解決字段與屬性不一致問題

15. resultMap：自定義字段與屬性映射

當數據庫字段與 Java 實體類屬性名稱不一致時，用 resultMap 手動映射：

<!-- 自定義結果映射（解決字段與屬性名不一致） -->


<resultMap id="userResultMap" type="User">

   <id property="userId" column="id"/> <!-- 主鍵映射 -->

   <result property="userName" column="username"/> <!-- 普通字段映射 -->

   <result property="userAge" column="age"/>

</resultMap>

<select id="getUserById" resultMap="userResultMap">

   SELECT id, username, age FROM user WHERE id = #{id}


</select>

// 實體類屬性與數據庫字段不同

public class User {


   private Long userId; // 對應數據庫 id

   private String userName; // 對應數據庫 username

   private Integer userAge; // 對應數據庫 age

   // getter/setter

}

16. 一對一關聯查詢（如訂單關聯用戶）

查詢訂單時同時關聯查詢用戶信息，用 association 標簽配置：

<!-- 訂單關聯查詢用戶（一對一） -->


<resultMap id="orderResultMap" type="Order">

   <id property="id" column="order_id"/>

   <result property="orderNo" column="order_no"/>

   <!-- 關聯用戶信息 -->

   <association property="user" javaType="User">

       <id property="id" column="user_id"/>

       <result property="username" column="username"/>

   </association>

</resultMap>

<select id="getOrderById" resultMap="orderResultMap">

   SELECT o.id AS order_id, o.order_no, u.id AS user_id, u.username


   FROM order o


   LEFT JOIN user u ON o.user_id = u.id


   WHERE o.id = #{id}


</select>

// 訂單實體類包含用戶對象

public class Order {


   private Long id;


   private String orderNo;


   private User user; // 關聯的用戶信息

   // getter/setter

}

17. 一對多關聯查詢（如用戶關聯訂單列表）

查詢用戶時同時查詢其所有訂單，用 collection 標簽配置：

<!-- 用戶關聯查詢訂單列表（一對多） -->


<resultMap id="userOrderResultMap" type="User">

   <id property="id" column="user_id"/>

   <result property="username" column="username"/>

   <!-- 關聯訂單列表 -->

   <collection property="orders" ofType="Order">

       <id property="id" column="order_id"/>

       <result property="orderNo" column="order_no"/>

   </collection>

</resultMap>

<select id="getUserWithOrders" resultMap="userOrderResultMap">

   SELECT u.id AS user_id, u.username, o.id AS order_id, o.order_no


   FROM user u


   LEFT JOIN order o ON u.id = o.user_id


   WHERE u.id = #{id}


</select>

// 用戶實體類包含訂單列表

public class User {


   private Long id;


   private String username;


   private List<Order> orders; // 關聯的訂單列表

   // getter/setter

}

六、高級配置：提升性能與靈活性

18. 別名配置：簡化類名書寫

在全局配置文件中定義別名，XML 映射文件中直接使用短名稱，避免寫全類名：

<!-- mybatis-config.xml 中配置別名 -->


<typeAliases>

   <typeAlias type="com.example.pojo.User" alias="User"/> <!-- 單個類別名 -->

   <package name="com.example.pojo"/> <!-- 包下所有類自動取首字母小寫別名 -->

</typeAliases>

<!-- 直接使用別名 -->


<select id="getUserById" resultType="User"> <!-- 無需寫全類名 -->

   SELECT id, username FROM user WHERE id = #{id}


</select>

19. 分頁查詢：使用 PageHelper 插件

MyBatis 本身不支持物理分頁，集成 PageHelper 插件實現高效分頁：

<!-- pom.xml 引入依賴 -->


<dependency>

   <groupId>com.github.pagehelper</groupId>

   <artifactId>pagehelper-spring-boot-starter</artifactId>

   <version>1.4.6</version>

</dependency>

// 分頁查詢（PageHelper 自動攔截 SQL 添加分頁條件）

PageHelper.startPage(1, 10); // 第 1 頁，每頁 10 條

List<User> userList = userMapper.getUserList();


Page<User> page = (Page<User>) userList;


System.out.println("總條數：" + page.getTotal());


System.out.println("總頁數：" + page.getPages());

20. 緩存配置：一級緩存與二級緩存

MyBatis 自帶緩存機制，減少數據庫查詢次數：

一級緩存：默認開啟，SqlSession 級別的緩存，同一 SqlSession 內查詢相同數據會命中緩存。
二級緩存：Mapper 級別的緩存，多個 SqlSession 共享，需手動開啟。

<!-- 在 Mapper.xml 中開啟二級緩存 -->


<cache eviction="LRU" flushInterval="60000" size="1024" readOnly="true"/>

<!-- 禁用某個方法的緩存 -->


<select id="getUserById" useCache="false">

   SELECT id, username FROM user WHERE id = #{id}


</select>

注意：二級緩存適合查詢頻繁、修改較少的數據，且實體類需實現 Serializable 接口。

21. 類型轉換器：處理特殊類型

自定義類型轉換器，解決數據庫類型與 Java 類型不匹配問題（如數據庫 VARCHAR 存儲 JSON 字符串，轉換為 Java 對象）：

// 自定義類型轉換器

public class JsonTypeHandler<T> extends BaseTypeHandler<T> {


   private Class<T> type;


   // 實現 getResult、setParameter 等方法，完成 JSON 與對象的轉換

}

<!-- 配置類型轉換器 -->


<typeHandlers>

   <typeHandler handler="com.example.handler.JsonTypeHandler" javaType="com.example.pojo.Info"/>

</typeHandlers>

<!-- 在 SQL 映射中使用 -->


<resultMap id="userResultMap" type="User">

   <result property="info" column="info" typeHandler="com.example.handler.JsonTypeHandler"/>

</resultMap>

七、實戰技巧：避坑與性能優化

22. #{} 與 ${} 的區別：防止 SQL 注入

#{} 會預編譯 SQL（參數用？占位），${} 直接拼接 SQL（有注入風險）：

<!-- 安全：#{} 預編譯，參數作為值傳入 -->


SELECT * FROM user WHERE username = #{username}


<!-- 危險：${} 直接拼接，可能導致 SQL 注入 -->


SELECT * FROM user WHERE username = '${username}'


<!-- 如果 username 為 '張三' OR '1'='1，會查詢所有用戶 -->

使用原則：優先用 #{}，只有在動態拼接表名、排序字段時才用 ${}，且必須嚴格校驗參數。

23. 批量更新：減少 SQL 執行次數

通過 foreach 拼接批量更新語句，比循環單條更新效率提升 10 倍：

<!-- 批量更新（MySQL 支持，需開啟 allowMultiQueries=true） -->


<update id="batchUpdate">

   <foreach collection="list" item="user" separator=";">

       UPDATE user SET username = #{user.username} WHERE id = #{user.id}


   </foreach>

</update>

注意：MySQL 需在連接 URL 中添加 allowMultiQueries=true 才能支持批量更新。

24. 懶加載：按需加載關聯數據

關聯查詢時默認不加載關聯數據，用到時才查詢，減少不必要的 SQL 執行：

<!-- 全局配置開啟懶加載 -->


<settings>

   <setting name="lazyLoadingEnabled" value="true"/>

   <setting name="aggressiveLazyLoading" value="false"/>

</settings>

<!-- 一對一懶加載 -->


<association property="user" javaType="User" select="getUserById" column="user_id"/>

// 調用時只查詢訂單，訪問 user 屬性時才查詢用戶

Order order = orderMapper.getOrderById(1L); // 只執行訂單查詢 SQL

User user = order.getUser(); // 此時才執行用戶查詢 SQL

25. SQL 片段：復用重復 SQL

將重復的 SQL 片段抽取為 <sql> 標簽，用 <include> 引用，減少代碼冗余：

<!-- 定義 SQL 片段 -->


<sql id="userColumns">id, username, age</sql>

<!-- 引用 SQL 片段 -->


<select id="getUserById" resultType="User">

   SELECT <include refid="userColumns"/> FROM user WHERE id = #{id}


</select>

<select id="getUserList" resultType="User">

   SELECT <include refid="userColumns"/> FROM user


</select>

為什么掌握這些能讓你少加班？

MyBatis 是 Java 后端開發的必備技能，但 80% 的開發者都在重復踩坑：SQL 注入、關聯查詢混亂、動態 SQL 拼接錯誤、性能低下…… 這 25 個案例覆蓋了 90% 的實際開發場景，從基礎配置到高級優化，讓你：

寫出更安全的 SQL（避免注入）
減少 50% 的代碼量（接口綁定 + 動態 SQL）
提升查詢性能（緩存 + 批量操作 + 懶加載）

責任編輯：趙寧寧來源：編程江湖