正文

新手必看：Java开源框架MyBatis全攻略，从入门到精通

/0 浏览量
0620

引言

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

对于初学者来说，掌握 MyBatis 可以大大提高开发效率，降低数据库操作复杂度。本文将带你从 MyBatis 的入门开始，逐步深入到高级应用，助你成为 MyBatis 的行家里手。

一、MyBatis 简介

1.1 MyBatis 的特点

  • 半自动化处理：MyBatis 只在处理 SQL 映射语句时自动处理，其他操作仍然需要手动完成。
  • 灵活的映射方式：MyBatis 提供了 XML 和注解两种映射方式，可以根据项目需求灵活选择。
  • 易于扩展：MyBatis 提供了丰富的插件机制，方便开发者进行功能扩展。

1.2 MyBatis 的架构

MyBatis 主要由以下几个组件组成：

  • SqlSessionFactory：用于创建 SqlSession，SqlSession 是 MyBatis 的核心接口，用于执行 SQL 语句。
  • SqlSession：用于执行 SQL 语句，获取映射器（Mapper）等。
  • Executor：负责执行 SQL 语句，包括查询、更新、删除等操作。
  • Mapper：接口，定义了数据库操作的方法。
  • MappedStatement：映射器中的 SQL 语句和参数信息。

二、MyBatis 入门

2.1 环境搭建

  1. 添加依赖：在项目的 pom.xml 文件中添加 MyBatis 依赖。
<dependency>
    <groupId>org.mybatis</groupId>
    <artifactId>mybatis</artifactId>
    <version>3.5.7</version>
</dependency>
  1. 配置数据库：在 application.properties 或 application.yml 文件中配置数据库连接信息。
# application.properties
jdbc.url=jdbc:mysql://localhost:3306/mybatis_db
jdbc.username=root
jdbc.password=root
jdbc.driver=com.mysql.cj.jdbc.Driver
  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"/>
                <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 {
    User getUserById(Integer id);
}

2.3 编写 Mapper 映射文件

在 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>

2.4 测试

在 com.example.mapper 包下创建 UserMapperTest.java 测试类，进行测试。

package com.example.mapper;

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

public class UserMapperTest {
    public static void main(String[] args) {
        try {
            // 创建 SqlSessionFactory
            SqlSessionFactory sqlSessionFactory = new SqlSessionFactoryBuilder().build();
            // 获取 SqlSession
            SqlSession sqlSession = sqlSessionFactory.openSession();
            // 获取 UserMapper
            UserMapper userMapper = sqlSession.getMapper(UserMapper.class);
            // 获取用户信息
            User user = userMapper.getUserById(1);
            System.out.println(user);
            // 关闭 SqlSession
            sqlSession.close();
        } catch (Exception e) {
            e.printStackTrace();
        }
    }
}

三、MyBatis 高级应用

3.1 动态 SQL

MyBatis 支持动态 SQL，可以灵活地构建 SQL 语句。

<select id="selectUsers" resultType="User">
    SELECT * FROM users
    <where>
        <if test="user.id != null">
            AND id = #{user.id}
        </if>
        <if test="user.username != null">
            AND username = #{user.username}
        </if>
    </where>
</select>

3.2 缓存

MyBatis 提供了两种缓存机制：一级缓存和二级缓存。

  • 一级缓存：SqlSession 缓存，在同一个 SqlSession 中，相同查询结果会被缓存。
  • 二级缓存：Mapper 缓存，在同一个 Mapper 中，相同查询结果会被缓存。

3.3 批处理

MyBatis 支持批处理操作，可以一次性执行多条 SQL 语句。

List<User> users = sqlSession.selectList("com.example.mapper.UserMapper.selectUsers");
sqlSession.delete("com.example.mapper.UserMapper.deleteUsers", users);

四、总结

本文从 MyBatis 的入门到高级应用进行了详细讲解，希望能帮助新手快速掌握 MyBatis。在实际开发中，不断积累经验，熟练运用 MyBatis 的各项功能，将大大提高开发效率。

-- 展开阅读全文 --