建立mybatis工程

先不管什么原理不原理，上来就是干呀。

前期准备

建立一个空白的maven工程，添加依赖：

<dependencies>

    <dependency>
        <groupId>org.mybatis</groupId>
        <artifactId>mybatis</artifactId>
        <version>3.5.1</version>
    </dependency>

    <dependency>
        <groupId>mysql</groupId>
        <artifactId>mysql-connector-java</artifactId>
        <version>8.0.16</version>
    </dependency>

    <dependency>
        <groupId>junit</groupId>
        <artifactId>junit</artifactId>
        <version>LATEST</version>
    </dependency>

    <dependency>
        <groupId>org.projectlombok</groupId>
        <artifactId>lombok</artifactId>
        <version>1.18.8</version>
    </dependency>


</dependencies>

最重要的就是mybatis与mysql依赖，其他的都可以不加入，但具体代码需你自己调整。

再建一张表，简单点就好

CREATE TABLE `fruits` (
`id` INT ( 11 ) NOT NULL AUTO_INCREMENT,
`fruits_name` VARCHAR ( 40 ) DEFAULT NULL,
`color` VARCHAR ( 20 ) DEFAULT NULL,
`weight` DOUBLE DEFAULT NULL,
`created_at` datetime DEFAULT NULL,
`updated_at` datetime DEFAULT NULL,
PRIMARY KEY ( `id` ) 
) ENGINE = INNODB AUTO_INCREMENT = 2 DEFAULT CHARSET = utf8mb4;

建表的时候想吃水果了，所以就建了这么个东西。再随便插入条数据：如

INSERT INTO `test`.`fruits`(`fruits_name`, `color`, `weight`, `created_at`) VALUES ('banana', 'green', 1234.2, '2019-06-18 16:16:35')

前期准备就算完成了。

写配置

本例中只关注mybatis，所以不会有与其他框架整合的配置。

配置与mysql的连接

先建个mysql.properties文件（这不是必须的，你可以直接写到mybatis的配置里去）
写(根据自己的情况修改)：

driver=com.mysql.cj.jdbc.Driver
url=jdbc:mysql://localhost:3306/test?characterEncoding=utf-8&serverTimezone=UTC
username=root
password=root

下面就是真正的配置，建个mybatis-config.xml文件，写入：

<configuration>
    <!-- 引入外部配置文件 -->
    <properties resource="mysql.properties"></properties>
    <environments default="development">
        <environment id="development">
            <!-- type="JDBC" 代表使用JDBC的提交和回滚来管理事务 -->
            <transactionManager type="JDBC"/>
            <!-- mybatis提供了3种数据源类型，分别是：POOLED,UNPOOLED,JNDI -->
            <!-- POOLED 表示支持JDBC数据源连接池 -->
            <!-- UNPOOLED 表示不支持数据源连接池 -->
            <!-- JNDI 表示支持外部数据源连接池 -->
            <dataSource type="POOLED">
                <property name="driver" value="${driver}"/>
                <property name="url" value="${url}"/>
                <property name="username" value="${username}"/>
                <property name="password" value="${password}"/>
            </dataSource>
        </environment>
    </environments>
</configuration>

建立表与实体的关系

建实体类

@Data
public class Fruits implements Serializable {
    private static final long serialVersionUID = 1L;
    private Integer id;

    private String fruitsName;

    private String color;

    private Double weight;

    private Date createdAt;

    private Date updatedAt;
}

lombok大法好呀~

建mapper接口

public interface FruitsMapper {
    
    Fruits selectById(Integer id);
}

建实体类的xml文件

在resource文件夹下建mapperxml/FruitsMapper.xml文件：

<mapper namespace="com.llh.mybatis.mapper.FruitsMapper">
    <select id="selectById" resultType="com.llh.mybatis.pojo.Fruits">
        select * from fruits where id=#{id} ;
    </select>
</mapper>

至此所有的配置文件已经写完了。但是，因为这里只是用了mybatis单一框架，又把映射文件（FruitsMapper.xml）放在了自定义文件夹里，所以我们需要给mybatis指定这个文件位置。
打开mybatis-config.xml文件，在configuration标签内添加：

    <mappers>
         <mapper resource="mapperxml/FruitsMapper.xml"/>
    </mappers>

那么，无聊的配置工作就可以告一段落了。

构建查询

使用mybatis查询总的来说，就两步：

1. 告诉mybatis我们写的配置
2. 使用SqlSession对象进行查询
   如下代码：

 private SqlSessionFactory sqlSessionFactory;

    @Before
    public void config() throws IOException {
        String resource = "mybatis-config.xml";
        InputStream inputStream = Resources.getResourceAsStream(resource);
        sqlSessionFactory = new SqlSessionFactoryBuilder().build(inputStream);
    }
    @Test
    public void selectOne() {
        try (SqlSession sqlSession = sqlSessionFactory.openSession()) {
            FruitsMapper mapper = sqlSession.getMapper(FruitsMapper.class);
            Fruits fruits = mapper.selectById(1);
            System.out.println(fruits);
        }
    }

如果一切顺利的话，你就可以看到打印出查询的结果了。
那么，我们费了这么大劲写的这个特简单东西到底有什么意思呢？
这个例子虽然简单，但它把mybatis核心组件都用上了。

MyBatis核心组件

从我们的代码来看：
首先是SqlSessionFactoryBuilder读取了配置文件，给我们返回了SqlSessionFactory对象，我们用SqlSessionFactory对象获取SqlSession对象，再由SqlSession对象去获取我们写的mapper接口，此时就可以使用mapper接口查询方法了。
所以整理出MyBatis核心组件：

• SqlSessionFactoryBuilder：读配置文件生成SqlSessionFactory对象
• SqlSessionFactory： 生成SqlSession对象
• SqlSession：执行所写的mapper接口查询方法
  不少书认为sqlSession.getMapper这样的方法是使用了SQL Mapper组件，目前尚未看出这个组件在源码里有体现，暂议。不过这个方法确实是以前方法的改进。更老一点的查询方法：

 @Test
    public void selectOneOld() {
        try (SqlSession sqlSession = sqlSessionFactory.openSession()) {
            Fruits fruits = sqlSession.selectOne("com.llh.mybatis.mapper.FruitsMapper.selectById", 1);
            System.out.println(fruits);
        }
    }

流程解读

流程.png
简书不支持时序图语法。
基本上一个查询的完整流程就是这样子。

后记

看到打印的结果你可能会奇怪为啥有些字段没值呢（如果你的代码与我保持一致的话）？
首先确认数据库里的值是否存在，如果存在，还是打印不出来的话，那就要来看看这个了。

自动映射

在mybatis-config.xml文件里，properties标签之后（顺序很重要）添加：

    <settings>
        <setting name="autoMappingBehavior" value="NONE"/>
    </settings>

然后再次执行查询，你就会惊喜地发现嘛都查不出来了。
这就是mybatis自动映射的功能（关闭方法）。
之前的配置中并没有配置结果字段与Java字段的映射，mybatis会自动把查询结果映射到指定Java类中具有相同名称和setter方法字段上。

字段映射

关闭了自动映射功能，自然就想到使用手动映射。
在FruitsMapper.xml文件内mapper标签内添加：

   <resultMap id="BaseMapper" type="com.llh.mybatis.pojo.Fruits">
        <id column="id" jdbcType="INTEGER" property="id"/>
        <result column="color" jdbcType="VARCHAR" property="color" />
        <result column="fruits_name" jdbcType="VARCHAR" property="fruitsName" />
        <result column="weight" jdbcType="VARCHAR" property="weight" />
        <result column="created_at" jdbcType="TIMESTAMP" property="createdAt" />
        <result column="updated_at" jdbcType="TIMESTAMP" property="updatedAt" />
    </resultMap>

再给select标签添加属性resultMap="BaseMapper"就可以引用这套映射配置（也就是说你可以整多套配置来满足需要）。
如此，之前没有值的字段也就有了值。

备注

MyBatis 自动映射有三种模式：NONE、PARTIAL、FULL。

第一个已经知道了。
第二个是默认项。
第三个会对嵌套对象进行映射。
总结下：第三个基本不会用，如无特殊需求就用默认。事实上配合代码生成工具，用第一个还是第二个配置并没有什么区别。

源码

此文使用项目源码在这里，查看标签v0.1里的代码即可。