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

一.什么是 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>        <!-- https://mvnrepository.com/artifact/mysql/mysql-connector-java -->        <dependency>            <groupId>mysql</groupId>            <artifactId>mysql-connector-java</artifactId>            <version>6.0.6</version>        </dependency>        <!-- https://mvnrepository.com/artifact/junit/junit -->        <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中运行

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

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"><!-- 在这个文件放置一些全局性的配置 如handler、objectFactory、plugin、以及mappers的映射路径 --><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）新建对应的实体类

代码如下

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文件

<?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，namespace的值习惯上设置成包名+sql映射文件名，这样就能够保证namespace的值是唯一的 例如namespace="com.vichoufa.mybatis.mapper.deptMapper"就是com.vichoufa.mybatis.mapper(包名)+deptMapper(deptMapper.xml 文件去除后缀) --><mapper namespace="com.vichoufa.mybatis.mapper.deptMapper">    <!--更具ID检索部门-->    <select id="selectDeptById" parameterType="int"             resultType="com.vichoufa.mybatis.pojo.DeptPojo">        select id, name        from dept        where id = #{id}    </select></mapper>

（4）将映射文件添加到mybatis.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"><!-- 在这个文件放置一些全局性的配置 如handler、objectFactory、plugin、以及mappers的映射路径 --><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>        <mappers>            <mapper resource="com/vichoufa/mybatis/mapper/deptMapper.xml"></mapper>        </mappers></configuration>

（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)运行测试用例：

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