MyBatis 是一个优秀的持久层框架,它消除了几乎所有的 JDBC 代码和手动设置参数以及获取结果集的过程。MyBatis 可以使用简单的 XML 或注解用于配置和原始映射,将接口和 Java 的 POJOs(Plain Old Java Objects,普通的 Java对象)映射成数据库中的记录。
MyBatis 简介
MyBatis 本意是“my batty”,是一种“半自动”持久层框架。它将 SQL 映射逻辑与对象模型分离,使得开发者可以更加专注于业务逻辑的实现。MyBatis 的核心是 SQL 映射文件,它包含了 SQL 语句和映射规则。
入门步骤
1. 环境搭建
首先,需要搭建一个 Java 开发环境,并引入 MyBatis 相关的依赖。
<dependencies>
<dependency>
<groupId>org.mybatis</groupId>
<artifactId>mybatis</artifactId>
<version>3.5.7</version>
</dependency>
<dependency>
<groupId>mysql</groupId>
<artifactId>mysql-connector-java</artifactId>
<version>8.0.26</version>
</dependency>
</dependencies>
2. 配置文件
创建 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"/>
<property name="username" value="root"/>
<property name="password" value=""/>
</dataSource>
</environment>
</environments>
<mappers>
<mapper resource="com/example/mapper/UserMapper.xml"/>
</mappers>
</configuration>
3. 编写映射文件
创建 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="selectById" resultType="com.example.entity.User">
SELECT * FROM user WHERE id = #{id}
</select>
</mapper>
4. 编写接口
创建 UserMapper 接口,定义方法。
package com.example.mapper;
import com.example.entity.User;
import org.apache.ibatis.annotations.Mapper;
import org.apache.ibatis.annotations.Select;
@Mapper
public interface UserMapper {
User selectById(Long id);
}
5. 测试
在主程序中,通过 MyBatis 的 SqlSessionFactoryBuilder 创建 SqlSessionFactory,然后通过 SqlSessionFactory 创建 SqlSession,最后通过 SqlSession 执行 SQL 语句。
package com.example;
import com.example.mapper.UserMapper;
import org.apache.ibatis.session.SqlSession;
import org.apache.ibatis.session.SqlSessionFactory;
import org.apache.ibatis.session.SqlSessionFactoryBuilder;
public class Main {
public static void main(String[] args) {
try (SqlSessionFactory sqlSessionFactory = new SqlSessionFactoryBuilder().build()) {
try (SqlSession session = sqlSessionFactory.openSession()) {
UserMapper mapper = session.getMapper(UserMapper.class);
User user = mapper.selectById(1L);
System.out.println(user);
}
}
}
}
实践技巧
合理使用缓存:MyBatis 提供了一级缓存和二级缓存,可以有效提高查询效率。
动态 SQL:使用
<if>、<choose>、<when>、<otherwise>等标签实现动态 SQL,提高代码的可读性和可维护性。分页查询:使用
<select>标签的limit属性实现分页查询,避免一次性加载过多数据。参数传递:使用
@Param注解为参数命名,方便在 SQL 映射文件中引用。自定义结果映射:使用
<resultMap>标签自定义结果映射,处理复杂的结果集。插件扩展:MyBatis 提供了插件机制,可以自定义插件来扩展 MyBatis 的功能。
单元测试:编写单元测试,确保 MyBatis 映射文件的正确性和接口方法的实现。
通过以上步骤,您可以快速入门 MyBatis,并掌握其核心功能和实践技巧。在实际项目中,MyBatis 可以帮助您提高开发效率,降低数据库操作的复杂度。
