mybatis xml映射文件

### 关于 MyBatis XML 映射文件

#### 配置方法概述

要在 MyBatis 中使用映射文件，需在配置文件中指定映射文件的位置[^1]。通常情况下，在项目的 `resources` 文件夹下创建名为 `mapper` 的子目录来存放这些 XML 配置文件[^2]。

#### 使用教程

为了更好地理解如何设置和利用 MyBatis 的 XML 映射文件，下面提供了一个基本的工作流程：

- **引入依赖**

确保项目已正确导入 MyBatis 及其相关库的 Maven 或 Gradle 依赖项。

- **编写 SQL 映射语句**

SQL 映射文件是 MyBatis 的核心部分之一，允许开发者通过标签定义 CRUD 操作和其他复杂的查询逻辑。对于简单的场景，可以直接书写 select, insert, update 和 delete 标签而无需额外的结果集映射。

<!-- UserMapper.xml -->
<mapper namespace="com.example.mapper.UserMapper">
    <!-- 查询所有用户 -->
    <select id="findAllUsers" resultType="com.example.model.User">
        SELECT * FROM users;
    </select>
</mapper>

上述代码片段展示了最基础的选择操作，其中 `namespace` 属性指定了接口全限定名；`id` 是唯一标识符用来区分不同的 SQL 命令；`resultType` 表明返回的数据类型为 Java 类型或 POJO 路径字符串形式。

- **关联 Mapper 接口与 XML 文件**

为了让应用程序能够识别并加载自定义编写的 SQL 映射文件，还需要有一个对应的 DAO/Repository 接口声明相同的方法签名。例如对应上面的例子应该有如下接口定义：

//UserMapper.java
package com.example.mapper;

import java.util.List;
import org.apache.ibatis.annotations.Mapper;
import com.example.model.User;

@Mapper
public interface UserMapper {
    List<User> findAllUsers();
}

此接口中的每一个抽象方法都应能在相应的 XML 映射文档里找到匹配的 `<statement>` 定义。

#### 示例说明

当不需要复杂的结果映射时，可以通过省略 resultMap 来简化配置过程。然而，如果涉及到多表联结或其他更高级的功能，则可能需要用到更为详细的 resultMap 设置以实现字段到属性的一一对应关系。