MyBatis 是一款优秀的持久层框架,它消除了几乎所有的 JDBC 代码和手动设置参数以及获取结果集的工作。MyBatis 可以使用简单的 XML 或注解用于配置和原始映射,将接口和 Java 的 POJOs(Plain Old Java Objects,普通的 Java 对象)映射成数据库中的记录。
MyBatis 入门教程
1. MyBatis 简介
MyBatis 是一个半自动的持久层框架,它将 SQL 映射成 Java 代码,简化了数据库操作。使用 MyBatis,你可以将 SQL 语句和 Java 代码分离,提高代码的可读性和可维护性。
2. 环境搭建
2.1 添加依赖
在 Maven 项目中,添加以下依赖到 pom.xml 文件中:
<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.2 配置数据库
在 application.properties 或 application.yml 文件中配置数据库连接信息:
# application.properties
jdbc.driver=com.mysql.cj.jdbc.Driver
jdbc.url=jdbc:mysql://localhost:3306/mybatis_example?useSSL=false&serverTimezone=UTC
jdbc.username=root
jdbc.password=root
3. 创建实体类和 Mapper 接口
创建一个实体类 User 和一个 Mapper 接口 UserMapper:
public class User {
private Integer id;
private String name;
private Integer age;
// 省略 getter 和 setter 方法
}
public interface UserMapper {
User selectById(Integer id);
}
4. 创建 Mapper XML 文件
在 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="selectById" resultType="com.example.User">
SELECT * FROM user WHERE id = #{id}
</select>
</mapper>
5. 配置 MyBatis
在 src/main/resources 目录下创建 mybatis-config.xml 文件,配置 MyBatis 核心配置:
<?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/mybatis_example?useSSL=false&serverTimezone=UTC"/>
<property name="username" value="root"/>
<property name="password" value="root"/>
</dataSource>
</environment>
</environments>
<mappers>
<mapper resource="com/example/mapper/UserMapper.xml"/>
</mappers>
</configuration>
6. 使用 MyBatis
在 Java 代码中,使用 SqlSessionFactoryBuilder 创建 SqlSessionFactory,然后使用 SqlSession 执行 SQL 映射:
public class Main {
public static void main(String[] args) throws IOException {
SqlSessionFactory sqlSessionFactory = new SqlSessionFactoryBuilder().build(new FileInputStream("src/main/resources/mybatis-config.xml"));
try (SqlSession sqlSession = sqlSessionFactory.openSession()) {
UserMapper userMapper = sqlSession.getMapper(UserMapper.class);
User user = userMapper.selectById(1);
System.out.println(user);
}
}
}
MyBatis 实战技巧
1. 使用注解替代 XML
MyBatis 支持使用注解代替 XML 进行映射配置。在 UserMapper 接口中,使用 @Select 注解替代 UserMapper.xml:
public interface UserMapper {
@Select("SELECT * FROM user WHERE id = #{id}")
User selectById(Integer id);
}
2. 使用动态 SQL
MyBatis 提供了动态 SQL 功能,可以根据条件动态构建 SQL 语句。例如,根据用户名查询用户:
public interface UserMapper {
@Select({
"<script>",
"SELECT * FROM user WHERE 1=1",
"<if test='name != null'>",
"AND name = #{name}",
"</if>",
"</script>"
})
List<User> selectByName(String name);
}
3. 使用分页插件
MyBatis 支持使用分页插件进行分页查询。在 mybatis-config.xml 文件中配置分页插件:
<plugins>
<plugin interceptor="com.github.pagehelper.PageInterceptor"/>
</plugins>
在查询时,使用 PageHelper 插件进行分页:
PageHelper.startPage(1, 10);
List<User> users = userMapper.selectByName(name);
4. 使用缓存
MyBatis 支持一级缓存和二级缓存。一级缓存默认开启,二级缓存需要手动开启。在 mybatis-config.xml 文件中配置二级缓存:
<settings>
<setting name="cacheEnabled" value="true"/>
</settings>
在 Mapper 接口中,使用 @Cache 注解配置缓存:
@CacheNamespace eviction="FIFO" flushInterval="60000" size="512" readOnly="true"/>
public interface UserMapper {
// ...
}
总结
MyBatis 是一款功能强大的持久层框架,可以帮助开发者提高开发效率。通过本文的介绍,相信你已经对 MyBatis 有了一定的了解。在实际开发中,不断学习和实践,掌握更多 MyBatis 的技巧,才能更好地发挥其优势。
