5154

MyBatis 是一款优秀的持久层框架，它支持自定义 SQL、存储过程以及高级映射，MyBatis 免除了几乎所有的 JDBC 代码以及设置参数和获取结果集的工作，MyBatis 可以通过简单的 XML 或注解来配置和映射原始类型、接口和 Java POJO（Plain Old Java Objects，普通老式 Java 对象）为数据库中的记录，其核心思想是将 SQL 语句从程序代码中彻底分离，实现 SQL 的灵活配置和管理，本文将系统性地阐述如何使用 MyBatis 进行数据库查询，从基础配置到高级应用，帮助开发者全面掌握其查询机制。

核心组件与工作原理

在深入查询操作之前,理解 MyBatis 的几个核心组件至关重要，它们共同构成了 MyBatis 执行查询的基础架构。

• SqlSessionFactory：这是 MyBatis 应用程序的核心，是创建 SqlSession 的工厂，它可以通过 SqlSessionFactoryBuilder 从 XML 配置文件或一个预先配置的 Configuration 实例来构建。SqlSessionFactory 对象一旦被创建，就应该在应用的整个运行周期中存在，通常使用单例模式管理。
• SqlSession：SqlSession 是由 SqlSessionFactory 创建的，它包含了执行 SQL 命令所需的所有方法，你可以通过 SqlSession 实例来直接执行已映射的 SQL 语句，或者获取 Mapper 接口的代理实例来执行，它相当于一次数据库会话，是非线程安全的，因此它的最佳作用域是请求或方法作用域。
• Mapper Interface：这是一个 Java 接口，其方法签名与 Mapper XML 文件中定义的 SQL 语句 ID 相对应，MyBatis 通过动态代理技术，为这个接口生成一个代理实例，使得开发者可以像调用本地方法一样执行数据库操作，这种方式类型安全且易于维护。
• Mapper XML 文件：这是 MyBatis 的精髓所在，它用于定义 SQL 语句、参数映射和结果集映射，每个 SQL 语句（如 <select>、<insert>、<update>、<delete>）都有一个唯一的 id，该 id 与 Mapper 接口中的方法名绑定。

构建 MyBatis 查询的步骤

下面将通过一个完整的流程,演示如何从零开始构建一个 MyBatis 查询，假设我们要查询一个用户表 t_user。

准备环境与配置

需要在项目中引入 MyBatis 和数据库驱动的依赖（Maven），创建 MyBatis 的核心配置文件 mybatis-config.xml，其中主要包含数据源信息和 Mapper 文件的注册路径。

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

创建实体类（POJO）

创建一个与数据库表结构对应的 Java 类。

public class User {
    private Long id;
    private String name;
    private String email;
    // 省略 getters 和 setters
}

定义 Mapper 接口

定义一个 Java 接口，声明查询方法。

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

编写 Mapper XML 文件

在 mapper/UserMapper.xml 文件中编写具体的 SQL 语句，并将其与 Mapper 接口的方法绑定。

<?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="selectUserById" resultType="com.example.model.User">
        SELECT id, name, email FROM t_user WHERE id = #{id}
    </select>
</mapper>

这里的 id 属性 selectUserById 必须与 UserMapper 接口中的方法名完全一致。resultType 指定了查询结果应映射到的 Java 对象。#{id} 是 MyBatis 的预编译参数占位符，可以有效防止 SQL 注入。

执行查询

在 Java 代码中通过 SqlSession 来执行查询。

String resource = "mybatis-config.xml";
InputStream inputStream = Resources.getResourceAsStream(resource);
SqlSessionFactory sqlSessionFactory = new SqlSessionFactoryBuilder().build(inputStream);
try (SqlSession session = sqlSessionFactory.openSession()) {
    UserMapper mapper = session.getMapper(UserMapper.class);
    User user = mapper.selectUserById(1L);
    System.out.println(user.getName());
}

高级查询技巧

MyBatis 的强大之处在于其对复杂查询场景的支持。

动态 SQL

动态 SQL 是 MyBatis 的一个强大特性，它允许你根据不同的条件在 XML 中构建不同的 SQL 语句，极大地提高了 SQL 的复用性和灵活性，常用的标签包括 <if>、<choose>、<where>、<foreach> 等。

一个多条件查询：

<select id="selectUsersByCondition" resultType="User">
    SELECT * FROM t_user
    <where>
        <if test="name != null and name != ''">
            AND name LIKE CONCAT('%', #{name}, '%')
        </if>
        <if test="email != null and email != ''">
            AND email = #{email}
        </if>
    </where>
</select>

下表小编总结了常用的动态 SQL 标签及其作用：

结果映射

当数据库列名与 Java 对象属性名不一致时，可以使用 <resultMap> 进行自定义映射。

<resultMap id="userResultMap" type="User">
    <id property="id" column="user_id"/>
    <result property="name" column="user_name"/>
    <result property="email" column="email_address"/>
</resultMap>
<select id="selectUserById" resultMap="userResultMap">
    SELECT user_id, user_name, email_address FROM t_user WHERE id = #{id}
</select>

<resultMap> 提供了终极的映射控制能力，是处理复杂查询结果（如关联查询）的关键。

相关问答FAQs

问题1：MyBatis 中的 和 有什么区别？

解答： 是预编译处理，是 MyBatis 推荐的参数占位符，在 SQL 执行时，MyBatis 会将 替换为 ，然后使用 PreparedStatement 设置参数，这样可以有效防止 SQL 注入，并且更高效。 则是字符串替换，MyBatis 会将 包裹的内容直接原样拼接到 SQL 语句中，这种方式虽然灵活（例如可以动态传入表名或列名），但存在严重的 SQL 注入风险，必须谨慎使用，并且要确保传入的参数是可信的。

问题2：MyBatis 与 JPA（如 Hibernate）在查询上有什么核心不同？

解答： 核心不同在于对 SQL 的控制程度和编程范式，MyBatis 是一种 “SQL-Centric” 的框架，它将 SQL 的编写权完全交给开发者，开发者需要手动编写 SQL 语句，MyBatis 负责将结果映射到 Java 对象，这种方式提供了对 SQL 优化的极致灵活性和透明度，而 JPA（Hibernate 是其最著名的实现）是 “Object-Centric” 的框架，它遵循 ORM（对象关系映射）思想，开发者操作的是 Java 对象，框架会根据这些操作自动生成并执行 SQL 语句，它屏蔽了 SQL 的细节，开发效率更高，但在面对复杂查询或 SQL 优化时，灵活性不如 MyBatis，简而言之，MyBatis 让你更贴近数据库，而 JPA 让你更专注于业务对象。