引言
MyBatis 是一款优秀的持久层框架,它消除了几乎所有的 JDBC 代码和手动设置参数以及获取结果集的过程。MyBatis 可以使用简单的 XML 或注解用于配置和原始映射,将接口和 Java 的 POJOs(Plain Old Java Objects,普通的 Java对象)映射成数据库中的记录。
本文将带您从入门到实战,深入探讨 MyBatis 的使用方法,包括其在项目中的应用。
一、MyBatis 入门攻略
1.1 环境搭建
首先,您需要在项目中引入 MyBatis 的依赖。这里以 Maven 为例,在 pom.xml 文件中添加以下依赖:
<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>
1.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"/>
<property name="username" value="root"/>
<property name="password" value=""/>
</dataSource>
</environment>
</environments>
<mappers>
<mapper resource="com/example/mapper/UserMapper.xml"/>
</mappers>
</configuration>
1.3 映射文件
映射文件用于定义 SQL 语句与 Java 对象的映射关系。以下是一个简单的用户映射文件示例:
<?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>
1.4 接口定义
定义一个 Mapper 接口,其中包含 SQL 语句对应的抽象方法。
package com.example.mapper;
public interface UserMapper {
User selectById(Integer id);
}
1.5 测试
在测试类中,通过 SqlSessionFactoryBuilder 创建 SqlSessionFactory,再通过 SqlSessionFactory 创建 SqlSession,最后通过 SqlSession 执行 SQL 语句。
package com.example.test;
import com.example.mapper.UserMapper;
import com.example.entity.User;
import org.apache.ibatis.session.SqlSession;
import org.apache.ibatis.session.SqlSessionFactory;
import org.apache.ibatis.session.SqlSessionFactoryBuilder;
public class MyBatisTest {
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(1);
System.out.println(user);
}
}
}
}
二、MyBatis 实战技巧
2.1 动态 SQL
MyBatis 提供了动态 SQL 的功能,可以方便地实现条件判断、循环等复杂 SQL 语句。
<select id="selectByCondition" resultType="com.example.entity.User">
SELECT * FROM user
<where>
<if test="id != null">
AND id = #{id}
</if>
<if test="name != null">
AND name = #{name}
</if>
</where>
</select>
2.2 缓存机制
MyBatis 提供了两种缓存机制:一级缓存和二级缓存。
- 一级缓存:会话缓存,只对当前会话有效。
- 二级缓存:全局缓存,对所有会话有效。
<cache eviction="FIFO" flushInterval="60000" size="512" readOnly="true"/>
2.3 分页插件
MyBatis 支持分页插件,如 PageHelper。
PageHelper.startPage(1, 10);
List<User> users = mapper.selectByCondition();
三、MyBatis 项目应用详解
3.1 项目结构
一个典型的 MyBatis 项目结构如下:
src/
|-- main/
| |-- java/
| | |-- com/
| | | |-- example/
| | | | |-- entity/
| | | | | |-- User.java
| | | | |-- mapper/
| | | | | |-- UserMapper.java
| | | | |-- service/
| | | | | |-- UserService.java
| | | | |-- controller/
| | | | | |-- UserController.java
| |-- resources/
| | |-- mybatis-config.xml
| | |-- mapper/
| | | |-- UserMapper.xml
|-- test/
| |-- java/
| | |-- com/
| | | |-- example/
| | | | |-- test/
| | | | | |-- MyBatisTest.java
|-- pom.xml
3.2 实体类
实体类用于表示数据库中的表,通常使用 Java Bean 规范。
public class User {
private Integer id;
private String name;
// getter 和 setter 方法
}
3.3 映射文件
映射文件定义了 SQL 语句与实体类的映射关系。
<mapper namespace="com.example.mapper.UserMapper">
<select id="selectById" resultType="com.example.entity.User">
SELECT * FROM user WHERE id = #{id}
</select>
</mapper>
3.4 服务层
服务层负责业务逻辑处理,调用 Mapper 接口实现数据库操作。
public class UserService {
private UserMapper mapper;
public UserService(UserMapper mapper) {
this.mapper = mapper;
}
public User getUserById(Integer id) {
return mapper.selectById(id);
}
}
3.5 控制层
控制层负责处理 HTTP 请求,调用服务层方法实现业务逻辑。
@RestController
@RequestMapping("/user")
public class UserController {
private UserService userService;
public UserController(UserService userService) {
this.userService = userService;
}
@GetMapping("/{id}")
public User getUserById(@PathVariable Integer id) {
return userService.getUserById(id);
}
}
总结
本文详细介绍了 MyBatis 的入门攻略、实战技巧以及项目应用。通过学习本文,您应该能够掌握 MyBatis 的基本用法,并在实际项目中应用它。希望本文对您有所帮助!
