MyBatis一款后起之秀的持久层框架ORM，支持自定义SQL、存储过程和高级映射，相对于Hibernate算是半自动化的框架，在国内行业内非常流行。

常规的JDBC操作，配置相应的数据库连接的信息，比如账户密码等，应用加载数据库驱动并手动创建数据库连接，编写业务sql并设置其入参生成Statement对象用于执行，获取结果数据集，及时释放持有资源，再对结果集进行数据处理。

加载驱动、创建连接、返回结果、释放资源等等都是重复的体力活，为了不把自己忙碌成代码的搬运工，这些都可以封装由框架去做，而自己关注最核心的业务层，也就是sql相关的逻辑。

把业务相关的sql逻辑配置在mapper.xml文件中，包括入参和返回的结果集，这其中会涉及到数据库中的字段和Java对象的字段之间的映射，一般如果字段名和类型相同可以通过MyBatis的自动映射即可，如果差别较大，则需要手动映射，甚至自定义类型处理typeHandlers。

每个MyBatis的应用都会以一个SqlSessionFacotry的实例为核心的，SqlSessionFacotryBuilder通过build加载核心配置文件mybatis-config.xml，从而创建SqlSessionFacotry，再由SqlSessionFacotry创建SqlSession。

核心配置文件mybatis-config.xml包含mapper.xml文件，在SqlSessionFacotryBuilder加载核心配置文件时一同加载进来，形成Configuration实例，其中mapper.xml的每个select/update/insert/delete节点都会最终生成MappedStatement对象，简单理解就是对应的完整sql语句，类似JDBC的Statement角色。

实际上核心配置文件除了包含mapper.xml，还包含数据库连接、事务、类型别名、类型处理器、插件、环境配置等等。

1准备工作：创建数据库和项目

创建数据库脚本

CREATE DATABASE `mybatisdemo`;USE mybatisdemo;CREATE TABLE `user` (`id` int(11) NOT NULL AUTO_INCREMENT,`name` varchar(20) DEFAULT NULL,PRIMARY KEY (`id`)) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4; 

创建maven项目，并在pom中添加mybatis和mysql驱动依赖包

<dependency>  <groupId>org.mybatisgroupId>  <artifactId>mybatisartifactId>  <version>3.5.5version>dependency><dependency>  <groupId>MySQLgroupId>  <artifactId>mysql-connector-javaartifactId>  <version>5.1.40version>dependency>

2添加核心配置文件mybatis-config.xml

<?xml  version="1.0" encoding="UTF-8" ?>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://127.0.0.1:3306/mybatisdemo"/>          <property name="username" value="root"/>          <property name="password" value="123456"/>      dataSource>    environment>  environments>

  <mappers>    <mapper resource="UserMapper.xml">mapper>  mappers>configuration>

3UserMapper.xml的配置

包含了插入数据的insert和查询数据的select，其中插入式通过设置useGeneratedKeys为true，返回自增id。

<?xml  version="1.0" encoding="UTF-8" ?>mapper        PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN"        "http://mybatis.org/dtd/mybatis-3-mapper.dtd"><mapper namespace="com.zhaiqianfeng.user.UserMapper">

  <insert id="insertUser" useGeneratedKeys="true" keyProperty="id">    insert into user(name) values(#{name})  insert>

  <select id="getUserById" resultMap="userMap">    select * from user where id = #{id}  select>

  <resultMap id="userMap" type="com.zhaiqianfeng.user.User">    <result property="id" column="id">result>    <result property="name" column="name">result>  resultMap>mapper>

4UserMapper.xml相对应Dao

UserMapper.java的代码如下，包含了相应插入和查询接口

package com.zhaiqianfeng.user;

public interface UserMapper {    User getUserById(int id);    int insertUser(User user);}

5创建SqlSession并验证

一切都准备好之后，开始创建SqlSession并执行

public static void main( String[] args ) throws IOException {  String config= "mybatis-config.xml";  InputStream inputStream= Resources.getResourceAsStream(config);  //SqlSessionFactoryBuilder加载核心(+mapper)配置文件并创建SqlSessionFactory  SqlSessionFactory sqlSessionFactory=     new SqlSessionFactoryBuilder().build(inputStream);

  //创建SqlSession  try(SqlSession sqlSession=sqlSessionFactory.openSession()) {    //获取mapper    UserMapper mapper = sqlSession.getMapper(UserMapper.class);

    User user = new User();    user.setName("chris");

    //执行操作    mapper.insertUser(user);    sqlSession.commit(); //flush    System.out.println("获取自增id:" + user.getId());

    user = mapper.getUserById(user.getId());    System.out.println("刚刚入库的user对象" + user);  }}

此时的项目结构是这样的

运行main之后打印

获取自增id:1

刚刚入库的user对象User(id=1, name=chris)

查看数据库

6优化

由于本例中的数据库表字段和Java对象的字段名一致，所以在UserMapper.xml中的resultMap可以省略，直接用resultType，mybatis会悄悄自动映射生成resultMap，省略后如

<?xml  version="1.0" encoding="UTF-8" ?>mapper        PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN"        "http://mybatis.org/dtd/mybatis-3-mapper.dtd"><mapper namespace="com.zhaiqianfeng.user.UserMapper">  <insert id="insertUser" useGeneratedKeys="true" keyProperty="id">    insert into user(name) values(#{name})  insert>  <select id="getUserById" resultType="com.zhaiqianfeng.user.User">    select * from user where id = #{id}  select>mapper>

还可以再简化，比如使用别名替换权限定名(com.zhaiqianfeng.user.User)等。

PS：本篇文章主要是通过漫画和图并结合对比常规JDBC来讲解MyBatis的原理和设计目标，比较适合新手阅读，感谢阅读。

源码地址:https://github.com/zhaiqianfeng/codeceo-demo/tree/master/mybatis/mybatis-demo-1

End

版权归@码农神说所有，转载须经授权，翻版必究

转载可联系助手，微信号：codeceo-01

往期精彩

---

 辟谣：程序员不配谈恋爱？你错的可以！真相来了 面试官:CAP都搞不清楚，别跟我说你懂微服务！ 互联网人的娱乐精神之28岁退休 & P8和生活助理的故事 千万不能让程序员给娃娃取名字 漫画 | 啊哈，给我一碗孟婆汤 人工智能之机械基 WC，接到一个阎王的需求