文章目录
1、Mybatis官网简介
- MyBatis一款半自动的ORM持久层框架,它支持自定义SQL、存储过程以及高级映射。
- MyBatis对JDBC进行了封装,几乎免除了所有的 JDBC 代码以及设置参数和获取结果集的工作。
- MyBatis可以通过简单的XML(mapper文件)或注解两种方式操作数据库。
MyBatis的执行流程图大致如下:
2、Demo搭建
Mybatis的Demo可以直接去官网下载,如果不下载的话那么可以根据下面的步骤搭建一个Demo,测试MyBatis
源码。
2.1、maven依赖
在maven项目中的pom文件引入Mybatis依赖,pom依赖项如下所示:
<dependency>
<groupId>org.mybatis</groupId>
<artifactId>mybatis</artifactId>
<version>3.2.1</version>
</dependency>
2.2、mybatis配置
新建一个mybatis-config.xml文件作为Mybatis文件配置,这个配置文件对应mybatis包下面的Configuration类,内容如下:
<?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>
<!--全局性地开启或关闭所有映射器配置文件中已配置的任何缓存-->
<setting name="cacheEnabled" value="true"/>
<!--延迟加载的全局开关,查询时,关闭关联对象即时加载以提高性能-->
<setting name="lazyLoadingEnabled" value="true"/>
<!--是否允许单个语句返回多结果集-->
<setting name="multipleResultSetsEnabled" value="true"/>
<!--使用列标签代替列名-->
<setting name="useColumnLabel" value="true"/>
<!--允许JDBC支持自动生成主键-->
<setting name="useGeneratedKeys" value="false"/>
<!--指定 MyBatis 应如何自动映射列到字段或属性-->
<!--NONE 表示关闭自动映射;PARTIAL 只会自动映射没有定义嵌套结果映射的字段。
FULL 会自动映射任何复杂的结果集(无论是否嵌套)-->
<setting name="autoMappingBehavior" value="PARTIAL"/>
<!--配置默认的执行器->
<!--SIMPLE 就是普通的执行器;REUSE 执行器会重用预处理语句(PreparedStatement);
BATCH 执行器不仅重用语句还会执行批量更新-->
<setting name="defaultExecutorType" value="SIMPLE"/>
<!--当没有为参数指定特定的 JDBC 类型时,空值的默认JDBC 类型->
<setting name="jdbcTypeForNull" value="OTHER"/>
</settings>
<!--定义SqlSession的环境配置-->
<environments default="development">
<environment id="development">
<!--定义事务管理器配置-->
<transactionManager type="JDBC"/>
<!--数据源配置 采用连接池-->
<dataSource type="POOLED">
<!--jdbc驱动器-->
<property name="driver" value="com.mysql.jdbc.Driver"/>
<!--mysql的url-->
<property name="url" value="实际路径"/>
<!--用户名-->
<property name="username" value="实际用户名"/>
<!--密码-->
<property name="password" value="实际密码"/>
</dataSource>
</environment>
</environments>
<!--配置mapper文件-->
<mappers>
<mapper resource="DemoMapper.xml"/>
</mappers>
</configuration>
本文demo的Mybatis配置文件只配置了以下三个内容,实际使用当中这三个配置也比较常用,具体如下所示:
- “settings”标签描述的是MyBatis自身的一些属性配置,比如缓存和延迟加载等一系列属性,在这里配置的属性会覆盖掉Mybatis包下面的Configuration类的默认配置。
- “environments”标签配置的数据库操作相关的,比如事务管理配置、连接池配置、数据源配置。
- 事务管理配置,MyBatis自身提供了两种事务管理器,分别为JDBC和MANAGED。
- JDBC – 这个配置直接使用了 JDBC 的提交和回滚设施,它依赖从数据源获得的连接来管理事务作用域
- MANAGED – 这个配置几乎没做什么。它从不提交或回滚一个连接,而是让容器来管理事务的整个生命周期。
- 连接池配置,MyBatis共提供了三种连接池,分别如下:
- UNPOOLED–这个数据源的实现会每次请求时打开和关闭连接。
- POOLED–这种数据源的实现利用“池”的概念将JDBC连接对象组织起来,避免了创建新的连接实例时所必需的初始化和认证时间。
- JNDI–这个数据源实现是为了能在如EJB或应用服务器这类容器中使用,容器可以集中或在外部配置数据源,然后放置一个 JNDI 上下文的数据源引用。
- 数据源配置就是用来连接数据库的,包括驱动器、URL、用户名和密码。
- 事务管理配置,MyBatis自身提供了两种事务管理器,分别为JDBC和MANAGED。
- mapper文件里面存放的是SQL语句,但是我们需要告诉MyBatis去哪找到这些SQL文件,所以mappers标签就是告诉MyBatis去哪找这些SQL语句。MyBatis提供了四种方法映射mapper文件,分别如下:
下面的demo是摘抄自官网,实际中应根据项目的具体路径配置
<!-- 第一种使用相对于类路径的资源引用 也是本文中使用的方式-->
<mappers>
<mapper resource="org/mybatis/builder/AuthorMapper.xml"/>
</mappers>
<!-- 第二种使用相对于类路径的资源引用 -->
<mappers>
<mapper url="file:///var/mappers/AuthorMapper.xml"/>
</mappers>
<!-- 第三种使用映射器接口实现类的完全限定类名 -->
<mappers>
<mapper class="org.mybatis.builder.AuthorMapper"/>
</mappers>
<!-- 第四种使用映射器接口实现类的完全限定类名 -->
<mappers>
<package name="org.mybatis.builder"/>
</mappers>
根据官网介绍,MyBatis配置文件共有9个配置标签可供使用,具体如下:
2.3、mapper文件配置
DemoMapper接口内容如下:
public interface DemoMapper {
/**
* 查询用户信息
*
* @return 返回结果
*/
List<BaseUserInfoDO> queryBaseUserInfoDO();
}
此次测试中选择的是base_user_info数据库表,本次只测试select查询语句,然后分析其底层源码实现。DemoMapper.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="com.test.mapper.DemoMapper">
<!--用as将数据表中的字段映射到实体类字段上-->
<select id="queryBaseUserInfoDO" resultType="com.test.entity.BaseUserInfoDO">
/**UserMapper.queryBaseUserInfoDO 用户信息查询*/
SELECT
id as id,
user_id as userId,
user_name as userName,
phone as phone,
status as status,
sign_status as signStatus,
sex as sex
FROM
base_user_info
</select>
</mapper>
对应接收的实体类如下:
@Getter
@Setter
@ToString(callSuper = true)
public class BaseUserInfoDO implements Serializable {
private Long id;
private Long userId;
private String userName;
private String phone;
private String status;
private String signStatus;
private String sex;
}
2.3、测试类
测试类代码如下:
public class TestMyBatis {
public static void main(String[] args) throws IOException {
String resource = "mybatis-config.xml";
//获取MyBatis配置文件
InputStream inputStream = Resources.getResourceAsStream(resource);
//通过SqlSessionFactoryBuilder的build()方法获取SqlSessionFactory 对象
//此时已将MyBatis配置文件的相关配置已获取到,即Configuration类已获取到值
SqlSessionFactory sqlSessionFactory = new SqlSessionFactoryBuilder().build(inputStream);
//通过SqlSessionFactory的openSession()方法获取SqlSession 对象
SqlSession sqlSession = sqlSessionFactory.openSession();
try