MyBatis详解2.MyBatis使用入门

字节跳动飞书内推！
北京、杭州、武汉、广州、深圳、上海，六大城市等你来投。
感兴趣的朋友可以私我咨询&内推，也可以通过链接直接投递！
海量HC，极速响应，快来和我成为同事吧。
今日头条、抖音、Tik Tok也可以内推～

点击进入我的博客

MyBatis详解1.概述
MyBatis详解2.MyBatis使用入门
MyBatis详解3.MyBatis配置详解
MyBatis详解4.映射器Mapper
MyBatis详解5.动态SQL
MyBatis详解6.MyBatis技术内幕
MyBatis详解7.插件
MyBatis详解8.集成Spring

1 MyBatis的结构

  • SqlSessionFactoryBuilder（构造器）：它会根据配置信息或者代码来生成SqISessionFactory。
  • SqISessionFactory（工厂接口）：依靠工厂来生成SqlSession
  • SqlSession（会话）：是一个既可以发送SQL去执行并返回结果，也可以获取 Mapper的接口。
  • SQL Mapper：它是MyBatis新设计的组件，它是由一个Java接口和XML文件（或注解）构成的，需要给出对应的SQL和映射规则。它负责发送SQL去执行，并返回结果。
MyBatis构成

2 构建SqISessionFactory

每个MyBatis应用都是以SqlSessionFactory的实例为中心的。 SqlSessionFactory的实例可以通过SqlSessionFactoryBuilder获得。MyBatis提供了两种模式去创建SqlSessionFactory：基于XML配置的方式和基于代码的方式。


SqlSessionFactory类图
Configuration类

Configuration类对象保存着我们配置在MyBatis的信息，这个对象将存在于整个MyBatis应用的生命期中，以便重复读取和运用。我们可以解析一次配置的XML文件保存到Configuration类对象中，方便我们从这个对象中读取配置信息。

两个SqlSessionFactory的实现类

在MyBatis中提供了两个SqlSessionFactory的实现类，DefaultSqlSessionFactory和SqlSessionManager。不过SqlSessionManager目前还没有使用，MyBatis中目前使用的是DefaultSqlSessionFactory。

2.1 通过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>
    <!-- 配置每个DO的别名 -->
    <typeAliases>
        <typeAlias type="com.ankeetc.spring.domain.UserDomain" alias="user"/>
    </typeAliases>
    <!-- 配置环境内容 -->
    <environments default="dev">
        <environment id="dev">
            <!-- 采用JDBC的事务管理模式 -->
            <transactionManager type="JDBC"/>
            <!-- 数据库的连接信息 -->=
            <dataSource type="POOLED">
                <property name="driver" value="com.mysql.jdbc.Driver"/>
                <property name="url" value="jdbc:mysql://localhost:3306/test"/>
                <property name="username" value="root"/>
            </dataSource>
        </environment>
    </environments>
    <!-- 配置映射器 -->
    <mappers>
        <mapper resource="mappers/TbNameMapper.xml"/>
    </mappers>
</configuration>

    public SqlSessionFactory getSqlSessionFactory() throws Exception {
        // 获取config源文件
        InputStream is = Resources.getResourceAsStream("mybatis-config.xml");
        // 通过SqlSessionFactoryBuilder构造
        return new SqlSessionFactoryBuilder().build(is);
    }

2.2 通过编码方式

    public SqlSessionFactory getSqlSessionFactory() throws Exception {
        // 构建数据库连接池
        PooledDataSource dataSource = new PooledDataSource();
        dataSource.setDriver("com.mysql.jdbc.Driver");
        dataSource.setUrl("jdbc:mysql://localhost:3306/test");
        dataSource.setUsername("root");

        // 构建数据库事务模式
        TransactionFactory transactionFactory = new JdbcTransactionFactory();

        // 创建数据库运行环境
        Environment environment = new Environment("dev", transactionFactory, dataSource);

        // 创建 Configuration 对象
        Configuration configuration = new Configuration(environment);
        // 配置MyBatis上下文别名
        configuration.getTypeAliasRegistry().registerAlias("user", UserDomain.class);
        // 配置映射器
        configuration.addMapper(TbNameMapper.class);
        // 使用SqlSessionFactoryBuilderg构建SqlSessionFactory
        return new SqlSessionFactoryBuilder().build(configuration);
    }

3 创建SqlSession

SqlSession是一个接口类，扮演着门面的作用，而真正干活的是Executor接口。只需要SqlSession参数信息和执行的方法，然后等待返回的结果，而不需要关心Executor是怎么工作的。

SqlSession的两个实现类
  • DefaultSqlSession
  • SqlSession
SqlSession的用法

SqlSession接口类似于一个JDBC中的Connection接囗对象，我们需要保证每次用完正常关闭它。正确的做法是把关闭SqlSession接口的代码写在finally句中保证每次都会
关闭SqlSession，让连接资源归还给数据库。

    public void func(SqlSessionFactory sqlSessionFactory) {
        // 打开SqlSession会话
        try (SqlSession sqlSession = sqlSessionFactory.openSession()){
            // doSomething()
            sqlSession.commit();
        } catch (Exception e) {
            // handle Exception
        }
    }
SqlSession的用途
  1. 获取映射器，让映射器通过命名空间和方法名称找到对应的SQL，发送给数据库执行后返回结果。
  2. 直接通过命名信息去执行SQL返回结果，这是 iBatis版本留下的方式。在SqlSession层我们可以通过update、insert、select、delete等方法，带上SQL的id来操作在XML中配置好的SQL，从而完成我们的工作；与此同时它也支持事务，通过 commit、rollback方法提交或者回滚事务。

4 映射器

映射器的作用

映射器是由Java接口和XML文件（或注解）共同组成的，作用如下：

  • 定义参数类型。
  • 描述缓存。
  • 描述SQL语句。
  • 定义查询结果和POJO的映射关系
映射器的两种实现方式有两种
  • 通过XML文件方式实现，
  • 通过代码方式实现，在Configuration里面注册Mapper接口

4.1 XML方式实现Mapper

  1. 定义了一个XML Mapper文件，而且在配置文件mybatis-config.xml中配置了的该文件，所以 MyBatis会读取这个配置文件，生成映射器。
  2. 定义了一个命名空间为 com.ankeetc.spring.mapper.TbNameMapper 的SQL Mapper，这个命名空间和我们定义的接口的全限定名是一致的。
  3. 定义了一个select元素，id和接口方法名UserDomain select(Long id)是一致的，parameterType则表示我们传递给这条SQL的是一个Long型参数，resultType则定义我们需要返回的数据类型。
<?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.ankeetc.spring.mapper.TbNameMapper">

    <select id="select" resultType="com.ankeetc.spring.domain.UserDomain" parameterType="java.lang.Long">
        SELECT * FROM tb_name WHERE id = #{id}
    </select>
</mapper>

public interface TbNameMapper {
    UserDomain select(Long id);
}

public static void func(SqlSessionFactory sqlSessionFactory) {
        // 打开SqlSession会话
        try (SqlSession sqlSession = sqlSessionFactory.openSession()){
            // 获取映射器Mapper
            TbNameMapper tbNameMapper = sqlSession.getMapper(TbNameMapper.class);
            // 执行查询
            UserDomain userDomain = tbNameMapper.select(18L);
            System.out.println(userDomain.getName());
            sqlSession.commit();
        } catch (Exception e) {
            // handle Exception
        }
    }

4.2 注解方式实现Mapper

public interface TbNameMapper2 {
    @Select("SELECT * FROM tb_name WHERE id = #{id}")
    UserDomain select(Long id);
}

在使用注解时，要向SqlSessionFactory中手动添加Mapper

    public SqlSessionFactory getSqlSessionFactory() throws Exception {
        // 在使用注解时，要向SqlSessionFactory中手动添加Mapper
        configuration.addMapper(TbNameMapper.class);
        //
    }

4.3 Mapper实现方式简述

我们使用的仅仅是Java接口和一个XML文件（或者注解）去实现 Mapper，一个没有实现类的接口怎么能够运行呢？这里其实是运用到Java语言的动态代理去实现，而实现Java语言的动态代理的方式有多种。这里我们还是集中于它的用法，所以可以这样理解：我们会在 MyBatis 上下文中描述这个接口，而MyBatis会为这个接口生成代理类对象，代理对象会根据“接口全路径+方法名”去匹配,找到对应的XML文件(或注解)去完成它所需要的任务，返回我们需要的结果。

5 生命周期

SqlSessionFactoryBuilder

SqlSessionFactoryBuilder是利用XML或者Java编码获得资源来构建SqlSessionFactory的，一旦我们构建了SqlSessionFactory，它的作用就已经完结，所以它的生命周期只存在于方法的局部。

SqlSessionFactory

SqlSessionFactory的作用是创建SqlSession，而SqlSession就是一个会话，每次访问数据库都需要通过SqlSessionFactory创建SqlSession，所以SqlSessionFactory应该在 MyBatis应用的整个生命周期中。而且SqlSessionFactory我们只是用它来创建SqlSession，只需要一个示例，所以需要用采用单例模式。

    public synchronized SqlSessionFactory initSqlSessionFactory() {
        try {
            if (sqlSessionFactory == null) {
                InputStream is = Resources.getResourceAsStream("mybatis-config.xml");
                sqlSessionFactory = new SqlSessionFactoryBuilder().build(is);
            }
            return sqlSessionFactory;
        } catch (Exception e) {
            throw new RuntimeException(e);
        }
    }
SqlSession

SqlSession是一个会话，它的生命周期应该是在请求数据库处理事务的过程中。它是一个线程不安全的对象，在涉及多线程的时候我们需要特别的当心，操作数据库需要注意其隔离级别，数据库锁等高级特性。每次创建的SqlSession都必须及时关闭它。

Mapper

Mapper是一个接口，它的作用是发送SQL然后返回我们需要的结果；或者执行SQL从而修改数据库的数据。因此它应该在一个SqlSession事务方法之内，是一个方法级别的东西。

最后编辑于 ：
©著作权归作者所有,转载或内容合作请联系作者
平台声明：文章内容（如有图片或视频亦包括在内）由作者上传并发布，文章内容仅代表作者本人观点，简书系信息发布平台，仅提供信息存储服务。

推荐阅读更多精彩内容