MyBatis 是一款优秀的持久层框架,它消除了几乎所有的 JDBC 代码和手动设置参数以及获取结果集的过程。MyBatis 可以使用简单的 XML 或注解用于配置和原始映射,将接口和 Java 的 POJOs(Plain Old Java Objects,普通的 Java 对象)映射成数据库中的记录。
MyBatis 简介
在进入实战之前,让我们先来了解一下 MyBatis 的核心概念和优势。
MyBatis 的优势
- 易于上手:MyBatis 可以快速上手,特别是对于熟悉 JDBC 开发的开发者来说。
- 接口和 Java 对象映射:无需编写 SQL 语句,只需定义接口和 Java 对象,MyBatis 会根据接口生成相应的 SQL 语句。
- 动态 SQL:支持动态 SQL,可以根据不同的条件生成不同的 SQL 语句。
- 内置类型处理器:提供丰富的内置类型处理器,可以轻松映射各种 Java 类型到 SQL 类型。
- 缓存机制:MyBatis 提供了一级和二级缓存机制,可以提高数据库访问效率。
MyBatis 的核心组件
- SqlSession:SqlSession 是 MyBatis 的核心接口,它包含执行 SQL 命令所需的所有方法。
- Executor:Executor 是 MyBatis 的核心处理对象,负责执行查询和更新操作。
- Mapped Statement:Mapped Statement 代表一个 SQL 映射语句,MyBatis 会为每个 SQL 映射语句生成一个 Mapped Statement。
- Mapper:Mapper 接口定义了需要执行的 SQL 命令,MyBatis 会为 Mapper 接口生成对应的实现。
MyBatis 入门
1. 创建 Maven 项目
首先,创建一个 Maven 项目,并在 pom.xml 文件中添加 MyBatis 的依赖。
<dependency>
<groupId>org.mybatis</groupId>
<artifactId>mybatis</artifactId>
<version>3.5.6</version>
</dependency>
2. 配置 MyBatis
创建一个 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.cj.jdbc.Driver"/>
<property name="url" value="jdbc:mysql://localhost:3306/mydb?useSSL=false"/>
<property name="username" value="root"/>
<property name="password" value=""/>
</dataSource>
</environment>
</environments>
<mappers>
<mapper resource="com/example/mapper/UserMapper.xml"/>
</mappers>
</configuration>
3. 创建 Mapper 文件
在 src/main/resources 目录下创建 UserMapper.xml 文件,配置 SQL 映射语句。
<?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">
<select id="selectUserById" resultType="com.example.User">
SELECT * FROM user WHERE id = #{id}
</select>
</mapper>
4. 创建 Mapper 接口
在 src/main/java 目录下创建 UserMapper.java 接口。
package com.example.mapper;
import com.example.User;
public interface UserMapper {
User selectUserById(int id);
}
5. 测试 MyBatis
在 src/test/java 目录下创建测试类,使用 MyBatis 执行 SQL 查询。
package com.example;
import org.apache.ibatis.session.SqlSession;
import org.apache.ibatis.session.SqlSessionFactory;
import org.apache.ibatis.session.SqlSessionFactoryBuilder;
import org.junit.Assert;
import org.junit.Test;
public class MyBatisTest {
@Test
public void testSelectUserById() {
try (SqlSession session = getSqlSessionFactory().openSession()) {
UserMapper mapper = session.getMapper(UserMapper.class);
User user = mapper.selectUserById(1);
Assert.assertEquals("John", user.getName());
}
}
private SqlSessionFactory getSqlSessionFactory() {
String resource = "mybatis-config.xml";
InputStream inputStream = Resources.getResourceAsStream(resource);
return new SqlSessionFactoryBuilder().build(inputStream);
}
}
MyBatis 实战
1. 动态 SQL
MyBatis 支持动态 SQL,可以根据不同的条件生成不同的 SQL 语句。
<select id="selectUsersByAge" resultType="com.example.User">
SELECT * FROM user
<where>
<if test="minAge != null">
AND age > #{minAge}
</if>
<if test="maxAge != null">
AND age < #{maxAge}
</if>
</where>
</select>
2. 一对多映射
MyBatis 支持复杂的关系映射,例如一对多。
<mapper namespace="com.example.mapper.UserMapper">
<resultMap id="userResultMap" type="com.example.User">
<id property="id" column="id"/>
<result property="name" column="name"/>
<result property="age" column="age"/>
<collection property="orders" ofType="com.example.Order">
<id property="id" column="order_id"/>
<result property="orderNumber" column="order_number"/>
<!-- 更多字段映射 -->
</collection>
</resultMap>
<select id="selectUserById" resultMap="userResultMap">
SELECT * FROM user WHERE id = #{id}
</select>
</mapper>
3. 使用注解代替 XML
MyBatis 也支持使用注解来配置映射语句。
@Mapper
public interface UserMapper {
@Select("SELECT * FROM user WHERE id = #{id}")
User selectUserById(@Param("id") int id);
}
通过以上入门和实战的介绍,相信你已经对 MyBatis 有了一定的了解。MyBatis 的灵活性和便捷性使得它在 Java 开发中得到了广泛的应用。希望这篇文章能够帮助你轻松搭建高效数据库应用。
