1. 了解MyBatis
1.1 MyBatis是什么？
使用Java操作数据库的话，JDK给我们提供了一层对各个数据库的封装，也就是JDBC，它屏蔽了数据库之间的差异，使用JDBC可以统一操作。但是他长期以来被人诟病的就是重复代码太多。封装参数需要一个一个set，还需要你把ResultSet一个一个映射成POJO，这里面充满了重复代码，这里完全可以由模板代码来代替。当然，不仅仅是重复代码，还有其他缺点，比如，性能，安全，扩展性等等。
封装JDBC以求达到更简洁，更优雅，更安全，更高效的方案有很多，MyBatis就是其中之一，这类框架一般被叫做ORM框架（Object Relational Mapping，就是Java中的对象和关系型数据库里的数据映射的一个框架）。
MyBatis通过构造一个Mapper来消除JDBC代码，却又可以实现查询数据库的功能。Mapper是个interface，我们可以指定这个接口里每个方法对应的SQL模板，然后由MyBatis来绑定运行时传入的参数给SQL模板里的占位符，构造成一个可执行的SQL，然后执行，获得结果后再自动封装成方法返回值的类型的对象。
举个例子，Mapper：
Blog selectBlog(long id);
SQL：
select * from Blog where id = #{id}这样查询时的参数绑定，和查询结果的封装都可以由MyBatis来完成。
1.2 为什么使用MyBatis？
知道MyBatis是什么，应该就明白为什么会出现MyBatis之类的ORM框架了，还有常见的Hibernate。对于ORM框架，或者类似的东西，存在的意义就是上面所说的。那么，为什么是MyBatis？而不是其他ORM框架呢？这里我简单的说说，为什么我喜欢MyBatis胜过喜欢Hibernate吧，我更喜欢简洁。说通俗一点，ORM确实有存在的必要，但是真的有必要封装的太过深吗？Hiberante可以达到让用户完全不知道自己在使用数据库的程度，这实现起来肯定比MyBatis更复杂，说明Hibernate的技术含量要更高，可是这也带来了问题，我们真的需要这样吗？
过度的封装，会带来更多的成本，学习成本、故障解决时的成本。而相比Hibernate的高度复杂，MyBatis就显得很简小精悍了。我想这也是很多人喜欢用guice而不是spring吧。
这里随意比较一下两个框架的文档：
image
image
2. 基本概念
这里介绍一下MyBatis最核心的几个类，虽然框架帮我们隐藏了很多细节，但是如果对他不够了解，就不能应用的得心应手。这里介绍的几个类都很容易理解，名字起的好也是一种本领啊。
2.1 SqlSessionFactoryBuilder
SqlSessionFactoryBuilder是根据配置创建SqlSessionFactory的工厂类，一般来说是通过XML，当然，我们也可以直接用代码来构建。这个类一旦创建出SqlSessionFactory之后，他的意义就结束了，可以被释放了。一般推荐在方法内定义，用完就释放。当然，你可以用它创建多个不同的SqlSessionFactory。
2.2 SqlSessionFactory
SqlSessionFactory一旦创建就应该一直存在，一般建议维护在应用级别（不是方法级别，也不是类级别，而是整个应用共享）。一般来说，不需要重复创建这个对象，也不要释放它。可以用单例模式来保证整个应用内的唯一性。
2.3 SqlSession
SqlSession是线程不安全的，所以每个线程应该维护一个单独的SqlSession对象。千万不要用对象的静态变量引用来指向一个SqlSession，这样会导致它泄露到其他线程中。而且，一定要记得关闭SqlSession，常见的使用方式如下：
SqlSession session = sqlSessionFactory.openSession();try { // do work} finally {
session.close();
}2.4 Mapper Instances
Mapper Instances是我们定义的Mapper接口的实例对象，他包含了SQL绑定关系，需要SqlSession创建。所以他的生命周期可以和SqlSession一致，也就是线程级别，但是为了简洁，我还是建议放在方法内部，它不需要关闭，使用方法一般如下：
SqlSession session = sqlSessionFactory.openSession();try {
BlogMapper mapper = session.getMapper(BlogMapper.class); // do work} finally {
session.close();
}3. 基本使用
代码可直接去Github上下载：https://github.com/dubby1994/mybatis_study
依赖：
<dependencies> <!-- https://mvnrepository.com/artifact/org.mybatis/mybatis --> <dependency> <groupId>org.mybatis</groupId> <artifactId>mybatis</artifactId> <version>3.2.1</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></dependencies>
3.1 XML版（经典版本）
MyBatis的经典版本就是用XML来配置，并用XML来实现SQL和Java代码的分离。
创建数据库：
CREATE TABLE `blog` ( `id` bigint(11) unsigned NOT NULL AUTO_INCREMENT, `title` varchar(1024) DEFAULT NULL, `content` text, `create_time` timestamp NULL DEFAULT CURRENT_TIMESTAMP, PRIMARY KEY (`id`) ) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;
插入数据：
INSERT INTO `blog` (`id`, `title`, `content`, `create_time`) VALUES (1, '标题1', '内容1', '2018-02-05 10:45:26');
编写主配置文件mybatis-config.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"><configuration> <typeAliases> <package name="cn.dubby.study.mybatis.basic.xml.entity"/> </typeAliases> <environments default="development"> <environment id="development"> <transactionManager type="JDBC"/> <dataSource type="POOLED"> <property name="driver" value="com.mysql.cj.jdbc.Driver"/> <property name="url" value="jdbc:mysql://localhost:3306/mybatis_study?useUnicode=true&characterEncoding=UTF-8&useLegacyDatetimeCode=false&serverTimezone=UTC"/> <property name="username" value="test"/> <property name="password" value="123456"/> </dataSource> </environment> </environments> <mappers> <mapper resource="cn/dubby/study/mybatis/basic/xml/mapper/BlogMapper.xml"/> </mappers></configuration>
编写启动类Main.java：
package cn.dubby.study.mybatis.basic.xml;import cn.dubby.study.mybatis.basic.xml.entity.Blog;import cn.dubby.study.mybatis.basic.xml.mapper.BlogMapper;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 java.io.IOException;import java.io.InputStream;public class Main { public static void main(String[] args) throws IOException {
String resource = "mybatis-config.xml";
InputStream inputStream = Resources.getResourceAsStream(resource);
SqlSessionFactory sqlSessionFactory = new SqlSessionFactoryBuilder().build(inputStream);
SqlSession session = sqlSessionFactory.openSession(); try {
Blog blog1 = session.selectOne("cn.dubby.study.mybatis.basic.xml.mapper.BlogMapper.selectBlog", 1);
System.out.println(blog1);
BlogMapper mapper = session.getMapper(BlogMapper.class);
Blog blog2 = mapper.selectBlog(1);
System.out.println(blog2);
} finally {
session.close();
}
}
}编写POJO Blog.java：
package cn.dubby.study.mybatis.basic.xml.entity;import java.util.Date;public class Blog { private Long id; private String title; private String content; private Date createTime; @Override
public String toString() { return "Blog{" + "id=" + id + ", title='" + title + '\'' + ", content='" + content + '\'' + ", createTime=" + createTime + '}';
}
//getter and setter ...}编写Mapper BlogMapper.java：
package cn.dubby.study.mybatis.basic.xml.mapper;import cn.dubby.study.mybatis.basic.xml.entity.Blog;public interface BlogMapper { Blog selectBlog(long id);
}运行Main.java结果：
Blog{id=1, title='标题1', content='内容1', createTime=Mon Feb 05 18:45:26 CST 2018}
Blog{id=1, title='标题1', content='内容1', createTime=Mon Feb 05 18:45:26 CST 2018}3.2 注解版
可以做到完全没有XML，总共有三个类，Main.java，Serial.java，SerialMapper.java。
先准备数据库：
CREATE TABLE `serial` ( `id` bigint(11) unsigned NOT NULL AUTO_INCREMENT, `name` varchar(1024) DEFAULT NULL, `description` text, PRIMARY KEY (`id`) ) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;
INSERT INTO `serial` (`id`, `name`, `description`) VALUES (1, 'MyBatis教程', '这一系列文章主要是介绍MyBatis，包含入门使用，高级特性，以及实现细节。');
Main.java：
package cn.dubby.study.mybatis.basic.without.xml;import cn.dubby.study.mybatis.basic.without.xml.entity.Serial;import cn.dubby.study.mybatis.basic.without.xml.mapper.SerialMapper;import org.apache.ibatis.datasource.unpooled.UnpooledDataSource;import org.apache.ibatis.mapping.Environment;import org.apache.ibatis.session.Configuration;import org.apache.ibatis.session.SqlSession;import org.apache.ibatis.session.SqlSessionFactory;import org.apache.ibatis.session.SqlSessionFactoryBuilder;import org.apache.ibatis.transaction.TransactionFactory;import org.apache.ibatis.transaction.jdbc.JdbcTransactionFactory;import javax.sql.DataSource;public class Main { public static void main(String[] args) {
DataSource dataSource = new UnpooledDataSource("com.mysql.cj.jdbc.Driver", "jdbc:mysql://localhost:3306/mybatis_study?useUnicode=true&characterEncoding=UTF-8&useLegacyDatetimeCode=false&serverTimezone=UTC", "test", "123456");
TransactionFactory transactionFactory = new JdbcTransactionFactory();
Environment environment = new Environment("development", transactionFactory, dataSource);
Configuration configuration = new Configuration(environment);
configuration.addMapper(SerialMapper.class);
SqlSessionFactory sqlSessionFactory = new SqlSessionFactoryBuilder().build(configuration);
SqlSession session = sqlSessionFactory.openSession(); try {
Serial serial1 = session.selectOne("cn.dubby.study.mybatis.basic.without.xml.mapper.SerialMapper.selectSerial", 1);
System.out.println(serial1);
SerialMapper mapper = session.getMapper(SerialMapper.class);
Serial serial2 = mapper.selectSerial(1);
System.out.println(serial2);
} finally {
session.close();
}
}
}Serial.java：
package cn.dubby.study.mybatis.basic.without.xml.entity;public class Serial { private Long id; private String name; private String description; @Override
public String toString() { return "Serial{" + "id=" + id + ", name='" + name + '\'' + ", description='" + description + '\'' + '}';
}
//setter and getter...}SerialMapper.java：
package cn.dubby.study.mybatis.basic.without.xml.mapper;import cn.dubby.study.mybatis.basic.without.xml.entity.Serial;import org.apache.ibatis.annotations.Select;public interface SerialMapper { @Select("SELECT * FROM serial WHERE id = #{id}") Serial selectSerial(long id);
}执行Main.java：
Serial{id=1, name='MyBatis教程', description='这一系列文章主要是介绍MyBatis，包含入门使用，高级特性，以及实现细节。'}
Serial{id=1, name='MyBatis教程', description='这一系列文章主要是介绍MyBatis，包含入门使用，高
作者：我是杨正
链接：https://www.jianshu.com/p/cc875436a406