<?xml version="1.0" encoding="UTF-8"?> <!DOCTYPE mapper PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN" "http://mybatis.org/dtd/mybatis-3-mapper.dtd"> <mapper namespace="com.landthink.common.mapper.WebsiteMapper">

<think>好的，我现在需要回答用户关于MyBatis 3 Mapper XML文件配置的问题，特别是关于namespace的示例。首先，我得回忆一下MyBatis的相关知识，确保自己正确理解namespace的作用和配置方法。 根据用户提供的引用内容，引用[3]中提到了Mapper XML文件的基本结构，其中namespace属性是定义在<mapper>标签中的，对应的是接口的全限定名。比如示例中的namespace="cn.tedu.tea.admin.server.content.dao.persist.mapper.TagMapper"。这说明namespace应该指向对应的Java接口，这样MyBatis才能将XML中的SQL语句与接口方法绑定。 接下来，我需要确认namespace的正确写法。根据MyBatis官方文档，namespace是必须的，且应该与Mapper接口的包名和类名完全一致。如果用户没有正确配置namespace，可能会导致MyBatis无法找到对应的映射，从而抛出异常。因此，在示例中，namespace的值必须与Java接口的完全限定名一致，这一点需要重点强调。 然后，用户可能想知道如何配置一个完整的Mapper XML文件。根据引用[3]中的示例，整个文件的结构包括XML声明、DOCTYPE声明、以及mapper根元素，其中包含了select语句和resultMap的定义。在配置时，需要确保每个SQL语句的id与接口中的方法名匹配，并且resultMap或resultType正确设置，以映射查询结果。 另外，引用[1]提到在mybatis-config.xml中需要添加mapper映射文件的配置，即通过<mappers>标签引入对应的XML文件。这可能也是用户需要注意的地方，但用户当前的问题主要集中在XML文件本身的配置，尤其是namespace部分，所以可能不需要深入讨论配置文件的部分，但可以稍微提及，以保持回答的完整性。 现在，我需要将这些信息组织成一个结构清晰的回答，分步骤说明如何正确配置namespace，并给出示例代码。同时，要确保使用中文，并遵循用户提供的格式要求，比如行内公式使用$...$，但在这个问题中可能用不到数学公式，但需要注意其他格式要求，如代码块的使用。 还需要生成相关问题，可能需要考虑用户可能感兴趣的其他方面，比如如何定义resultMap，或者如何处理动态SQL，或者常见的配置错误等。因此，相关问题可以围绕这些主题展开。 最后，要确保引用正确的来源，用户提供的引用[3]中有具体的示例，所以回答中需要标注引用标识[^3]。同时，引用[2]提供了关于Mapper XML文件结构的概述，也可以作为补充引用。</think>### MyBatis 3 Mapper XML 文件配置示例及`namespace`详解 #### 1. `namespace`的作用与配置规则 `namespace`是Mapper XML文件的根标签`<mapper>`的核心属性，**必须与对应的Java接口全限定名一致**。它的作用是将XML中的SQL语句与接口方法绑定，实现方法调用与SQL执行的映射[^3]。 示例： ```xml <mapper namespace="com.example.mapper.UserMapper"> <!-- SQL配置 --> </mapper> ``` - `namespace="com.example.mapper.UserMapper"`表示该XML文件对应`UserMapper`接口。 - 若未正确配置，MyBatis会因无法关联接口方法而报错。 --- #### 2. 完整Mapper XML文件配置示例 以下是一个包含查询语句、结果映射和动态SQL的完整配置示例[^3]： ```xml <?xml version="1.0" encoding="UTF-8" ?> <!DOCTYPE mapper PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN" "http://mybatis.org/dtd/mybatis-3-mapper.dtd"> <mapper namespace="com.example.mapper.UserMapper"> <!-- 查询用户 --> <select id="selectUserById" resultType="User"> SELECT * FROM user WHERE id = #{id} </select> <!-- 结果映射（复杂对象） --> <resultMap id="UserResultMap" type="User"> <id property="id" column="id"/> <result property="name" column="name"/> <result property="email" column="email"/> </resultMap> <!-- 动态SQL示例 --> <update id="updateUser"> UPDATE user <set> <if test="name != null">name = #{name},</if> <if test="email != null">email = #{email}</if> </set> WHERE id = #{id} </update> </mapper> ``` --- #### 3. 关键配置说明 | 配置项 | 说明 | |--------------|--------------------------------------------------------------------| | `namespace` | **必须与Mapper接口全限定名一致**，如`com.example.mapper.UserMapper`[^3] | | `id` | SQL语句的唯一标识，需与接口方法名匹配 | | `resultType` | 简单返回类型（如基本类型或POJO类） | | `resultMap` | 复杂结果映射（需定义`<resultMap>`标签） | --- #### 4. 常见错误及解决方法 - **问题1**：`Invalid bound statement (not found)` **原因**：`namespace`或`id`未正确匹配接口方法。 **解决**：检查`namespace`是否与接口全名一致，且SQL的`id`与方法名相同[^3]。 - **问题2**：返回结果映射失败 **原因**：`resultType`或`resultMap`配置错误。 **解决**：使用`resultMap`定义字段与属性的映射关系[^3]。 ---