MyBatis 是一款优秀的持久层框架,它消除了几乎所有的 JDBC 代码和手动设置参数以及获取结果集的过程。MyBatis 可以使用简单的 XML 或注解用于配置和原始映射,将接口和 Java 的 POJOs(Plain Old Java Objects,普通的 Java对象)映射成数据库中的记录。
下面,我们将一步步从搭建环境到实践操作,快速入门 MyBatis。
1. 环境搭建
1.1 系统要求
- Java 8 或更高版本
- MySQL 数据库或其他支持的数据库
- Maven 3.0 或更高版本(用于依赖管理)
1.2 创建 Maven 项目
- 打开 Maven 官网,下载适合的安装包。
- 安装 Maven 并配置环境变量。
- 打开命令行,使用以下命令创建一个新项目:
mvn archetype:generate \
-DarchetypeArtifactId=maven-archetype-quickstart \
-DgroupId=com.example \
-DartifactId=mybatis-example \
-Dversion=1.0.0
- 输入完成后,Maven 会自动创建一个基本的 Maven 项目。
1.3 添加依赖
编辑 pom.xml 文件,添加 MyBatis 以及数据库驱动依赖:
<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. 配置 MyBatis
2.1 创建 MyBatis 配置文件
在项目的 src/main/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/mydb?useSSL=false"/>
<property name="username" value="root"/>
<property name="password" value="password"/>
</dataSource>
</environment>
</environments>
<mappers>
<mapper resource="com/example/mybatis/EmployeeMapper.xml"/>
</mappers>
</configuration>
2.2 创建映射文件
在 src/main/resources/com/example/mybatis 目录下创建 EmployeeMapper.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.mybatis.EmployeeMapper">
<select id="selectById" resultType="com.example.mybatis.Employee">
SELECT * FROM employees WHERE id = #{id}
</select>
</mapper>
2.3 创建接口
在 com/example/mybatis 目录下创建 EmployeeMapper.java 接口,并添加以下内容:
package com.example.mybatis;
public interface EmployeeMapper {
Employee selectById(int id);
}
3. 编写代码实现
3.1 创建 Employee 类
在 com/example/mybatis 目录下创建 Employee.java 类,并添加以下内容:
package com.example.mybatis;
public class Employee {
private int id;
private String name;
private String department;
// getters and setters
}
3.2 编写测试代码
在项目的 src/test/java 目录下创建 MyBatisTest.java 类,并添加以下内容:
package com.example.mybatis;
import org.apache.ibatis.session.SqlSession;
import org.apache.ibatis.session.SqlSessionFactory;
import org.apache.ibatis.session.SqlSessionFactoryBuilder;
public class MyBatisTest {
public static void main(String[] args) {
try {
SqlSessionFactory sqlSessionFactory = new SqlSessionFactoryBuilder().build("src/main/resources/mybatis-config.xml");
SqlSession session = sqlSessionFactory.openSession();
EmployeeMapper mapper = session.getMapper(EmployeeMapper.class);
Employee employee = mapper.selectById(1);
System.out.println("Employee Name: " + employee.getName());
session.close();
} catch (Exception e) {
e.printStackTrace();
}
}
}
4. 运行测试
- 打开命令行,切换到项目的根目录。
- 执行以下命令运行测试:
mvn test
在控制台输出中,你会看到查询到的员工姓名。
通过以上步骤,你已经成功入门了 MyBatis,并实现了一个简单的查询操作。MyBatis 的强大之处在于它提供了灵活的映射方式,可以让你轻松地将 Java 对象和数据库中的记录进行映射。随着实践的深入,你将能够更加熟练地使用 MyBatis,并在项目中发挥其优势。
