引言
MyBatis 是一款优秀的持久层框架,它消除了几乎所有的 JDBC 代码和手动设置参数以及获取结果集的工作。MyBatis 通过简单的 XML 或注解用于配置和原始映射,将接口和 Java 的 POJOs(Plain Old Java Objects,普通的 Java对象)映射成数据库中的记录。
在这个指南中,我们将从零基础开始,逐步深入,带你了解 MyBatis 的基本概念、安装配置、环境搭建,以及如何使用 MyBatis 进行数据库操作。
第一部分:MyBatis 简介
1.1 MyBatis 的优势
- 简化数据库操作:通过 XML 或注解的方式,将数据库操作封装起来,减少 JDBC 代码量。
- 灵活的映射:支持复杂的 SQL 映射,如多表关联、动态 SQL 等。
- 易于扩展:支持自定义插件,如分页插件、缓存插件等。
1.2 MyBatis 的架构
MyBatis 的架构主要由以下几个部分组成:
- SqlSessionFactory:用于创建 SqlSession 对象。
- SqlSession:用于执行 SQL 语句,管理事务。
- Executor:负责执行 SQL 语句。
- MappedStatement:存储 SQL 语句和参数的映射关系。
第二部分:环境搭建
2.1 环境准备
- Java:MyBatis 需要 Java 1.6 或更高版本。
- Maven:用于管理项目依赖。
- 数据库:如 MySQL、Oracle 等。
2.2 创建 Maven 项目
- 打开 Maven 官网,下载并安装 Maven。
- 创建一个新的 Maven 项目,添加以下依赖:
<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.22</version>
</dependency>
</dependencies>
2.3 配置数据库连接
在 src/main/resources 目录下创建 application.properties 文件,配置数据库连接信息:
# 数据库配置
db.url=jdbc:mysql://localhost:3306/mydb
db.username=root
db.password=root
db.driver=com.mysql.cj.jdbc.Driver
第三部分:编写 MyBatis 映射文件
3.1 创建 Mapper 接口
在 src/main/java 目录下创建一个接口,例如 UserMapper.java:
public interface UserMapper {
User selectById(Integer id);
}
3.2 编写 MyBatis 映射文件
在 src/main/resources 目录下创建 UserMapper.xml 文件,配置 SQL 语句:
<mapper namespace="com.example.mapper.UserMapper">
<select id="selectById" resultType="com.example.entity.User">
SELECT * FROM user WHERE id = #{id}
</select>
</mapper>
3.3 配置 SqlSessionFactory
在 src/main/resources 目录下创建 mybatis-config.xml 文件,配置 SqlSessionFactory:
<?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="${db.driver}"/>
<property name="url" value="${db.url}"/>
<property name="username" value="${db.username}"/>
<property name="password" value="${db.password}"/>
</dataSource>
</environment>
</environments>
<mappers>
<mapper resource="com/example/mapper/UserMapper.xml"/>
</mappers>
</configuration>
第四部分:使用 MyBatis 进行数据库操作
4.1 创建 SqlSession
SqlSessionFactory sqlSessionFactory = new SqlSessionFactoryBuilder().build(Resources.getResourceAsStream("mybatis-config.xml"));
SqlSession sqlSession = sqlSessionFactory.openSession();
4.2 执行 SQL 语句
User user = sqlSession.selectOne("com.example.mapper.UserMapper.selectById", 1);
System.out.println(user);
4.3 提交事务
sqlSession.commit();
4.4 关闭 SqlSession
sqlSession.close();
总结
通过本指南,你已成功入门 MyBatis,并掌握了如何使用 MyBatis 进行数据库操作。MyBatis 的灵活性和易用性使其成为 Java 开发者常用的持久层框架之一。在实际项目中,你可以根据需求进一步学习和使用 MyBatis 的高级特性,如动态 SQL、插件、缓存等。
