引言
MyBatis 是一款优秀的持久层框架,它消除了几乎所有的 JDBC 代码和手动设置参数以及获取结果集的工作。MyBatis 可以使用简单的 XML 或注解用于配置和原始映射,将接口和 Java 的 POJOs(Plain Old Java Objects,普通的 Java对象)映射成数据库中的记录。
本指南将带您从搭建环境开始,逐步学习 MyBatis 的基本使用,直至实践应用。
一、环境搭建
1.1 系统要求
- Java 运行环境:Java 8 或更高版本
- 数据库:MySQL、Oracle、SQL Server 等
- 开发工具:IntelliJ IDEA、Eclipse 或其他 Java 开发环境
1.2 添加依赖
在项目的 pom.xml 文件中添加以下依赖:
<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>com.alibaba</groupId>
<artifactId>druid</artifactId>
<version>1.2.8</version>
</dependency>
</dependencies>
1.3 配置数据库
创建数据库和表,例如:
CREATE TABLE user (
id INT PRIMARY KEY AUTO_INCREMENT,
username VARCHAR(50),
password VARCHAR(50)
);
二、MyBatis 基本使用
2.1 编写 MyBatis 配置文件
在项目中创建 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_db?useSSL=false"/>
<property name="username" value="root"/>
<property name="password" value="root"/>
</dataSource>
</environment>
</environments>
<mappers>
<mapper resource="com/example/mapper/UserMapper.xml"/>
</mappers>
</configuration>
2.2 编写 Mapper 接口
在项目中创建 UserMapper.java 接口,定义数据库操作方法:
package com.example.mapper;
import com.example.entity.User;
public interface UserMapper {
User getUserById(int id);
}
2.3 编写 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="getUserById" resultType="com.example.entity.User">
SELECT * FROM user WHERE id = #{id}
</select>
</mapper>
2.4 使用 MyBatis
在 Java 代码中,创建 SqlSessionFactory 和 SqlSession 对象,执行数据库操作:
package com.example.mapper;
import org.apache.ibatis.session.SqlSession;
import org.apache.ibatis.session.SqlSessionFactory;
public class MyBatisDemo {
public static void main(String[] args) {
try {
// 创建 SqlSessionFactory
SqlSessionFactory sqlSessionFactory = MyBatisUtil.getSqlSessionFactory();
// 获取 SqlSession
SqlSession sqlSession = sqlSessionFactory.openSession();
// 创建 UserMapper 接口的代理对象
UserMapper userMapper = sqlSession.getMapper(UserMapper.class);
// 执行查询操作
User user = userMapper.getUserById(1);
// 输出查询结果
System.out.println(user.getUsername());
// 提交事务
sqlSession.commit();
// 关闭 SqlSession
sqlSession.close();
} catch (Exception e) {
e.printStackTrace();
}
}
}
三、MyBatis 高级特性
3.1 动态 SQL
MyBatis 支持动态 SQL,可以方便地实现 SQL 语句的动态拼接。例如,使用 <if> 标签实现条件查询:
<select id="getUserByCondition" resultType="com.example.entity.User">
SELECT * FROM user
<where>
<if test="username != null">
AND username = #{username}
</if>
<if test="password != null">
AND password = #{password}
</if>
</where>
</select>
3.2 缓存
MyBatis 提供了两种类型的缓存:一级缓存和二级缓存。一级缓存是本地缓存,只对当前会话有效;二级缓存是全局缓存,可以在多个会话间共享。
<cache eviction="FIFO" flushInterval="60000" size="512" readOnly="true"/>
3.3 批处理
MyBatis 支持批处理,可以批量插入、删除和更新数据。使用 <foreach> 标签实现批处理:
<insert id="batchInsert" parameterType="java.util.List">
INSERT INTO user (username, password) VALUES
<foreach collection="list" item="user" separator=",">
(#{user.username}, #{user.password})
</foreach>
</insert>
四、总结
本文介绍了 MyBatis 的基本使用和高级特性,从搭建环境到实践应用,帮助您快速入门 MyBatis。在实际项目中,您可以根据需求灵活运用 MyBatis 的各种特性,提高开发效率。希望本文能对您有所帮助!
