Mybatis源码学习（一）：初探Myabtis

一、Mybatis简介

MyBatis 是一款优秀的持久层框架，它支持定制化 SQL、存储过程以及高级映射。MyBatis 避免了几乎所有的 JDBC 代码和手动设置参数以及获取结果集。MyBatis 可以使用简单的 XML 或注解来配置和映射原生信息，将接口和 Java 的 POJOs(Plain Ordinary Java Object,普通的 Java对象)映射成数据库中的记录。

二、如何使用Mybatis

目前的开发基本都是基于Maven或者gradle，本文中以Maven为例。
第一步：

    <dependencies>
        <!--Mybatis核心-->
        <dependency>
            <groupId>org.mybatis</groupId>
            <artifactId>mybatis</artifactId>
            <version>3.4.6</version>
        </dependency>

        <!--Mysql依赖-->
        <dependency>
            <groupId>mysql</groupId>
            <artifactId>mysql-connector-java</artifactId>
            <version>8.0.27</version>
        </dependency>

        <!--测试依赖-->
        <dependency>
            <groupId>junit</groupId>
            <artifactId>junit</artifactId>
            <version>4.13</version>
            <scope>test</scope>
        </dependency>
    </dependencies>

第二步：准备配置文件（从官网上拷贝）
官网地址：

<?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 resource="db.properties"/>
    <settings>
        <setting name="cacheEnabled" value="false"/>
    </settings>

    <typeAliases>
        <typeAlias type="com.cmxy.entity.Person"/>
    </typeAliases>

    <environments default="development">
        <environment id="development">
            <transactionManager type="JDBC"/>

            <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="mapper/personMapper.xml"/>
    </mappers>
</configuration>

配置文件分析：

第三步：编码
1、创建数据表（Person）

CREATE TABLE `t_person` (
  `id` bigint NOT NULL AUTO_INCREMENT,
  `username` varchar(255) NOT NULL,
  `password` varchar(255) NOT NULL,
  PRIMARY KEY (`id`)
) ENGINE=InnoDB AUTO_INCREMENT=2 DEFAULT CHARSET=utf8mb3;

2、创建对应实体类

package com.cmxy.entity;

import org.apache.ibatis.type.Alias;

public class Person {
    
    private Long id;
    
    private String username;
    
    private String password;
    
    //省略get/set 
}

3、编写Mapper以及对应Mapper.xml

public interface PersonMapper {
    List<Person> selectAll();
}

<?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.cmxy.mapper.PersonMapper">
  
  <resultMap id="BaseResultMap" type="com.cmxy.entity.Person">
    <id property="id" column="id"/>
    <result property="username" column="username"/>
    <result property="password" column="password"/>
  </resultMap>
  
  <select id="selectAll" resultMap="BaseResultMap" >
    select *  from t_person
  </select>
</mapper>

4、调用对应Java Api

public class Application {
    
    public static void main(String[] args) throws Exception {
        String resource = "mybatis-config.xml";
        InputStream inputStream = Resources.getResourceAsStream(resource);
        SqlSessionFactory sqlSessionFactory = new SqlSessionFactoryBuilder().build(inputStream);
        //方式一：
        try (SqlSession session = sqlSessionFactory.openSession()) {
            PersonMapper mapper = session.getMapper(PersonMapper.class);
            List<Person> personList = mapper.selectAll();
            System.out.println(personList);
        }
        //方式二：
        try (SqlSession session = sqlSessionFactory.openSession()) {
            List<Person> personList = session.selectList("com.cmxy.mapper.PersonMapper.selectAll", Person.class);
            System.out.println(personList);
        }
    }
}

（tips：这两种方法更推荐使用第一种，第一种语义更加明确，毕竟编写代码有一个很重要的指标就是易读。）

三、Mybatis中的几个核心对象

图片摘自：

1、Configuration：
完整路径：org.apache.ibatis.session.Configuration
作用**：Mybatis通过IO操作将我们的配置文件封装成为Configuration**这个类

2、SqlSessionFactory：SQL 会话工厂
完整路径：org.apache.ibatis.session.SqlSessionFactory
作用：该类是一个接口，定义了用于管理数据库连接（会话，Session）

/**
 * Creates an {@link SqlSession} out of a connection or a DataSource
 *
 * @author Clinton Begin
 */
public interface SqlSessionFactory {

  /**
   * 开启一个会话
   * @return
   */
  SqlSession openSession();

  SqlSession openSession(boolean autoCommit);

  SqlSession openSession(Connection connection);

  SqlSession openSession(TransactionIsolationLevel level);

  SqlSession openSession(ExecutorType execType);

  SqlSession openSession(ExecutorType execType, boolean autoCommit);

  SqlSession openSession(ExecutorType execType, TransactionIsolationLevel level);

  SqlSession openSession(ExecutorType execType, Connection connection);

  Configuration getConfiguration();

}

3、SqlSession：SQL 会话
完整路径：org.apache.ibatis.session.SqlSession
作用：SqlSession也是一个接口，该接口中定义了一些列有关于数据的操作，例如查询列表、查询单个、插入、删除等等。

4、MappedStatement：映射语句
完整路径：org.apache.ibatis.mapping.MappedStatement
作用：用于封装我们所写的Mapper文件

5、Executor：执行器
完整路径：org.apache.ibatis.executor.Executor
作用：Executor是一个接口，定义了数据库操作用于封装原始JDBC代码，例如查询、插入

6、StatmentHandler：Statement处理器
完整路径：org.apache.ibatis.executor.statement.StatementHandler
作用： StatementHandler是Mybatis封装了JDBC Statement，真正Mybatis进行数据库访问操作的核心。

7、ParameterHandler、ResultSetHandler、TypeHandler
这里几个类比较好理解，分别用于处理参数、处理ResultSet（JDBC的ResultSet）、处理类型（数据库类型和Java类型的映射）

四、小结

至此我们已经初步知道了Mybatis如何使用以及Mybatis中的一些核心对象，下一篇文章会针对这些核心对象做源码级别的分析。希望对你有所帮助