MyBatis 是一款优秀的持久层框架,它消除了几乎所有的 JDBC 代码和手动设置参数以及获取结果集的过程。MyBatis 可以使用简单的 XML 或注解用于配置和原始映射,将接口和 Java 的 POJOs(Plain Old Java Objects,普通的 Java对象)映射成数据库中的记录。
下面,我们将从搭建环境开始,逐步深入到实践案例,让你轻松入门 MyBatis。
一、搭建 MyBatis 开发环境
1. 环境准备
Java 开发工具包(JDK)
首先,确保你的计算机上安装了 JDK,并且配置了环境变量。MyBatis 要求 JDK 版本至少为 1.6。
Maven
Maven 是一个项目管理工具,可以帮助我们管理项目的依赖。下载并安装 Maven,配置 Maven 的环境变量。
MySQL 数据库
下载并安装 MySQL 数据库,创建一个用于 MyBatis 实践的数据库。
2. 创建 Maven 项目
在 IDE 中创建一个新的 Maven 项目,并添加以下依赖:
<dependencies>
<!-- MyBatis 核心库 -->
<dependency>
<groupId>org.mybatis</groupId>
<artifactId>mybatis</artifactId>
<version>3.5.7</version>
</dependency>
<!-- MySQL 驱动 -->
<dependency>
<groupId>mysql</groupId>
<artifactId>mysql-connector-java</artifactId>
<version>8.0.26</version>
</dependency>
<!-- Log4j 日志库 -->
<dependency>
<groupId>org.apache.logging.log4j</groupId>
<artifactId>log4j-api</artifactId>
<version>2.14.1</version>
</dependency>
<dependency>
<groupId>org.apache.logging.log4j</groupId>
<artifactId>log4j-core</artifactId>
<version>2.14.1</version>
</dependency>
</dependencies>
3. 配置文件
在项目的 src/main/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.cj.jdbc.Driver"/>
<property name="url" value="jdbc:mysql://localhost:3306/mybatis_example?useSSL=false"/>
<property name="username" value="root"/>
<property name="password" value=""/>
</dataSource>
</environment>
</environments>
<mappers>
<mapper resource="com/example/mapper/UserMapper.xml"/>
</mappers>
</configuration>
二、编写 MyBatis 映射文件
在 src/main/resources 目录下创建 com/example/mapper/UserMapper.xml 文件,编写 MyBatis 的映射文件。
<?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="selectUserById" resultType="com.example.model.User">
SELECT * FROM user WHERE id = #{id}
</select>
</mapper>
三、编写 MyBatis 接口
在 com/example/mapper 包下创建 UserMapper.java 接口,定义 MyBatis 的映射方法。
package com.example.mapper;
import com.example.model.User;
public interface UserMapper {
User selectUserById(Integer id);
}
四、实践案例
以下是一个简单的 MyBatis 实践案例,演示如何使用 MyBatis 查询数据库中的用户信息。
package com.example;
import com.example.mapper.UserMapper;
import org.apache.ibatis.session.SqlSession;
import org.apache.ibatis.session.SqlSessionFactory;
import org.apache.ibatis.session.SqlSessionFactoryBuilder;
public class MyBatisExample {
public static void main(String[] args) {
try {
// 创建 SqlSessionFactory
SqlSessionFactory sqlSessionFactory = new SqlSessionFactoryBuilder().build(
Resources.getResourceAsStream("mybatis-config.xml")
);
// 获取 SqlSession
SqlSession session = sqlSessionFactory.openSession();
// 获取 UserMapper 接口
UserMapper userMapper = session.getMapper(UserMapper.class);
// 查询用户信息
User user = userMapper.selectUserById(1);
System.out.println("User ID: " + user.getId());
System.out.println("User Name: " + user.getName());
// 提交事务
session.commit();
// 关闭 SqlSession
session.close();
} catch (Exception e) {
e.printStackTrace();
}
}
}
五、总结
通过以上步骤,你现在已经成功搭建了 MyBatis 开发环境,并完成了第一个 MyBatis 实践案例。希望这篇文章能帮助你轻松入门 MyBatis,为你的 Java 开发之路添砖加瓦。
