MyBatis 是一个优秀的持久层框架,它消除了几乎所有的 JDBC 代码和手动设置参数以及获取结果集的工作。MyBatis 可以使用简单的 XML 或注解用于配置和原始映射,将接口和 Java 的 POJOs(Plain Old Java Objects,普通的 Java对象)映射成数据库中的记录。
MyBatis 简介
MyBatis 遵循约定大于配置的原则,通过 XML 或注解的方式配置 SQL 映射,将接口和 Java 对象映射,从而实现数据库操作。相比于其他的 ORM 框架,MyBatis 更灵活,更易于定制。
环境搭建
1. 准备工作
- 安装 JDK 1.8 或更高版本
- 安装 Maven 3.5 或更高版本
- 创建一个 Maven 项目
2. 添加依赖
在 pom.xml 文件中添加以下依赖:
<dependencies>
<dependency>
<groupId>org.mybatis</groupId>
<artifactId>mybatis</artifactId>
<version>3.5.3</version>
</dependency>
<dependency>
<groupId>mysql</groupId>
<artifactId>mysql-connector-java</artifactId>
<version>8.0.21</version>
</dependency>
</dependencies>
3. 配置数据源
在 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/test?useSSL=false"/>
<property name="username" value="root"/>
<property name="password" value=""/>
</dataSource>
</environment>
</environments>
</configuration>
创建 Mapper 接口
在 com.example.mapper 包下创建一个接口 UserMapper.java,定义数据库操作方法:
package com.example.mapper;
public interface UserMapper {
User getUserById(int id);
void addUser(User user);
void updateUser(User user);
void deleteUser(int id);
}
创建 Mapper XML
在 resources 目录下创建 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">
<select id="getUserById" resultType="com.example.entity.User">
SELECT * FROM user WHERE id = #{id}
</select>
<insert id="addUser">
INSERT INTO user (name, age) VALUES (#{name}, #{age})
</insert>
<update id="updateUser">
UPDATE user SET name = #{name}, age = #{age} WHERE id = #{id}
</update>
<delete id="deleteUser">
DELETE FROM user WHERE id = #{id}
</delete>
</mapper>
创建实体类
在 com.example.entity 包下创建一个实体类 User.java,对应数据库中的用户表:
package com.example.entity;
public class User {
private int id;
private String name;
private int age;
// 省略 getter 和 setter 方法
}
使用 MyBatis
1. 创建 SqlSessionFactory
String resource = "mybatis-config.xml";
InputStream inputStream = Resources.getResourceAsStream(resource);
SqlSessionFactory sqlSessionFactory = new SqlSessionFactoryBuilder().build(inputStream);
2. 获取 SqlSession
SqlSession session = sqlSessionFactory.openSession();
3. 获取 Mapper
UserMapper userMapper = session.getMapper(UserMapper.class);
4. 执行数据库操作
// 查询用户
User user = userMapper.getUserById(1);
System.out.println(user.getName());
// 添加用户
User newUser = new User();
newUser.setName("张三");
newUser.setAge(20);
userMapper.addUser(newUser);
// 更新用户
user.setName("李四");
user.setAge(21);
userMapper.updateUser(user);
// 删除用户
userMapper.deleteUser(1);
5. 关闭 SqlSession
session.close();
总结
通过以上步骤,我们成功入门了 MyBatis,并实现了高效 SQL 映射与数据库操作。MyBatis 提供了灵活的配置方式,方便我们定制数据库操作,同时减少了 JDBC 代码,提高了开发效率。在实际项目中,我们还可以结合 Spring 框架使用 MyBatis,实现更强大的功能。
