目录
（一）SqlSession & SqlSessionFactory
一、概述
MyBatis是一个半自动的持久层框架，用来把SQL、存储过程和Java对象映射起来。
二、ORM
ORM（对象-关系映射）把程序里的对象和数据库表之间建立映射，让我们用面向对象的方式读写数据库，而不是手写大量SQL。
这种思想可以显著地提升我们对数据库操作的效率，但是对于比较复杂的还是推荐手写SQL。
三、映射基础
（一）SqlSession & SqlSessionFactory
SqlSessionFactory是工厂，负责创建SqlSession。通常由SqlSessionFactoryBuilder从mybatis-config.或Configuration构建。线程安全，整个应用应只创建一次，是单例模式。
SqlSession是Mybatis核心操作的句柄，用于执行映射语句、管理事务以及获取。非线程安全，应该每次请求都创建一个新的，是多例模式。
Spring容器中使用了SqlSessionTemplate替代了SqlSession，是线程安全且更加便于Spring管理的模板句柄。 而在Spring Boot框架中通常使用mybatis-spring-boot-starter，而不手动构造SqlSessionFactory。
（二）Mapper接口以及XML映射
Mapper接口定义方法签名，对应的XML文件中实现SQL，并根据SQL语句的ID与Mapper接口的方法对应起来。Mybatis要求namespace是Mapper接口的全限定类名，而id对应方法名，不然getMapper会无法找到映射。
Mybatis的底层简单来说就是为我们动态编写JDBC的模板代码，我们只需关注SQL实现，而无需编写资源管理或异常处理的代码，是模板回调的设计模式思想。
public interface UserMapper { User selectById(Long id); int insert(User user);}<mapper namespace="com.example.mapper.UserMapper"> <select id="selectById" parameterType="long" resultType="com.example.model.User"> SELECT id, username, email FROM users WHERE id = #{id} </select>
<insert id="insert" parameterType="com.example.model.User" useGeneratedKeys="true" keyProperty="id"> INSERT INTO users(username,email) VALUES(#{username},#{email}) </insert></mapper>useGeneratedKeys=“true” 与 keyProperty 用于自增主键回填。
（三）注解方式
MyBatis支持在Mapper接口上用注解写SQL（@Select、@、@Update、@Delete），以及用@Results/@Result做映射。适合简单SQL。
public interface UserMapper {
@Select("SELECT id, username, email FROM users WHERE id = #{id}") User selectById(@Param("id") Long id);
@Insert("INSERT INTO users(username,email) VALUES(#{username},#{email})") @Options(useGeneratedKeys=true, keyProperty="id") int insert(User user);}不过还是推荐无论简单还是复杂SQL都统一使用XML实现，便于维护和管理。
（四）ResultMap
ResultType只适合简单唯一的对象。但是当列名和对象字段名不一致或者嵌套查询时，使用ResultMap配置返回对象会更加灵活。
<resultMap id="UserResultMap" type="com.example.model.User"> <id column="id" property="id"/> <result column="username" property="username"/> <result column="email" property="email"/> <collection property="posts" ofType="com.example.model.Post"> <id column="post_id" property="id"/> <result column="post_title" property="title"/> </collection></resultMap>
<select id="selectUserWithPosts" resultMap="UserResultMap" parameterType="long"> SELECT u.id, u.username, u.email, p.id AS post_id, p.title AS post_title FROM users u LEFT JOIN posts p ON p.user_id = u.id WHERE u.id = #{id}</select>不过最好还是使用别名，便于维护。
（五）#{}与${}
#{}是预编译占位符，会先将参数使用问号占位然后预编译SQL语句后才替换参数。
${}是替换符，是直接将参数拼接到SQL语句后编译，会有SQL注入风险，并不安全。
最佳实践是使用#{}进行动态传参，使用${}进行关键字的动态替换，例如ASC/DESC。
四、动态SQL
（一）XML动态标签
把SQL作为可组合的模板写在XML里，并在运行时根据参数拼接出最终SQL。MyBatis动态标签能避免手工拼字符串、并自动把参数用#{}绑定为预编译参数。
常见的动态标签如下：
- <if test=”…”>：按条件包含SQL片段。
- <where>：智能添加WHERE并自动去除多余前导AND/OR。
- <trim>：更通用的前后缀/前导处理。
- <set>：用于UPDATE的SET子句，自动处理末尾逗号。
- <foreach>：遍历集合。
- <choose> <when> <otherwise>：switch/if-else-if 结构。
- <bind name=“xxx” value=“someExp”/>：绑定一个变量，便于复用或构造 %…%。
- <sql id=“xxx”> / <include refid=“xxx”/>：复用 SQL 片段。
（二）注解方式
Mybatis同样支持以注解的方式编写动态SQL语句。
@Select({ "<script>", "SELECT * FROM users", "<where>", " <if test='name != null and name != \"\"'> AND username LIKE #{name} </if>", " <if test='status != null'> AND status = #{status} </if>", "</where>", "</script>"})List<User> search(@Param("name") String name, @Param("status") Integer status);不过可读性和可维护性都很差，不推荐这么写。
但Mybatis还支持使用Java静态方法编写动态SQL语句，不过更加麻烦，不如直接使用XML。
（三）的条件构造器
MyBatis-Plus提供链式、类型安全的条件构造器，大幅简化动态查询。
主要分为两种：QueryWrapper和 LambdaQueryWrapper。
QueryWrapper是通过字符串映射字段名，在重构或增强的时候都得变动这个条件构造器，违反了开闭原则。
而LambdaQueryWrapper支持使用lambda表达式映射字段名，便于重构和增强。
这两种条件构造器都支持链式调用API动态编写SQL语句，无需使用XML和注释，方便又美观。
五、事务管理
MyBatis本身通过SqlSession本地事务。在单独使用MyBatis时我们需要手动控制事务。
不过如果是在Spring环境下，还是建议将Mybatis的事务管理权交给Spring容器进行统一管理，所以这里并没有太多需要说明的点，因为Mybatis原生的事务管理极少使用。
六、缓存机制
（一）一级缓存
一级缓存是MyBatis内置的、每个SqlSession范围的缓存。只要使用同一个SqlSession多次执行相同查询，MyBatis会返回缓存结果，从而节省磁盘和网络IO。
但在以下情况下，一级缓存会失效或是被清空：
- 在同一个SqlSession中执行了insert/update/delete语句。
- 手动调用sqlSession.clearCache()。
- 使用了不同的查询参数或不同的SQL语句ID。
- 配置localCacheScope=STATEMENT。
注意不要将一级缓存跨线程使用，因为SqlSession是多例，会造成线程污染或者逻辑错误问题。
（二）二级缓存
二级缓存是MyBatis提供的可选缓存，按Mapper的namespace为单位共享。缓存跨SqlSession、跨请求有效。
（三）与缓存一致性
一级缓存是单线程有效，天然线程安全且保障缓存一致性。
二级缓存虽然可以跨线程，但是仅限于单JVM。在分布式架构下会出现脏读问题：节点A缓存了旧值，节点B清理了旧值，那么两个节点执行同一个SQL语句就可能出现查询结果不一致的情况。
虽然也有解决办法，但是比较麻烦且效果并不是很好，所以我们一般不启用Mybatis的二级缓存，而是使用Redis作为核心缓存层。
七、MyBatis-Plus的增强功能
（一）ActiveRecord
ActiveRecord是一种把“数据 + 持久化方法”放在同一个实体类里的风格。MyBatis-Plus提供了Model<T>基类，实体继承后可以直接调用insert()、updateById()、selectById()、deleteById()等方法，从而省去写Mapper/Service的部分样板代码。
public class User extends Model<User> { @TableId(type = IdType.AUTO) private Long id; private String username; private String email;}User u = new User();u.setUsername("alice");u.setEmail("a@example.com");u.insert();
User db = new User().selectById(1L);db.setEmail("b@example.com");db.updateById();虽然确实很方便简洁，但是违反了我们的单一职责原则，不应该在pojo层缝合进dao层，而是应该做到职责分层。
只推荐开发个人项目图方便时使用，大型项目还是规范编码为重。
（二）自动CRUD
MyBatis-Plus的BaseMapper<T>提供一整套通用方法，只需定义Mapper接口继承它即可复用 CRUD。
@Mapperpublic interface UserMapper extends BaseMapper<User> {}
@Servicepublic class UserServiceImpl extends ServiceImpl<UserMapper,User> implements UserService { @Autowired private UserMapper userMapper;
private UserVO findUser(Lonh userId){ User u = userMapper.selectById(userId); return BeanUtil.toBean(u, User.class); }}使用这个方式可以无需手动编写SQL语句，上文提到的条件构造器也是相同的效果。
（三）乐观锁
只要在实体和数据表中加上版本号字段，注册一个OptimisticLockerInnerInterceptor后，每当使用Mybatis-Plus自带的update方法，Mybatis-Plus就会自动在查询条件中带上version，并且在执行成功后自动更新version。
public class User { private Long id; private String name; @Version private Integer version;}@Beanpublic MybatisPlusInterceptor mybatisPlusInterceptor() { MybatisPlusInterceptor interceptor = new MybatisPlusInterceptor(); interceptor.addInnerInterceptor(new OptimisticLockerInnerInterceptor()); return interceptor;}（四）逻辑删除
通过标记字段而不是物理删除记录。MyBatis-Plus自动在查询中附加 deleted = 0条件，并在删除操作时执行更新修改删除标志，而不会真的删除元数据。
public class User { private Long id; private String name; @TableLogic(value = "0", delval = "1") private Integer deleted;}MyBatis-Plus在执行deleteById(id)的时候，会执行UPDATE table SET deleted = delval WHERE id = ?这条语句，而不是DELETE。
需要物理删除的话则需要自己编写额外的SQL语句。
（五）元对象自动填充
通过配置，Mybatis-Plus会用于自动填充createTime、updateTime等字段，避免在每个 insert/update 中重复赋值。
@Componentpublic class MyMetaObjectHandler implements MetaObjectHandler { @Override public void insertFill(MetaObject metaObject) { this.strictInsertFill(metaObject, "createTime", LocalDateTime.class, LocalDateTime.now()); this.strictInsertFill(metaObject, "updateTime", LocalDateTime.class, LocalDateTime.now()); }
@Override public void updateFill(MetaObject metaObject) { this.strictUpdateFill(metaObject, "updateTime", LocalDateTime.class, LocalDateTime.now()); }}@TableField(fill = FieldFill.INSERT)private LocalDateTime createTime;
@TableField(fill = FieldFill.INSERT_UPDATE)private LocalDateTime updateTime;（六）内置分页
分页基于Page<T>与IPage<T>，需注册分页内置拦截器。
@Beanpublic MybatisPlusInterceptor mybatisPlusInterceptor() { MybatisPlusInterceptor interceptor = new MybatisPlusInterceptor(); interceptor.addInnerInterceptor(new PaginationInnerInterceptor(DbType.MYSQL)); return interceptor;}
public IPage<User> pageUser(int pageNo, int pageSize){ Page<User> page = new Page<>(pageNo, pageSize); IPage<User> result = userMapper.selectPage(page, Wrappers. <User>lambdaQuery().eq(User::getStatus, 1)); List<User> records = result.getRecords(); long total = result.getTotal(); result.setRecord(records); rsult.setTotal(total); return result;}码文不易，留个赞再走吧
原文链接: 带你轻松学习MyBatis 作者: Yilena
如果这篇文章对你有帮助，欢迎分享给更多人！
部分信息可能已经过时