正文

手把手教你精通Java开源框架MyBatis：从入门到实践

/0 浏览量
0527

引言

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

第一部分：MyBatis 入门

1.1 MyBatis 简介

MyBatis 是一个半自动化的持久层框架，它将 SQL 映射成 Java 代码，简化了数据库操作。它支持自定义 SQL、存储过程以及高级映射。

1.2 MyBatis 工作原理

MyBatis 通过 XML 或注解配置 SQL 语句，将 SQL 与 Java 代码分离，使得 SQL 语句更加清晰易读。MyBatis 使用 SQL 映射文件（XML）来定义 SQL 语句，并通过 Java 接口调用这些 SQL 语句。

1.3 MyBatis 的优势

  • 简化 JDBC 编程
  • 高度可配置
  • 支持自定义 SQL
  • 支持缓存机制

第二部分：MyBatis 实践

2.1 环境搭建

  1. 添加依赖
<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.26</version>
    </dependency>
</dependencies>
  1. 配置数据库

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

# 数据库连接信息
spring.datasource.url=jdbc:mysql://localhost:3306/mybatis_db?useUnicode=true&characterEncoding=utf8&useSSL=false
spring.datasource.username=root
spring.datasource.password=root
spring.datasource.driver-class-name=com.mysql.cj.jdbc.Driver
  1. 创建实体类

创建一个实体类 User，对应数据库中的 user 表：

public class User {
    private Integer id;
    private String name;
    private Integer age;
    // 省略 getter 和 setter 方法
}
  1. 创建接口

创建一个 MyBatis 映射接口 UserMapper：

public interface UserMapper {
    User getUserById(Integer id);
}
  1. 创建 XML 映射文件

创建一个 XML 映射文件 UserMapper.xml，配置 SQL 语句：

<mapper namespace="com.example.mapper.UserMapper">
    <select id="getUserById" resultType="com.example.entity.User">
        SELECT * FROM user WHERE id = #{id}
    </select>
</mapper>
  1. 配置 MyBatis 配置文件

创建一个 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?useUnicode=true&characterEncoding=utf8&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>
  1. 使用 MyBatis

创建一个测试类 MyBatisTest，使用 MyBatis 进行数据库操作：

public class MyBatisTest {
    public static void main(String[] args) throws IOException {
        // 创建 SqlSessionFactory
        String resource = "mybatis-config.xml";
        InputStream inputStream = Resources.getResourceAsStream(resource);
        SqlSessionFactory sqlSessionFactory = new SqlSessionFactoryBuilder().build(inputStream);

        // 创建 SqlSession
        SqlSession sqlSession = sqlSessionFactory.openSession();

        // 创建 UserMapper 接口的代理对象
        UserMapper userMapper = sqlSession.getMapper(UserMapper.class);

        // 调用方法
        User user = userMapper.getUserById(1);
        System.out.println(user);

        // 关闭资源
        sqlSession.close();
    }
}

2.2 高级特性

  1. 动态 SQL

MyBatis 支持动态 SQL，可以根据条件动态拼接 SQL 语句。

<select id="selectUsers" resultType="User">
    SELECT * FROM users
    <where>
        <if test="username != null">
            AND username = #{username}
        </if>
        <if test="address != null">
            AND address = #{address}
        </if>
    </where>
</select>
  1. 关联映射

MyBatis 支持关联映射，将多个表的数据映射到一个实体类中。

<resultMap id="userResultMap" type="User">
    <id property="id" column="id"/>
    <result property="username" column="username"/>
    <result property="address" column="address"/>
    <collection property="orders" column="id" select="selectOrders"/>
</resultMap>

<select id="selectUser" resultMap="userResultMap">
    SELECT * FROM users WHERE id = #{id}
</select>

<select id="selectOrders" resultMap="orderResultMap">
    SELECT * FROM orders WHERE user_id = #{id}
</select>
  1. 缓存机制

MyBatis 支持一级缓存和二级缓存，可以减少数据库访问次数，提高性能。

<cache eviction="FIFO" flushInterval="60000" size="512" readOnly="true"/>

第三部分：总结

通过本文的学习，相信你已经对 MyBatis 有了一定的了解。MyBatis 是一个功能强大、易于使用的持久层框架，可以帮助你简化数据库操作。在实际项目中，你可以根据自己的需求选择合适的 MyBatis 配置方式，例如 XML 或注解。希望本文能帮助你精通 MyBatis，在项目中发挥其优势。

-- 展开阅读全文 --