MyBatis 是一个优秀的持久层框架,它消除了几乎所有的 JDBC 代码和手动设置参数以及获取结果集的工作。MyBatis 可以使用简单的 XML 或注解用于配置和原始映射,将接口和 Java 的 POJOs(Plain Old Java Objects,普通的 Java对象)映射成数据库中的记录。
MyBatis 简介
MyBatis 的核心是 SQL 映射文件,它包含了 SQL 语句和映射规则。MyBatis 将 SQL 语句和 Java 对象之间的关系通过 XML 文件或注解进行配置,从而实现对象与数据库的交互。
环境搭建
1. 准备工作
- JDK 1.8 或更高版本
- Maven 或 Gradle 构建工具
- MySQL 数据库
2. 创建 Maven 项目
<project xmlns="http://maven.apache.org/POM/4.0.0"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
<modelVersion>4.0.0</modelVersion>
<groupId>com.example</groupId>
<artifactId>mybatis-example</artifactId>
<version>1.0-SNAPSHOT</version>
<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>
<!-- 模拟数据 -->
<dependency>
<groupId>org.flywaydb</groupId>
<artifactId>flyway-core</artifactId>
<version>9.0.0</version>
</dependency>
</dependencies>
</project>
3. 配置 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/mybatis_example?useSSL=false"/>
<property name="username" value="root"/>
<property name="password" value="root"/>
</dataSource>
</environment>
</environments>
</configuration>
编写 SQL 映射文件
在 src/main/resources/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">
<select id="selectById" resultType="com.example.entity.User">
SELECT * FROM user WHERE id = #{id}
</select>
</mapper>
编写接口
在 src/main/java/com/example/mapper 目录下创建 UserMapper.java 接口。
package com.example.mapper;
import com.example.entity.User;
import org.apache.ibatis.annotations.Mapper;
import org.apache.ibatis.annotations.Select;
@Mapper
public interface UserMapper {
User selectById(Integer id);
}
编写 Java 对象
在 src/main/java/com/example/entity 目录下创建 User.java 类。
package com.example.entity;
public class User {
private Integer id;
private String name;
private Integer age;
// getter 和 setter 方法
}
使用 MyBatis
在 src/main/java/com/example 目录下创建 Application.java 类,启动 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 Application {
public static void main(String[] args) {
try {
SqlSessionFactory sqlSessionFactory = new SqlSessionFactoryBuilder().build();
SqlSession sqlSession = sqlSessionFactory.openSession();
UserMapper userMapper = sqlSession.getMapper(UserMapper.class);
User user = userMapper.selectById(1);
System.out.println(user.getName());
sqlSession.close();
} catch (Exception e) {
e.printStackTrace();
}
}
}
实战案例
以下是一个简单的实战案例,演示如何使用 MyBatis 添加、查询、更新和删除用户。
1. 添加用户
在 UserMapper.xml 文件中添加以下 SQL 语句:
<insert id="insert" parameterType="com.example.entity.User">
INSERT INTO user (name, age) VALUES (#{name}, #{age})
</insert>
在 UserMapper.java 接口中添加以下方法:
@Insert("INSERT INTO user (name, age) VALUES (#{name}, #{age})")
void insert(User user);
在 Application.java 类中添加以下代码:
User user = new User();
user.setName("张三");
user.setAge(20);
userMapper.insert(user);
sqlSession.commit();
2. 查询用户
在 UserMapper.xml 文件中添加以下 SQL 语句:
<select id="selectByName" resultType="com.example.entity.User">
SELECT * FROM user WHERE name = #{name}
</select>
在 UserMapper.java 接口中添加以下方法:
@Select("SELECT * FROM user WHERE name = #{name}")
List<User> selectByName(String name);
在 Application.java 类中添加以下代码:
List<User> users = userMapper.selectByName("张三");
for (User user : users) {
System.out.println(user.getName());
}
3. 更新用户
在 UserMapper.xml 文件中添加以下 SQL 语句:
<update id="update" parameterType="com.example.entity.User">
UPDATE user SET name = #{name}, age = #{age} WHERE id = #{id}
</update>
在 UserMapper.java 接口中添加以下方法:
@Update("UPDATE user SET name = #{name}, age = #{age} WHERE id = #{id}")
void update(User user);
在 Application.java 类中添加以下代码:
User user = new User();
user.setId(1);
user.setName("李四");
user.setAge(21);
userMapper.update(user);
sqlSession.commit();
4. 删除用户
在 UserMapper.xml 文件中添加以下 SQL 语句:
<delete id="delete" parameterType="int">
DELETE FROM user WHERE id = #{id}
</delete>
在 UserMapper.java 接口中添加以下方法:
@Delete("DELETE FROM user WHERE id = #{id}")
void delete(Integer id);
在 Application.java 类中添加以下代码:
userMapper.delete(1);
sqlSession.commit();
通过以上步骤,您已经完成了 MyBatis 的搭建和实战案例解析。希望这篇文章能帮助您快速入门 MyBatis,并在实际项目中应用它。
