MyBatis 中SQL 映射文件是如何与 Mapper 接口关联起来的？ MyBatis 如何知道应该调用哪个 SQL 语句？

news2025/3/13 9:01:43

1. 命名空间 (Namespace):

SQL 映射文件 (XML): 在 SQL 映射文件的 <mapper> 根元素中，有一个 namespace 属性。这个 namespace 属性的值必须是 Mapper 接口的全限定名（包名 + 接口名）。
```
<mapper namespace="com.example.mapper.UserMapper">
    
</mapper>
```
作用: namespace 将 SQL 映射文件与 Mapper 接口建立了唯一的对应关系。MyBatis 通过 namespace 来区分不同的 Mapper 接口和 SQL 映射文件。

2. 语句 ID (Statement ID):

SQL 映射文件 (XML): 在 SQL 映射文件中，每个 SQL 语句（<select>, <insert>, <update>, <delete>）都有一个 id 属性，这个 id 属性的值必须与 Mapper 接口中对应方法的名称相同。
```
<select id="selectUserById" parameterType="int" resultType="com.example.model.User">
    SELECT id, username, password FROM users WHERE id = #{id}
</select>
```

Mapper 接口:

public interface UserMapper {
    User selectUserById(int id); // 方法名与 SQL 语句的 id 相同
}

作用: id 属性将 Mapper 接口中的方法与 SQL 映射文件中的具体 SQL 语句建立了唯一的对应关系。MyBatis 通过方法名（即 id）来查找并执行对应的 SQL 语句。

3. 参数类型 (Parameter Type) 和结果类型 (Result Type):

SQL 映射文件 (XML):
- parameterType 属性（可选）：指定 SQL 语句的参数类型。MyBatis 可以自动推断参数类型，但在某些情况下（例如，使用复杂类型或自定义类型处理器时），需要显式指定 parameterType。
- resultType 属性（或 resultMap 属性）：指定 SQL 语句的查询结果类型。resultType 用于简单的结果映射，resultMap 用于复杂的关联映射。
Mapper 接口:
- 方法的参数类型必须与 SQL 语句的 parameterType 匹配（或兼容）。
- 方法的返回值类型必须与 SQL 语句的 resultType 或 resultMap 匹配（或兼容）。
作用: 参数类型和结果类型确保了 Java 方法的输入输出与 SQL 语句的输入输出一致，MyBatis 会根据这些类型信息进行参数绑定和结果映射。

MyBatis 如何知道应该调用哪个 SQL 语句 (执行流程):

调用 Mapper 接口的方法: 当我们在 Java 代码中调用 Mapper 接口的方法时，实际上调用的是 MyBatis 生成的 Mapper 接口代理对象的方法。
查找 MappedStatement: MyBatis 会根据以下信息查找对应的 MappedStatement 对象：
- Namespace: Mapper 接口的全限定名，用于确定 SQL 映射文件。
- Statement ID: Mapper 接口的方法名，用于确定 SQL 映射文件中的具体 SQL 语句。
执行 SQL 语句: MyBatis 找到 MappedStatement 对象后，会根据 MappedStatement 中的信息（SQL 语句、参数类型、结果类型等）创建 Executor、StatementHandler、ParameterHandler、ResultSetHandler 等对象，并执行 SQL 语句。
参数绑定和结果映射: MyBatis 会使用 TypeHandler 将 Java 方法的参数转换为 JDBC 类型，并设置到 PreparedStatement 中；然后执行 SQL 语句；最后，使用 TypeHandler 将 ResultSet 中的数据转换为 Java 对象，并返回给调用者。