引言
MyBatis 是一款优秀的持久层框架,它消除了几乎所有的 JDBC 代码和手动设置参数以及获取结果集的过程。MyBatis 通过简单的 XML 或注解用于配置和原始映射,将接口和 Java 的 POJOs(Plain Old Java Objects,简单的 Java 对象)映射成数据库中的记录。本指南将带你从入门到实战,学会如何使用 MyBatis 构建高效的 Java 项目。
MyBatis 简介
什么是 MyBatis?
MyBatis 是一个半ORM(对象关系映射)框架,它允许开发者将 SQL 语句映射到 Java 接口的操作。它不同于完全的ORM框架(如Hibernate),因为它允许开发者完全控制 SQL 语句,而不需要将 SQL 与 Java 代码分离。
MyBatis 的特点
- 易于上手:MyBatis 使用 XML 或注解来映射 SQL,对初学者友好。
- 灵活:允许自定义 SQL、存储过程以及高级映射。
- 扩展性:可以扩展 MyBatis 的功能,如插件。
- 支持多种数据库:MyBatis 不依赖于任何特定的数据库。
环境搭建
1. 添加依赖
在 Maven 项目中,添加以下依赖:
<dependencies>
<dependency>
<groupId>org.mybatis</groupId>
<artifactId>mybatis</artifactId>
<version>3.5.3</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>
</dependencies>
2. 配置 MyBatis
在 resources 目录下创建 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/your_database"/>
<property name="username" value="root"/>
<property name="password" value="root"/>
</dataSource>
</environment>
</environments>
<mappers>
<mapper resource="com/example/mapper/UserMapper.xml"/>
</mappers>
</configuration>
编写 Mapper 接口
在 com.example.mapper 包下创建 UserMapper.java 接口:
package com.example.mapper;
import com.example.entity.User;
public interface UserMapper {
User findUserById(int id);
}
编写 Mapper 映射文件
在 com/example/mapper 目录下创建 UserMapper.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="findUserById" resultType="com.example.entity.User">
SELECT * FROM user WHERE id = #{id}
</select>
</mapper>
使用 MyBatis
在 Spring Boot 项目中,添加以下依赖:
<dependencies>
<!-- ... -->
<dependency>
<groupId>org.mybatis.spring.boot</groupId>
<artifactId>mybatis-spring-boot-starter</artifactId>
<version>2.1.3</version>
</dependency>
<!-- ... -->
</dependencies>
在 application.properties 文件中配置数据库信息:
spring.datasource.url=jdbc:mysql://localhost:3306/your_database
spring.datasource.username=root
spring.datasource.password=root
spring.datasource.driver-class-name=com.mysql.cj.jdbc.Driver
在 Spring Boot 主类上添加 @MapperScan 注解:
package com.example;
import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.context.annotation.MapperScan;
@SpringBootApplication
@MapperScan("com.example.mapper")
public class MyBatisApplication {
public static void main(String[] args) {
SpringApplication.run(MyBatisApplication.class, args);
}
}
在业务层使用 MyBatis:
package com.example.service;
import com.example.entity.User;
import com.example.mapper.UserMapper;
public class UserService {
private final UserMapper userMapper;
public UserService(UserMapper userMapper) {
this.userMapper = userMapper;
}
public User findUserById(int id) {
return userMapper.findUserById(id);
}
}
总结
通过以上步骤,你已成功搭建了 MyBatis 环境,并学会了如何使用 MyBatis 构建简单的 Java 项目。在实际项目中,MyBatis 可以与 Spring Boot、Spring MVC 等框架结合使用,实现更加复杂的业务需求。希望这份指南对你有所帮助,祝你学习愉快!
