规则一：同包同名#

这里有个初学时容易卡住的细节：接口在 java 目录、XML 在 resources 目录，为什么算”同包”？ 因为 Java 代码编译后 class 文件在 classpath:/com/itheima/mapper/ 下，而 resources 里的东西是原样复制到 classpath 根的——所以在 resources 下建出 com/itheima/mapper/ 这串目录、把 UserMapper.xml 放进去，编译之后它在 classpath 里的位置正好和 com.itheima.mapper.UserMapper 这个接口”同包同名”。这样 MyBatis 拿着接口名就能默认找到同名 XML，不用写任何配置。

接口这边长这样（去掉 SQL，只剩方法签名）：

课程工程里 findAll 的注解就是被注释掉、SQL 交给 XML 的（源码原样）：

1
    /**
2
     * 查询所有用户
3
     */
4
    //@Select("select id, username, password, name, age from user")
5
    public List<User> findAll();

规则二、三：namespace 与方法名#

XML 那份文件的内容（课程 UserMapper.xml 全文）：

1
<?xml version="1.0" encoding="UTF-8" ?>
2
<!DOCTYPE mapper
3
        PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN"
4
        "https://mybatis.org/dtd/mybatis-3-mapper.dtd">
5
<mapper namespace="com.itheima.mapper.UserMapper">
6

7
    <!--resultType: 查询返回的单条记录所封装的类型-->
8
    <select id="findAll" resultType="com.itheima.pojo.User">
9
        select id, username, password, name, age from user
10
    </select>
11

12
</mapper>

逐行对照三条规则：

前两行 <?xml …?> 和 <!DOCTYPE mapper …> 是 XML 的声明与约束（DTD），MyBatis 官方文档里给了现成的，照着复制过来就行，别手打。

PPT 第 39 页还给了一份错误的对照，用来把三条规则钉死：

本机实测：SQL 走 XML 之后#

接口上没有 SQL 了，那条 SQL 在 XML 里，跑起来是什么样？本机把工程里的查询测试跑了一遍：

1
==>  Preparing: select id, username, password, name, age from user
2
==> Parameters:
3
<==      Total: 5
4
User(id=1, username=daqiao, password=123456, name=大乔, age=22)
5
User(id=2, username=xiaoqiao, password=123456, name=小乔, age=18)
6
User(id=3, username=diaochan, password=123456, name=貂蝉, age=24)
7
User(id=4, username=lvbu, password=123456, name=吕布, age=28)
8
User(id=5, username=zhaoyun, password=12345678, name=赵云, age=27)

一、知识回顾（读完直接做下面的实践题）#

1. 两种配置方式：SQL 既可以写在接口方法上的注解里（@Select("…")），也可以写进 XML 映射文件；同一个工程里可以混用
2. 规则一（同包同名）：XML 文件名与 Mapper 接口名一致、放在相同包下；实际做法是在 resources/com/itheima/mapper/ 下建出接口的包路径（resources 会原样复制到 classpath 根，所以编译后算同包）
3. 规则二（namespace）：<mapper namespace="…"> 的属性值必须是 Mapper 接口的全限定名，课程里是 com.itheima.mapper.UserMapper
4. 规则三（id 与返回类型）：XML 里 SQL 语句的 id 与接口方法名一致；resultType 写单条记录封装的类型（接口返回 List<User> 时也写 com.itheima.pojo.User）
5. XML 的抬头：<?xml version="1.0" encoding="UTF-8" ?> + <!DOCTYPE mapper …> 声明与约束，从官方文档复制，不要手打
6. 注解还是 XML：简单的增删改查用注解；复杂 SQL 用 XML（官方说明地址 https://mybatis.net.cn/getting-started.html）
7. XML 换位置要配什么：mybatis.mapper-locations=classpath:mapper/*.xml——告诉 MyBatis 去哪里找 XML 映射文件；配了它位置自由，但 namespace、id 两条规则仍要遵守
8. 本机实测（XML 生效的证据）：findAll 走 XML 时的日志是 Preparing: select id, username, password, name, age from user、Parameters:（空）、Total: 5，然后打印出 5 个 User 对象
9. 课程两个工程的差异：springboot-mybatis-quickstart = yml + XML（XML 在 resources/mapper/，用 mapper-locations 指定）；aliyun-mybatis-quickstart = properties + 注解（没有 XML），两套都跑通了 5 个测试
10. MybatisX 插件：IDEA 里安装的 MyBatis 开发插件，支持 Mapper 接口与 XML 双向跳转、XML 标签提示、自动生成语句骨架

二、裸写题#

• 2-1 把”查询所有用户”的 SQL 从接口搬进 XML 需求：UserMapper 接口里有一个查全部用户的方法；现在把 SQL 挪出接口，写进一个独立的 XML 映射文件里，位置让 MyBatis 默认就能找到（不用改任何配置），保证项目启动后调用这个方法仍能查出 5 条数据。 （练习文件 test_55_XML映射文件.xml 的题目2-1 里给了写作区；接口方法签名与实体类位置作为素材已写在素材区。）

  提示（先自己想，实在想不出再点开）

  一级 · 思路：先决定 XML 放哪、叫什么名字（默认规则）；文件里从官方文档抄声明与约束头，再写一个 mapper 根标签，把”接口全限定名”和”这条 SQL 的 id/返回类型”分别填对 二级 · 方法：文件放 resources/com/itheima/mapper/UserMapper.xml；根标签用 <mapper namespace="…">；查询语句用 <select id="…" resultType="…"> 三级 · 骨架：<?xml version="1.0" encoding="UTF-8" ?> + <!DOCTYPE mapper …> + <mapper namespace="____"> <select id="____" resultType="____"> select … from user </select> </mapper>

  参考答案（做完再点开）

  文件：src/main/resources/com/itheima/mapper/UserMapper.xml

  1
  <?xml version="1.0" encoding="UTF-8" ?>
  2
  <!DOCTYPE mapper
  3
          PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN"
  4
          "https://mybatis.org/dtd/mybatis-3-mapper.dtd">
  5
  <mapper namespace="com.itheima.mapper.UserMapper">
  6
  
  7
      <!--resultType: 查询返回的单条记录所封装的类型-->
  8
      <select id="findAll" resultType="com.itheima.pojo.User">
  9
          select id, username, password, name, age from user
  10
      </select>
  11
  
  12
  </mapper>

  接口那边只留方法签名（原来方法上的 @Select 要注释/删掉，否则会冲突或让人看混）：

  1
  @Mapper
  2
  public interface UserMapper {
  3
      public List<User> findAll();
  4
  }

  检查三处是否对上：文件名与位置（resources/com/itheima/mapper/UserMapper.xml）、namespace（com.itheima.mapper.UserMapper）、id 与 resultType（findAll / com.itheima.pojo.User）。本机工程（放的是 resources/mapper/）里 findAll 走 XML 的实测日志是 Preparing: select id, username, password, name, age from user、Parameters:（空）、Total: 5——XML 放在上面哪种位置，跑起来这条日志都一样。

• 2-2 在同一个 XML 里再加一条”按 id 查询用户” 需求：接口里新增一个方法——按用户 id 查一条用户记录并返回；SQL 也写在同一个 XML 文件里（不要用注解）。写完后调用它查 id 为 1 的用户，确认能拿到”大乔”那条数据。 （练习文件 test_55_XML映射文件.xml 的题目2-2 里给了写作区。）

  提示（先自己想，实在想不出再点开）

  一级 · 思路：接口加方法签名，XML 加一条语句；语句的 id 必须等于新方法名，返回类型还是单条记录的类型；参数照样用 #{} 二级 · 方法：新建的语句用 <select id="findById" resultType="…">；SQL 里用 where id = #{id}；接口方法叫 User findById(Integer id); 三级 · 骨架：接口 public ____ findById(____ id); / XML <select id="____" resultType="____"> select id, username, password, name, age from user where id = ____ </select>

  参考答案（做完再点开）

  接口新增：

  1
  public User findById(Integer id);

  同一个 XML 文件里新增一条语句：

  1
      <select id="findById" resultType="com.itheima.pojo.User">
  2
          select id, username, password, name, age from user where id = #{id}
  3
      </select>

  要点：一条方法对应一条语句，id 和方法名一一对应；XML 里 #{id} 取的就是接口方法的形参（单个参数，名字随意但建议一致）。查 id=1 得到的就是 User(id=1, username=daqiao, password=123456, name=大乔, age=22) 这一条（该行数据见54 篇实测里的 findAll 输出）。

• 2-3 找错：这份 XML 为什么会让项目起不来 背景：有同学把 XML 写成了下面这样，启动项目时报错说找不到方法对应的 SQL 语句：

  1
  <mapper namespace="itheima">
  2
      <select id="abc" resultType="com.itheima.pojo.User">
  3
          select id, username, password, name, age from user
  4
      </select>
  5
  </mapper>

  完成：① 指出这份 XML 违反了三条默认规则里的哪两条；② 把它们改成正确的值；③ 再回答：如果 XML 不放在”同包同名”的位置，还需要在哪份配置里加一行什么，才能让 MyBatis 找到它？ （练习文件 test_55_XML映射文件.xml 的题目2-3 里给了写作区。）

  提示（先自己想，实在想不出再点开）

  一级 · 思路：对照三条规则一行行看——根标签的属性对不对？语句的 id 对不对？再想想”换目录”时那条配置 二级 · 方法：根标签的 namespace 要写接口全限定名；语句 id 要写接口里的方法名；位置自由靠 mybatis.mapper-locations 三级 · 骨架：<mapper namespace="____.____.____"> / <select id="____" …> / mybatis.mapper-locations=classpath:____/*.xml

  参考答案（做完再点开）

  ① 违反了两条：namespace 不是接口全限定名（写成 itheima）、语句 id 不是接口方法名（写成 abc）——这两处对不上，MyBatis 就建立不起”接口方法 → SQL 语句”的映射关系，启动即报错。第三条规则（同包同名）这份代码没体现，它决定”能不能被默认找到”。 ② 改成：

  1
  <mapper namespace="com.itheima.mapper.UserMapper">
  2
      <select id="findAll" resultType="com.itheima.pojo.User">
  3
          select id, username, password, name, age from user
  4
      </select>
  5
  </mapper>

  ③ 如果 XML 不放在”同包同名”的位置（比如统一放到 resources/mapper/ 下），要在配置文件（application.properties 或 application.yml）里加：

  1
  mybatis.mapper-locations=classpath:mapper/*.xml

  注意：这行只解决”去哪儿找文件”；namespace 和 id 那两条规则任何方式下都要遵守。这也是课程 springboot-mybatis-quickstart 的实际做法（XML 在 resources/mapper/，配置里有这一行）。

三、综合题#

• 3-1 把注解版 CRUD 改造成 XML 版，并对照两边的日志 把 54 篇写好的四个注解方法整体迁到 XML 里，走一遍”两条路做同一件事”的完整流程。

  1. 准备：接口 UserMapper 里保留 findAll、deleteById、insert、update、findByUsernameAndPassword 五个方法，把方法上的 @Select/@Delete/@Insert/@Update 全部注释掉；
  2. 决定 XML 的放法并说明理由：要么放 resources/com/itheima/mapper/UserMapper.xml（同包同名、零配置），要么放 resources/mapper/UserMapper.xml 并在配置里加 mybatis.mapper-locations=classpath:mapper/*.xml；
  3. 在 XML 里把这五条语句补齐（每条语句的 id 与方法名一致、resultType 与返回类型一致，参数用 #{} 接）；
  4. 跑测试：查全部（应得 5 条）、按 id 删除、新增、修改、按用户名密码查一条；把每条语句的 Preparing/Parameters 抄到练习文件末尾；
  5. 对照回答：同一句 SQL，写在注解里和写在 XML 里，日志里的 Preparing 有什么不同？为什么？（提示：看参数是 ? 还是具体值）
  6. 再回答 PPT 第 40 页的那个问题：什么时候用注解、什么时候用 XML？把你这五个方法按这个标准分一下类。 （练习文件 test_55_XML映射文件.xml 的”综合题”一段里按这 6 步给了写作区。）

  涉及知识点

  知识点	在这里的应用
  三条默认规则	第 2、3 步——位置、namespace、id 与返回类型
  mapper-locations	第 2 步——XML 换目录时必须配
  XML 语句标签	第 3 步——<select> / <insert> / <update> / <delete> 的 id 与参数
  #{} 预编译	第 4、5 步——XML 里同样生成 ? + Parameters
  注解与 XML 的选择	第 6 步——简单增删改查 vs 复杂 SQL

  提示（先自己想，实在想不出再点开）

  一级 · 思路：把54 篇四条注解里的 SQL 原样抄进 XML 的四个标签里，接口只留方法签名；测完拿日志对照 二级 · 方法：XML 里查询用 <select>、新增 <insert>、修改 <update>、删除 <delete>，每个都带 id；参数照旧 #{}；换个目录就在配置里写 mybatis.mapper-locations 三级 · 骨架：<select id="findAll" resultType="____">…</select> / <delete id="deleteById">delete from user where id = ____</delete> / <insert id="insert">insert into user(____) values(____)</insert> / <update id="update">…</update>

  参考答案（做完再点开）

  3-1 1~3. 接口（只留签名）与 XML（放在 resources/mapper/UserMapper.xml，并在配置里加 mybatis.mapper-locations=classpath:mapper/*.xml）：

  1
  @Mapper
  2
  public interface UserMapper {
  3
      public List<User> findAll();
  4
      public Integer deleteById(Integer id);
  5
      public void insert(User user);
  6
      public void update(User user);
  7
      public User findByUsernameAndPassword(@Param("username") String username, @Param("password") String password);
  8
  }

  1
  <?xml version="1.0" encoding="UTF-8" ?>
  2
  <!DOCTYPE mapper
  3
          PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN"
  4
          "https://mybatis.org/dtd/mybatis-3-mapper.dtd">
  5
  <mapper namespace="com.itheima.mapper.UserMapper">
  6
  
  7
      <select id="findAll" resultType="com.itheima.pojo.User">
  8
          select id, username, password, name, age from user
  9
      </select>
  10
  
  11
      <delete id="deleteById">
  12
          delete from user where id = #{id}
  13
      </delete>
  14
  
  15
      <insert id="insert">
  16
          insert into user(username, password, name, age) values (#{username}, #{password}, #{name}, #{age})
  17
      </insert>
  18
  
  19
      <update id="update">
  20
          update user set username = #{username}, password = #{password}, name = #{name}, age = #{age} where id = #{id}
  21
      </update>
  22
  
  23
      <select id="findByUsernameAndPassword" resultType="com.itheima.pojo.User">
  24
          select * from user where username = #{username} and password = #{password}
  25
      </select>
  26
  
  27
  </mapper>

  显示更多显示更少

  4~5. 本机实测里 findAll 走 XML 的日志是：

  1
  ==>  Preparing: select id, username, password, name, age from user
  2
  ==> Parameters:
  3
  <==      Total: 5

  而 54 篇里那几条走注解的实测日志形如 Preparing: delete from user where id = ? + Parameters: 4(Integer)。两边都生成了预编译 SQL——Preparing 行是最终发给数据库的语句模板，注解或 XML 只是”SQL 写在哪儿”的区别，#{} 的机制完全一样（这就是54 篇那条”#{…} 会变成 ?”的结论在两处都成立的原因）。 6. 按 PPT 第 40 页的标准：这五个方法都是简单的增删改查（每条一句话、条件固定），用注解更合适；只有出现多表连接、条件个数不定（需要 <if>/<where>）、SQL 很长需要单独维护时，才把它们搬到 XML 里。所以真实项目里常见”注解为主、XML 兜底”的混用方式——本机课程的两个工程正好各占一边。