MyBatis 是一个优秀的持久层框架,它消除了几乎所有的 JDBC 代码和手动设置参数以及获取结果集的工作。MyBatis 可以使用简单的 XML 或注解用于配置和原始映射,将接口和 Java 的 POJOs(Plain Old Java Objects,普通的 Java对象)映射成数据库中的记录。
快速上手
1. 环境搭建
首先,需要在项目中引入 MyBatis 的依赖。以下是一个简单的 Maven 依赖配置:
<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.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/test?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 接口
在 com.example.mapper 包下创建一个 UserMapper 接口,定义需要执行的 SQL 语句。
package com.example.mapper;
public interface UserMapper {
List<User> findAll();
}
4. 创建 Mapper XML 文件
在 com/example/mapper 包下创建一个 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="findAll" resultType="com.example.entity.User">
SELECT * FROM user
</select>
</mapper>
5. 使用 MyBatis
在 Java 代码中,创建 SqlSessionFactory 和 SqlSession 对象,然后使用 SqlSession 执行 SQL 语句。
package com.example;
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("mybatis-config.xml")) {
try (SqlSession session = sqlSessionFactory.openSession()) {
UserMapper userMapper = session.getMapper(UserMapper.class);
List<User> users = userMapper.findAll();
for (User user : users) {
System.out.println(user);
}
}
}
}
}
实践技巧
1. 使用注解代替 XML
MyBatis 支持使用注解来替代 XML 配置。以下是一个使用注解的例子:
package com.example.mapper;
import org.apache.ibatis.annotations.Mapper;
import org.apache.ibatis.annotations.Select;
import java.util.List;
@Mapper
public interface UserMapper {
@Select("SELECT * FROM user")
List<User> findAll();
}
2. 使用动态 SQL
MyBatis 支持使用动态 SQL 来构建复杂的 SQL 语句。以下是一个使用动态 SQL 的例子:
<select id="findUsersByCondition" resultType="com.example.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. 使用缓存
MyBatis 支持使用一级缓存和二级缓存来提高性能。以下是一个使用一级缓存的例子:
package com.example.mapper;
import org.apache.ibatis.annotations.CacheNamespace;
import org.apache.ibatis.annotations.Mapper;
import org.apache.ibatis.annotations.Select;
import java.util.List;
@Mapper
@CacheNamespace(eviction = CacheEviction.FIFO, flushInterval = 60000, size = 512, readWrite = true)
public interface UserMapper {
@Select("SELECT * FROM user")
List<User> findAll();
}
常见问题解决
1. 数据库连接失败
检查数据库连接信息是否正确,包括驱动、URL、用户名和密码等。
2. SQL 执行失败
检查 SQL 语句是否正确,包括语法和参数类型等。
3. 映射文件找不到
检查映射文件路径是否正确,以及文件名是否与 Mapper 接口名称一致。
4. 无法获取结果集
检查返回类型是否正确,以及 SQL 语句是否返回了正确的数据。
MyBatis 是一个功能强大的持久层框架,通过以上内容,相信你已经对 MyBatis 有了一个深入的了解。在实际开发过程中,不断积累经验,掌握更多实践技巧,才能更好地发挥 MyBatis 的优势。
