MyBatis
2023/1/1大约 6 分钟
MyBatis基本概念和功能
MyBatis是一款优秀的持久层框架，它支持自定义SQL、存储过程以及高级映射。MyBatis消除了几乎所有的JDBC代码和手动设置参数以及获取结果集的工作。下面是MyBatis的基本概念和功能：
- SQL映射：MyBatis提供了SQL映射功能，可以将SQL语句配置在XML文件或注解中，实现SQL与Java代码的分离。
- 参数映射：MyBatis提供了参数映射功能，可以将Java对象自动映射为SQL语句的参数。
- 结果映射：MyBatis提供了结果映射功能，可以将数据库查询结果自动映射为Java对象。
- 动态SQL：MyBatis提供了动态SQL功能，可以根据条件动态生成SQL语句，提高SQL的灵活性。
- 缓存机制：MyBatis提供了一级缓存和二级缓存机制，可以提高查询性能。
为什么要用MyBatis？
使用MyBatis有以下几个优点：
- 简单易学：MyBatis相对于Hibernate等ORM框架更加简单，学习成本低，开发者可以快速上手。
- 灵活性高：MyBatis允许开发者编写原生的SQL语句，可以充分发挥SQL的优势，满足复杂的查询需求。
- SQL与代码分离：MyBatis将SQL语句配置在XML文件中，实现了SQL与Java代码的分离，便于维护和管理。
- 性能优化：MyBatis支持动态SQL和缓存机制，可以根据业务需求优化SQL性能。
- 易于集成：MyBatis可以与Spring、Spring Boot等框架无缝集成，简化开发流程。
总之，使用MyBatis可以帮助开发者简化数据库操作，提高开发效率，同时保持SQL的灵活性。
MyBatis应用场景
MyBatis主要应用于需要精细控制SQL的场景，如复杂的报表查询、多表关联查询、存储过程调用等，适合对SQL性能有较高要求的项目。
MyBatis核心组件
MyBatis的核心组件包括：
- SqlSessionFactory：SqlSessionFactory是MyBatis的核心对象，用于创建SqlSession对象。SqlSessionFactory是通过SqlSessionFactoryBuilder创建的，通常在应用启动时创建一个单例实例。
- SqlSession：SqlSession是MyBatis的会话对象，用于执行SQL语句、获取Mapper接口、管理事务等。SqlSession不是线程安全的，应该在使用后及时关闭。
- Mapper接口：Mapper接口是MyBatis的映射接口，用于定义数据库操作方法。Mapper接口的方法可以通过XML配置或注解实现。
- XML配置文件：MyBatis的XML配置文件用于配置数据源、事务管理器、类型别名、插件等信息。
- XML映射文件：MyBatis的XML映射文件用于配置SQL语句、参数映射、结果映射等信息。
MyBatis核心架构图
+------------------+ +------------------+ +------------------+
| Application | | Application | | Application |
| | | | | |
+------------------+ +------------------+ +------------------+
| | |
| | |
| | |
+------------------+ +------------------+ +------------------+
| SqlSession | | SqlSession | | SqlSession |
| | | | | |
+------------------+ +------------------+ +------------------+
| | |
| | |
| | |
+------------------+ +------------------+ +------------------+
| Executor | | Executor | | Executor |
| (执行器) | | (执行器) | | (执行器) |
+------------------+ +------------------+ +------------------+
| | |
| | |
| | |
+------------------+ +------------------+ +------------------+
| StatementHandler| | StatementHandler| | StatementHandler|
| (语句处理器) | | (语句处理器) | | (语句处理器) |
+------------------+ +------------------+ +------------------+
| | |
| | |
| | |
+------------------+ +------------------+ +------------------+
| Parameter | | Result | | Type |
| Handler | | Handler | | Handler |
| (参数处理器) | | (结果处理器) | | (类型处理器) |
+------------------+ +------------------+ +------------------+
| | |
| | |
| | |
+------------------+ +------------------+ +------------------+
| Database | | Database | | Database |
| (数据库) | | (数据库) | | (数据库) |
+------------------+ +------------------+ +------------------+在上面的架构图中，展示了MyBatis的核心组件之间的关系：SqlSession通过Executor执行SQL，Executor通过StatementHandler处理SQL语句，StatementHandler通过ParameterHandler设置参数，通过ResultHandler处理结果，通过TypeHandler进行类型转换。
MyBatis快速入门
1、添加依赖
<dependency>
<groupId>org.mybatis.spring.boot</groupId>
<artifactId>mybatis-spring-boot-starter</artifactId>
<version>3.0.3</version>
</dependency>
<dependency>
<groupId>mysql</groupId>
<artifactId>mysql-connector-java</artifactId>
<version>8.0.33</version>
</dependency>2、配置数据源
在application.yml中配置数据源：
spring:
datasource:
driver-class-name: com.mysql.cj.jdbc.Driver
url: jdbc:mysql://localhost:3306/mydb?useUnicode=true&characterEncoding=utf8&useSSL=false&serverTimezone=GMT%2B8
username: root
password: 123456
mybatis:
mapper-locations: classpath:mapper/*.xml
type-aliases-package: com.example.entity
configuration:
map-underscore-to-camel-case: true3、创建实体类
public class User {
private Long id;
private String username;
private String password;
private String email;
// getter和setter方法
}4、创建Mapper接口
@Mapper
public interface UserMapper {
User findById(Long id);
List<User> findAll();
int insert(User user);
int update(User user);
int delete(Long id);
}5、创建XML映射文件
在resources/mapper目录下创建UserMapper.xml：
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE mapper PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN"
"http://mybatis.org/dtd/mybatis-3-mapper.dtd">
<mapper namespace="com.example.mapper.UserMapper">
<resultMap id="BaseResultMap" type="com.example.entity.User">
<id column="id" property="id" jdbcType="BIGINT"/>
<result column="username" property="username" jdbcType="VARCHAR"/>
<result column="password" property="password" jdbcType="VARCHAR"/>
<result column="email" property="email" jdbcType="VARCHAR"/>
</resultMap>
<select id="findById" resultMap="BaseResultMap">
SELECT * FROM user WHERE id = #{id}
</select>
<select id="findAll" resultMap="BaseResultMap">
SELECT * FROM user
</select>
<insert id="insert" parameterType="com.example.entity.User">
INSERT INTO user (username, password, email)
VALUES (#{username}, #{password}, #{email})
</insert>
<update id="update" parameterType="com.example.entity.User">
UPDATE user
SET username = #{username},
password = #{password},
email = #{email}
WHERE id = #{id}
</update>
<delete id="delete">
DELETE FROM user WHERE id = #{id}
</delete>
</mapper>6、使用Mapper
@Service
public class UserService {
@Autowired
private UserMapper userMapper;
public User findById(Long id) {
return userMapper.findById(id);
}
public List<User> findAll() {
return userMapper.findAll();
}
public int insert(User user) {
return userMapper.insert(user);
}
public int update(User user) {
return userMapper.update(user);
}
public int delete(Long id) {
return userMapper.delete(id);
}
}MyBatis动态SQL
MyBatis提供了强大的动态SQL功能，可以根据条件动态生成SQL语句。
if标签
<select id="findByCondition" resultMap="BaseResultMap">
SELECT * FROM user
<where>
<if test="username != null">
AND username = #{username}
</if>
<if test="email != null">
AND email = #{email}
</if>
</where>
</select>choose标签
<select id="findByCondition" resultMap="BaseResultMap">
SELECT * FROM user
<where>
<choose>
<when test="username != null">
AND username = #{username}
</when>
<when test="email != null">
AND email = #{email}
</when>
<otherwise>
AND 1=1
</otherwise>
</choose>
</where>
</select>foreach标签
<select id="findByIds" resultMap="BaseResultMap">
SELECT * FROM user
WHERE id IN
<foreach collection="ids" item="id" open="(" separator="," close=")">
#{id}
</foreach>
</select>MyBatis缓存机制
MyBatis提供了一级缓存和二级缓存机制，可以提高查询性能。
一级缓存
一级缓存是SqlSession级别的缓存，默认开启。在同一个SqlSession中，相同的查询语句只会执行一次数据库查询，后续查询会从缓存中获取。
二级缓存
二级缓存是namespace级别的缓存，需要手动开启。在同一个namespace中，不同的SqlSession可以共享缓存。
开启二级缓存：
- 在MyBatis配置文件中开启二级缓存：
<settings>
<setting name="cacheEnabled" value="true"/>
</settings>- 在Mapper XML文件中配置缓存：
<cache eviction="LRU" flushInterval="60000" size="512" readOnly="true"/>MyBatis插件机制
MyBatis提供了插件机制，可以在SQL执行的各个阶段进行拦截和增强。
自定义插件
@Intercepts({
@Signature(type= Executor.class, method = "update", args = {MappedStatement.class, Object.class})
})
public class MyPlugin implements Interceptor {
@Override
public Object intercept(Invocation invocation) throws Throwable {
// 前置处理
System.out.println("执行SQL前...");
// 执行原方法
Object result = invocation.proceed();
// 后置处理
System.out.println("执行SQL后...");
return result;
}
}注册插件
在MyBatis配置文件中注册插件：
<plugins>
<plugin interceptor="com.example.plugin.MyPlugin"/>
</plugins>参考链接
https://mybatis.org/mybatis-3/zh/index.html
https://mybatis.org/spring-boot-starter/mybatis-spring-boot-autoconfigure/
贡献者
cmyshare