MyBatis 是一个优秀的持久层框架,它消除了几乎所有的 JDBC 代码和手动设置参数以及获取结果集的过程。MyBatis 可以使用简单的 XML 或注解用于配置和原始映射,将接口和 Java 的 POJOs(Plain Old Java Objects,普通的 Java对象)映射成数据库中的记录。
一、MyBatis 简介
MyBatis 允许你完全控制 SQL 的映射过程,并且支持高级映射功能,如关联、集合和继承。MyBatis 的设计哲学是“半自动”,它不会为你处理所有的事情,而是提供了一种灵活的方式来处理大多数常见场景。
1.1 MyBatis 的优势
- 简化开发:减少了 JDBC 编码和手动处理数据库连接的工作。
- 灵活配置:使用 XML 或注解配置 SQL 映射,易于理解和维护。
- 高级映射功能:支持复杂的关系映射,如关联、集合和继承。
- 支持多种数据库:适用于多种数据库,如 MySQL、Oracle、SQL Server 等。
1.2 MyBatis 的使用场景
- 小到中型的应用:MyBatis 的轻量级和灵活性使其成为小型到中型应用的理想选择。
- 复杂 SQL 查询:MyBatis 提供了强大的 SQL 映射功能,适用于复杂的 SQL 查询。
- 自定义 SQL:对于需要自定义 SQL 逻辑的场景,MyBatis 提供了丰富的自定义功能。
二、MyBatis 入门
2.1 环境搭建
- 添加依赖:在 Maven 项目中添加 MyBatis 依赖。
<dependency>
<groupId>org.mybatis</groupId>
<artifactId>mybatis</artifactId>
<version>3.5.6</version>
</dependency>
- 配置数据源:在
application.properties或application.yml中配置数据库连接信息。
# application.properties
jdbc.driver=com.mysql.jdbc.Driver
jdbc.url=jdbc:mysql://localhost:3306/mydb?useSSL=false
jdbc.username=root
jdbc.password=root
- 创建 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="${jdbc.driver}"/>
<property name="url" value="${jdbc.url}"/>
<property name="username" value="${jdbc.username}"/>
<property name="password" value="${jdbc.password}"/>
</dataSource>
</environment>
</environments>
<mappers>
<mapper resource="com/example/mapper/UserMapper.xml"/>
</mappers>
</configuration>
2.2 编写 Mapper 接口和 XML 映射文件
- 创建 Mapper 接口:定义数据库操作的接口。
package com.example.mapper;
import com.example.entity.User;
public interface UserMapper {
User getUserById(Integer id);
}
- 编写 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="getUserById" resultType="com.example.entity.User">
SELECT * FROM user WHERE id = #{id}
</select>
</mapper>
2.3 使用 MyBatis
- 创建 SqlSessionFactory:
String resource = "mybatis-config.xml";
InputStream inputStream = Resources.getResourceAsStream(resource);
SqlSessionFactory sqlSessionFactory = new SqlSessionFactoryBuilder().build(inputStream);
- 获取 SqlSession:
SqlSession sqlSession = sqlSessionFactory.openSession();
- 执行 SQL 映射:
User user = sqlSession.selectOne("com.example.mapper.UserMapper.getUserById", 1);
- 关闭 SqlSession:
sqlSession.close();
三、MyBatis 进阶
3.1 映射关系
MyBatis 支持多种关系映射,包括一对一、一对多、多对多和集合映射。
3.1.1 一对一映射
<mapper namespace="com.example.mapper.UserMapper">
<resultMap id="userMap" type="com.example.entity.User">
<id property="id" column="id"/>
<result property="name" column="name"/>
<association property="address" javaType="com.example.entity.Address">
<id property="id" column="address_id"/>
<result property="city" column="city"/>
</association>
</resultMap>
<select id="getUserById" resultMap="userMap">
SELECT u.id, u.name, a.id as address_id, a.city
FROM user u
LEFT JOIN address a ON u.id = a.user_id
WHERE u.id = #{id}
</select>
</mapper>
3.1.2 一对多映射
<mapper namespace="com.example.mapper.UserMapper">
<resultMap id="userMap" type="com.example.entity.User">
<id property="id" column="id"/>
<result property="name" column="name"/>
<collection property="orders" ofType="com.example.entity.Order">
<id property="id" column="order_id"/>
<result property="orderNumber" column="order_number"/>
</collection>
</resultMap>
<select id="getUserById" resultMap="userMap">
SELECT u.id, u.name, o.id as order_id, o.order_number
FROM user u
LEFT JOIN order o ON u.id = o.user_id
WHERE u.id = #{id}
</select>
</mapper>
3.1.3 多对多映射
多对多映射通常通过中间表来实现。
<mapper namespace="com.example.mapper.UserMapper">
<resultMap id="userMap" type="com.example.entity.User">
<id property="id" column="id"/>
<result property="name" column="name"/>
<collection property="roles" ofType="com.example.entity.Role">
<id property="id" column="role_id"/>
<result property="name" column="role_name"/>
</collection>
</resultMap>
<select id="getUserById" resultMap="userMap">
SELECT u.id, u.name, r.id as role_id, r.name as role_name
FROM user u
LEFT JOIN user_role ur ON u.id = ur.user_id
LEFT JOIN role r ON ur.role_id = r.id
WHERE u.id = #{id}
</select>
</mapper>
3.2 插入、更新和删除
MyBatis 提供了丰富的 SQL 映射功能,包括插入、更新和删除操作。
3.2.1 插入操作
<mapper namespace="com.example.mapper.UserMapper">
<insert id="insertUser" parameterType="com.example.entity.User">
INSERT INTO user (name, age) VALUES (#{name}, #{age})
</insert>
</mapper>
3.2.2 更新操作
<mapper namespace="com.example.mapper.UserMapper">
<update id="updateUser" parameterType="com.example.entity.User">
UPDATE user SET name = #{name}, age = #{age} WHERE id = #{id}
</update>
</mapper>
3.2.3 删除操作
<mapper namespace="com.example.mapper.UserMapper">
<delete id="deleteUser" parameterType="int">
DELETE FROM user WHERE id = #{id}
</delete>
</mapper>
3.3 分页查询
MyBatis 支持分页查询,可以通过插件或手动编写分页 SQL 实现分页功能。
3.3.1 手动分页
<mapper namespace="com.example.mapper.UserMapper">
<select id="getUserByPage" resultType="com.example.entity.User">
SELECT * FROM user LIMIT #{offset}, #{pageSize}
</select>
</mapper>
3.3.2 插件分页
使用分页插件,如 PageHelper,可以简化分页查询的实现。
PageHelper.startPage(1, 10);
List<User> users = sqlSession.selectList("com.example.mapper.UserMapper.getUserByPage");
四、MyBatis 高级特性
4.1 动态 SQL
MyBatis 支持动态 SQL,可以灵活地编写条件查询。
<mapper namespace="com.example.mapper.UserMapper">
<select id="getUserByCondition" resultType="com.example.entity.User">
SELECT * FROM user
<where>
<if test="name != null and name != ''">
AND name = #{name}
</if>
<if test="age != null">
AND age = #{age}
</if>
</where>
</select>
</mapper>
4.2 事务管理
MyBatis 支持事务管理,可以与 Spring 等框架集成使用。
SqlSession sqlSession = sqlSessionFactory.openSession(ExecutorType.BATCH);
try {
// 执行 SQL 操作
sqlSession.commit();
} catch (Exception e) {
sqlSession.rollback();
} finally {
sqlSession.close();
}
4.3 缓存机制
MyBatis 支持一级缓存和二级缓存,可以提高数据库操作的效率。
<cache eviction="FIFO" flushInterval="60000" size="512" readOnly="true"/>
五、总结
MyBatis 是一个功能强大的持久层框架,可以帮助开发者简化数据库操作。通过本文的介绍,相信你已经对 MyBatis 有了一定的了解。在实际项目中,你需要不断学习和实践,掌握 MyBatis 的更多高级特性,从而提高开发效率。
