引言
MyBatis 是一个优秀的持久层框架,它消除了几乎所有的 JDBC 代码和手动设置参数以及获取结果集的过程。MyBatis 可以使用简单的 XML 或注解用于配置和原始映射,将接口和 Java 的 POJOs(Plain Old Java Objects,普通的 Java对象)映射成数据库中的记录。
本文将带你从入门到精通 MyBatis,通过实战案例教学,让你掌握这个强大的框架。
一、MyBatis 简介
1.1 什么是 MyBatis?
MyBatis 是一个半自动化的持久层框架,它消除了大部分 JDBC 代码和手动设置参数以及获取结果集的过程。MyBatis 可以使用简单的 XML 或注解用于配置和原始映射,将接口和 Java 的 POJOs 映射成数据库中的记录。
1.2 MyBatis 的优势
- 简化 JDBC 代码:MyBatis 自动处理数据库连接、事务管理、结果集解析等繁琐的工作。
- 灵活的映射配置:可以使用 XML 或注解进行映射配置,方便扩展和修改。
- 支持自定义 SQL:可以自定义 SQL 语句,实现复杂的查询和操作。
- 支持多种数据库:MyBatis 支持多种数据库,如 MySQL、Oracle、SQL Server 等。
二、MyBatis 入门
2.1 环境搭建
- 下载 MyBatis:从 MyBatis 官网下载最新版本的 MyBatis。
- 添加依赖:在项目的
pom.xml文件中添加 MyBatis 依赖。
<dependency>
<groupId>org.mybatis</groupId>
<artifactId>mybatis</artifactId>
<version>3.5.7</version>
</dependency>
- 配置 MyBatis:在项目的
src/main/resources目录下创建mybatis-config.xml文件,配置数据源、事务管理器等。
<?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.jdbc.Driver"/>
<property name="url" value="jdbc:mysql://localhost:3306/mybatis_db"/>
<property name="username" value="root"/>
<property name="password" value=""/>
</dataSource>
</environment>
</environments>
<mappers>
<mapper resource="com/mybatis/mapper/UserMapper.xml"/>
</mappers>
</configuration>
2.2 创建实体类和 Mapper 接口
- 创建实体类:定义一个与数据库表对应的 Java 类,如
User类。
public class User {
private Integer id;
private String name;
private Integer age;
// 省略 getter 和 setter 方法
}
- 创建 Mapper 接口:定义一个与实体类对应的 Mapper 接口,如
UserMapper接口。
public interface UserMapper {
User getUserById(Integer id);
}
2.3 编写 Mapper 映射文件
- 创建 Mapper 映射文件:在
src/main/resources目录下创建com/mybatis/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.mybatis.mapper.UserMapper">
<select id="getUserById" resultType="com.mybatis.entity.User">
SELECT * FROM user WHERE id = #{id}
</select>
</mapper>
- 配置 Mapper 接口:在
mybatis-config.xml文件中配置 Mapper 接口。
<mappers>
<mapper resource="com/mybatis/mapper/UserMapper.xml"/>
</mappers>
2.4 使用 MyBatis
- 创建 SqlSessionFactory:在
MyBatis的配置文件中创建SqlSessionFactory。
String resource = "mybatis-config.xml";
InputStream inputStream = Resources.getResourceAsStream(resource);
SqlSessionFactory sqlSessionFactory = new SqlSessionFactoryBuilder().build(inputStream);
- 获取 SqlSession:通过
SqlSessionFactory获取SqlSession。
SqlSession sqlSession = sqlSessionFactory.openSession();
- 执行查询:通过
SqlSession执行查询。
User user = sqlSession.selectOne("com.mybatis.mapper.UserMapper.getUserById", 1);
System.out.println(user);
- 关闭资源:关闭
SqlSession。
sqlSession.close();
三、MyBatis 高级特性
3.1 动态 SQL
MyBatis 支持动态 SQL,可以动态地构建 SQL 语句。
<select id="getUserByCondition" resultType="com.mybatis.entity.User">
SELECT * FROM user
<where>
<if test="name != null">
AND name = #{name}
</if>
<if test="age != null">
AND age = #{age}
</if>
</where>
</select>
3.2 缓存
MyBatis 支持一级缓存和二级缓存。
- 一级缓存:在同一个
SqlSession中,同一个 Mapper 接口的同一个方法调用返回相同的数据时,会从一级缓存中获取数据。 - 二级缓存:在同一个数据库的同一个 Mapper 接口的所有
SqlSession中,同一个 Mapper 接口的同一个方法调用返回相同的数据时,会从二级缓存中获取数据。
3.3 批处理
MyBatis 支持批处理,可以批量插入、更新、删除数据。
<insert id="batchInsertUsers" parameterType="java.util.List">
INSERT INTO user (name, age) VALUES
<foreach collection="list" item="user" separator=",">
(#{user.name}, #{user.age})
</foreach>
</insert>
四、实战案例
4.1 用户管理系统
- 需求分析:实现用户管理系统的基本功能,包括用户注册、登录、查询、修改、删除等。
- 数据库设计:设计用户表,包含用户名、密码、邮箱、手机号等字段。
- 实体类:定义
User类,包含用户的基本信息。 - Mapper 接口:定义
UserMapper接口,包含用户管理相关的操作。 - Mapper 映射文件:编写
UserMapper.xml文件,配置 SQL 语句。 - 服务层:编写
UserService类,实现用户管理相关的业务逻辑。 - 控制器:编写
UserController类,处理用户请求。
4.2 商品管理系统
- 需求分析:实现商品管理系统的基本功能,包括商品添加、修改、删除、查询等。
- 数据库设计:设计商品表,包含商品名称、价格、库存、描述等字段。
- 实体类:定义
Product类,包含商品的基本信息。 - Mapper 接口:定义
ProductMapper接口,包含商品管理相关的操作。 - Mapper 映射文件:编写
ProductMapper.xml文件,配置 SQL 语句。 - 服务层:编写
ProductService类,实现商品管理相关的业务逻辑。 - 控制器:编写
ProductController类,处理商品请求。
五、总结
MyBatis 是一个功能强大的持久层框架,它可以帮助开发者简化数据库操作,提高开发效率。通过本文的介绍,相信你已经对 MyBatis 有了一定的了解,并能将其应用到实际项目中。希望本文能帮助你快速掌握 MyBatis,成为一名优秀的 Java 开发者。
