正文

新手必看：从入门到精通，MyBatis开源框架实用教程及实战案例

/0 浏览量
0705

引言

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

对于新手来说，从入门到精通 MyBatis 可能会有些挑战，但通过以下教程和实战案例，你可以逐步掌握这个强大的框架。

第一章：MyBatis 入门

1.1 MyBatis 简介

MyBatis 是一个半自动化的持久层框架，它允许你将 SQL 映射到 Java 接口和 POJOs 上。MyBatis 避免了几乎所有的 JDBC 代码和手动设置参数以及获取结果集的过程。

1.2 MyBatis 的特点

  • 简单的 XML 或注解配置：MyBatis 使用简单的 XML 或注解来配置 SQL 映射，这使得代码更加简洁。
  • 接口和 Java POJOs 的映射：MyBatis 可以将接口和 Java POJOs 映射成数据库中的记录。
  • 灵活的映射：MyBatis 提供了强大的映射功能，支持多种映射方式。
  • 插件扩展：MyBatis 支持插件扩展，例如分页插件等。

1.3 MyBatis 的安装

你可以通过 Maven 或直接下载 MyBatis 的 jar 包来安装 MyBatis。

<!-- Maven 依赖 -->
<dependency>
    <groupId>org.mybatis</groupId>
    <artifactId>mybatis</artifactId>
    <version>3.5.6</version>
</dependency>

第二章：MyBatis 基础

2.1 SQL 映射

MyBatis 使用 XML 或注解来配置 SQL 映射。以下是一个简单的 XML 映射示例：

<mapper namespace="com.example.mapper.UserMapper">
    <select id="selectById" resultType="com.example.entity.User">
        SELECT * FROM users WHERE id = #{id}
    </select>
</mapper>

2.2 接口和 POJOs 的映射

MyBatis 可以将接口和 Java POJOs 映射成数据库中的记录。以下是一个简单的接口和 POJOs 的映射示例：

public interface UserMapper {
    User selectById(Integer id);
}

public class User {
    private Integer id;
    private String name;
    // getters and setters
}

2.3 MyBatis 配置

MyBatis 的配置文件通常包含数据库连接信息、事务管理器、映射文件等。以下是一个简单的 MyBatis 配置文件示例：

<?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.jdbc.Driver"/>
                <property name="url" value="jdbc:mysql://localhost:3306/mydb"/>
                <property name="username" value="root"/>
                <property name="password" value=""/>
            </dataSource>
        </environment>
    </environments>
    <mappers>
        <mapper resource="com/example/mapper/UserMapper.xml"/>
    </mappers>
</configuration>

第三章：MyBatis 进阶

3.1 动态 SQL

MyBatis 支持动态 SQL，可以让你根据条件动态地构建 SQL 语句。以下是一个使用 <if> 标签的动态 SQL 示例：

<select id="selectByCondition" resultType="com.example.entity.User">
    SELECT * FROM users
    <where>
        <if test="name != null">
            AND name = #{name}
        </if>
        <if test="age != null">
            AND age = #{age}
        </if>
    </where>
</select>

3.2 关联映射

MyBatis 支持关联映射，可以将一个实体映射到多个相关联的实体。以下是一个使用 <collection> 标签的关联映射示例：

<select id="selectUserAndOrders" resultType="com.example.entity.User">
    SELECT u.*, o.*
    FROM users u
    LEFT JOIN orders o ON u.id = o.user_id
    WHERE u.id = #{id}
</select>

3.3 缓存

MyBatis 支持一级缓存和二级缓存。一级缓存是 SQL 会话级别的缓存，二级缓存是映射器级别的缓存。以下是如何启用二级缓存：

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

第四章：MyBatis 实战案例

4.1 创建项目

首先，创建一个 Maven 项目，并添加 MyBatis 依赖。

4.2 创建数据库表

创建一个用户表和订单表，用于后续的示例。

CREATE TABLE users (
    id INT PRIMARY KEY AUTO_INCREMENT,
    name VARCHAR(50),
    age INT
);

CREATE TABLE orders (
    id INT PRIMARY KEY AUTO_INCREMENT,
    user_id INT,
    order_date DATE,
    amount DECIMAL(10, 2)
);

4.3 创建实体类

创建 User 和 Order 实体类。

public class User {
    private Integer id;
    private String name;
    private Integer age;
    // getters and setters
}

public class Order {
    private Integer id;
    private Integer userId;
    private Date orderDate;
    private BigDecimal amount;
    // getters and setters
}

4.4 创建接口

创建 UserMapper 接口。

public interface UserMapper {
    User selectById(Integer id);
    List<Order> selectOrdersByUserId(Integer userId);
}

4.5 创建映射文件

创建 UserMapper.xml 映射文件。

<mapper namespace="com.example.mapper.UserMapper">
    <select id="selectById" resultType="com.example.entity.User">
        SELECT * FROM users WHERE id = #{id}
    </select>
    <select id="selectOrdersByUserId" resultType="com.example.entity.Order">
        SELECT * FROM orders WHERE user_id = #{userId}
    </select>
</mapper>

4.6 创建配置文件

创建 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.jdbc.Driver"/>
                <property name="url" value="jdbc:mysql://localhost:3306/mydb"/>
                <property name="username" value="root"/>
                <property name="password" value=""/>
            </dataSource>
        </environment>
    </environments>
    <mappers>
        <mapper resource="com/example/mapper/UserMapper.xml"/>
    </mappers>
</configuration>

4.7 编写测试代码

编写测试代码来验证 MyBatis 的功能。

public class MyBatisTest {
    public static void main(String[] args) throws IOException {
        String resource = "mybatis-config.xml";
        InputStream inputStream = Resources.getResourceAsStream(resource);
        SqlSessionFactory sqlSessionFactory = new SqlSessionFactoryBuilder().build(inputStream);
        SqlSession sqlSession = sqlSessionFactory.openSession();
        
        try {
            UserMapper mapper = sqlSession.getMapper(UserMapper.class);
            User user = mapper.selectById(1);
            System.out.println(user.getName());
            
            List<Order> orders = mapper.selectOrdersByUserId(1);
            for (Order order : orders) {
                System.out.println(order.getId());
            }
        } finally {
            sqlSession.close();
        }
    }
}

第五章：总结

通过以上教程和实战案例，你应该已经对 MyBatis 有了一定的了解。MyBatis 是一个功能强大的持久层框架，可以帮助你简化数据库操作。希望这份教程能帮助你从入门到精通 MyBatis。

-- 展开阅读全文 --