正文

从零开始：全面解读Java开源框架MyBatis的入门与进阶实战

/0 浏览量
0502

引言

MyBatis 是一个优秀的持久层框架，它消除了几乎所有的 JDBC 代码和手动设置参数以及获取结果集的工作。MyBatis 通过简单的 XML 或注解用于配置和原始映射，将接口和 Java 的 POJOs（Plain Old Java Objects，简单的 Java 对象）映射成数据库中的记录。

本文将从零开始，逐步深入地介绍 MyBatis 的入门知识，并探讨如何进阶实战，以帮助读者从初学者成长为 MyBatis 的熟练使用者。

入门篇

1. MyBatis 简介

MyBatis 是一个半自动化的持久层框架，它使用 XML 或注解来配置和原始映射，将接口和 Java 的 POJOs 映射成数据库中的记录。MyBatis 具有以下特点：

  • 简单的 XML 或注解配置：MyBatis 使用 XML 或注解来配置 SQL 映射，使得 SQL 语句的编写和管理更加简单。
  • 接口和 POJOs 映射：MyBatis 将接口和 Java 的 POJOs 映射成数据库中的记录，简化了数据库操作。
  • 灵活的映射机制：MyBatis 提供了丰富的映射机制，支持一对一、一对多、多对多等复杂关系的映射。

2. MyBatis 环境搭建

2.1 添加依赖

在项目的 pom.xml 文件中添加以下依赖：

<dependencies>
    <dependency>
        <groupId>org.mybatis</groupId>
        <artifactId>mybatis</artifactId>
        <version>3.5.6</version>
    </dependency>
    <dependency>
        <groupId>mysql</groupId>
        <artifactId>mysql-connector-java</artifactId>
        <version>8.0.23</version>
    </dependency>
</dependencies>

2.2 配置数据库

在 application.properties 文件中配置数据库连接信息：

# 数据库配置
spring.datasource.url=jdbc:mysql://localhost:3306/mybatis_example
spring.datasource.username=root
spring.datasource.password=root
spring.datasource.driver-class-name=com.mysql.cj.jdbc.Driver

2.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>
    <mappers>
        <mapper resource="com/example/mapper/UserMapper.xml"/>
    </mappers>
</configuration>

3. 编写 MyBatis 映射文件

在 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">
    <select id="selectById" resultType="com.example.entity.User">
        SELECT * FROM user WHERE id = #{id}
    </select>
</mapper>

4. 编写 MyBatis 接口

在 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);
}

5. 编写测试代码

在 com.example.mapper 包下创建 UserMapperTest.java 测试类：

package com.example.mapper;

import com.example.entity.User;
import org.apache.ibatis.session.SqlSession;
import org.apache.ibatis.session.SqlSessionFactory;
import org.apache.ibatis.session.SqlSessionFactoryBuilder;
import org.junit.Test;

public class UserMapperTest {
    @Test
    public void testSelectById() {
        SqlSessionFactory sqlSessionFactory = new SqlSessionFactoryBuilder().build();
        try (SqlSession sqlSession = sqlSessionFactory.openSession()) {
            UserMapper userMapper = sqlSession.getMapper(UserMapper.class);
            User user = userMapper.selectById(1);
            System.out.println(user);
        }
    }
}

进阶篇

1. 动态 SQL

MyBatis 提供了动态 SQL 功能，允许在 XML 映射文件中根据条件动态地构建 SQL 语句。动态 SQL 主要包括以下几种：

  • <if>：根据条件判断是否执行 SQL 语句。
  • <choose>、<when>、<otherwise>：类似于 Java 中的 switch 语句，根据条件执行不同的 SQL 语句。
  • <foreach>：用于遍历集合，执行循环操作。

2. 传入参数

MyBatis 支持多种参数传入方式，包括：

  • 基本数据类型
  • 对象
  • 集合
  • 枚举

3. 返回值

MyBatis 支持多种返回值类型，包括：

  • 单个对象
  • 集合
  • Map
  • 自定义对象

4. 缓存机制

MyBatis 提供了两种缓存机制：

  • 一级缓存：基于 SQL 会话的缓存，同一个 SQL 会话中的查询结果会被缓存。
  • 二级缓存：基于命名空间的缓存，同一个命名空间下的查询结果会被缓存。

5. 扩展功能

MyBatis 支持自定义插件，可以扩展其功能。例如，可以实现分页插件、日志插件等。

总结

MyBatis 是一个功能强大的持久层框架，通过本文的介绍，相信你已经对 MyBatis 的入门和进阶有了初步的了解。在实际项目中，MyBatis 可以帮助你简化数据库操作，提高开发效率。希望本文能够帮助你更好地掌握 MyBatis，并在实际项目中发挥其优势。

-- 展开阅读全文 --