MyBatis插入语句配置-尧图网站建设

📅 发布时间：2026/6/19 9:09:50

 <sql id="Manage_field"> id,userName,passWord,realName</sql>
<!--    实体类属性--><sql id="Manage_insert">#{id},#{userName},#{passWord},#{realName}</sql><insert id="insert" parameterType="com.javapandeng.po.Manage" useGeneratedKeys="true" keyProperty="id">insert into manage(<include refid="Manage_field"/>)values (<include refid="Manage_insert"/>)</insert>

这段代码是一个典型的 MyBatis 插入语句配置，它展示了 MyBatis 的几个优秀特性：SQL 片段重用、参数映射和自动获取主键。我们来详细解析它的用处和每个部分的作用。

整体用途

这段代码的目的是：向数据库的 manage 表中插入一条新的管理员记录。它定义了一个名为 insert 的 SQL 操作，MyBatis 会根据这个配置生成最终的 INSERT INTO SQL 语句并执行。

代码逐层解析

1. SQL 片段定义 (`<sql>` 标签) - 代码重用

<sql id="Manage_field"> id,userName,passWord,realName
</sql><sql id="Manage_insert">#{id},#{userName},#{passWord},#{realName}
</sql>

<sql> 标签的作用：定义可重用的 SQL 代码片段。这类似于编程中的“变量”或“宏”，目的是避免重复代码，提高维护性。
id 属性：给这个片段起一个唯一的名字，方便在其他地方引用。
<include> 标签：用于引入之前定义好的 SQL 片段。
- <include refid="Manage_field"/> 会被替换为 id,userName,passWord,realName
- <include refid="Manage_insert"/> 会被替换为 #{id},#{userName},#{passWord},#{realName}

好处：

一致性：确保字段列表和值列表永远是对应的，不会因为手误而错位。
易维护：如果表结构变更（例如增加一个字段），只需要在一个地方（这两个 <sql> 标签内）修改，所有引用了它们的 SQL 语句都会自动更新。

2. 插入语句核心 (`<insert>` 标签)

<insert id="insert" parameterType="com.javapandeng.po.Manage" useGeneratedKeys="true" keyProperty="id">insert into manage(<include refid="Manage_field"/>) values (<include refid="Manage_insert"/>)
</insert>

<insert> 标签：表示这是一个插入数据的 SQL 映射语句。
id="insert"：这个语句的唯一标识符。在 Java 的 Mapper 接口中，你需要定义一个同名的方法来调用它：
java
```
public interface ManageMapper {int insert(Manage manage); // 这个方法名 "insert" 对应 XML 中的 id
}
```
parameterType="com.javapandeng.po.Manage"：指定传入参数的类型。MyBatis 会期望接收到一个 Manage 类型的对象，然后从这个对象中获取属性值来填充 SQL 中的 #{property} 占位符。
- #{id} -> manage.getId()
- #{userName} -> manage.getUserName()
- ...
useGeneratedKeys="true" keyProperty="id"：这是非常有用且重要的特性！
- 作用：告诉 MyBatis，数据库表的主键 id 是自增的（AUTO_INCREMENT），并且希望在执行插入操作后，自动将数据库生成的主键值取回来，并填充回传入的 Java 对象的 id 属性中。
- 工作流程：
  1. 你创建一个新的 Manage 对象，设置 userName, passWord, realName，但 id 为 null。
  2. 调用 mapper.insert(manageObj) 方法。
  3. MyBatis 执行 SQL，数据库成功插入数据并自动生成了一个主键值（比如 5）。
  4. MyBatis 从数据库获取这个新生成的值（5），并自动调用 manageObj.setId(5)。
  5. 方法执行完毕后，你传入的 manageObj 对象的 id 属性就不再是 null，而是数据库中的新 ID（5）了。你无需再次查询就能直接使用这个带有完整ID的对象。

3. 最终生成的 SQL

当 MyBatis 处理完所有片段和参数后，最终发送到数据库的 SQL 语句大概是这样的：

INSERT INTO manage (id, userName, passWord, realName) 
VALUES (?, ?, ?, ?);

PreparedStatement 的参数 ? 会被替换为 manage 对象中对应的属性值。

总结与用途

这段代码的核心用处是：提供一种高效、可靠、可维护的方式向 manage 表插入数据，并自动获取数据库生成的主键。

它体现了 MyBatis 的几大优势：

DRY (Don't Repeat Yourself) 原则：通过 <sql> 和 <include> 重用代码，减少冗余。
便捷的ORM：自动将 Java 对象属性映射到 SQL 参数，开发者无需手动拼装参数。
自动化流程：useGeneratedKeys 和 keyProperty 属性极大地简化了获取自增主键的流程，避免了“先插入，再查询获取ID”的繁琐步骤。
清晰的结构：SQL 和 Java 代码分离，结构清晰，易于阅读和调试。

调用示例：

// 创建新对象，id 为 null
Manage newManager = new Manage();
newManager.setUserName("admin");
newManager.setPassWord("123456");
newManager.setRealName("张经理");// 调用插入方法
manageMapper.insert(newManager); // 注意：这里传入对象// 插入完成后，MyBatis 自动将数据库生成的ID set到了对象中
System.out.println("新插入记录的主键ID是: " + newManager.getId()); // 这

MyBatis插入语句配置