引言
MyBatis 是一个优秀的持久层框架,它消除了几乎所有的 JDBC 代码和手动设置参数以及获取结果集的工作。MyBatis 可以使用简单的 XML 或注解用于配置和原始映射,将接口和 Java 的 POJOs(Plain Old Java Objects,普通的 Java对象)映射成数据库中的记录。
MyBatis 简介
1.1 MyBatis 的核心功能
- 映射接口方法到 SQL 语句:MyBatis 可以将接口的方法直接映射到 SQL 语句上,无需编写具体的 SQL 代码。
- SQL 映射文件:MyBatis 使用 XML 文件来配置 SQL 语句,使得 SQL 的配置更加灵活。
- 动态 SQL:MyBatis 提供了动态 SQL 的支持,可以根据不同的条件执行不同的 SQL 语句。
- 缓存机制:MyBatis 提供了两种类型的缓存:一级缓存和二级缓存,可以有效地提高数据库操作的效率。
1.2 MyBatis 的优势
- 简化开发:减少 JDBC 代码,提高开发效率。
- 灵活配置:通过 XML 或注解配置 SQL 语句,灵活性强。
- 易于扩展:MyBatis 的架构设计使得扩展性很好,可以方便地集成其他框架。
MyBatis 入门实践
2.1 环境搭建
2.1.1 环境准备
- Java 开发环境:安装 JDK 1.8 或更高版本。
- IDE:推荐使用 IntelliJ IDEA 或 Eclipse。
- Maven:用于项目构建和依赖管理。
2.1.2 创建 Maven 项目
- 打开 Maven,创建一个新的项目。
- 选择 Java 类型项目,并填写项目信息。
- 添加 MyBatis 相关依赖到
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 配置 MyBatis
- 在
src/main/resources目录下创建mybatis-config.xml文件。 - 配置数据库连接信息、事务管理器和映射器。
<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_db?useSSL=false"/>
<property name="username" value="root"/>
<property name="password" value="root"/>
</dataSource>
</environment>
</environments>
<mappers>
<mapper resource="com/example/mapper/UserMapper.xml"/>
</mappers>
</configuration>
2.3 创建 Mapper 接口和 XML 映射文件
- 在
com.example.mapper包下创建UserMapper.java接口。
package com.example.mapper;
public interface UserMapper {
User getUserById(int id);
}
- 在
src/main/resources/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="getUserById" resultType="com.example.entity.User">
SELECT * FROM user WHERE id = #{id}
</select>
</mapper>
2.4 使用 MyBatis
- 在
com.example.service包下创建UserService.java类。
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 getUserById(int id) {
return userMapper.getUserById(id);
}
}
- 在
com.example.controller包下创建UserController.java类。
package com.example.controller;
import com.example.entity.User;
import com.example.service.UserService;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RequestParam;
import org.springframework.web.bind.annotation.RestController;
@RestController
public class UserController {
private final UserService userService;
@Autowired
public UserController(UserService userService) {
this.userService = userService;
}
@GetMapping("/user")
public User getUserById(@RequestParam int id) {
return userService.getUserById(id);
}
}
- 运行项目,访问
http://localhost:8080/user?id=1,查看结果。
总结
本文介绍了 MyBatis 框架的基本概念、核心功能和入门实践。通过本文的学习,读者可以快速掌握 MyBatis 的使用方法,并将其应用到实际项目中。MyBatis 作为一款优秀的持久层框架,在提高开发效率、简化数据库操作方面具有显著优势。
