MyBatis源码学习环境准备

以下内容的公开课视频已经录制，需要的同学可留言

MyBatis作为一个应用广泛的优秀的持久层ORM框架，已经成了JavaWeb世界近乎标配的部分，它支持定制化 SQL、存储过程以及高级映射。MyBatis避免了几乎所有的 JDBC 代码和手动设置参数以及获取结果集。MyBatis 可以使用简单的 XML 或注解来配置和映射原生类型、接口和 Java 的 POJO（Plain Old Java Objects，普通老式 Java 对象）为数据库中的记录。

1. 下载源码

下载最新的稳定版或者目前项目中使用的MyBatis源代码，本课以MyBatis 3.5.1为例进行讲解，（目前最新版本为3.5.2-SNAPSHOT）。
下载地址： https://github.com/mybatis/mybatis-3

注意按照读tag进行版本选择。

源码下载.png

2. 创建源码项目工程

下载源码后，在idea中导入pom工程，需要按照以下步骤进行修改调整，项目才能编译成功。

• pom文件中 ognl、javassist修改为false

    
      ognl
      ognl
      3.2.10
      compile
      false
    
    
      org.javassist
      javassist
      3.24.1-GA
      compile
      false
    

• 删除项目目录下的license.txt
  如果不删除的话，在执行maven install时会出错。

• 手动下载jar包到本地

这个视情况而定，如果本地执行maven install时出现如下错误

[INFO] --- maven-surefire-plugin:2.7.1:test (default-test) @ wms ---
[WARNING] Error injecting: org.apache.maven.plugin.surefire.SurefirePlugin
java.lang.NoClassDefFoundError: org/apache/maven/surefire/util/NestedCheckedException
    at java.lang.ClassLoader.defineClass1(Native Method)

则可以考虑手动下载对应jar包到本地maven仓库中。

下载地址：http://repo1.maven.org/maven2/org/apache/maven/surefire/maven-surefire-common/3.0.0-M3/maven-surefire-common-3.0.0-M3.jar

• 关闭maven-pdf-plugin

• 关闭test

  执行maven install 时忽略test。

忽略test.png

• 执行maven install

  将MyBatis编译安装到本地maven仓库。

3. 搭建简单demo

从最简单的demo入手，前期先不要集成Spring，只看最简单的最原始的MyBatis，熟悉了MyBatis源码后再看如何与Spring集成；

结合官方文档搭建demo：http://www.mybatis.org/mybatis-3/zh/getting-started.html

基本使用流程

• 引入依赖

          
              org.mybatis
              mybatis
              3.5.1
          
          
              mysql
              mysql-connector-java
              5.1.46
          
          
              log4j
              log4j
              1.2.17
          
  

• 创建xml配置文件

  mybatis-config.xml

  EmployeeMapper.xml

  
  
  
  
      
          select id,last_name lastname,gender, email from bxg_employee where id=#{id}
      
  
  

• 创建dto对象

  Employee.java

  package com.boxuegu.javaee.mybatissourcelearn.dto;
  
  /**
   * @author Jam Fang  https://www.jianshu.com/u/0977ede560d4
   * @version 创建时间：05.24 15:27
   */
  public class Employee {
      private Integer id;
      private String lastName;
      private String email;
      private String gender;
  
      @Override
      public String toString() {
          return "Employee{" +
                  "id=" + id +
                  ", lastName='" + lastName + '\'' +
                  ", email='" + email + '\'' +
                  ", gender='" + gender + '\'' +
                  '}';
      }
  
      public Integer getId() {
          return id;
      }
  
      public void setId(Integer id) {
          this.id = id;
      }
  
      public String getLastName() {
          return lastName;
      }
  
      public void setLastName(String lastName) {
          this.lastName = lastName;
      }
  
      public String getEmail() {
          return email;
      }
  
      public void setEmail(String email) {
          this.email = email;
      }
  
      public String getGender() {
          return gender;
      }
  
      public void setGender(String gender) {
          this.gender = gender;
      }
  }
  
  

• 创建dao

  EmployeeMapper.java

  package com.boxuegu.javaee.mybatissourcelearn.dao;
  
  import com.boxuegu.javaee.mybatissourcelearn.dto.Employee;
  
  /**
   * @author Jam Fang  https://www.jianshu.com/u/0977ede560d4
   * @version 创建时间：05.24 17:32
   */
  public interface EmployeeMapper {
      public Employee getEmployeeById(Integer id);
  }
  
  

• 创建数据库测试表

  -- ----------------------------
  -- Table structure for bxg_employee
  -- ----------------------------
  DROP TABLE IF EXISTS `bxg_employee`;
  CREATE TABLE `bxg_employee` (
    `id` int(11) NOT NULL AUTO_INCREMENT,
    `last_name` varchar(255) DEFAULT NULL,
    `gender` char(1) DEFAULT NULL,
    `email` varchar(255) DEFAULT NULL,
    PRIMARY KEY (`id`)
  ) ENGINE=InnoDB AUTO_INCREMENT=2 DEFAULT CHARSET=utf8;
  
  -- ----------------------------
  -- Records of bxg_employee
  -- ----------------------------
  INSERT INTO `bxg_employee` VALUES ('1', 'zhangsan', '1', '[email protected]');
  

• 创建测试代码

  package com.boxuegu.javaee.mybatissourcelearn;
  
  import com.boxuegu.javaee.mybatissourcelearn.dao.EmployeeMapper;
  import com.boxuegu.javaee.mybatissourcelearn.dto.Employee;
  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;
  
  /**
   * @author Jam Fang  https://www.jianshu.com/u/0977ede560d4
   * @version 创建时间：2019/6/17 13:16
   */
  public class Test {
      public static void main(String[] args) {
          //1.加载配置文件
          String resource = "mybatis-config.xml";
          InputStream inputStream = null;
          try {
              inputStream = Resources.getResourceAsStream(resource);
          } catch (IOException e) {
              e.printStackTrace();
          }
          
          //2. 获取sqlSessionFactory
          SqlSessionFactory sqlSessionFactory = new SqlSessionFactoryBuilder().build(inputStream);
  
          //3. 获取sqlSession
          SqlSession sqlSession = sqlSessionFactory.openSession();
          try {
              //4. 获取mapper接口实现
              EmployeeMapper mapper = sqlSession.getMapper(EmployeeMapper.class);
              System.out.println("mapper::::" + mapper.getClass());
  
              //5. 执行sql语句
              Employee employee = mapper.getEmployeeById(1);
              System.out.println(employee);
  
          } finally {
              sqlSession.close();
          }
      }
  }