MyBatis 是一个流行的 Java 持久层框架，用于简化数据库交互的开发工作。与 JPA（Java Persistence API）或 Hibernate 等 ORM（对象关系映射）框架相比，MyBatis 提供了更细粒度的控制，尤其适用于那些需要灵活 SQL 语句或复杂查询的场景。在这篇博客中，我们将详细介绍 MyBatis 的核心概念、配置、常用功能以及如何在 Java 项目中使用 MyBatis。
1. MyBatis 简介
MyBatis 是一款支持自定义 SQL、存储过程以及高级映射的持久层框架。它的核心是通过映射文件将 Java 对象与数据库中的记录相互转换。与 Hibernate 等 ORM 框架相比，MyBatis 给予开发者更大的 SQL 控制权，并允许开发者直接编写 SQL 语句，避免了 ORM 框架中自动生成的 SQL 可能存在的问题。
MyBatis 特性
- 手写 SQL：开发者可以完全控制 SQL 语句，尤其是复杂查询。
- 支持存储过程：除了基本的 CRUD 操作，MyBatis 还支持调用存储过程。
- 动态 SQL：提供动态生成 SQL 的功能，支持
<if>、<choose>等标签来动态拼接 SQL。 - 自动映射：可以自动将查询结果集映射到 Java 对象。
2. MyBatis 核心原理
MyBatis 的核心原理是 映射器（Mapper）和 SQL 会话（SqlSession）。通过 Mapper 映射文件，将 Java 对象与 SQL 查询结果进行映射。MyBatis 使用 XML 配置文件或注解来定义 SQL 映射关系。
核心组件
- SqlSessionFactory：工厂类，用于创建
SqlSession实例，SqlSession是 MyBatis 的核心，用于执行 SQL 语句。 - SqlSession：主要用于执行 SQL 语句、获取映射器、提交事务等操作。
- Mapper：用于定义 SQL 与 Java 方法的映射关系。MyBatis 可以通过 XML 或注解来定义映射。
3. MyBatis 配置文件
MyBatis 的配置文件 mybatis-config.xml 定义了 MyBatis 的一些基本配置信息，包括数据库连接、映射器路径、缓存设置等。
配置文件示例
<?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>
<!-- 配置数据源 -->
<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/mydb"/>
<property name="username" value="root"/>
<property name="password" value="password"/>
</dataSource>
</environment>
</environments>
<!-- 配置别名 -->
<typeAliases>
<typeAlias alias="User" type="com.example.domain.User"/>
</typeAliases>
<!-- 配置映射文件 -->
<mappers>
<mapper resource="com/example/mapper/UserMapper.xml"/>
</mappers>
</configuration>
在这个配置文件中，我们配置了 MyBatis 的数据库连接信息和映射文件位置。<mappers> 标签指向具体的映射文件（XML），该文件定义了 SQL 查询与 Java 方法的映射关系。
4. MyBatis 映射器
MyBatis 映射器（Mapper）是 SQL 与 Java 方法之间的桥梁。你可以使用 XML 配置文件或者注解来定义映射。
XML 映射文件示例
假设我们有一个 User 对象，以下是对应的 Mapper XML 配置。
<mapper namespace="com.example.mapper.UserMapper">
<!-- 查询用户 -->
<select id="findUserById" resultType="com.example.domain.User">
SELECT id, name, age FROM users WHERE id = #{id}
</select>
<!-- 插入用户 -->
<insert id="insertUser">
INSERT INTO users (name, age) VALUES (#{name}, #{age})
</insert>
</mapper>
映射接口示例
与映射文件对应的 Java 接口如下：
public interface UserMapper {
User findUserById(int id);
void insertUser(User user);
}
在上述代码中，findUserById 方法与 XML 文件中的 <select> 标签对应，而 insertUser 方法与 <insert> 标签对应。MyBatis 会自动根据方法名和 XML 中的 SQL 映射进行连接。
5. 动态 SQL
MyBatis 支持动态 SQL，可以根据传入的参数动态构建 SQL 语句。常用的动态 SQL 标签有：
<if>：如果某个条件成立，才生成 SQL 语句的一部分。<choose>：选择某个条件生成 SQL。<foreach>：批量处理集合参数。<trim>：用于处理 SQL 的前缀和后缀。
动态 SQL 示例
<select id="findUsersByCondition" resultType="com.example.domain.User">
SELECT * FROM users
<where>
<if test="name != null">AND name = #{name}</if>
<if test="age != null">AND age = #{age}</if>
</where>
</select>
上述代码实现了根据 name 和 age 参数动态生成查询条件。
6. 事务管理
MyBatis 提供了两种事务管理方式：JDBC 事务和 MANAGED 事务（例如与 Spring 一起使用）。通常，我们会使用 Spring 提供的事务管理。
使用 Spring 管理事务
如果在 Spring 项目中使用 MyBatis，可以通过 Spring 的 @Transactional 注解来管理事务：
@Service
public class UserService {
@Autowired
private UserMapper userMapper;
@Transactional
public void addUser(User user) {
userMapper.insertUser(user);
}
}
7. MyBatis 与 Spring 集成
在 Spring Boot 项目中，MyBatis 可以与 Spring 数据源和事务管理集成，简化开发。
Spring Boot 配置
mybatis:
mapper-locations: classpath:mapper/*.xml
type-aliases-package: com.example.domain
configuration:
map-underscore-to-camel-case: true
8. 性能优化技巧
- 懒加载：使用懒加载来延迟加载关联对象，避免不必要的查询。
- 批量处理：对于大量数据的插入或更新，可以使用批量操作提高效率。
- 缓存机制：MyBatis 支持一级缓存（SqlSession）和二级缓存（跨 Session）。
- SQL 优化：避免 N+1 查询问题，使用连接查询来减少数据库请求次数。