MyBatis持久层框架教程：入门与实践指南-原创手记-慕课网

概述

MyBatis是一款优秀的持久层框架，提供了灵活的数据库访问方式，简化了数据库操作。本文将详细介绍MyBatis持久层框架教程，包括其基本概念、优势、应用场景以及如何进行环境搭建和配置。通过示例代码，读者可以了解MyBatis的核心配置文件编写、映射文件的创建和常用标签与注解的使用方法。

MyBatis 持久层框架教程：入门与实践指南

MyBatis 基本概念

MyBatis 是一款优秀的持久层框架，它支持自定义 SQL、存储过程以及高级映射。MyBatis 可以消除几乎所有的 JDBC 代码和手动设置参数以及获取结果集的工作，它的设计目标是将数据库的交互从业务逻辑代码中分离出来。通过配置文件，可以方便地将 SQL 语句映射到 Java 方法上，从而简化了数据库访问代码的编写。

MyBatis 的优势

灵活性：MyBatis 使用 XML 或注解来配置数据库映射关系，提供了一种灵活的数据库访问方式。
高性能：MyBatis 通过直接使用 JDBC、没有中间层，所以性能优于 Hibernate。
代码简洁：MyBatis 的代码量相对较少，不需要复杂的对象关系映射和大量的配置文件。

MyBatis 的应用场景

大型企业系统
高性能网站
需要灵活数据库访问的项目

MyBatis 与 JDBC 的区别

JDBC 是 Java 语言访问数据库的标准接口，而 MyBatis 是在 JDBC 的基础上进行了封装，提供了更简单的访问数据库的方式。JDBC 代码复杂，编写 SQL 时需要手动处理结果集；而 MyBatis 通过配置文件自动处理 SQL 语句和结果集，简化了数据库访问代码。

MyBatis 环境搭建

开发环境的配置

在开发 MyBatis 应用程序之前，需要搭建一个适合的开发环境。首先，确保环境已经安装了 Java 开发工具包（JDK）、数据库（如 MySQL）和一个集成开发环境（IDE，如 IntelliJ IDEA 或 Eclipse）。

添加 MyBatis 依赖

在 Maven 项目中，可以通过在 pom.xml 文件中添加 MyBatis 的依赖来引入 MyBatis 框架。以下是添加 MyBatis 依赖的示例：

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

创建第一个 MyBatis 应用程序

一个简单的 MyBatis 应用程序通常包括以下步骤：

创建数据库连接。
创建 SqlSessionFactory。
使用 SqlSessionFactory 创建 SqlSession。
使用 SqlSession 执行 SQL 语句。
关闭 SqlSession。

以下是一个简单的示例代码：

import org.apache.ibatis.session.SqlSession;
import org.apache.ibatis.session.SqlSessionFactory;
import org.apache.ibatis.session.SqlSessionFactoryBuilder;

import java.io.InputStream;

public class MyBatisDemo {
    public static void main(String[] args) {
        // 1. 读取 MyBatis 配置文件
        String resource = "mybatis-config.xml";
        InputStream inputStream = MyBatisDemo.class.getClassLoader().getResourceAsStream(resource);

        // 2. 创建 SqlSessionFactory
        SqlSessionFactory sqlSessionFactory = new SqlSessionFactoryBuilder().build(inputStream);

        // 3. 使用 SqlSessionFactory 创建 SqlSession
        try (SqlSession session = sqlSessionFactory.openSession()) {
            // 4. 使用 SqlSession 执行 SQL 语句
            MyBatisUserMapper mapper = session.getMapper(MyBatisUserMapper.class);
            List<User> users = mapper.selectAllUsers();
            for (User user : users) {
                System.out.println(user);
            }
        }
    }
}

MyBatis 核心配置文件详解

配置文件结构

MyBatis 的配置文件通常命名为 mybatis-config.xml，它包含数据库连接配置、映射文件配置、类型别名配置、插件配置等信息。

1. 数据源配置

<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/mydatabase"/>
                <property name="username" value="root"/>
                <property name="password" value="password"/>
            </dataSource>
        </environment>
    </environments>
</configuration>

2. SQL 映射文件配置

<configuration>
    <mappers>
        <mapper resource="com/example/mapper/UserMapper.xml"/>
    </mappers>
</configuration>

3. 类型别名配置

<configuration>
    <typeAliases>
        <typeAlias type="com.example.User" alias="User"/>
    </typeAliases>
</configuration>

4. 完整的 `mybatis-config.xml` 文件

<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/mydatabase"/>
                <property name="username" value="root"/>
                <property name="password" value="password"/>
            </dataSource>
        </environment>
    </environments>
    <mappers>
        <mapper resource="com/example/mapper/UserMapper.xml"/>
    </mappers>
    <typeAliases>
        <typeAlias type="com.example.User" alias="User"/>
    </typeAliases>
</configuration>

MyBatis 映射文件的编写

创建映射文件

映射文件通常命名为 UserMapper.xml，它定义了与数据库表之间的映射关系。该文件中包含 SQL 语句及其对应的 Java 方法。

1. 编写 SQL 语句

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

2. 结果集映射与映射关系

结果集映射定义了从数据库返回的结果集如何映射到 Java 对象。如上例中，resultType 用于指定返回的 Java 类型。

public interface UserMapper {
    User selectUserById(int id);
}

3. 完整的 `UserMapper.xml` 文件

<mapper namespace="com.example.mapper.UserMapper">
    <select id="selectUserById" resultType="User">
        SELECT * FROM users WHERE id = #{id}
    </select>
    <select id="selectAllUsers" resultType="User">
        SELECT * FROM users
    </select>
    <insert id="insertUser" parameterType="User">
        INSERT INTO users (id, name, email) VALUES (#{id}, #{name}, #{email})
    </insert>
    <update id="updateUser" parameterType="User">
        UPDATE users SET name = #{name}, email = #{email} WHERE id = #{id}
    </update>
    <delete id="deleteUser" parameterType="User">
        DELETE FROM users WHERE id = #{id}
    </delete>
</mapper>

MyBatis 常用标签与注解讲解

使用标签实现 SQL 动态拼装

MyBatis 提供了多种标签来实现 SQL 动态拼装，如 <if>、<choose>、<when>、<otherwise>、<foreach> 等。

示例代码

<select id="selectUsersByCondition" resultType="User">
    SELECT * FROM users
    <where>
        <if test="id != null">
            AND id = #{id}
        </if>
        <if test="name != null">
            AND name = #{name}
        </if>
    </where>
</select>

使用注解简化开发过程

MyBatis 也支持使用注解来代替 XML 配置，简化了开发过程。以下是一个使用注解的例子：

import org.apache.ibatis.annotations.Select;

public interface UserMapper {
    @Select("SELECT * FROM users WHERE id = #{id}")
    User selectUserById(int id);
    @Select("SELECT * FROM users")
    List<User> selectAllUsers();
    @Insert("INSERT INTO users (id, name, email) VALUES (#{id}, #{name}, #{email})")
    void insertUser(User user);
    @Update("UPDATE users SET name = #{name}, email = #{email} WHERE id = #{id}")
    void updateUser(User user);
    @Delete("DELETE FROM users WHERE id = #{id}")
    void deleteUser(User user);
}

MyBatis 事务管理与异常处理

事务的配置与使用

MyBatis 支持在配置文件中配置事务管理器，并通过 SqlSession 的 commit 和 rollback 方法来控制事务的提交和回滚。

示例代码

try (SqlSession session = sqlSessionFactory.openSession()) {
    UserMapper mapper = session.getMapper(UserMapper.class);
    User user = mapper.selectUserById(1);
    user.setName("New Name");
    mapper.updateUser(user);
    session.commit(); // 提交事务
} catch (Exception e) {
    // 捕获异常并回滚事务
    e.printStackTrace();
    session.rollback();
}

错误与异常的捕获与处理

在处理数据库操作时，可能会遇到各种错误和异常。MyBatis 提供了异常处理机制，可以通过捕获异常来处理错误情况。

示例代码

try {
    // 数据库操作代码
} catch (MyBatisSystemException e) {
    // 处理 MyBatis 系统异常
} catch (SqlSessionException e) {
    // 处理 SqlSession 异常
} catch (Exception e) {
    // 捕获其他异常
}

通过以上步骤和示例代码，你可以开始使用 MyBatis 进行数据库操作。在实际开发中，可以根据项目需求选择配置文件或注解来编写映射文件，并根据业务需求配置事务管理和异常处理。更多详细信息和高级用法可以参考 MyBatis 的官方文档。