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），并放在相同包路径下（或通过 <mappers></mappers> 显式注册）。根元素必须是 <mapper></mapper>，且必须声明 namespace，值为对应接口的全限定类名：

常用 SQL 标签怎么写

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

• 简单查询：<select id="findById" resulttype="User">SELECT * FROM user WHERE id = #{id}</select>
• 带条件插入：<insert id="save" parametertype="User">INSERT INTO user(name, age) VALUES(#{name}, #{age})</insert>
• 动态更新：用 <set></set> + <if></if> 避免逗号和 SET 关键字冗余：
  
    UPDATE user
    
      name = #{name},
      age = #{age}
    
    WHERE id = #{id}
  

结果映射（resultMap）怎么配

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

Copysmith

Copysmith是一款面向企业的 AI 内容创建解决方案

168

查看详情

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

SQL 片段复用与参数处理

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

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

以上就是Mybatis的XML映射文件怎么写 Mapper XML教程的详细内容，更多请关注php中文网其它相关文章！