MyBatis 是一个优秀的持久层框架,它消除了几乎所有的 JDBC 代码和手动设置参数以及获取结果集的过程。MyBatis 可以使用简单的 XML 或注解用于配置和原始映射,将接口和 Java 的 POJOs(Plain Old Java Objects,普通的 Java对象)映射成数据库中的记录。下面,我将带你从零开始,了解 MyBatis,并学习如何使用它来轻松搞定数据库操作。
一、MyBatis 简介
1.1 MyBatis 的优势
- 易用性:MyBatis 可以通过简单的 XML 或注解来配置 SQL,让开发者无需编写繁琐的 JDBC 代码。
- 可扩展性:MyBatis 提供了丰富的扩展点,如插件、自定义类型处理器等,可以满足各种需求。
- 支持定制化:MyBatis 支持自定义 SQL 映射,允许开发者根据实际需求定制查询语句。
- 支持多种数据库:MyBatis 支持多种数据库,如 MySQL、Oracle、SQL Server 等。
1.2 MyBatis 的适用场景
- 项目规模较小:对于小型项目,MyBatis 可以简化数据库操作,提高开发效率。
- 需求多变:MyBatis 的灵活性和可扩展性,可以方便地应对需求变化。
- 性能要求较高:MyBatis 可以通过缓存机制提高数据库操作性能。
二、MyBatis 快速入门
2.1 环境搭建
- 下载 MyBatis:从 MyBatis 官网下载最新版本的 MyBatis 以及依赖库。
- 创建 Maven 项目:在 IDEA 或 Eclipse 中创建一个 Maven 项目,并添加 MyBatis 依赖。
<dependencies>
<dependency>
<groupId>org.mybatis</groupId>
<artifactId>mybatis</artifactId>
<version>3.5.6</version>
</dependency>
<!-- 其他依赖,如数据库驱动、日志等 -->
</dependencies>
- 配置 MyBatis:在
src/main/resources目录下创建mybatis-config.xml文件,配置数据库连接信息、事务管理、映射文件路径等。
<configuration>
<environments default="development">
<environment id="development">
<transactionManager type="JDBC"/>
<dataSource type="POOLED">
<property name="driver" value="com.mysql.jdbc.Driver"/>
<property name="url" value="jdbc:mysql://localhost:3306/test"/>
<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 接口
在 com/example/mapper 目录下创建 UserMapper.java 接口,定义数据库操作方法。
package com.example.mapper;
public interface UserMapper {
void addUser(User user);
User getUserById(int id);
}
2.3 编写 Mapper XML
在 src/main/resources/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">
<insert id="addUser" parameterType="User">
INSERT INTO user (name, age) VALUES (#{name}, #{age})
</insert>
<select id="getUserById" parameterType="int" resultType="User">
SELECT * FROM user WHERE id = #{id}
</select>
</mapper>
2.4 使用 MyBatis
- 创建 SqlSessionFactory:在
MyBatisConfig.java文件中创建SqlSessionFactory实例。
package com.example.config;
import org.apache.ibatis.session.SqlSessionFactory;
import org.apache.ibatis.session.SqlSessionFactoryBuilder;
public class MyBatisConfig {
public static SqlSessionFactory sqlSessionFactory() throws Exception {
String resource = "mybatis-config.xml";
InputStream inputStream = Resources.getResourceAsStream(resource);
return new SqlSessionFactoryBuilder().build(inputStream);
}
}
- 获取 SqlSession:在业务代码中,获取
SqlSession实例,并使用其执行数据库操作。
package com.example.service;
import com.example.mapper.UserMapper;
import com.example.model.User;
import org.apache.ibatis.session.SqlSession;
public class UserService {
public void addUser(User user) {
try (SqlSession session = MyBatisConfig.sqlSessionFactory().openSession()) {
UserMapper userMapper = session.getMapper(UserMapper.class);
userMapper.addUser(user);
session.commit();
}
}
public User getUserById(int id) {
try (SqlSession session = MyBatisConfig.sqlSessionFactory().openSession()) {
UserMapper userMapper = session.getMapper(UserMapper.class);
return userMapper.getUserById(id);
}
}
}
三、MyBatis 实战解析
3.1 MyBatis 缓存机制
MyBatis 提供了两种类型的缓存:一级缓存和二级缓存。
- 一级缓存:默认开启,只针对同一个
SqlSession有效,用于存储同一个SqlSession中执行过的查询。 - 二级缓存:全局缓存,对整个应用有效,可跨
SqlSession,但需要手动开启。
3.2 MyBatis 动态 SQL
MyBatis 支持动态 SQL,可以根据条件动态构建 SQL 语句。
<select id="getUserByCondition" parameterType="map" resultType="User">
SELECT * FROM user
<where>
<if test="name != null">
AND name = #{name}
</if>
<if test="age != null">
AND age = #{age}
</if>
</where>
</select>
3.3 MyBatis 插件
MyBatis 插件可以扩展 MyBatis 的功能,如拦截 SQL 执行、结果处理等。
package com.example.plugin;
import org.apache.ibatis.executor.statement.StatementHandler;
import org.apache.ibatis.plugin.*;
import java.sql.Connection;
import java.util.Properties;
@Intercepts({@Signature(type = StatementHandler.class, method = "prepare", args = {Connection.class, Integer.class})})
public class ExamplePlugin implements Interceptor {
@Override
public Object intercept(Invocation invocation) throws Throwable {
// 在这里实现自定义逻辑
return invocation.proceed();
}
@Override
public Object plugin(Object target) {
return Plugin.wrap(target, this);
}
@Override
public void setProperties(Properties properties) {
// 设置插件属性
}
}
在 mybatis-config.xml 文件中注册插件:
<plugins>
<plugin interceptor="com.example.plugin.ExamplePlugin"/>
</plugins>
四、总结
通过本文的介绍,相信你已经对 MyBatis 有了一定的了解。MyBatis 是一个功能强大、易于使用的持久层框架,可以帮助开发者轻松搞定数据库操作。希望本文能帮助你快速入门 MyBatis,并在实际项目中发挥其魅力。
