mybatis的延迟加载（懒加载）

最新推荐文章于 2025-07-14 21:09:35 发布

原创最新推荐文章于 2025-07-14 21:09:35 发布 · 2.6k 阅读

6 ·

CC 4.0 BY-SA版权

文章标签：

#mybatis的延迟加载懒加载 #maven #mybatis #mybatis延迟加载 #Mybatis关联查询

java常用框架专栏收录该内容

50 篇文章

订阅专栏

本文介绍MyBatis框架中的懒加载配置方法及其实现步骤，通过具体示例展示了如何通过配置实现延迟加载，减少不必要的数据库查询，提高应用程序性能。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

mybatis的延迟加载

延迟加载的意思是说，在关联查询时，利用延迟加载，先加载主信息。使用关联信息时再去加载关联信息。

要设置延迟加载，只需要在主配置文件中加入如下的配置即可：

<!-- 开启延迟加载 -->
	<settings>
		<!-- lazyLoadingEnabled：延迟加载启动，默认是false 相当于是否开启延迟加载 -->
		<setting name="lazyLoadingEnabled" value="true" />
		<!--aggressiveLazyLoading:积极的懒加载，falsed话按需加载，默认是true -->
		<setting name="aggressiveLazyLoading" value="false"></setting>
	</settings>

下面将演示懒加载的使用：

本人在数据库中创建了emp员工表和dept部门表，emp外键关联dept, 案例将演示在查询员工信息的过程中观察懒加载。我们开启懒加载后，在我们需要使用关联表的数据时，才会去查询，需要的信息不包括其他关联数据时将不会去查询关联的数据。

表的结构如下：

测试项目结构如下（案例使用的是maven项目）：

IEmpDAO.java为接口，提供查询emp的方法，EmpDAOImpl.java为接口的实现类，MybatisSqlSessionFactory.java为本人创建的获取sqlSession的工具类，Emp.java为员工实体类，Emp.xml为Emp实体类映射文件，Dept.java 为部门实体类，Dept.xml为部门实体类映射文件，log4j.properties为mybatis打印日志，mybatis_cfg.xml为mybatis主配置文件，Test.java为测试类，pom.xml为maven引入依赖的文件。

1、IEmpDAO.java为接口，提供查询emp的方法

package cn.sz.hcq.dao;

import cn.sz.hcq.pojo.Emp;

public interface IEmpDAO {
	/**
	 * 根据员工编号查询员工信息
	 * 
	 * @param empno
	 * @return
	 */
	public Emp findAllByEmpno(Integer empno);

}

2、EmpDAOImpl.java为接口的实现类

package cn.sz.hcq.dao.impl;

import org.apache.ibatis.session.SqlSession;

import cn.sz.hcq.dao.IEmpDAO;
import cn.sz.hcq.factory.MybatisSqlSessionFactory;
import cn.sz.hcq.pojo.Emp;

public class EmpDAOImpl implements IEmpDAO {

	public Emp findAllByEmpno(Integer empno) {
		SqlSession sqlSession = null;
		try {
			sqlSession = MybatisSqlSessionFactory.getMySqlSession();
			return sqlSession.selectOne("cn.sz.hcq.pojo.Emp.findEmpByEmpno",
					empno);
		} catch (Exception e) {
			e.printStackTrace();
		} finally {
			MybatisSqlSessionFactory.closeSqlSession();
		}
		return null;
	}
}

3、MybatisSqlSessionFactory.java为本人创建的获取sqlSession的工具类

package cn.sz.hcq.factory;

import java.io.IOException;
import java.io.Reader;

import org.apache.ibatis.io.Resources;
import org.apache.ibatis.session.SqlSession;
import org.apache.ibatis.session.SqlSessionFactory;
import org.apache.ibatis.session.SqlSessionFactoryBuilder;

public class MybatisSqlSessionFactory {
	// 配置文件
	private static final String RESOURCE = "mybatis_cfg.xml";
	private static Reader reader = null;
	private static SqlSessionFactoryBuilder builder = null;
	private static SqlSessionFactory factory = null;
	// 可以在同一个线程范围内，共享一个对象
	private static ThreadLocal<SqlSession> threadLocal = new ThreadLocal<SqlSession>();

	// 静态代码块（类加载的时候执行一次）
	static {
		try {
			reader = Resources.getResourceAsReader(RESOURCE);
			builder = new SqlSessionFactoryBuilder();
			factory = builder.build(reader);
		} catch (IOException e) {
			e.printStackTrace();
		}
	}

	public static SqlSession getMySqlSession() {
		// 从本地线程中获取session连接
		SqlSession sqlSession = threadLocal.get();
		// 连接为空则创建连接，并将该连接添加到本地线程中去
		if (sqlSession == null) {
			if (factory == null) {
				rebuildFactory();
			}
			sqlSession = factory.openSession();
		}
		threadLocal.set(sqlSession);
		return sqlSession;
	}

	// 创建工厂
	public static void rebuildFactory() {
		try {
			reader = Resources.getResourceAsReader(RESOURCE);
			builder = new SqlSessionFactoryBuilder();
			factory = builder.build(reader);
		} catch (IOException e) {
			e.printStackTrace();
		}
	}

	// 关闭连接
	public static void closeSqlSession() {
		SqlSession sqlSession = threadLocal.get();
		if (sqlSession != null) {
			// 关闭session
			sqlSession.close();
		}
		// 同时将本地线程中置为null（防止用户再次调用时出现空的session）
		threadLocal.set(null);
	}

}

4、Emp.java为员工实体类

package cn.sz.hcq.pojo;

import java.io.Serializable;
import java.util.Date;

public class Emp implements Serializable {
	private Integer empno;
	private String ename;
	private String job;
	private Integer mgr;
	private Date hiredate;
	private Double sal;
	private Double comm;
	private Dept dept;

	public Integer getEmpno() {
		return empno;
	}

	public void setEmpno(Integer empno) {
		this.empno = empno;
	}

	public String getEname() {
		return ename;
	}

	public void setEname(String ename) {
		this.ename = ename;
	}

	public String getJob() {
		return job;
	}

	public void setJob(String job) {
		this.job = job;
	}

	public Integer getMgr() {
		return mgr;
	}

	public void setMgr(Integer mgr) {
		this.mgr = mgr;
	}

	public Date getHiredate() {
		return hiredate;
	}

	public void setHiredate(Date hiredate) {
		this.hiredate = hiredate;
	}

	public Double getSal() {
		return sal;
	}

	public void setSal(Double sal) {
		this.sal = sal;
	}

	public Double getComm() {
		return comm;
	}

	public void setComm(Double comm) {
		this.comm = comm;
	}

	public Dept getDept() {
		return dept;
	}

	public void setDept(Dept dept) {
		this.dept = dept;
	}

}

5、Emp.xml为Emp实体类映射文件

<?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">
<mapper namespace="cn.sz.hcq.pojo.Emp">

	<!-- 根据员工编号查询员工信息，并查询出他所在部门信息 （关联查询） -->
	<select id="findEmpByEmpno" parameterType="java.lang.Integer"
		resultMap="empinfo" useCache="true">
		select
		empno,ename,job,mgr,sal,comm,hiredate,deptno from
		emp
		where
		empno=#{empno}
	</select>
	<resultMap type="cn.sz.hcq.pojo.Emp" id="empinfo">
		<id column="empno" property="empno"></id>
		<result column="ename" property="ename" />
		<result column="job" property="job" />
		<result column="mgr" property="mgr" />
		<result column="sal" property="sal" />
		<result column="comm" property="comm" />
		<result column="hiredate" property="hiredate" />
		<association property="dept" column="deptno"
			select="cn.sz.hcq.pojo.Dept.findDeptByDeptno"></association>
	</resultMap>

</mapper>

6、Dept.java 为部门实体类

package cn.sz.hcq.pojo;

import java.io.Serializable;
import java.util.List;

public class Dept implements Serializable {
	private Integer deptno;
	private String dname;
	private String loc;
	
	private List<Emp> emps;

	public Integer getDeptno() {
		return deptno;
	}

	public void setDeptno(Integer deptno) {
		this.deptno = deptno;
	}

	public String getDname() {
		return dname;
	}

	public void setDname(String dname) {
		this.dname = dname;
	}

	public String getLoc() {
		return loc;
	}

	public void setLoc(String loc) {
		this.loc = loc;
	}

	public List<Emp> getEmps() {
		return emps;
	}

	public void setEmps(List<Emp> emps) {
		this.emps = emps;
	}

}

7、Dept.xml为部门实体类映射文件

<?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">
<mapper namespace="cn.sz.hcq.pojo.Dept">
	<!-- 根据部门编号查询部门信息 -->
	<select id="findDeptByDeptno" parameterType="java.lang.Integer"
		resultType="cn.sz.hcq.pojo.Dept">
		select deptno,dname,loc from dept where deptno=#{deptno}
	</select>
</mapper>

8、log4j.properties为mybatis打印日志

log4j.appender.stdout=org.apache.log4j.ConsoleAppender
log4j.appender.stdout.Target=System.out
log4j.appender.stdout.layout=org.apache.log4j.PatternLayout
log4j.appender.stdout.layout.ConversionPattern=%d{yyyy-MM-dd HH:mm:ss} %m%n
log4j.appender.file=org.apache.log4j.FileAppender

log4j.appender.file.File=d:/log.txt

log4j.appender.file.layout=org.apache.log4j.PatternLayout

log4j.appender.file.layout.ConversionPattern=%d{yyyy-MM-dd HH:mm:ss}  %m%n
log4j.rootLogger=debug,file,stdout
#fatal-->error-->warn-->info-->debug

log4j.logger.com.ibatis=DEBUG
log4j.logger.com.ibatis.common.jdbc.SimpleDataSource=DEBUG
log4j.logger.com.ibatis.common.jdbc.ScriptRunner=DEBUG
log4j.logger.com.ibatis.sqlmap.engine.impl.SqlMapClientDelegate=DEBUG
log4j.logger.java.sql.Connection=DEBUG
log4j.logger.java.sql.Statement=DEBUG
log4j.logger.java.sql.PreparedStatement=DEBUG

9、pom.xml为maven引入依赖的文件

<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
	xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
	<modelVersion>4.0.0</modelVersion>
	<groupId>cn.sz.hcq.pro</groupId>
	<artifactId>Mybatis_lazy</artifactId>
	<version>0.0.1-SNAPSHOT</version>
	<packaging>war</packaging>
	<dependencies>
		<!-- mybatis依赖 -->
		<dependency>
			<groupId>org.mybatis</groupId>
			<artifactId>mybatis</artifactId>
			<version>3.2.3</version>
		</dependency>
		<!--mysql数据库驱动依赖 -->
		<dependency>
			<groupId>mysql</groupId>
			<artifactId>mysql-connector-java</artifactId>
			<version>5.1.39</version>

		</dependency>
		<!-- 日志记录 -->
		<dependency>
			<groupId>log4j</groupId>
			<artifactId>log4j</artifactId>
			<version>1.2.17</version>
		</dependency>
		<dependency>
			<groupId>cglib</groupId>
			<artifactId>cglib</artifactId>
			<version>2.2.2</version>
		</dependency>
		<dependency>
			<groupId>org.slf4j</groupId>
			<artifactId>slf4j-log4j12</artifactId>
			<version>1.7.5</version>
		</dependency>

	</dependencies>
</project>

10、mybatis_cfg.xml为mybatis主配置文件

<?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>
	<!--配置参数 -->
	<!-- 开启延迟加载 -->
	<settings>
		<!-- lazyLoadingEnabled：延迟加载启动，默认是false 相当于是否开启延迟加载 -->
		<setting name="lazyLoadingEnabled" value="true" />
		<!--aggressiveLazyLoading:积极的懒加载，falsed话按需加载，默认是true -->
		<setting name="aggressiveLazyLoading" value="false"></setting>
	</settings>
	
	<!--数据源 -->
	<environments default="myconn">
		<environment id="myconn">
			<!--事务管理方式 -->
			<transactionManager type="JDBC"></transactionManager>
			<!--数据库连接参数 -->
			<dataSource type="POOLED">
				<!-- type:数据源连接的方式 ，POOLED:连接池方式， UNPOOLED: 非连接池的方式 ，JNDI：java命名与目录接口方式 -->
				<property name="driver" value="org.gjt.mm.mysql.Driver"></property>
				<property name="url" value="jdbc:mysql://localhost:3306/db"></property>
				<property name="username" value="root"></property>
				<property name="password" value="root"></property>
			</dataSource>
		</environment>
	</environments>

	<!-- 引入实体映射文件 -->
	<mappers>
		<mapper resource="cn/sz/hcq/pojo/Emp.xml" />
		<mapper resource="cn/sz/hcq/pojo/Dept.xml" />
	</mappers>
</configuration>

11、Test.java为测试类

package cn.sz.hcq.test;

import cn.sz.hcq.dao.IEmpDAO;
import cn.sz.hcq.dao.impl.EmpDAOImpl;
import cn.sz.hcq.pojo.Emp;

public class Test {
	public static void main(String[] args) {
		IEmpDAO empDAO = new EmpDAOImpl();
		// 查询编号为7788的员工
		Emp emp = empDAO.findAllByEmpno(7788);

		// 如果我们不配置懒加载，mybatis默认是立即加载的

		// 我们在配置文件中配置了懒加载，当我们需要调用dept表的信息的时候才会给我们查询部门表的数据
		System.out.println("姓名：" + emp.getEname() + ",员工号：" + emp.getEmpno()
				+ "，部门：" + emp.getDept().getDname());

		// 当我们不适用部门dept的数据时，将不会查询部门的信息
		System.out.println("姓名：" + emp.getEname() + ",员工号：" + emp.getEmpno());
	}
}

当我们开启延迟加载后，在测试中在查询员工的信息然后输出员工的信息并输出部门的信息，发现控制台的有2条sql语句，一条查询员工信息的，一条是查询部门信息（开启懒加载之后我们需要使用关联其它表的数据时，才会帮我们去查询）。

这里在测试类中先注释该代码：

//System.out.println("姓名：" + emp.getEname() + ",员工号：" + emp.getEmpno());

测试结果：

接下面我们在查询员工的信息之后只是输出员工的信息，并没有输出部门的信息，发现并不会发送sql语句去查询部门信息。（这里我们没有使用到部门信息，所以不会去查询）。

这里注释该代码：

//System.out.println("姓名：" + emp.getEname() + ",员工号：" + emp.getEmpno()
				+ "，部门：" + emp.getDept().getDname());

测试结果：

在mybatis框架中默认是立即加载。

mybatis的延迟加载 （懒加载）

mybatis的延迟加载

mybatis的延迟加载（懒加载）