【狂神说Java】Mybatis最新完整教程IDEA版通俗易懂(1)

官网

https://mybatis.org/mybatis-3/zh/index.html

1、简介

---

1-1.什么是Mybatis

Mybatis是一款优秀的持久层框架，它支持定制化SQL、存储过程以及高级映射。

Mybatis避免了几乎所有的JDBC代码和手动设置参数以及获取结果集。

MyBatis 可以通过简单的 XML 或注解来配置和映射原始类型、接口和 Java POJO（Plain Old Java Objects，普通老式 Java 对象）为数据库中的记录。

MyBatis 本是apache的一个开源项目iBatis, 2010年这个项目由apache software foundation 迁移到了google code，并且改名为MyBatis 。2013年11月迁移到Github。

github地址

https://github.com/mybatis/mybatis-3

依赖

org.mybatis

mybatis

3.5.7

---

1-2.持久化

数据持久化

• 持久化就是将程序的数据在持久状态和瞬时状态转化的过程

• 内存：断电即失

• 数据库（jdbc）、io文件持久化

• 生活：冷藏，罐头。

为什么需要持久化？

• 有一些对象，不能让他丢掉。

• 内存太贵了

---

1-3.持久层（名词，概念）

• Dao层，Service层，Controller层…

• 完成持久化工作的代码块

• 层界限十分明显。

---

1-4.为啥需要Mybatis？

• 帮助程序员将数据存入到数据库中。

• 方便

• 传统的JDBC代码太复杂了。简化。框架。自动化。

• 不用Mybatis也可以。更容易上手。技术没有高低之分

特点

• 简单易学：只要两个jar文件+配置几个sql映射文件易于学习

• 灵活： sql写在xml里，便于统一管理和优化。

• 解除sql与程序代码的耦合：将业务逻辑和数据访问逻辑分离，使系统的设计更清晰，。sql和代码的分离，提高了可维护性。

• 提供映射标签，支持对象与数据库的orm字段关系映射

• 提供对象关系映射标签，支持对象关系组建维护

• 提供xml标签，支持编写动态sql。

最重要的一点：使用的人多！

2、第一个Mybatis程序

---

思路：搭建环境——》导入Mybatis——》编写代码——》测试

2-1.搭建环境

mysql

mysql-connector-java

5.1.49

org.mybatis

mybatis

3.5.3

junit

junit

4.13

test

---

2-2.创建模块

1.编写mybatis核心配置文件

<?xml version="1.0" encoding="UTF-8" ?>

2.编写mybatis工具类

package cn.bloghut.dao.utils;

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;

/**

• 获取SQLSessionFactory对----》sqlSession

*/

public class MybatisUtils {

private static SqlSessionFactory factory;

static {

try {

//使用mybatis第一步

String resource = “mybatis-config”;

InputStream in = Resources.getResourceAsStream(resource);

factory = new SqlSessionFactoryBuilder().build(in);

} catch (IOException e) {

e.printStackTrace();

}

}

/**

• 既然有了SqlSessionFactory，顾名思义，我们就可以从中获得SQLSession实例了

• SQLSession 完全包含了面向库执行 SQL 命令所需的所有方法

• @return

*/

public static SqlSession getSqlSession(){

return factory.openSession();

}

}

3.编写代码

1. 实体类

2. Dao接口

3. 接口实现类

public class User implements Serializable {

private int id;

private String name;

private String pwd;

//省略toString ，get/set

}

public interface UserDao {

List getUser();

}

select * from users

4.测试

@Test

public void test(){

//第一步，获得SQLSession对象

SqlSession sqlSession = MybatisUtils.getSqlSession();

//执行SQL

//方式一

//UserDao userDao = sqlSession.getMapper(UserDao.class);

//List users = userDao.getUser();

//方式二

List users = sqlSession.selectList(“cn.bloghut.dao.UserDao.getUser”);

for (User user : users){

System.out.println(user);

}

//关闭SQLSession

sqlSession.close();

}

---

3、CRUD

---

3-1.namespace

namespace中的包名要和Dao/Mapper 接口的包名一致！

---

3-2.select

选择、查询语句

id ：就是对应的namespace接口中的方法名；

resuleType ：SQL语句执行的返回值

parameterType ：参数类型

1.编写接口

/**

• 根据id查询用户

• @param id

• @return

*/

User getUserById(int id);

2.编写对应的mapper中的sql语句

select * from users where id = #{id}

3.测试

@Test

public void t1() {

SqlSession sqlSession = MybatisUtils.getSqlSession();

UserMapper userMapper = sqlSession.getMapper(UserMapper.class);

User user = userMapper.getUserById(1);

System.out.println(user);

sqlSession.close();

}

---

3-3.insert

insert into users(name,pwd) values(#{name},#{pwd})

---

3-4.update

update users set name=#{name},pwd=#{pwd} where id = #{id}

---

3-5.delete

delete from users where id = #{id}

注意：增删改需要提交事务

---

3-6万能Map

假设，我们的实体类，或者数据库中的表，字段或者参数过多，我们应当考虑使用Map！

@Test

public void t5() {

SqlSession sqlSession = MybatisUtils.getSqlSession();

UserMapper userMapper = sqlSession.getMapper(UserMapper.class);

Map<String, Object> map = new HashMap<>();

map.put(“username”, “闲言”);

map.put(“password”, “111”);

userMapper.addUser2(map);

sqlSession.commit();

sqlSession.close();

}

void addUser2(Map<String,Object> map);

insert into users(name,pwd) values(#{username},#{password})

• Map 传递参数，直接在sql中取出key 【parameterType=“Map”】

• 对象传递参数，直接在sql中取对象的属性即可 【parameterType=“Object”】

• 只有一个基本类型参数的情况下，可以直接在sql中取到

• 多个参数用Map或注解

3-7模糊查询

1.Java代码执行的时候，传递通配符 %%

List userLike = userMapper.getUserLike(“%闲%”);

2.在sql拼接中使用通配符

select * from users where name like “%”#{value}“%”

---

4、配置解析

---

4-1、核心配置文件

mybatis-config.xml

configuration（配置）

properties（属性）

settings（设置）

typeAliases（类型别名）

typeHandlers（类型处理器）

objectFactory（对象工厂）

plugins（插件）

environments（环境配置）

environment（环境变量）

transactionManager（事务管理器）

dataSource（数据源）

databaseIdProvider（数据库厂商标识）

mappers（映射器）

---

4-2.environments（环境配置）

• MyBatis 可以配置成适应多种环境

不过要记住：尽管可以配置多个环境，但每个 SqlSessionFactory 实例只能选择一种环境。

• 学会使用配置多套运行环境！

• Mybatis默认的事务管理器就是JDBC，连接池：POOLED

---

4-3.属性properties

这些属性可以在外部进行配置，并可以进行动态替换。你既可以在典型的 Java 属性文件中配置这些属性，也可以在 properties 元素的子元素中设置。【db.properties】

编写一个配置文件

db.properties

driver=com.mysql.jdbc.Driver

url=jdbc:mysql://localhost:3306/mybatis?useSSL=false&useUnicode=true&characterEncoding=UTF8

username=root

password=123

---

4-4.类型别名typeAliases

存在别名的是为Java类型设置一个短的名字

存在的意义仅用来减少类完全限定的冗余

也可以指定一个包名，Mybatis会在包名下面搜索java Bean ，比如：

扫描实体类的包，它的默认别名就是为这个类的类型，首字母小写！

在实体类比较少的时候，使用第一种方式

如果实体类十分多，建议使用第二种

第一种可以DIY别名，第二种则不行，如果非要改，需要在实体上增加注解

@Alias(“user”)

public class User implements Serializable {

---

4-5.映射器

MapperRegistry：注册绑定我们的Mapper文件；

方式一：【推荐使用】

方式二：使用class文件绑定注册

注意点：

接口和他的mapper文件都需要在Mybatis核心配置文件中注册

接口和他的mapper文件配置文件必须再同一包下！

方式三：使用扫描包注册

注意点：

接口和他的Mapper配置文件必须同名！

接口和他的mapper文件配置文件必须再同一包下！

---

4-6生命周期和作用域

不同作用域和生命周期类别是至关重要的，因为错误的使用会导致非常严重的并发问题。

SqlSessionFactoryBuilder

• 一旦创建了 SqlSessionFactory，就不再需要它了。

• 局部变量

SqlSessionFactory

• SqlSessionFactory 一旦被创建就应该在应用的运行期间一直存在，没有任何理由丢弃它或重新创建另一个实例。

• SqlSessionFactory 的最佳作用域是应用作用域。

• 最简单的就是使用单例模式或者静态单例模式

SqlSession（相当于从连接池中获取一个连接）

• 连接到连接池的请求！

• 关闭

• SqlSession 的实例不是线程安全的，因此是不能被共享的，它的最佳的作用域是请求或方法作用域

• 用完之后需要赶紧关闭，

一个SQLSession 可以多次使用它的getMapper方法，获取多个mapper接口实例

打个比方：

1. SqlSessionFactoryBuilder 是造车公司

2. 造了100台车，然后买给租车公司（SQLSessionFactory），然后倒闭

3. SQLSession 用户 租车，使用车

4. mapper 用户的使用，用户租到车之后可以开去这，开去那，任凭使用

5. 用户（SQLSession） 执行完想做的事之后，必须归还“汽车” 给租车公司（SQLSessionFactory）

这里面的每一个mapper 就代表一个具体的业务。

---

5、解决属性名和字段名不一致的问题

---

数据库中的字段和JavaBean不一致的情况

public class User {

private int id;

private String name;

private String password;

select id,name,pwd from users

解决办法

起别名

select id,name,pwd as password from users

2、ResultMap 结果集映射

resultMap 元素是 MyBatis 中最重要最强大的元素。

ResultMap 的设计思想是，对简单的语句做到零配置，对于复杂一点的语句，只需要描述语句之间的关系就行了。

MyBatis 会在幕后自动创建一个 ResultMap，再根据属性名来映射列到 JavaBean 的属性上。

---

6、日志

---

6-1.日志工厂

如果一个数据库操作出现了异常，我们需要排错。日志就是最好的助手！

曾经：debug sout

现在：日志工厂

• SLF4J

• LOG4J 【掌握】

• LOG4J2

• JDK_LOGGING

• COMMONS_LOGGING

• STDOUT_LOGGING

• NO_LOGGING

---

6-2.LOG4J

什么是LOG4J

• Log4j是Apache的一个开源项目

• 通过使用Log4j，我们可以控制日志信息输送的目的地是控制台、文件、GUI组件

• 我们可以控制每一条日志的输出格式；

• 通过定义每一条日志信息的级别，我们能够更加细致地控制日志的生成过程。

• 通过一个配置文件来灵活地进行配置，而不需要修改应用的代码。

1.先导入LOG4J的依赖

log4j

log4j

1.2.17

2.编写log4j.properties文件

配置根

log4j.rootLogger = debug,console ,fileAppender,dailyRollingFile,ROLLING_FILE,MAIL,DATABASE

设置输出sql的级别，其中logger后面的内容全部为jar包中所包含的包名

log4j.logger.org.apache=debug

log4j.logger.java.sql.Connection=debug

log4j.logger.java.sql.Statement=debug

log4j.logger.java.sql.PreparedStatement=debug

log4j.logger.java.sql.ResultSet=debug

配置输出到控制台

log4j.appender.console = org.apache.log4j.ConsoleAppender

log4j.appender.console.Target = System.out

log4j.appender.console.layout = org.apache.log4j.PatternLayout

log4j.appender.console.layout.ConversionPattern = %d{ABSOLUTE} %5p %c{1}:%L - %m%n

配置输出到文件

log4j.appender.fileAppender = org.apache.log4j.FileAppender

log4j.appender.fileAppender.File = logs/log.log

log4j.appender.fileAppender.Append = true

log4j.appender.fileAppender.Threshold = DEBUG

log4j.appender.fileAppender.layout = org.apache.log4j.PatternLayout

log4j.appender.fileAppender.layout.ConversionPattern = %-d{yyyy-MM-dd HH:mm:ss} [ %t:%r ] - [ %p ] %m%n

配置输出到文件，并且每天都创建一个文件

log4j.appender.dailyRollingFile = org.apache.log4j.DailyRollingFileAppender

log4j.appender.dailyRollingFile.File = logs/log.log

log4j.appender.dailyRollingFile.Append = true

log4j.appender.dailyRollingFile.Threshold = DEBUG

log4j.appender.dailyRollingFile.layout = org.apache.log4j.PatternLayout

log4j.appender.dailyRollingFile.layout.ConversionPattern = %-d{yyyy-MM-dd HH:mm:ss} [ %t:%r ] - [ %p ] %m%n

配置输出到文件，且大小到达指定尺寸的时候产生一个新的文件

log4j.appender.ROLLING_FILE=org.apache.log4j.RollingFileAppender

log4j.appender.ROLLING_FILE.Threshold=ERROR

log4j.appender.ROLLING_FILE.File=rolling.log

log4j.appender.ROLLING_FILE.Append=true

log4j.appender.ROLLING_FILE.MaxFileSize=10KB

log4j.appender.ROLLING_FILE.MaxBackupIndex=1

log4j.appender.ROLLING_FILE.layout=org.apache.log4j.PatternLayout

log4j.appender.ROLLING_FILE.layout.ConversionPattern=[framework] %d - %c -%-4r [%t] %-5p %c %x - %m%n

4j.appender.A1.layout=org.apache.log4j.xml.XMLLayout

3.配置log4j为日志实现

4.测试

---

6-3简单使用

1.在要使用log4j的类中导入Apache的包

import org.apache.log4j.Logger;

2.日志对象，参数为当前类的class

static Logger logger = Logger.getLogger(UserTest.class);

3.使用

日志级别

info

debug

error

@Test

public void testLog4j(){

logger.info(“info:进入了testLog4j方法”);

logger.debug(“debug:进入了testLog4j方法”);

logger.error(“error:进入了testLog4j方法”);

}

---

7、分页

---

思考：为什么要分页？

减少数据的处理量

7-1.使用Limit分页

语法：select * from users limit startIndex,PageSize;

1.接口

/**

• 分页查询用户

• @param map

• @return

*/

List getUserByLimit(Map<String,Object> map);

2.映射文件

select * from users limit #{currentPage},#{pageSize}

3.测试

@Test

public void t4(){

SqlSession sqlSession = MybatisUtils.getSqlSession();

UserMapper userMapper = sqlSession.getMapper(UserMapper.class);

Map<String,Object> map = new HashMap<>();

map.put(“currentPage”,0);

map.put(“pageSize”,2);

List users = userMapper.getUserByLimit(map);

for (User user : users) {

System.out.println(user);

}

sqlSession.close();

}

---

7-2.RowBounds分页

不再使用SQL实现分页

1.接口

/**

• 使用RowBounds实现分页

• @return

*/

List getUserByRowBounds();

2.mapper.xml

select * from users

3.测试

@Test

public void t5(){

SqlSession sqlSession = MybatisUtils.getSqlSession();

RowBounds rowBounds = new RowBounds(0, 2);

//通过Java代码层实现分页

List users = sqlSession.selectList(“cn.bloghut.dao.UserMapper.getUserByRowBounds”, null, rowBounds);

for (User user : users) {

System.out.println(user);

}

sqlSession.close();

}

---

7-3.分页插件

官网

https://pagehelper.github.io/

---

8、注解开发

---

8-1.面向接口编程

大家之前都学过面向对象编程，也学习过接口，但在真正的开发中，很多时候我们会选择面向接口编程。

根本原因:解耦，可拓展，提高复用，分层开发中，上层不用管具体的实现，大家都遵守共同的标准，使得开发变得容易，规范性更好

在一个面向对象的系统中，系统的各种功能是由许许多多的不同对象协作完成的。在这种情况下，各个对象内部是如何实现自己的,对系统设计人员来讲就不那么重要了;

而各个对象之间的协作关系则成为系统设计的关键。小到不同类之间的通信，大到各模块之间的交互，在系统设计之初都是要着重考虑的，这也是系统设计的主要工作内容。面向接口编程就是指按照这种思想来编程。

关于接口的理解

接口从更深层次的理解，应是定义(规范，约束)与实现(名实分离的原则）的分离。

接口的本身反映了系统设计人员对系统的抽象理解。

接口应有两类:

第一类是对一个个体的抽象，它可对应为一个抽象体(abstract class);

第二类是对一个个体某一方面的抽象，即形成一个抽象面(interface) ;

一个体有可能有多个抽象面。抽象体与抽象面是有区别的。

三个面向区别

面向对象是指，我们考虑问题时，以对象为单位，考虑它的属性及方法．

面向过程是指，我们考虑问题时，以一个具体的流程（事务过程)为单位，考虑它的实现.

接口设计与非接口设计是针对复用技术而言的，与面向对象（过程)不是一个问题.更多的体现就是对系统整体的架构

8-2.使用注解开发

1.注解在接口上实现

@Select(“select * from users”)

List getUsers();

2.需要在核心配置文件中绑定接口！

3.测试

本质：反射机制实现

底层：动态代理！

8-3.Mybatis详细的执行流程！

---

8-4.CRUD

在配置文件绑定Mapper接口位置

我们可以在工具类创建的时候实现自动提交事务！

/**

• 既然有了SqlSessionFactory，顾名思义，我们就可以从中获得SQLSession实例了

• SQLSession 完全包含了面向库执行 SQL 命令所需的所有方法

• @return

*/

public static SqlSession getSqlSession(){

return factory.openSession(true);

}

接口

public interface UserMapper {

@Select(“select * from users”)

List getUsers();

/**

• 方法存在多个参数，所有的参数前面必须加上 @Param 注解

• @param id

• @return

*/

@Select(“select * from users where id = #{id}”)

User getUserById(@Param(“id”) int id);

@Insert(“insert into users(name,pwd) values(#{name},#{password})”)

int insert(User user);

@Update(“update users set name=#{name},pwd=#{password} where id = #{id}”)

int update(User user);

@Delete(“delete from users where id = #{id}”)

int delete(@Param(“id”)int id);

}

测试

public class T {

@Test

public void t1() {

SqlSession sqlSession = MybatisUtils.getSqlSession();

//底层主要应用反射

UserMapper mapper = sqlSession.getMapper(UserMapper.class);

List users = mapper.getUsers();

for (User user : users) {

System.out.println(user);

}

sqlSession.close();

}

@Test

public void t2() {

SqlSession sqlSession = MybatisUtils.getSqlSession();

//底层主要应用反射

UserMapper mapper = sqlSession.getMapper(UserMapper.class);

User user = mapper.getUserById(1);

System.out.println(user);

sqlSession.close();

}

@Test

public void t3() {

SqlSession sqlSession = MybatisUtils.getSqlSession();

//底层主要应用反射

UserMapper mapper = sqlSession.getMapper(UserMapper.class);

User user = new User();

user.setName(“xian”);

user.setPassword(“321”);

int flag = mapper.insert(user);

System.out.println(flag);

sqlSession.close();

}

@Test

public void t4() {

SqlSession sqlSession = MybatisUtils.getSqlSession();

//底层主要应用反射

UserMapper mapper = sqlSession.getMapper(UserMapper.class);

User user = new User();

user.setId(12);

user.setName(“xy”);

user.setPassword(“321”);

int flag = mapper.update(user);

System.out.println(flag);

sqlSession.close();

}

@Test

public void t5() {

SqlSession sqlSession = MybatisUtils.getSqlSession();

//底层主要应用反射

UserMapper mapper = sqlSession.getMapper(UserMapper.class);

int flag = mapper.delete(12);

System.out.println(flag);

sqlSession.close();

}

}

关于@Param注解

1. 基本类型的参数或者String类型，需要加上

2. 引用类型不需要加

3. 如果只有一个基本类型的话，可以忽略，但是建议都加上

4. 我们在SQL中引用的就是我们这里的@Param(“uid”)中设定的属性名

#{} 和 ${} 区别

最后：学习总结——MyBtis知识脑图（纯手绘xmind文档）

学完之后，若是想验收效果如何，其实最好的方法就是可自己去总结一下。比如我就会在学习完一个东西之后自己去手绘一份xmind文件的知识梳理大纲脑图，这样也可方便后续的复习，且都是自己的理解，相信随便瞟几眼就能迅速过完整个知识，脑补回来。下方即为我手绘的MyBtis知识脑图，由于是xmind文件，不好上传，所以小编将其以图片形式导出来传在此处，细节方面不是特别清晰。但可给感兴趣的朋友提供完整的MyBtis知识脑图原件（包括上方的面试解析xmind文档）

除此之外，前文所提及的Alibaba珍藏版mybatis手写文档以及一本小小的MyBatis源码分析文档——《MyBatis源码分析》等等相关的学习笔记文档，也皆可分享给认可的朋友！

SqlSession sqlSession = MybatisUtils.getSqlSession();

//底层主要应用反射

UserMapper mapper = sqlSession.getMapper(UserMapper.class);

List users = mapper.getUsers();

for (User user : users) {

System.out.println(user);

}

sqlSession.close();

}

@Test

public void t2() {

SqlSession sqlSession = MybatisUtils.getSqlSession();

//底层主要应用反射

UserMapper mapper = sqlSession.getMapper(UserMapper.class);

User user = mapper.getUserById(1);

System.out.println(user);

sqlSession.close();

}

@Test

public void t3() {

SqlSession sqlSession = MybatisUtils.getSqlSession();

//底层主要应用反射

UserMapper mapper = sqlSession.getMapper(UserMapper.class);

User user = new User();

user.setName(“xian”);

user.setPassword(“321”);

int flag = mapper.insert(user);

System.out.println(flag);

sqlSession.close();

}

@Test

public void t4() {

SqlSession sqlSession = MybatisUtils.getSqlSession();

//底层主要应用反射

UserMapper mapper = sqlSession.getMapper(UserMapper.class);

User user = new User();

user.setId(12);

user.setName(“xy”);

user.setPassword(“321”);

int flag = mapper.update(user);

System.out.println(flag);

sqlSession.close();

}

@Test

public void t5() {

SqlSession sqlSession = MybatisUtils.getSqlSession();

//底层主要应用反射

UserMapper mapper = sqlSession.getMapper(UserMapper.class);

int flag = mapper.delete(12);

System.out.println(flag);

sqlSession.close();

}

}

关于@Param注解

1. 基本类型的参数或者String类型，需要加上

2. 引用类型不需要加

3. 如果只有一个基本类型的话，可以忽略，但是建议都加上

4. 我们在SQL中引用的就是我们这里的@Param(“uid”)中设定的属性名

#{} 和 ${} 区别

最后：学习总结——MyBtis知识脑图（纯手绘xmind文档）

学完之后，若是想验收效果如何，其实最好的方法就是可自己去总结一下。比如我就会在学习完一个东西之后自己去手绘一份xmind文件的知识梳理大纲脑图，这样也可方便后续的复习，且都是自己的理解，相信随便瞟几眼就能迅速过完整个知识，脑补回来。下方即为我手绘的MyBtis知识脑图，由于是xmind文件，不好上传，所以小编将其以图片形式导出来传在此处，细节方面不是特别清晰。但可给感兴趣的朋友提供完整的MyBtis知识脑图原件（包括上方的面试解析xmind文档）

[外链图片转存中…(img-0NudWJHV-1714532360565)]

除此之外，前文所提及的Alibaba珍藏版mybatis手写文档以及一本小小的MyBatis源码分析文档——《MyBatis源码分析》等等相关的学习笔记文档，也皆可分享给认可的朋友！

本文已被CODING开源项目：【一线大厂Java面试题解析+核心总结学习笔记+最新讲解视频+实战项目源码】收录