如何编写一个mapper.xml文件

### MyBatis Mapper.xml 文件编写教程 #### 1. 映射文件基本结构 MyBatis 的 `mapper.xml` 文件是一个核心配置文件，主要用于定义 SQL 查询语句及其与 Java 方法之间的映射关系。该文件通常由 `<mapper>` 根节点包裹，并包含多个子节点来描述不同的 SQL 操作[^1]。 以下是典型的 `mapper.xml` 文件的基本结构： ```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"> <!-- 定义SQL语句 --> </mapper> ``` - **namespace**: 命名空间，用于唯一标识当前的 Mapper 接口类。它通常是对应的接口全限定名。 --- #### 2. 编写 SELECT 查询语句 SELECT 是最常见的查询操作之一，可以通过 `<select>` 节点完成。以下是一个简单的例子： ```xml <select id="getUserById" resultType="com.example.model.User" parameterType="int"> SELECT * FROM users WHERE id = #{id} </select> ``` - **id**: 对应 Mapper 接口中方法名称。 - **resultType**: 返回的结果集类型，可以是 POJO 类路径或者基础数据类型。 - **parameterType**: 输入参数的数据类型。 如果返回的是复杂对象集合，则可以用 `resultMap` 来替代 `resultType` 进行更灵活的映射。 --- #### 3. 批量新增 (INSERT) 示例 对于批量新增的操作，可以在 `mapper.xml` 中使用动态 SQL 实现。例如，假设有一个列表需要插入到数据库中[^2]: ```xml <insert id="batchInsertUsers" parameterType="java.util.List"> INSERT INTO users (name, age) VALUES <foreach collection="list" item="item" separator=","> (#{item.name}, #{item.age}) </foreach> </insert> ``` - 使用 `<foreach>` 标签遍历传入的 List 参数。 - 设置 `separator` 属性指定分隔符，避免语法错误。 --- #### 4. 处理特殊字符（如小于号） 在 XML 文件中，某些特殊字符（如 `<`, `<=`）会被解析为标记的一部分，因此需要对其进行转义处理[^3]。例如： ```xml <!-- 错误示范 --> WHERE age < #{age} <!-- 正确方式 --> WHERE age &lt; #{age} ``` 也可以通过 CDATA 区域绕过 XML 解析器的干扰: ```xml <where><![CDATA[ age < #{age} AND status <= 'active' ]]></where> ``` --- #### 5. IDEA 开发环境优化 开发过程中可能会遇到 IDE 提示表字段或表名不可识别的情况。这通常是因为插件未正确加载所致[^4]。解决办法如下： - 确保安装并启用了 **Database Tools and SQL** 插件。 - 配置好 JDBC 数据源连接信息。 - 如果仍然存在问题，尝试重启 IntelliJ IDEA 或重新导入项目依赖项。 --- ### 总结 以上介绍了 MyBatis `mapper.xml` 文件的基础结构、常见 SQL 操作的编写技巧以及一些实际应用中的注意事项。合理利用这些功能可以帮助开发者高效地构建基于 MyBatis 的持久层逻辑。