别在一直纠结MyBatis-Plus了,MyBatis才是真正的主人!

    2025-10-11 06:31:56

    前言

    为什么要整理这样一篇文章咧❓

    现在大家开发的过程中,基本上已经不用手写Mapper了,大多数可能用MyBatis-Plus啊,tkMapper啊,这些等等的封装了MyBatis的省时省力的东西,并不是说不用这些,当然省事省力就是给自己节约时间成本!

    之所以要整理一份关于MyBatis的文章,一个是为了重新复习它,另一个原因就是,别因为这些简单省事的框架,把真正需要好好掌握的基本给忘记了!

    话糙理不糙的说,比如几张表联查的统计查询?真正复杂的查询,还是需要自己把SQL搞出来的,难道不是嘛?一手SQL出神入化,任你多少表,我都能查!

    正文

    下面步入正题撒!

    什么是MyBatis?

    MyBatis是一个免费且优秀的开源持久性框架,支持自定义SQL,高级映射和存储过程。

    再也不用手写JDBC了,因为MyBatis几乎免除了所有关于JDBC代码。

    MyBatis可以通过XML或者注解的方式,来配置映射类型、接口和实体。

    数据库配置

    这个是用SpringBoot的配置写法:

    spring.datasource.driverClassName=com.mysql.cj.jdbc.Driver

    spring.datasource.url=jdbc:mysql://localhost:3306/test?useUnicode=true&characterEncoding=UTF-8&serverTimezone=Asia/Shanghai

    spring.datasource.username=root

    spring.datasource.password=123456

    在mysql-connector-java 6之后,driver驱动加入了cj,且需要指定时区serverTimezone

    老版本的:com.mysql.jdbc.Driver

    如果是SpringBoot,在启动类上写好扫码Dao包的位置

    @MapperScan(basePackages = "com.test.dao")

    下面开始举个栗子🌰

    在定义好Dao层接口后,根据接口中的方法,可以写出与之对应的Mapper,可以理解为实现类。

    Mapper.xml 放在Resources里就好啦,在配置中加入:

    mybatis.mapper-locations=classpath:/*Mapper.xml

    Dao层接口:

    public interface UserMapper {

    // 增加用户

    int addUser(User user);

    }

    Mapper.xml具体实现:

    PUBLIC "-//mybatis.org//DTD Config 3.0//EN"

    "http://mybatis.org/dtd/mybatis-3-mapper.dtd">

    insert into user(id, name, age) VALUES (#{id},#{name},#{age});

    上面 mapper PUBLIC…管他啥用的,这么写就对了!

    namespace 命名空间,这个xml是谁的实现,就写谁,完整包名,后面都以完整包名说,容易区分开。

    写好之后,按住Ctrl你试试,能不能点进去?这些个打错字母的怪才,咱复制粘贴他不香嘛!

    id 接口方法名,namespace是谁的,去谁里面找,都说是实现类了,名字要和方法一样。

    parameterType 传入参数类型,写User完整名也行,再不就写参数的别名,这就是user,要是方法的参数 (User abc) 那么写abc他也好使

    #{?,?,?} ?字符串,和实体类变量名对应,建议哈,表字段和实体类变量属性名字大小写一致,免得一会表字段,一会实体属性的出问题,或用resultMap也可以,后面说这个。

    #与 $ 这两个都是其中能包含属性的:

    $ 可能也看见过,之所以不用,实际就是对SQL语句的拼接而不安全,容易被SQL注入攻击。

    SQL注入是什么,请自行度娘

    #就是个占位符,SQL语句会预编译它。

    基本上只要是参数是实体的,增删改返回int类型的,这么写就没毛病,写就完了!

    1、单个查询:

    接口中的方法:

    //根据id查询单个用户

    User findUserById(@Param("id") String id);

    Mapper实现:

    resultType 指返回的类型,返回哪个实体,写那个实体就好

    parameterType 这次他不再是实体对象了,但同理,用谁写谁

    @Param 这个注解内容尽量和参数名相同,省的自己搞乱了;这个注解是在多个参数的情况下才需要写的,只有一个参数忽略不计。

    但好像是19版的IDEA还有忘记了哪个版本之上的MyBatis更新后可以忽略不写,这个自行度娘吧!

    查询全部

    接口中的方法:

    // 查询全部用户

    List findAllUsers();

    Mapper实现:

    这里明明是List,resultType 为啥要写User?

    你写个返回List还带泛型的,我瞅瞅咋写的!

    这里的 resultType ,根据泛型是什么就写什么。

    resultMap 结果集映射

    resultMap 是 MyBatis 中最强大的一个元素

    它可以做JDBC不支持的操作,简单的不需要管,复杂的描述之间的关系就OK!

    接口的方法:

    //查询所有用户

    List findAllUsers();

    实现类:

    select 的 resultMap 就要和 resultMap 的 id 相同了

    type 代表了映射的是哪个实体,内部是实体属性和表字段的关系,属性想要返回什么写什么就好了,可不都写上去。

    参数是Map或者List怎么办?使劲办!😁

    先说说Map:

    //根据map获取用户

    List findAllUsers (Map map);

    Map map = new HashMap();

    map.put("username","老吴");

    map.put("password","123456");

    存入参数中的key就是#{key}

    List:

    //根据list获取用户

    List findAllUsers (List list);

    List list = new ArrayList();

    list.add("老王");

    list.add("老吴");

    使用 foreach 语句循环集合中的数据,item 就是循环到的数据,名字随便取

    collection 值 要写 list

    多对一 与 一对多(举例说下一对多的情况,实际学生与老师是多对多的)

    就以学生和老师举例子吧,

    学生和他的老师,多对一:

    //学生

    @Data

    @AllArgsConstructor

    @NoArgsConstructor

    public class Student {

    private String id;

    private String name;

    private Teacher teacher;

    }

    //老师

    @Data

    @AllArgsConstructor

    @NoArgsConstructor

    public class Teacher {

    private String id;

    private String name;

    }

    List findAllStudentAndTeacher();

    这里主要用到 association ,它是一个对象标签

    老师的学生们,一对多:

    //学生

    @Data

    @AllArgsConstructor

    @NoArgsConstructor

    public class Student {

    private String id;

    private String name;

    // 对应老师的ID就行

    private String teacher;

    }

    //老师

    @Data

    @AllArgsConstructor

    @NoArgsConstructor

    public class Teacher {

    private String id;

    private String name;

    // 老师的学生列表

    private List students;

    }

    List findAllTeacherAndStudent();

    既然是学生们了,那是个List集合吧,泛型是User

    动态SQL — if

    动态SQL可以增加同一个标签中,重复使用。

    比如我想要根据username查询用户或者根据id查询用户,实际上使用一个就可以

    List findUserByParam (@Param("username") String username, @Param("id") String id);

    给id传空值,那就是根据username查了,对吧?写代码嘛!省事为主,哈!

    if 中 test 就是 判断条件,true 或 false

    至于为什么要加 where 1 = 1 呢?

    虽然这种写法不太符合规定,但是可以有效避免所有查询条件都是空,至少正常显示结果,已经必有了1=1的条件,不会出现错误。

    动态SQL — chose

    chose的用法思想,实际上和我刚说到 if 是一样的,他可以理解成java中的switch循环

    动态SQL — foreach

    实际上他就是个for循环,只是写法奇怪了点,刚说参数是LIst的时候,实际上已经用到他了,往上翻👆

    MyBatis的缓存鸡汁🐤

    一级缓存:

    MyBatis 内置了一个强大的事务性查询缓存机制,默认情况下,只启用了本地的会话缓存(一级缓存)

    1、映射语句文件中的所有 select 语句的结果将会被缓存。

    2、映射语句文件中的所有 insert、update 和 delete 语句会刷新缓存。

    3、缓存会使用算法LRU,最近最少使用算法,来清除不需要的缓存。

    4、缓存不会定时进行刷新(也就是说,没有刷新间隔)。

    5、缓存获取到的对象并不是共享的,可以被调用者修改,而不干扰其他调用者或线程所做的修改。

    二级缓存:

    如果没有开启二级缓存,在两个不同的SqlSession中发起查询,系统会执行两次SQL指令

    在mapper.xml中可以配置开启:

    < cache type=“org.apache.ibatis.cache.impl.PerpetualCache” /> 默认1024个对象个数

    开启后,不同的SqlSession发起查询,可如果是相同语句,只会真正的执行一次SQL命令。

    MyBatis启动时,都做了哪些操作?

    借了大佬一张图,看看MyBatis启动都干了什么?

    (1)读取MyBatis配置: XML写法的话那就是mybatis-config.xml的文件,

    如果是只用了application.properties(yml),其实道理是一样的,读取其配置的MyBatis的运行环境呀,数据库连接信息啊,以及MyBatis的设置等等这些信息。

    (2)加载映射文件: 就是我们所写的Mapper文件,加载操作数据库的SQL,一次性可以加载多个,每个文件实际就是数据库的一张表。

    (3)SqlSessionFactory: 会话工厂,通过SqlSessionFactoryBuilder对象类获得,而SqlSessionFactoryBuilder则可以从配置文件构建出SqlSessionFactory的实例.每一个MyBatis的应用程序都以一个SqlSessionFactory对象的实例为核心,SqlSessionFactory就是创建SqlSession的工厂.。

    (4)SqlSession: 会话对象,其包含了执行SQL的所有方法,也是程序和数据库直接交换的单线程对象,它是线程不安全的,就想HttpSession一样,用完及时关闭,当然了这件事MyBatis自己已经做了,实际上他的底层就是JDBC的连接,所以可以好不客气的说,MyBatis最核心的就是它了。

    (5)Executor: SqlSession对象的执行器,是SqlSession的内部属性,SqlSession创建的时候也顺便把Executor给创建好了。说白了,就是执行SQL的执行器,它会将SqlSession对象传递的参数,动态生成需要执行的SQL。可能说SqlSession扔过来一堆东西,但并不是直接可执行的SQL语句,Executor执行器会把这一堆变成一个能执行的SQL,并且执行,而且Executor也负责了查询缓存的维护工作。

    (5.1) Executor的缓存功能:👆前面说过的,一级默认开启,二级需要手动开启。

    如果在配置中开启了二级缓存,SqlSessionFactory在创建SqlSession对象时,其内部创建的是CachingExecutor执行器,它继承了Executor,目的就是为了操作缓存。它内部有个查询二级缓存的方法,如果没有查到某个namespace(也就是mapper里面写的dao文件)的二级缓存,就交给Executor执行器继续查询一级缓存,如果连一级缓存不存在,就去查询数据库。

    简单来说,CachingExecutor有个二级缓存管理器,且内部方法专门查询二级的,如果二级没有,交给Executor后它就不管了。这就是Executor执行器的查询缓存的维护工作。

    (5.2) 除了CachingExecutor执行器以外,还有BaseExecutor的接口,而此接口中存在三个子类实现:

    ReuseExecutor、BatchExecutor、SimpleExecutor(executor默认的),

    具体干嘛的自行度娘吧!超出本宝宝能力范围了! 😄

    (6)MappedStatement:在Executor执行方法中的参数,对映射信息(SQL语句的id、参数等信息)的封装,实际就是paramterType、resultType这些参数。

    它是mapper文件路径的配置信息:mybatis.mapper-locations=classpath:/*Mapper.xml来加载的,

    如果没有配置这条,它会先按照@Select这些注解来封装映射信息,如果注解也没用的话,它会调用内部方法,将按dao接口名称来寻找对应的Mapper。

    (7)(8)

    根据MappedStatement中封装的映射信息、参数等,Executor执行器真正的去执行SQL,并且返回给封装好的映射方法,输入输出类型可以是Map、List等等类型,也可以是对象实体,看mapper怎么写的喽!

    MyBatis和Hibernate的区别?

    Hibernate我理解的不多,看看大佬怎么说的吧!

    https://blog.csdn.net/firejuly/article/details/8190229

    我这里想说的就是,无论哪种框架,适合项目,适合自己就好了。

    谁优谁良这种事,小生道行甚浅,不敢妄自评价!

    总结

    第一次写近W字的文章,闲暇时间搞了近3天时间,可能有些啰嗦,但不光为了自己回忆MyBatis,也是希望对大家有些许助力吧!

    Mapper写法都是我在编辑器手敲上去的,直接复制粘贴我可不敢保证好用啊!😁

    特别深入的东西,我不懂,也不敢多讲,大佬们请理解!如果有问题,请评论告知,我及时修改!谢谢啦!

    参考文章:

    https://blog.csdn.net/qq_41464123/article/details/108172276

    https://blog.csdn.net/cold___play/article/details/102729810

    希望对大家有点帮助!我是阿昊,一个独自在大城市努力的年轻人。