引言
MyBatis 是一个优秀的持久层框架,它消除了几乎所有的 JDBC 代码和手动设置参数以及获取结果集的工作。MyBatis 可以使用简单的 XML 或注解用于配置和原始映射,将接口和 Java 的 POJOs(Plain Old Java Objects,普通的 Java对象)映射成数据库中的记录。
在本教程中,我们将从基础开始,逐步深入,带你快速上手 MyBatis,并学会如何进行数据库操作。
一、环境搭建
1.1 确定开发环境
在开始之前,请确保你的开发环境已经搭建好,包括以下内容:
- Java Development Kit (JDK)
- Integrated Development Environment (IDE),如 IntelliJ IDEA 或 Eclipse
- Maven 或 Gradle
1.2 创建Maven项目
使用 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>
</dependencies>
二、配置MyBatis
2.1 创建SqlSessionFactory
在 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="com.mysql.cj.jdbc.Driver"/>
<property name="url" value="jdbc:mysql://localhost:3306/mydatabase"/>
<property name="username" value="root"/>
<property name="password" value=""/>
</dataSource>
</environment>
</environments>
<mappers>
<mapper resource="com/example/mapper/UserMapper.xml"/>
</mappers>
</configuration>
2.2 创建Mapper接口
在 com.example.mapper 包下创建 UserMapper.java 接口:
package com.example.mapper;
public interface UserMapper {
void insertUser(User user);
User getUserById(int id);
}
2.3 创建Mapper XML
在 resources 目录下创建 com/example/mapper/UserMapper.xml 文件,配置 SQL 映射:
<?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">
<insert id="insertUser" parameterType="User">
INSERT INTO users (name, age) VALUES (#{name}, #{age})
</insert>
<select id="getUserById" resultType="User">
SELECT * FROM users WHERE id = #{id}
</select>
</mapper>
三、编写Java代码
3.1 创建实体类
在 com.example.entity 包下创建 User.java 实体类:
package com.example.entity;
public class User {
private int id;
private String name;
private int age;
// 省略getter和setter方法
}
3.2 创建MyBatis工具类
在 com.example.utils 包下创建 MyBatisUtil.java 工具类:
package com.example.utils;
import org.apache.ibatis.session.SqlSession;
import org.apache.ibatis.session.SqlSessionFactory;
import org.apache.ibatis.session.SqlSessionFactoryBuilder;
public class MyBatisUtil {
private static SqlSessionFactory sqlSessionFactory;
static {
try {
sqlSessionFactory = new SqlSessionFactoryBuilder().build(MyBatisUtil.class.getClassLoader().getResourceAsStream("mybatis-config.xml"));
} catch (Exception e) {
e.printStackTrace();
}
}
public static SqlSessionFactory getSqlSessionFactory() {
return sqlSessionFactory;
}
}
3.3 编写测试代码
在 com.example.test 包下创建 UserTest.java 测试类:
package com.example.test;
import com.example.entity.User;
import com.example.mapper.UserMapper;
import com.example.utils.MyBatisUtil;
import org.apache.ibatis.session.SqlSession;
public class UserTest {
public static void main(String[] args) {
try (SqlSession session = MyBatisUtil.getSqlSessionFactory().openSession()) {
UserMapper mapper = session.getMapper(UserMapper.class);
User user = new User();
user.setName("张三");
user.setAge(20);
mapper.insertUser(user);
session.commit();
System.out.println("插入成功");
User userById = mapper.getUserById(1);
System.out.println("查询结果:" + userById);
} catch (Exception e) {
e.printStackTrace();
}
}
}
四、总结
通过本教程,你已成功搭建了 MyBatis 开发环境,并学会了如何进行数据库操作。在实际项目中,你可以根据需求调整配置和映射文件,实现更复杂的业务逻辑。
希望本教程能帮助你快速上手 MyBatis,祝你学习愉快!
