快捷導(dǎo)航

Mybatis延遲加載的實現(xiàn)示例

更新時間：2026年04月02日 10:03:23 作者：小王不愛笑132

延遲加載是 MyBatis 的一種優(yōu)化機(jī)制,也稱為懶加載,本文就來詳細(xì)的介紹一下Mybatis延遲加載的實現(xiàn),文中通過示例代碼介紹的非常詳細(xì),對大家的學(xué)習(xí)或者工作具有一定的參考學(xué)習(xí)價值,需要的朋友們下面隨著小編來一起學(xué)習(xí)學(xué)習(xí)吧

什么是延遲加載

延遲加載（Lazy Loading）是 MyBatis 的一種優(yōu)化機(jī)制，也稱為懶加載。它指的是在進(jìn)行關(guān)聯(lián)查詢時，按需加載數(shù)據(jù)，而不是一次性加載所有關(guān)聯(lián)數(shù)據(jù)，從而提高系統(tǒng)性能，減少不必要的數(shù)據(jù)庫查詢。

延遲加載配置

全局配置（SqlMapConfig.xml）

需要在 MyBatis 核心配置文件中開啟延遲加載開關(guān)：

<settings>
    <!-- 開啟延遲加載 -->
    <setting name="lazyLoadingEnabled" value="true"/>
    <!-- 將積極加載改為消極加載（按需加載） -->
    <setting name="aggressiveLazyLoading" value="false"/>
</settings>

lazyLoadingEnabled：全局開啟延遲加載開關(guān)（默認(rèn) false）
aggressiveLazyLoading：是否開啟積極加載（默認(rèn) false）
- 積極加載：加載一個對象時，會同時加載所有關(guān)聯(lián)對象
- 消極加載：只有真正使用關(guān)聯(lián)對象時才會加載

延遲加載實現(xiàn)（以 Account 和 User 為例）

1. 實體類定義

Account 類（包含 User 關(guān)聯(lián)對象）：

public class Account implements Serializable {
    private Integer id;
    private Integer uid;
    private Double money;
    // 關(guān)聯(lián)的用戶對象
    private User user;
    // getter/setter/toString省略
}

User 類：

public class User implements Serializable {
    private Integer id;
    private String name;
    private Date birthday;
    private String sex;
    private String address;
    // getter/setter/toString省略
}

2. Mapper 接口定義

AccountMapper 接口：

public interface AccountMapper {
    // 查詢所有賬戶
    List<Account> findAll();
}

UserMapper 接口：

public interface UserMapper {
    // 根據(jù)ID查詢用戶
    User findById(Integer id);
}

3. Mapper 映射文件配置（關(guān)鍵）

AccountMapper.xml 中配置延遲加載：

<mapper namespace="com.qcby.mapper.AccountMapper">
    <!-- 延遲加載配置 -->
    <select id="findAll" resultMap="accountMap">
        select * from account
    </select>
    <resultMap id="accountMap" type="Account">
        <id column="id" property="id"/>
        <result column="uid" property="uid"/>
        <result column="money" property="money"/>
        <!-- 配置延遲加載 -->
        <association 
            property="user"        <!-- 關(guān)聯(lián)對象在Account中的屬性名 -->
            javaType="User"        <!-- 關(guān)聯(lián)對象的類型 -->
            select="com.qcby.mapper.UserMapper.findById"  <!-- 延遲加載時執(zhí)行的查詢 -->
            column="uid"/>         <!-- 傳遞給select查詢的參數(shù)（賬戶表中的uid字段） -->
    </resultMap>
</mapper>

UserMapper.xml 中需要有對應(yīng)的查詢方法：

<mapper namespace="com.qcby.mapper.UserMapper">
    <select id="findById" parameterType="int" resultType="User">
        select * from user where id = #{id}
    </select>
</mapper>

延遲加載測試代碼

public class Test02 {
    private InputStream in;
    private SqlSession session;
    private AccountMapper mapper;
    @Before
    public void init() throws Exception {
        // 加載配置文件
        in = Resources.getResourceAsStream("SqlMapConfig.xml");
        // 創(chuàng)建工廠對象
        SqlSessionFactory factory = new SqlSessionFactoryBuilder().build(in);
        // 創(chuàng)建session對象
        session = factory.openSession();
        // 獲取代理對象
        mapper = session.getMapper(AccountMapper.class);
    }
    @After
    public void destroy() throws Exception {
        session.close();
        in.close();
    }
    @Test
    public void testLazyLoading() {
        // 1. 查詢所有賬戶（此時只會執(zhí)行account表的查詢）
        List<Account> accounts = mapper.findAll();
        // 2. 遍歷賬戶列表
        for (Account account : accounts) {
            System.out.println("賬戶信息：" + account.getMoney());
            // 3. 當(dāng)需要使用user屬性時，才會執(zhí)行user表的查詢（延遲加載觸發(fā)點）
            System.out.println("用戶信息：" + account.getUser().getName());
        }
    }
}