一文全了解Mybatis

初步了解

总体架构设计

Mybatis 整体框架如下:

接口层

MyBatis 和数据库的交互有两种方式:

  • 使用传统的 MyBatis 提供的 API;
  • 使用 Mapper 接口;
使用传统的 MyBatis 提供的 API

这是传统的传递 Statement Id 和查询参数给 SqlSession 对象,使用 SqlSession 对象完成和数据库的交互;MyBatis 提供了非常方便和简单的 API,供用户实现对数据库的增删改查数据操作,以及对数据库连接信息和 MyBatis 自身配置信息的维护操作。

使用 Mapper 接口

MyBatis 将配置文件中的每一个<mapper> 节点抽象为一个 Mapper 接口,而这个接口中声明的方法和跟<mapper> 节点中的<select|update|delete|insert> 节点项对应,即<select|update|delete|insert> 节点的 id 值为 Mapper 接口中的方法名称,parameterType 值表示 Mapper 对应方法的入参类型,而 resultMap 值则对应了 Mapper 接口表示的返回值类型或者返回结果集的元素类型。

根据 MyBatis 的配置规范配置好后,通过 SqlSession.getMapper(XXXMapper.class)方法,MyBatis 会根据相应的接口声明的方法信息,通过动态代理机制生成一个 Mapper 实例,我们使用 Mapper 接口的某一个方法时,MyBatis 会根据这个方法的方法名和参数类型,确定 Statement Id,底层还是通过 SqlSession.select("statementId",parameterObject);或者 SqlSession.update("statementId",parameterObject); 等等来实现对数据库的操作, MyBatis 引用 Mapper 接口这种调用方式,纯粹是为了满足面向接口编程的需要。(其实还有一个原因是在于,面向接口的编程,使得用户在接口上可以使用注解来配置 SQL 语句,这样就可以脱离 XML 配置文件,实现“0 配置”)。

数据处理层

数据处理层可以说是 MyBatis 的核心,从大的方面上讲,它要完成两个功能:

  • 通过传入参数构建动态 SQL 语句;
  • SQL 语句的执行以及封装查询结果集成List<E>
通过传入参数构建动态 SQL 语句;

动态语句生成可以说是 MyBatis 框架非常优雅的一个设计,MyBatis 通过传入的参数值,使用 Ognl 来动态地构造 SQL 语句,使得 MyBatis 有很强的灵活性和扩展性。

参数映射指的是对于 java 数据类型和 jdbc 数据类型之间的转换:这里有包括两个过程:查询阶段,我们要将 java 类型的数据,转换成 jdbc 类型的数据,通过 preparedStatement.setXXX() 来设值;另一个就是对 resultset 查询结果集的 jdbcType 数据转换成 java 数据类型。

SQL 语句的执行以及封装查询结果集成List<E>

动态 SQL 语句生成之后,MyBatis 将执行 SQL 语句,并将可能返回的结果集转换成List<E> 列表。MyBatis 在对结果集的处理中,支持结果集关系一对多和多对一的转换,并且有两种支持方式,一种为嵌套查询语句的查询,还有一种是嵌套结果集的查询。

框架支撑层
  • 事务管理机制

事务管理机制对于 ORM 框架而言是不可缺少的一部分,事务管理机制的质量也是考量一个 ORM 框架是否优秀的一个标准。

  • 连接池管理机制

由于创建一个数据库连接所占用的资源比较大, 对于数据吞吐量大和访问量非常大的应用而言,连接池的设计就显得非常重要。

  • 缓存机制

为了提高数据利用率和减小服务器和数据库的压力,MyBatis 会对于一些查询提供会话级别的数据缓存,会将对某一次查询,放置到 SqlSession 中,在允许的时间间隔内,对于完全相同的查询,MyBatis 会直接将缓存结果返回给用户,而不用再到数据库中查找。

  • SQL 语句的配置方式

传统的 MyBatis 配置 SQL 语句方式就是使用 XML 文件进行配置的,但是这种方式不能很好地支持面向接口编程的理念,为了支持面向接口的编程,MyBatis 引入了 Mapper 接口的概念,面向接口的引入,对使用注解来配置 SQL 语句成为可能,用户只需要在接口上添加必要的注解即可,不用再去配置 XML 文件了,但是,目前的 MyBatis 只是对注解配置 SQL 语句提供了有限的支持,某些高级功能还是要依赖 XML 配置文件配置 SQL 语句。

引导层

引导层是配置和启动 MyBatis 配置信息的方式。MyBatis 提供两种方式来引导 MyBatis :基于 XML 配置文件的方式和基于 Java API 的方式。

主要构件及其相互关系

主要的核心部件解释如下:

  • SqlSession 作为 MyBatis 工作的主要顶层 API,表示和数据库交互的会话,完成必要数据库增删改查功能
  • Executor MyBatis 执行器,是 MyBatis 调度的核心,负责 SQL 语句的生成和查询缓存的维护
  • StatementHandler 封装了 JDBC Statement 操作,负责对 JDBC statement 的操作,如设置参数、将 Statement 结果集转换成 List 集合。
  • ParameterHandler 负责对用户传递的参数转换成 JDBC Statement 所需要的参数,
  • ResultSetHandler 负责将 JDBC 返回的 ResultSet 结果集对象转换成 List 类型的集合;
  • TypeHandler 负责 java 数据类型和 jdbc 数据类型之间的映射和转换
  • MappedStatement MappedStatement 维护了一条<select|update|delete|insert>节点的封装,
  • SqlSource 负责根据用户传递的 parameterObject,动态地生成 SQL 语句,将信息封装到 BoundSql 对象中,并返回
  • BoundSql 表示动态生成的 SQL 语句以及相应的参数信息
  • Configuration MyBatis 所有的配置信息都维持在 Configuration 对象之中。

流程简解

准备

  1. /src/main/resources/mybatis-config.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>
        <property name="driver" value="com.mysql.cj.jdbc.Driver"/>
        <property name="url"
                  value="jdbc:mysql://localhost:3306/test?useUnicode=true&amp;characterEncoding=UTF8&amp;useSSL=false&amp;autoReconnect=true"/>
        <property name="username" value="root"/>
        <property name="password" value="123456"/>
    </properties>

    <!-- 环境,可以配置多个,default:指定采用哪个环境 -->
    <environments default="test">
        <environment id="test">
            <!-- 事务管理器,JDBC类型的事务管理器 -->
            <transactionManager type="JDBC"/>
            <!-- 数据源,池类型的数据源 -->
            <dataSource type="POOLED">
                <property name="driver" value="${driver}"/> <!-- 配置了properties,所以可以直接引用 -->
                <property name="url" value="${url}"/>
                <property name="username" value="${username}"/>
                <property name="password" value="${password}"/>
            </dataSource>
        </environment>
    </environments>
    <mappers>
        <mapper resource="TeacherMapper.xml"/>
    </mappers>
</configuration>

  1. /src/main/resources/TeacherMapper.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:命名空间,随便写,一般保证命名空间唯一 -->
    <mapper namespace="TeacherMapper">
        <!-- statement,内容:sql语句。id:唯一标识,随便写,在同一个命名空间下保持唯一
           resultType:sql语句查询结果集的封装类型,tb_user即为数据库中的表
         -->
        <select id="selectTest" resultType="org.apache.ibatis.test.Teacher">
            select *
            from teacher
            where id = #{id}
        </select>
    </mapper>
    
    
  2. /src/main/resources/log4j.properties

    log4j.rootLogger=DEBUG, stdout
    log4j.appender.stdout=org.apache.log4j.ConsoleAppender
    log4j.appender.stdout.layout=org.apache.log4j.PatternLayout
    log4j.appender.stdout.layout.ConversionPattern=%5p [%t] - %m%n
    
  3. /src/main/java/org/apache/ibatis/test/Teacher.java

    package org.apache.ibatis.test;
    
    
    public class Teacher {
        private Long id;
        private String name;
    
        public Long getId() {
            return id;
        }
     
        public void setId(Long id) {
            this.id = id;
        }
     
        public String getName() {
            return name;
        }
     
        public void setName(String name) {
            this.name = name;
        }
     
        @Override
        public String toString() {
            return "Teacher{" +
                    "id=" + id +
                    ", name='" + name + '\'' +
                    '}';
        }
    }
    
    
  4. /src/main/java/org/apache/ibatis/test/Test.java

    package org.apache.ibatis.test;
    
    import org.apache.ibatis.io.Resources;
    import org.apache.ibatis.session.SqlSession;
    import org.apache.ibatis.session.SqlSessionFactory;
    import org.apache.ibatis.session.SqlSessionFactoryBuilder;
    
    import java.io.IOException;
    import java.io.InputStream;
    
    public class Test {
        public static void main(String[] args) throws IOException {
            // 指定全局配置文件
            String resource = "mybatis-config.xml";
            // 读取配置文件
            InputStream inputStream = Resources.getResourceAsStream(resource);
            // 构建sqlSessionFactory
            SqlSessionFactory sqlSessionFactory = new SqlSessionFactoryBuilder().build(inputStream);
            // 获取sqlSession
            SqlSession sqlSession = sqlSessionFactory.openSession();
            // 操作CRUD,第一个参数:指定statement,规则:命名空间+“.”+statementId
            // 第二个参数:指定传入sql的参数:这里是用户id
            Teacher test = sqlSession.selectOne("TeacherMapper.selectTest", 1);
            System.out.println(test.getName());
        }
    }
    

整体流程

  1. 通过 mybatis-config.xml 进行初始化创建出 SqlSessionFactory。其内部是通过创建XMLConfigBuilder对象,然后自己进行解析 XML文件,把文件内容解析封装为Configuration对象,最后由SqlSessionFactory进行封装为SqlSessionFactory对象来完成SqlSessionFactory的创建。
  2. 通过SqlSessionFactory对象进行开启一个SqlSession。其内部是通过获取ConfigurationEnvironment数据进行构建TransactionFactory–>Executor,最后封装为SqlSession返回进行使用
  3. 通过SqlSession执行 XML 中对应的方法。其中是先通过statementXML 指定的类#方法名称获取MappedStatement对象,然后提交给Executor进行执行。

目录详解

exception

下图是Mybatis中异常的关系图:

背景知识

  • 工厂模式
  • 异常的封装

讲解

工厂模式

public class ExceptionFactory {

    private ExceptionFactory() {
        // Prevent Instantiation
    }

    public static RuntimeException wrapException(String message, Exception e) {
        return new PersistenceException(ErrorContext.instance().message(message).cause(e).toString(), e);
    }

}
  • 私有构造函数:导致该工厂无法创建出对应的对象
  • 静态wrapException方法,用于通过异常信息和异常类型进行封装异常为Mybatis中的异常类型。全局通过ExceptionFactory.wrapException()进行生产出对应的异常对象

异常类型

  • IbatisException:Mybatis中最高的异常,但是直接继承该类的子类只有PersistenceException,而且该类也添加了@Deprecated说明以后可能去除。

  • PersistenceException: 译为持久化异常。Mybatis对应是持久化框架,后期可能该异常类型为Mybatis所有异常的父类。

  • TooManyResultsException:译为多条返回结果异常。用处为selectOne却返回多条记录时所抛出的异常。

  • TypeException: 译为类型异常。当 Mybatis 中需要类型转化时,若转换失败则会抛出该异常。

  • CacheException: 译为缓存异常。当Mybatis读取缓存中数据出现问题时则会抛出该异常。

  • ParsingException: 译为解析异常。当前代码未看到使用。

  • ScriptingException: 译为脚本异常。

  • ResultMapException: 译为结果映射异常。在结果转换为对应类型的对象时,若转换失败则会抛出异常。

  • DataSourceException: 译为数据源异常。在初始化数据源时若出现错误则会抛出该异常。

  • TransactionException: 译为事务异常。在给connection开启事务时若失败则会抛出该异常。

  • BuilderException: 译为建造异常。在建造对象失败时会抛出该异常。

  • SqlSessionException: 译为SqlSession的异常。基本只会在SqlSessionManager中使用,主要是SqlSession使用过程中的异常。

  • ReflectionException: 译为反射异常。基本只会在反射使用时会抛出该异常。

  • ExecutorException: 译为执行器异常。会在线程操作数据库的时候抛出该异常。

  • BatchExecutorException:译为批量执行器异常。会在线程批量操作数据库的时候抛出该异常。

  • BindingException: 译为绑定异常。主要是 mapper映射的时候会抛出该异常。

  • LogException: 译为日志异常。目前只在LogFactory构建日志相关的时候才会抛出该异常。

  • PluginException: 译为插件异常。目前只在Plugin中使用,在获取插件信息时候会抛出该异常。

Mybatis类型主要是根据业务相关包放在一起,所以命名绝大多数都能够直观的看到原因所在。

jdbc

背景知识

  • 模版模式
  • 易用性

讲解

模版模式

某些类通用的一些处理方法一致,但是处理对象可能存在不同,此时可以使用模版方法,抽取父类编写通用处理方法,子类只需实现获取对象的方法即可。

public class SQL extends AbstractSQL<SQL> {

    @Override
    public SQL getSelf() {
        return this;
    }

}
public abstract class AbstractSQL<T> {

    private static final String AND = ") \nAND (";
    private static final String OR = ") \nOR (";

    private final SQLStatement sql = new SQLStatement();

    public abstract T getSelf();

    public T UPDATE(String table) {
        sql().statementType = SQLStatement.StatementType.UPDATE;
        sql().tables.add(table);
        return getSelf();
    }

    public T SET(String sets) {
        sql().sets.add(sets);
        return getSelf();
    }
		......
}

以上代码可知:

  1. 若用户需要自定SQLExplainSQL,从而进行性能调优,此时只需要继承 AbstractSQL即可,而无需编写原方法。
易用性

为了用户使用方便和构建 SQL的直观性,AbstractSQL命名采用了全大写的模式,以此让用户更加易用。

SqlRunner
    public int insert(String sql, Object... args) throws SQLException {
        PreparedStatement ps;
        if (useGeneratedKeySupport) {
            ps = connection.prepareStatement(sql, Statement.RETURN_GENERATED_KEYS);
        } else {
            ps = connection.prepareStatement(sql);
        }

        try {
            setParameters(ps, args);
            ps.executeUpdate();
            if (useGeneratedKeySupport) {
                List<Map<String, Object>> keys = getResults(ps.getGeneratedKeys());
                if (keys.size() == 1) {
                    Map<String, Object> key = keys.get(0);
                    Iterator<Object> i = key.values().iterator();
                    if (i.hasNext()) {
                        Object genkey = i.next();
                        if (genkey != null) {
                            try {
                                return Integer.parseInt(genkey.toString());
                            } catch (NumberFormatException e) {
                                //ignore, no numeric key support
                            }
                        }
                    }
                }
            }
            return NO_GENERATED_KEY;
        } finally {
            try {
                ps.close();
            } catch (SQLException e) {
                //ignore
            }
        }
    }

    public int update(String sql, Object... args) throws SQLException {
        PreparedStatement ps = connection.prepareStatement(sql);
        try {
            setParameters(ps, args);
            return ps.executeUpdate();
        } finally {
            try {
                ps.close();
            } catch (SQLException e) {
                //ignore
            }
        }
    }

此类在Mybatis中没有任何的使用,此类应该只是为了提供给用户,让用户可以自定义执行相关 SQL,分析其方法本质为原始JDBC相关操作流程。

ScriptRunner
   private void executeFullScript(Reader reader) {
        StringBuilder script = new StringBuilder();
        try {
            BufferedReader lineReader = new BufferedReader(reader);
            String line;
            while ((line = lineReader.readLine()) != null) {
                script.append(line);
                script.append(LINE_SEPARATOR);
            }
            String command = script.toString();
            println(command);
            executeStatement(command);
            commitConnection();
        } catch (Exception e) {
            String message = "Error executing: " + script + ".  Cause: " + e;
            printlnError(message);
            throw new RuntimeSqlException(message, e);
        }
    }

    private void executeLineByLine(Reader reader) {
        StringBuilder command = new StringBuilder();
        try {
            BufferedReader lineReader = new BufferedReader(reader);
            String line;
            while ((line = lineReader.readLine()) != null) {
                handleLine(command, line);
            }
            commitConnection();
            checkForMissingLineTerminator(command);
        } catch (Exception e) {
            String message = "Error executing: " + command + ".  Cause: " + e;
            printlnError(message);
            throw new RuntimeSqlException(message, e);
        }
    }
    private void handleLine(StringBuilder command, String line) throws SQLException {
        String trimmedLine = line.trim();
        if (lineIsComment(trimmedLine)) {
            Matcher matcher = DELIMITER_PATTERN.matcher(trimmedLine);
            if (matcher.find()) {
                delimiter = matcher.group(5);
            }
            println(trimmedLine);
        } else if (commandReadyToExecute(trimmedLine)) {
            command.append(line.substring(0, line.lastIndexOf(delimiter)));
            command.append(LINE_SEPARATOR);
            println(command);
            executeStatement(command.toString());
            command.setLength(0);
        } else if (trimmedLine.length() > 0) {
            command.append(line);
            command.append(LINE_SEPARATOR);
        }
    }

此类的核心方法如上,可看出其本质和SqlRunner类一致。

datasource

背景知识

讲解

transaction

背景知识

讲解

cursor

背景知识

讲解

io

背景知识

讲解

reflection

背景知识

讲解

logging

背景知识

讲解

scripting

背景知识

讲解

type

背景知识

讲解

mapping

背景知识

讲解

builder

背景知识

讲解

parsing

背景知识

讲解

binding

背景知识

讲解

annotationslang

背景知识

讲解

cache

背景知识

讲解

plugin

背景知识

讲解

session

背景知识

讲解

流程详解

总结

热门相关:超武穿梭   修仙界最后的单纯   横行霸道   梦回大明春   无限杀路