MyBatis 是一个优秀的持久层框架,它支持定制化 SQL、存储过程以及高级映射。MyBatis 避免了几乎所有的 JDBC 代码和手动设置参数以及获取结果集的工作。MyBatis 可以使用简单的 XML 或注解用于配置和原始映射,将接口和 Java 的 POJOs(Plain Old Java Objects,普通的 Java对象)映射成数据库中的记录。
MyBatis 简介
MyBatis 最初是由原 iBATIS 框架的作者 MyBatis 集团开发,旨在简化 SQL 映射和数据库操作。与 Hibernate 等全栈框架相比,MyBatis 更加轻量级,提供了更高的灵活性。
MyBatis 的核心特性
- 接口和映射文件的分离:可以将 SQL 映射配置在 XML 文件中,与 Java 代码分离,使得代码更清晰易维护。
- 动态 SQL:支持动态 SQL,可以根据不同的条件执行不同的 SQL 语句。
- 缓存机制:MyBatis 支持一级缓存和二级缓存,可以显著提高性能。
- 插件机制:MyBatis 提供了插件机制,可以扩展其功能。
环境搭建
1. 环境要求
- Java 8 或以上版本
- MySQL 或其他数据库
- Maven 或 Gradle 作为构建工具
2. 创建项目
使用 Maven 创建一个 Java Web 项目,并在 pom.xml 文件中添加 MyBatis 依赖。
<dependencies>
<dependency>
<groupId>org.mybatis</groupId>
<artifactId>mybatis</artifactId>
<version>3.5.7</version>
</dependency>
<!-- 数据库连接池 -->
<dependency>
<groupId>com.alibaba</groupId>
<artifactId>druid</artifactId>
<version>1.2.5</version>
</dependency>
<!-- MySQL 驱动 -->
<dependency>
<groupId>mysql</groupId>
<artifactId>mysql-connector-java</artifactId>
<version>8.0.23</version>
</dependency>
<!-- Spring 依赖 -->
<dependency>
<groupId>org.springframework</groupId>
<artifactId>spring-context</artifactId>
<version>5.3.10</version>
</dependency>
</dependencies>
3. 配置数据库连接
在 application.properties 或 application.yml 文件中配置数据库连接信息。
# application.properties
db.url=jdbc:mysql://localhost:3306/mydb
db.username=root
db.password=root
db.driver=com.mysql.cj.jdbc.Driver
MyBatis 核心配置
1. mybatis-config.xml
这是 MyBatis 的核心配置文件,包含数据源、事务管理器、环境配置、映射器等。
<?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"/>
<property name="username" value="root"/>
<property name="password" value="root"/>
</dataSource>
</environment>
</environments>
<mappers>
<mapper resource="com/example/mapper/UserMapper.xml"/>
</mappers>
</configuration>
2. 映射文件
映射文件用于定义 SQL 语句和与 Java 类的映射关系。
<?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.domain.User">
SELECT * FROM user WHERE id = #{id}
</select>
</mapper>
使用 MyBatis 进行数据库操作
1. 创建接口
public interface UserMapper {
User selectById(Integer id);
}
2. 创建 Java 实体类
public class User {
private Integer id;
private String name;
// getter 和 setter 方法
}
3. 创建 MyBatis 会话工厂
public class MyBatisUtil {
public static SqlSession getSqlSession() {
try {
// 创建 SQL 会话工厂
SqlSessionFactory sqlSessionFactory = new SqlSessionFactoryBuilder().build(new FileInputStream("mybatis-config.xml"));
// 使用 SQL 会话工厂创建 SQL 会话
return sqlSessionFactory.openSession();
} catch (Exception e) {
e.printStackTrace();
}
return null;
}
}
4. 使用 MyBatis 进行数据库操作
public class UserDemo {
public static void main(String[] args) {
SqlSession sqlSession = MyBatisUtil.getSqlSession();
try {
UserMapper mapper = sqlSession.getMapper(UserMapper.class);
User user = mapper.selectById(1);
System.out.println(user);
} finally {
sqlSession.close();
}
}
}
MyBatis 实战技巧
1. 使用注解进行映射
MyBatis 支持使用注解进行映射,使代码更简洁。
public interface UserMapper {
@Select("SELECT * FROM user WHERE id = #{id}")
User selectById(Integer id);
}
2. 动态 SQL
使用 <if>, <choose>, <when>, <otherwise> 等标签实现动态 SQL。
<select id="selectUsers" resultType="User">
SELECT * FROM user
<where>
<if test="name != null">
AND name = #{name}
</if>
<if test="email != null">
AND email = #{email}
</if>
</where>
</select>
3. 分页查询
使用 <foreach> 和 <choose> 标签实现分页查询。
<select id="selectUsers" resultType="User">
SELECT * FROM user
LIMIT #{start}, #{length}
</select>
4. 缓存机制
MyBatis 提供了一级缓存和二级缓存机制,可以有效地提高查询性能。
<cache eviction="FIFO" flushInterval="60000" size="512" readOnly="true"/>
总结
通过本文,我们学习了 MyBatis 的基本概念、环境搭建、核心配置、数据库操作以及一些实战技巧。MyBatis 是一个强大的持久层框架,可以帮助我们高效地搭建 Java 应用程序的数据持久层。希望本文能帮助你快速上手 MyBatis,并应用于实际项目中。
