MyBatis 是一个优秀的持久层框架,它消除了几乎所有的 JDBC 代码和手动设置参数以及获取结果集的过程。MyBatis 可以使用简单的 XML 或注解用于配置和原始映射,将接口和 Java 的 POJOs(Plain Old Java Objects,普通的 Java对象)映射成数据库中的记录。
MyBatis 简介
MyBatis 遵循约定优于配置( Convention Over Configuration)的原则,这使得它在易用性和性能之间取得了很好的平衡。MyBatis 的核心功能包括:
- 映射接口到 XML 文件:将 SQL 映射到接口的方法上,接口中的方法名称即 SQL 语句的 ID。
- SQL 映射文件:XML 文件中配置 SQL 语句,可以包含参数映射、结果映射等。
- 动态 SQL:使用 OGNL 表达式进行动态 SQL 的构建。
- 缓存机制:支持一级缓存和二级缓存,提高查询效率。
入门指南
1. 环境搭建
首先,确保你的开发环境已经安装了 Java 和 Maven。接着,你可以通过以下步骤来搭建 MyBatis 的开发环境:
- 添加依赖:在你的 Maven 项目中添加 MyBatis 的依赖。
<dependencies>
<dependency>
<groupId>org.mybatis</groupId>
<artifactId>mybatis</artifactId>
<version>3.5.7</version>
</dependency>
<dependency>
<groupId>mysql</groupId>
<artifactId>mysql-connector-java</artifactId>
<version>8.0.26</version>
</dependency>
</dependencies>
- 配置数据源:在
application.properties或application.yml中配置数据库连接信息。
# application.properties
jdbc.url=jdbc:mysql://localhost:3306/mydb
jdbc.username=root
jdbc.password=root
jdbc.driver=com.mysql.cj.jdbc.Driver
- 创建 MyBatis 配置文件:创建
mybatis-config.xml文件,配置数据源、事务管理器等。
<configuration>
<environments default="development">
<environment id="development">
<transactionManager type="JDBC"/>
<dataSource type="POOLED">
<property name="driver" value="${jdbc.driver}"/>
<property name="url" value="${jdbc.url}"/>
<property name="username" value="${jdbc.username}"/>
<property name="password" value="${jdbc.password}"/>
</dataSource>
</environment>
</environments>
<mappers>
<mapper resource="com/example/mapper/UserMapper.xml"/>
</mappers>
</configuration>
2. 创建 Mapper 接口
在 com.example.mapper 包下创建 UserMapper.java 接口,定义你需要执行的 SQL 语句。
package com.example.mapper;
public interface UserMapper {
User getUserById(int id);
}
3. 创建 Mapper XML 文件
在 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">
<select id="getUserById" resultType="com.example.entity.User">
SELECT * FROM user WHERE id = #{id}
</select>
</mapper>
4. 使用 MyBatis
在 com.example.service 包下创建 UserService.java,注入 SqlSessionFactory。
package com.example.service;
import com.example.mapper.UserMapper;
import com.example.entity.User;
import org.apache.ibatis.session.SqlSession;
import org.apache.ibatis.session.SqlSessionFactory;
public class UserService {
private final SqlSessionFactory sqlSessionFactory;
public UserService(SqlSessionFactory sqlSessionFactory) {
this.sqlSessionFactory = sqlSessionFactory;
}
public User getUserById(int id) {
try (SqlSession session = sqlSessionFactory.openSession()) {
UserMapper mapper = session.getMapper(UserMapper.class);
return mapper.getUserById(id);
}
}
}
核心技巧
1. 动态 SQL
MyBatis 提供了动态 SQL 功能,可以使用 <if>、<choose>、<when>、<otherwise> 等标签进行动态 SQL 的构建。
<select id="getUserList" resultType="com.example.entity.User">
SELECT * FROM user
<where>
<if test="name != null">
AND name = #{name}
</if>
<if test="age != null">
AND age = #{age}
</if>
</where>
</select>
2. 缓存机制
MyBatis 支持一级缓存和二级缓存。一级缓存是会话级别的缓存,二级缓存是映射器级别的缓存。
<cache eviction="FIFO" flushInterval="60000" size="512" readOnly="true"/>
3. 插入、更新、删除
MyBatis 提供了 <insert>、<update>、<delete> 标签来执行插入、更新、删除操作。
<insert id="insertUser" parameterType="com.example.entity.User">
INSERT INTO user (name, age) VALUES (#{name}, #{age})
</insert>
总结
MyBatis 是一个功能强大的 Java 开源框架,它可以帮助你简化数据库操作,提高项目效率。通过本文的介绍,相信你已经对 MyBatis 有了一定的了解。在实际开发中,不断实践和总结,你会更加熟练地使用 MyBatis。
