引言
MyBatis 是一个优秀的持久层框架,它消除了几乎所有的 JDBC 代码和手动设置参数以及获取结果集的过程。MyBatis 可以使用简单的 XML 或注解用于配置和原始映射,将接口和 Java 的 POJOs(Plain Old Java Objects,普通的 Java 对象)映射成数据库中的记录。
一、MyBatis 简介
1.1 MyBatis 概念
MyBatis 是一个半自动化的持久层框架,它使用 XML 或注解用于配置和原始映射,将接口和 Java 的 POJOs 映射成数据库中的记录。
1.2 MyBatis 特点
- 易学易用:MyBatis 的学习曲线相对较平缓,易于上手。
- 灵活的映射:支持 XML 和注解两种方式配置映射。
- 接口和 POJO:使用接口和 POJOs 映射数据库记录,无需编写繁琐的 JDBC 代码。
- 插件扩展:支持自定义插件进行扩展。
二、MyBatis 入门
2.1 环境搭建
2.1.1 创建项目
使用 Maven 创建一个 Java 项目,并添加 MyBatis 相关依赖。
<dependencies>
<dependency>
<groupId>org.mybatis</groupId>
<artifactId>mybatis</artifactId>
<version>3.5.6</version>
</dependency>
<!-- 数据库连接相关依赖 -->
<dependency>
<groupId>mysql</groupId>
<artifactId>mysql-connector-java</artifactId>
<version>8.0.23</version>
</dependency>
</dependencies>
2.1.2 配置数据库
配置数据库连接信息,如 JDBC 驱动、URL、用户名和密码等。
# db.properties
driver=com.mysql.cj.jdbc.Driver
url=jdbc:mysql://localhost:3306/mydb?useUnicode=true&characterEncoding=utf8&useSSL=false
username=root
password=root
2.1.3 创建 Mapper 接口和 XML 映射文件
创建一个 Mapper 接口,并编写对应的 XML 映射文件。
public interface UserMapper {
User getUserById(int id);
}
<mapper namespace="com.example.mapper.UserMapper">
<select id="getUserById" resultType="com.example.entity.User">
SELECT * FROM user WHERE id = #{id}
</select>
</mapper>
2.2 编写配置文件
创建 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="${driver}"/>
<property name="url" value="${url}"/>
<property name="username" value="${username}"/>
<property name="password" value="${password}"/>
</dataSource>
</environment>
</environments>
<mappers>
<mapper resource="com/example/mapper/UserMapper.xml"/>
</mappers>
</configuration>
2.3 编写代码调用
在业务代码中,创建 SqlSessionFactory 和 SqlSession,并使用 UserMapper 接口进行数据库操作。
public class Application {
public static void main(String[] args) {
try {
String resource = "mybatis-config.xml";
InputStream inputStream = Resources.getResourceAsStream(resource);
SqlSessionFactory sqlSessionFactory = new SqlSessionFactoryBuilder().build(inputStream);
try (SqlSession session = sqlSessionFactory.openSession()) {
UserMapper mapper = session.getMapper(UserMapper.class);
User user = mapper.getUserById(1);
System.out.println(user);
}
} catch (Exception e) {
e.printStackTrace();
}
}
}
三、MyBatis 进阶
3.1 映射文件标签
MyBatis 提供了丰富的标签用于映射 SQL 语句,以下是一些常用的标签:
<select>:用于查询操作。<insert>:用于插入操作。<update>:用于更新操作。<delete>:用于删除操作。<resultMap>:用于映射结果集到实体类。<parameterMap>:用于映射输入参数到实体类。
3.2 动态 SQL
MyBatis 支持动态 SQL,可以根据条件动态生成 SQL 语句。常用的动态 SQL 标签包括:
<if>:根据条件判断是否执行 SQL 语句。<choose>:类似于 Java 中的switch语句。<when>:类似于if语句。<otherwise>:类似于else语句。
3.3 缓存机制
MyBatis 提供了两种缓存机制:
- 一级缓存:SqlSession 级别的缓存,用于缓存当前会话中查询到的数据。
- 二级缓存:SqlSessionFactory 级别的缓存,用于缓存整个应用程序中的数据。
四、总结
MyBatis 是一个功能强大、易学易用的持久层框架。通过本文的介绍,相信读者已经对 MyBatis 有了一定的了解。在实际开发中,可以根据需求选择合适的配置方式和扩展功能,使 MyBatis 发挥最大的作用。
