Mybatis的XML映射文件怎么写 Mapper XML教程

MyBatis XML映射文件以为根元素，需声明对应接口全限定名的namespace；通过、等标签定义SQL，id匹配方法名，#{xxx}安全传参，处理字段映射与关联查询，与实现SQL复用。

MyBatis 的 XML 映射文件（Mapper XML）是用来定义 SQL 语句和结果映射的核心配置，它把 Java 接口方法和数据库操作解耦，让 SQL 更清晰、可维护性更强。

XML 文件基本结构和命名规范

每个 Mapper XML 文件需对应一个接口（如 UserMapper.java），文件名建议与接口同名（UserMapper.xml），并放在相同包路径下（或通过 显式注册）。根元素必须是 ，且必须声明 namespace，值为对应接口的全限定类名：

常用 SQL 标签怎么写

核心标签包括 、、、，每个标签用 id 属性对应接口中的方法名，用 parameterType 指定入参类型（可省略，MyBatis 能自动推断），用 resultType 或 resultMap 指定返回类型：

• 简单查询：SELECT * FROM user WHERE id = #{id}
• 带条件插入：INSERT INTO user(name, age) VALUES(#{name}, #{age})
• 动态更新：用 + 避免逗号和 SET 关键字冗余：
  
    UPDATE user
    
      name = #{name},
      age = #{age}
    
    WHERE id = #{id}
  

结果映射（resultMap）怎么配

当列名和属性名不一致，或需要嵌套查询（一对一、一对多）时，要用 。先定义 ID，再用 （主键）、（普通字段）做映射；复杂关系用 （一对一）或 （一对多）：

注意：select 属性指向另一个 的 id，实现延迟加载（需开启 lazyLoadingEnabled）。

SQL 片段复用与参数处理

用 标签抽取可复用的 SQL 片段（如公共字段列表），再用 引入；参数占位统一用 #{xxx}（预编译防注入），仅在极少数场景（如 ORDER BY 字段）才用 ${xxx}（字符串拼接，需自行校验）：

• 定义片段：id, name, age, create_time
• 引用片段：SELECT FROM user
• 安全传参：WHERE status = #{status} ✅；ORDER BY ${sortBy} ⚠️（确保 sortBy 是白名单值）