建立mybatis工程

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

前期准备

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



    
        org.mybatis
        mybatis
        3.5.1
    

    
        mysql
        mysql-connector-java
        8.0.16
    

    
        junit
        junit
        LATEST
    

    
        org.projectlombok
        lombok
        1.18.8

最重要的就是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文件，写入：

建立表与实体的关系

建实体类

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

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

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

构建查询

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

告诉mybatis我们写的配置
使用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标签之后（顺序很重要）添加：

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

字段映射

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

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

备注

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

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

源码

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

初识MyBatis