MyBatis 是一个优秀的持久层框架,它消除了几乎所有的 JDBC 代码和手动设置参数以及获取结果集的工作。MyBatis 可以使用简单的 XML 或注解用于配置和原始映射,将接口和 Java 的 POJOs(Plain Old Java Objects,普通的 Java对象)映射成数据库中的记录。
MyBatis 简介
MyBatis 的核心是 SQL 映射文件,这个文件包含了 SQL 语句和映射规则。MyBatis 的强大之处在于它的动态 SQL,这使得编写复杂的 SQL 变得非常简单。
MyBatis 的优势
- 易于使用:MyBatis 的学习曲线相对较低,即使没有经验也可以快速上手。
- 灵活配置:MyBatis 支持多种配置方式,包括 XML 和注解。
- 动态 SQL:MyBatis 的动态 SQL 功能使得编写复杂的 SQL 变得非常简单。
- 支持自定义类型处理器:MyBatis 支持自定义类型处理器,可以处理复杂的类型转换。
- 支持缓存:MyBatis 支持一级缓存和二级缓存,可以显著提高性能。
MyBatis 的基本使用
步骤一:添加依赖
首先,需要在项目的 pom.xml 文件中添加 MyBatis 的依赖。
<dependencies>
<dependency>
<groupId>org.mybatis</groupId>
<artifactId>mybatis</artifactId>
<version>3.5.7</version>
</dependency>
<dependency>
<groupId>org.mybatis.caches</groupId>
<artifactId>mybatis-redis</artifactId>
<version>1.0.0</version>
</dependency>
<dependency>
<groupId>org.springframework</groupId>
<artifactId>spring-context</artifactId>
<version>5.3.10</version>
</dependency>
<dependency>
<groupId>org.springframework</groupId>
<artifactId>spring-jdbc</artifactId>
<version>5.3.10</version>
</dependency>
</dependencies>
步骤二:配置 MyBatis
在 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.jdbc.Driver"/>
<property name="url" value="jdbc:mysql://localhost:3306/mybatis_db"/>
<property name="username" value="root"/>
<property name="password" value=""/>
</dataSource>
</environment>
</environments>
<mappers>
<mapper resource="com/example/mapper/UserMapper.xml"/>
</mappers>
</configuration>
步骤三:编写 Mapper 接口和 XML 映射文件
在 com.example.mapper 包下创建一个名为 UserMapper.java 的接口,定义查询用户的方法。
package com.example.mapper;
public interface UserMapper {
User getUserById(int id);
}
在 resources 目录下创建一个名为 com/example/mapper/UserMapper.xml 的文件,编写 XML 映射文件。
<?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>
步骤四:使用 MyBatis
在 Spring Boot 应用中,可以通过以下方式使用 MyBatis:
@SpringBootApplication
@MapperScan("com.example.mapper")
public class MyBatisApplication {
public static void main(String[] args) {
SpringApplication.run(MyBatisApplication.class, args);
}
}
在业务层,可以通过 @Autowired 注入 UserMapper 接口,并调用 getUserById 方法查询用户。
@Service
public class UserService {
@Autowired
private UserMapper userMapper;
public User getUserById(int id) {
return userMapper.getUserById(id);
}
}
实战案例
以下是一个简单的实战案例,演示如何使用 MyBatis 查询用户信息。
- 创建数据库表:
CREATE TABLE user (
id INT PRIMARY KEY AUTO_INCREMENT,
username VARCHAR(50),
password VARCHAR(50)
);
- 创建实体类:
package com.example.entity;
public class User {
private int id;
private String username;
private String password;
// 省略 getter 和 setter 方法
}
- 创建 Mapper 接口和 XML 映射文件:
package com.example.mapper;
public interface UserMapper {
User getUserById(int id);
}
<?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>
- 在业务层使用 MyBatis:
@Service
public class UserService {
@Autowired
private UserMapper userMapper;
public User getUserById(int id) {
return userMapper.getUserById(id);
}
}
- 测试:
@RestController
@RequestMapping("/user")
public class UserController {
@Autowired
private UserService userService;
@GetMapping("/{id}")
public User getUserById(@PathVariable int id) {
return userService.getUserById(id);
}
}
通过访问 http://localhost:8080/user/1,可以查询到 ID 为 1 的用户信息。
总结
本文全面解读了 Java 开源框架 MyBatis,从基本使用到实战案例,帮助读者从小白到高手。希望本文能对您有所帮助!
