MyBatis框架

一、MyBatis是什么

  MyBatis是一个基于java的持久层框架，它内部封装了jdbc，使开发者只需要关注sql语句本身，而不需要花费精力去处理加载驱动、创建连接、创建statement等繁杂的过程。

  mybatis通过xml或注解的方式将要执行的各种 statement配置起来，并通过java对象和statement中sql的动态参数进行映射生成最终执行的sql语句。

  最后mybatis框架执行sql并将结果映射为java对象并返回。采用ORM思想解决了实体和数据库映射的问题，对jdbc 进行了封装，屏蔽了jdbc api 底层访问细节，使我们不用与jdbc api 打交道，就可以完成对数据库的持久化操作。

二、开发步骤

1、添加MyBatis的坐标

在pom.xml中导入驱动：

  <dependency>
            <groupId>org.mybatis</groupId>
            <artifactId>mybatis</artifactId>
            <version>3.4.6</version>
   </dependency>

2、编写映射文件

在编写映射文件的前提下先建立数据库表和实体类，映射文件主要描述的是SQL语句。

动态SQL语句

  Mybatis 的映射文件中，前面我们的 SQL 都是比较简单的，有些时候业务逻辑复杂时，我们的 SQL是动态变化的，此时在前面的学习中我们的 SQL 就不能满足要求了。

常用的标签：

标签名	作用
< select>	查询
< insert>	插入
< update>	修改
< delete>	删除
< where>	where条件
< if>	if判断
< foreach>	循环
< sql>	sql片段抽取

  Sql 中可将重复的 sql 提取出来，使用时用 include 引用即可，最终达到 sql 重用的目的

< foreach>标签用于遍历集合，它的属性：

	collection：代表要遍历的集合元素，注意编写时不要写#{}
	open：代表语句的开始部分
	close：代表结束部分
	item：代表遍历集合的每个元素，生成的变量名
	sperator：代表分隔符

案例：

<mapper namespace="com.itheima.mapper.UserMapper">
    <!--sql语句抽取-->
    <sql id="selectUser">select * from user</sql>
    
    <select id="findByCondition" parameterType="user" resultType="user">
        <include refid="selectUser"></include>
        <where>
            <if test="id!=0">
                and id=#{id}
            </if>
            <if test="username!=null">
                and username=#{username}
            </if>
            <if test="password!=null">
                and password=#{password}
            </if>
        </where>
    </select>
    <select id="findByIds" parameterType="list" resultType="user">
        <include refid="selectUser"></include>
        <where>
            <foreach collection="list" open="id in(" close=")" item="id" separator=",">
                #{id}
            </foreach>
        </where>
    </select>

</mapper>

3、编写核心文件

案例：

<configuration>

    <!--通过properties标签加载外部properties文件-->
    <properties resource="jdbc.properties"></properties>

    <!--自定义别名-->
    <typeAliases>
        <typeAlias type="com.itheima.domain.User" alias="user"></typeAlias>
    </typeAliases>

    <!--数据源环境-->
    <environments default="developement">
        <environment id="developement">
            <transactionManager type="JDBC"></transactionManager>
            <dataSource type="POOLED">
                <property name="driver" value="${jdbc.driver}"/>
                <property name="url" value="${jdbc.url}"/>
                <property name="username" value="${jdbc.username}"/>
                <property name="password" value="${jdbc.password}"/>
            </dataSource>
        </environment>
    </environments>

    <!--加载映射文件-->
    <mappers>
        <mapper resource="com/itheima/mapper/UserMapper.xml"></mapper>
    </mappers>
</configuration>

核心文件中的标签：

environments标签

transactionManager事务管理器，类型有两种：

1、JDBC：这个配置就是直接使用了JDBC 的提交和回滚设置，它依赖于从数据源得到的连接来管理事务作用域。

2、MANAGED：这个配置几乎没做什么。它从来不提交或回滚一个连接，而是让容器来管理事务的整个生命周期（比如 JEE 应用服务器的上下文）。
 默认情况下它会关闭连接，然而一些容器并不希望这样，因此需要将 closeConnection 属性设置为 
false 来阻止它默认的关闭行为。

dataSource数据源类型有三种：

1、UNPOOLED：这个数据源的实现只是每次被请求时打开和关闭连接。

2、POOLED：这种数据源的实现利用“池”的概念将 JDBC 连接对象组织起来。

3、JNDI：这个数据源的实现是为了能在如 EJB 或应用服务器这类容器中使用，容器可以集中或在外部配置数据源，然后放置一个 JNDI 上下文的引用。

mappers标签

  <!--加载映射文件-->
    <mappers>
        <mapper resource="com/itheima/mapper/UserMapper.xml"></mapper>
    </mappers>

该标签的作用是加载映射的，加载方式有

Properties标签

  实际开发中，习惯将数据源的配置信息单独抽取成一个properties文件，该标签可以加载额外配置的properties文件

typeAliases标签

typeHandlers标签

由于Java 类型和数据库的 JDBC 类型不是一一对应的， 所以我们把 Java 对象转换为数据库的值，和把数据库的值转换成 Java 对象，需要经过 一定的转换，这两个方向的转换就要用到 TypeHandler。

  无论是 MyBatis 在预处理语句（PreparedStatement）中设置一个参数时，还是从结果集中取出一个值时， 都会用类型处理器将获取的值以合适的方式转换成 Java 类型。

开发步骤：

①定义转换类继承类BaseTypeHandler<T>
②覆盖4个未实现的方法，其中setNonNullParameter为java程序设置数据到数据库的回调方法，getNullableResult为查询时 mysql的字符串类型转换成 java的Type类型的方法
③在MyBatis核心配置文件中进行注册

plugins标签(插件标签)

MyBatis可以使用第三方的插件来对功能进行扩展，分页助手PageHelper是将分页的复杂操作进行封装，使用简单的方式即可获得分页的相关数据

开发步骤：
①导入通用PageHelper的坐标
②在mybatis核心配置文件中配置PageHelper插件
③测试分页数据获取

三、MyBatis的相应API

SqlSession工厂构建器SqlSessionFactoryBuilder:

SqlSession工厂对象SqlSessionFactory:

SqlSession会话对象
  SqlSession 实例在 MyBatis 中是非常强大的一个类。在这里你会看到所有执行语句、提交或回滚事务和获取映射器实例的方法。

四、MyBatis的Dao层实现

传统开发方式

1、编写UserDao接口

2、编写UserDaoImpl实现

3、测试传统方式

代理开发方式

  采用 Mybatis 的代理开发方式实现 DAO 层的开发，Mapper 接口开发方法只需要程序员编写Mapper 接口（相当于Dao 接口），由Mybatis 框架根据接口定义创建接口的动态代理对象，代理对象的方法体同上边Dao接口实现类方法。

Mapper 接口开发需要遵循以下规范:

编写UserMapper接口:

测试代理方式

五、MyBatis的多表操作

六、MyBatis注解开发

常用注解：

注解	说明
@Insert	实现新增
@Update	实现更新
@Delete	实现删除
@Select	实现查询
@Result	实现结果及封装
@Results	可以与@Result 一起使用，封装多个结果集
@One	实现一对一结果集封装
@Many	实现一对多结果集封装

MyBatis的注解实现复杂映射开发：

  实现复杂关系映射之前我们可以在映射文件中通过配置来实现，使用注解开发后，我们可以使用@Results注解，@Result注解，@One注解，@Many注解组合完成复杂关系的配置

七、列表查询按例

数据库表关系如图所示：

1、一对一查询

需求：查询orders中某条记录，及该记录的user信息

数据库中SQL语句为：

select * from orders o,user u where o.uid=u.id;

查询结果：

利用Mybatis查询：
第一步：先根据数据库表创建实体类
第二步：根据实体类创建Mapper接口
UserMapper接口：

public interface UserMapper {
    @Select("select * from user where id=#{id}")
    public User findById(int id);
}

OrderMapper接口：

public interface OrderMapper {
    @Select("select * from orders")
    @Results({
            @Result(column = "id", property = "id"),
            @Result(column = "ordertime", property = "ordertime"),
            @Result(column = "total", property = "total"),
            @Result(
                    property = "user", //要封装的属性名称
                    column = "uid", //根据那个字段去查询user表的数据
                    javaType = User.class, //要封装的实体类型
                    //select属性 代表查询那个接口的方法获得数据
                    one = @One(select = "com.itheima.mapper.UserMapper.findById")
            )
    })
    public List<Order> findAll();
}

第三步：创建核心文件
sqlMapConfig.xml：

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

    <!--通过properties标签加载外部properties文件-->
    <properties resource="jdbc.properties"></properties>

    <!--自定义别名-->
    <typeAliases>
        <typeAlias type="com.itheima.domain.User" alias="user"></typeAlias>
    </typeAliases>


    <!--数据源环境-->
    <environments default="developement">
        <environment id="developement">
            <transactionManager type="JDBC"></transactionManager>
            <dataSource type="POOLED">
                <property name="driver" value="${jdbc.driver}"/>
                <property name="url" value="${jdbc.url}"/>
                <property name="username" value="${jdbc.username}"/>
                <property name="password" value="${jdbc.password}"/>
            </dataSource>
        </environment>
    </environments>

    <!--加载映射关系-->
    <mappers>
        <!--指定接口所在的包-->
        <package name="com.itheima.mapper"></package>
    </mappers>
</configuration>

第四步：创建测试类：

public class MyBatisTest2 {
    private OrderMapper mapper;
    @Before
    public void before() throws IOException {
        InputStream resourceAsStream = Resources.getResourceAsStream("sqlMapConfig.xml");
        SqlSessionFactory sqlSessionFactory = new SqlSessionFactoryBuilder().build(resourceAsStream);
        SqlSession sqlSession = sqlSessionFactory.openSession(true);
        mapper = sqlSession.getMapper(OrderMapper.class);
    }
    @Test
    public void testSave(){
        List<Order> all = mapper.findAll();
        for (Order order : all) {
            System.out.println(order);
        }
    }
}

测试结果：

15:47:44,920 DEBUG findAll:159 - <==      Total: 2
Order{id=1, ordertime=Mon May 02 00:00:00 CST 2022, total=2000.0, user=User{id=1, username='小张', password='123', birthday=Mon May 09 00:00:00 CST 2022, roleList=null}}
Order{id=2, ordertime=Tue May 03 00:00:00 CST 2022, total=232.0, user=User{id=2, username='aaa', password='abc', birthday=Thu May 12 00:00:00 CST 2022, roleList=null}}