MyBatis全版教程+源码分析（一）

朱雀 2022-06-05 05:51 51阅读 0赞

#### 一.什么是 MyBatis ####

MyBatis 是一款优秀的持久层框架，它支持定制化 SQL、存储过程以及高级映射。MyBatis 避免了几乎所有的 JDBC 代码和手动设置参数以及获取结果集。MyBatis 可以使用简单的 XML 或注解来配置和映射原生信息，将接口和 Java 的 POJOs(Plain Old Java Objects,普通的 Java对象)映射成数据库中的记录。（摘自MyBatis官网：http://www.mybatis.org/mybatis-3/zh/index.html）

我们来将他的介绍仔细分析一下

（1）首先它是一款持久层框架（persistence framework），什么是持久化，顾名思义就是将瞬时数据(比如内存中的数据，是不能永久保存的）持久化为持久数据（比如持久化至数据库中，能够长久保存）。规范的定义是将程序数据在持久状态和瞬时状态间转换的机制。目前比较流行的持久化框架就是Hibernate与MyBatis。

（2）它的优点是<避免了几乎所有的 JDBC 代码和手动设置参数以及获取结果集，我们在使用原生JDBC代码实现数据库的增删改查时，肯定会写大量冗余的代码比如数据库连接，将检索出来的数据原型映射成对象，当然我们可以在自己的项目手动将该类方法抽象成工具类。但是每个项目都需要这种工具类时，我们可以将其整理起来封装为jar包，随处使用，mybatis底层就实现了这种工具类

（3）方式：通过XML或注解来配置和映射原生信息，通过XML来获取配置，通过注解来入侵类，这是大量开源框架的惯用方式。

更多信息可以参见MyBatis官网

#### 二.MyBatis项目构建 ####

##### 2.1.准备开发环境 #####

（1）新建一个maven项目，

（2）目前mybatis最新版本是mybatis-3.4.5，pom文件如下：

<?xml version="1.0" encoding="UTF-8"?>
    <project xmlns="http://maven.apache.org/POM/4.0.0"
             xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
             xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
        <modelVersion>4.0.0</modelVersion>
    
        <groupId>com.vichoufa</groupId>
        <artifactId>mybatis</artifactId>
        <version>1.0-SNAPSHOT</version>
    
        <dependencies>
            <dependency>
                <groupId>org.mybatis</groupId>
                <artifactId>mybatis</artifactId>
                <version>3.4.5</version>
            </dependency>
    
            
            <dependency>
                <groupId>mysql</groupId>
                <artifactId>mysql-connector-java</artifactId>
                <version>6.0.6</version>
            </dependency>
    
            
            <dependency>
                <groupId>junit</groupId>
                <artifactId>junit</artifactId>
                <version>4.10</version>
                <scope>test</scope>
            </dependency>
        </dependencies>
    
        <build>
            <plugins>
                <plugin>
                    <groupId>org.apache.maven.plugins</groupId>
                    <artifactId>maven-compiler-plugin</artifactId>
                    <version>3.1</version>
                    <configuration>
                        <source>1.7</source>
                        <target>1.7</target>
                        <encoding>UTF-8</encoding>
                    </configuration>
                </plugin>
                <plugin>
                    <groupId>org.apache.maven.plugins</groupId>
                    <artifactId>maven-surefire-plugin</artifactId>
                    <configuration>
                        <skip>true</skip>
                    </configuration>
                </plugin>
    
            </plugins>
        </build>
    
    </project>

（3）建立测试数据库

create database test default character utf8 COLLATE utf8_general_ci；  
    CREATE TABLE `dept` (  
      `id` int(11) NOT NULL AUTO_INCREMENT,  
      `dept_name` varchar(50) DEFAULT NULL,  
      PRIMARY KEY (`id`)  
    ) ENGINE=InnoDB AUTO_INCREMENT=9 DEFAULT CHARSET=utf8;  
    insert into dept (dept_name) values ('开发部'),('运营部'),('销售部'),('人事部'),('财务部'),('总经理办公室'),('后勤部'),('市场部');

在mysql中运行

![Image 1][]

到此，前期的开发环境准备工作全部完成。

##### 2.2.使用MyBatis查询表中的数据 #####

(1)添加配置文件

<?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>
            <environments default="development">
                <environment id="development">
                    <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" />
                        <property name="password" value="root" />
                    </dataSource>
                </environment>
            </environments>
    </configuration>

（2）新建对应的实体类

![Image 1][]

代码如下

package com.vichoufa.mybatis.pojo;
    
    /**
     * Created by vichoufa on 2017/11/19 0019.
     */
    public class DeptPojo {
        private int id;
    
        private String name;
    
        public int getId() {
            return id;
        }
    
        public void setId(int id) {
            this.id = id;
        }
    
        public String getName() {
            return name;
        }
    
        public void setName(String name) {
            this.name = name;
        }
    
        @Override
        public String toString() {
            return "DeptPojo{" +
                    "id=" + id +
                    ", name='" + name + '\'' +
                    '}';
        }
    }

（3）定义操作dept表的sql文件

![Image 1][]

<?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.vichoufa.mybatis.mapper.deptMapper">
        
        <select id="selectDeptById" parameterType="int" 
                resultType="com.vichoufa.mybatis.pojo.DeptPojo">
            select id, name
            from dept
            where id = #{id}
        </select>
    </mapper>

（4）将映射文件添加到mybatis.xml映射中去

（5）编写测试代码

package com.vichoufa.mybatis.test;
    
    import com.vichoufa.mybatis.pojo.DeptPojo;
    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 org.junit.Test;
    
    import java.io.IOException;
    import java.io.Reader;
    
    /**
     * Created by vizhoufa on 2017/11/19 0019.
     */
    public class TestDeptMapper {
        @Test
        public void testSelectDeptById() throws IOException {
            //mybatis的配置文件
            String resource = "MyBatis.xml";
            //使用类加载器加载mybatis的配置文件（它也加载关联的映射文件）
    //        InputStream is = TestDeptMapper.class.getClassLoader().getResourceAsStream(resource);
    //        //构建sqlSession的工厂
    //        SqlSessionFactory sessionFactory = new SqlSessionFactoryBuilder().build(is);
            //使用MyBatis提供的Resources类加载mybatis的配置文件（它也加载关联的映射文件）
            Reader reader = Resources.getResourceAsReader(resource);
            //构建sqlSession的工厂
            SqlSessionFactory sessionFactory = new SqlSessionFactoryBuilder().build(reader);
            //创建能执行映射文件中sql的sqlSession
            SqlSession session = sessionFactory.openSession();
    
            String statement = "com.vichoufa.mybatis.mapper.deptMapper.selectDeptById";//映射sql的标识字符串
            //执行查询返回一个唯一user对象的sql
            DeptPojo dept = session.selectOne(statement, 1);
            System.out.println(dept);
        }
    }

(6)运行测试用例：

![Image 1][]![Image 1][]![SouthEast][]

有什么问题的话，请留言，我会及时回复

[Image 1]: 
[SouthEast]: /images/20220605/043ebf29cda2433b82f971c62b981d95.png