MyBatis 入门概述 sqlsession 工作原理

最新推荐文章于 2025-04-04 09:42:24 发布

澄清石灰水t

最新推荐文章于 2025-04-04 09:42:24 发布

阅读量282

点赞数

文章标签： mybatis

本文链接：https://blog.youkuaiyun.com/chengqingshihuishui/article/details/113369071

版权

本文是MyBatis的基础教程，涵盖了MyBatis的简介、使用方法、入门案例以及接口式编程的实践。通过案例介绍了如何创建数据库表、编写JavaBean、配置MyBatis的全局配置文件和SQL映射文件，以及如何利用SqlSession执行SQL。文章还探讨了MyBatis的工作原理，包括SqlSessionFactory和SqlSession的创建，以及Executor、StatementHandler、ParameterHandler和ResultSetHandler的作用。

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

1、MyBatis简介

2、如何使用MyBatis

3、入门案例，写一个MyBatis版本"HelloWorld"

4、接口式编程（文档里面也写了接口式变成新方法，建议使用）

5、MyBatis工作原理

1、MyBatis简介

MyBatis是一个半自动化的持久化层框架。比JDBC好用的多。

用MyBatis可以做到sql和java编码分开，功能边界清晰，一个专注业务、一个专注数据。

扩展：JDBC缺点
SQL夹在Java代码块里，耦合度高导致硬编码内伤
维护不易且实际开发需求中sql是有变化，频繁修改的情况多见

2、如何使用MyBatis

百度mybatis，进入官网，https://mybatis.org/mybatis-3/zh/getting-started.html

进入官网后，点击入门，按照指示，通过Maven进行安装。

3、入门案例，写一个MyBatis版本"HelloWorld"

（1）要求：创建一张测试表
① 创建对应的javaBean
② 创建mybatis配置文件，sql映射文件
③ 测试

（2）操作步骤总结如下：

① 根据xml配置文件（全局配置文件）创建一个SqlSessionFactory对象有数据源一些运行环境信息
② sql映射文件；配置了每一个sql，以及sql的封装规则等。
③ 将sql映射文件注册在全局配置文件中
④ 写代码：
1）根据全局配置文件得到SqlSessionFactory；
2）使用sqlSession工厂，获取到sqlSession对象使用他来执行增删改查，一个sqlSession就是代表和数据库的一次会话，用完关闭
3）使用sql的唯一标志来告诉MyBatis执行哪个sql。sql都是保存在sql映射文件中的。

（3）具体演示

Step1 使用SQLyog 创建一个mysql数据表

Step2 项目工程里面包com.atguigu.mybatis.bean下创建一个与数据库里面的数据表对应的javabean。 Employee

package com.atguigu.mybatis.bean;

public class Employee {
	
	private Integer id;
	private String lastName;
	private String email;
	private String gender;
	
	
	public Integer getId() {
		return id;
	}
	public void setId(Integer id) {
		this.id = id; 
    \\get,set tostring 有参，空参等等bean组件要素

}

Step3 编写mybatis全局配置文件

创建一个conf文件夹，在该文件夹下创建一个xml文档，然后直接去官方网站复制过来。然后主要修改以下

① driver（数据源），这里用的是mysql

② url：localhost:3306/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>
	<environments default="development">
		<environment id="development">
			<transactionManager type="JDBC" />
			<dataSource type="POOLED">
				<property name="driver" value="com.mysql.jdbc.Driver" />
				<property name="url" value="jdbc:mysql://localhost:3306/mybatis" />
				<property name="username" value="root" />
				<property name="password" value="123456" />
			</dataSource>
		</environment>
	</environments>
</configuration>

step4 去测试类中构建 从 XML 中构建 SqlSessionFactory实例，以便后面从工厂获取sqlSession

来完成增删改查。官网已经给我写好了代码，粘贴过来修改就是了

注意resource写配置文件的路径，写好自己的路径，这里和官网的不一样

新建包 com.atguigu.mybatis.test;

package com.atguigu.mybatis.test;


public class MyBatisTest {
	

	public SqlSessionFactory getSqlSessionFactory() throws IOException {
		String resource = "mybatis-config.xml";
		InputStream inputStream = Resources.getResourceAsStream(resource);
		return new SqlSessionFactoryBuilder().build(inputStream);
	}
  
}

step5 在conf文件夹下继续创建一个配置类EmployeeMapper.xml ，这个xml用于sql语句映射

细节：数据库里面的字段是last_name, javabean里面的属性是lastName，为了让系统识别，就需要给数据库里的last_name起别名，让他成为lastName

说明：

namespace:名称空间，名字随便取（此案例）;后续会指定为接口的全类名（为了方便接口式编程）
id：唯一标识
resultType：返回值类型
#{id}：从传递过来的参数中取出id值

<mapper namespace="com.atguigu.mybatis.dao.EmployeeMapper">
<!-- 
public Employee getEmpById(Integer id);
 -->
	<select id="selectEmp" resultType="com.atguigu.mybatis.bean.Employee">
		select id,last_name lastName,email,gender from tbl_employee where id = #{id}
	</select>
</mapper>

step6 回MyBatisTest.java中写好使用配置文件中sql语句的方法

① 获取sqlSession实例，能直接执行已经映射的sql语句

② sql的唯一标识：statement Unique identifier matching the statement to use.

③ 执行sql要用的参数：parameter A parameter object to pass to the statement.

openSession.selectOne（参数1，参数2）方法，第一个参数，写配置文件中的名称空间+id,第二个参数写，要操作的行

使用sqlSession工厂，获取到sqlSession对象使用他来执行增删改查，一个sqlSession就是代表和数据库的一次会话，用完关闭
使用sql的唯一标志来告诉MyBatis执行哪个sql。sql都是保存在sql映射文件中的。

package com.atguigu.mybatis.test;


public class MyBatisTest {
    @Test
	public void test() throws IOException {
		SqlSessionFactory sqlSessionFactory = getSqlSessionFactory();
		SqlSession openSession = sqlSessionFactory.openSession();
		try {
			Employee employee = openSession.selectOne(
					"com.atguigu.mybatis.EmployeeMapper.selectEmp", 1);
			System.out.println(employee);
		} finally {
			openSession.close();
		}
	}
}

step7 回到mybatis全局配置文件，写<mappers>标签，配置sql映射

<?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>
	<environments default="development">
		<environment id="development">
			<transactionManager type="JDBC" />
			<dataSource type="POOLED">
				<property name="driver" value="com.mysql.jdbc.Driver" />
				<property name="url" value="jdbc:mysql://localhost:3306/mybatis" />
				<property name="username" value="root" />
				<property name="password" value="123456" />
			</dataSource>
		</environment>
	</environments>
	<!-- 将我们写好的sql映射文件（EmployeeMapper.xml）一定要注册到全局配置文件（mybatis-config.xml）中 -->
	<mappers>
		<mapper resource="EmployeeMapper.xml" />
	</mappers>
</configuration>

4、接口式编程（文档里面也写了接口式变成新方法，建议使用）

上面用的方法还是老方法，不够简洁。因此升级了接口式编程，mybatis框架让接口可以与配置文件动态绑定

处理过程：

创建一个Dao接口
修改Mapper文件
测试

（1）接口式编程
原生：       Dao       ====> DaoImpl
mybatis：   Mapper   ====> xxMapper.xml
（2）SqlSession代表和数据库的一次会话；用完必须关闭；
（3）SqlSession和connection一样她都是非线程安全。每次使用都应该去获取新的对象。SqlSession每次使用完成后需要正确关闭
（4）mapper接口没有实现类，但是mybatis会为这个接口生成一个代理对象。
（将接口和xml进行绑定）
EmployeeMapper empMapper =   sqlSession.getMapper(EmployeeMapper.class);
（5）两个重要的配置文件：
①  mybatis的全局配置文件：包含数据库连接池信息，事务管理器信息等...系统运行环境信息
② sql映射文件：保存了每一个sql语句的映射信息：将sql抽取出来。

在com.atguigu.mybatis.dao下定义一个接口

package com.atguigu.mybatis.dao;

public interface EmployeeMapper {
	
	public Employee getEmpById(Integer id);

}

此时再进入EmployeeMapper.xml ，重新配置

此时名称空间指定为接口的全类名，方便动态绑定，id改为接口方法名

<mapper namespace="com.atguigu.mybatis.dao.EmployeeMapper">
<!-- 
public Employee getEmpById(Integer id);
 -->
	<select id="getEmpById" resultType="com.atguigu.mybatis.bean.Employee">
		select id,last_name lastName,email,gender from tbl_employee where id = #{id}
	</select>
</mapper>

回到springmvctest.java类

说明：接口不用实例化，因为mybatis会为接口自动的创建一个代理对象（其他代码都用反射自动写好），代理对象去执行增删改查方法

package com.atguigu.mybatis.test;


public class MyBatisTest {
	
    @Test
	public void test01() throws IOException {
		// 1、获取sqlSessionFactory对象
		SqlSessionFactory sqlSessionFactory = getSqlSessionFactory();
		// 2、获取sqlSession对象
		SqlSession openSession = sqlSessionFactory.openSession();
		try {
			// 3、获取接口的实现类对象
			//会为接口自动的创建一个代理对象，代理对象去执行增删改查方法
			EmployeeMapper mapper = openSession.getMapper(EmployeeMapper.class);
			Employee employee = mapper.getEmpById(1);
			System.out.println(mapper.getClass());
			System.out.println(employee);
		} finally {
			openSession.close();
		}
	}
}

5、MyBatis工作原理

MyBatis框架工作步骤：

（1）获取sqlSessionFactory对象:
   *        解析文件的每一个信息保存在Configuration中，返回包含Configuration的DefaultSqlSession；
   *        注意：【MappedStatement】：代表一个增删改查的详细信息
   *
（2）获取sqlSession对象
   *        返回一个DefaultSQlSession对象，包含Executor和Configuration;
   *        这一步会创建Executor对象；
   *
（3）获取接口的代理对象（MapperProxy）
   *        getMapper，使用MapperProxyFactory创建一个MapperProxy的代理对象
   *        代理对象里面包含了，DefaultSqlSession（Executor）
（4）执行增删改查方法
   *
总结：
（1）根据配置文件（全局，sql映射）初始化出Configuration对象
（2）创建一个DefaultSqlSession对象，
   *        他里面包含Configuration以及
   *        Executor（根据全局配置文件中的defaultExecutorType创建出对应的Executor）
（3）DefaultSqlSession.getMapper（）：拿到Mapper接口对应的MapperProxy；
（4）MapperProxy里面有（DefaultSqlSession）；
（5）执行增删改查方法：
   *         1）、调用DefaultSqlSession的增删改查（Executor）；
   *         2）、会创建一个StatementHandler对象。
   *             （同时也会创建出ParameterHandler和ResultSetHandler）
   *         3）、调用StatementHandler预编译参数以及设置参数值;
   *             使用ParameterHandler来给sql设置参数
   *         4）、调用StatementHandler的增删改查方法；
   *         5）、ResultSetHandler封装结果
注意：
   *     四大对象每个创建的时候都有一个interceptorChain.pluginAll(parameterHandler);