MyBatis XML映射文件编写【后端 18】

MyBatis XML映射文件编写

MyBatis 是一个优秀的持久层框架,它支持定制化 SQL、存储过程以及高级映射。MyBatis 避免了几乎所有的 JDBC 代码和手动设置参数以及获取结果集。MyBatis 可以使用简单的 XML 或注解用于配置和原始映射,将接口和 Java 的 POJOs (Plain Old Java Objects, 普通的 Java 对象)映射成数据库中的记录。

在 MyBatis 中,XML 映射文件是非常关键的部分,它定义了如何将 Java 对象映射到 SQL 语句以及如何将 SQL 查询结果映射回 Java 对象。下面,我们将详细介绍如何编写 MyBatis 的 XML 映射文件。

1. XML 映射文件的基本结构

每个 MyBatis 的映射文件都包含了一个 <mapper> 元素作为根元素。在 <mapper> 元素内部,你可以定义多种映射语句,如 <select>、<insert>、<update> 和 <delete>。

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:命名空间,它是绑定 MyBatis 接口的全路径名,用于唯一标识 mapper。
2. SQL 映射语句
2.1 <select>

用于查询操作。你可以使用 #{} 来进行参数替换,防止 SQL 注入。

xml 复制代码
<select id="selectUserById" parameterType="int" resultType="com.example.domain.User">  
  SELECT * FROM users WHERE id = #{id}  
</select>
  • id:唯一标识符,与 Mapper 接口中的方法名对应。
  • parameterType:输入参数的类型。
  • resultType:SQL 查询返回的结果类型,即 Java 对象的全路径名。
2.2 <insert>、<update> 和 <delete>

这些标签分别用于插入、更新和删除操作。对于修改数据库的操作,MyBatis 支持使用 <selectKey> 来获取自动生成的主键。

xml 复制代码
<insert id="insertUser" parameterType="com.example.domain.User">  
  <selectKey keyProperty="id" resultType="int" order="AFTER">  
    SELECT LAST_INSERT_ID()  
  </selectKey>  
  INSERT INTO users (name, email) VALUES (#{name}, #{email})  
</insert>
  • keyProperty:指定 Java 对象的哪个属性用于接收生成的主键值。
  • order :指定 <selectKey> 相对于插入语句的执行顺序,BEFORE 或 AFTER。
3. 映射复杂结果

对于复杂的查询,你可能需要将结果映射到多个 Java 对象或者映射到 Java 对象的集合中。MyBatis 提供了 <resultMap> 元素来支持复杂的映射。

xml 复制代码
<resultMap id="userResultMap" type="com.example.domain.User">  
  <id property="id" column="user_id" />  
  <result property="username" column="user_name" />  
  <result property="email" column="email_address" />  
  <!-- 更多映射 -->  
</resultMap>  
  
<select id="selectUsers" resultMap="userResultMap">  
  SELECT user_id, user_name, email_address FROM users  
</select>
  • :用于映射主键字段。
  • :用于映射非主键字段。
4. 注意事项
  • 确保 XML 文件的命名空间和路径与 Mapper 接口的全路径名一致。
  • 在 <mapper> 标签内,避免使用 MyBatis 保留的关键字。
  • 仔细检查 SQL 语句中的参数替换,确保没有 SQL 注入的风险。
  • 使用 <resultMap> 可以更灵活地控制复杂对象的映射关系。

通过上面的介绍,你应该对 MyBatis 的 XML 映射文件编写有了基本的了解。在实际开发中,根据具体需求编写相应的 SQL 映射语句,将大大提高数据访问层的开发效率和灵活性。

相关推荐
IT_陈寒24 分钟前
Java序列化踩坑记:对象循环引用让我加班两小时
前端·人工智能·后端
ZhengEnCi27 分钟前
同样的模型,为什么本地和云 API 差别那么大:量化精度、聊天模板与采样参数的三大元凶
人工智能·算法·llm
lgcgkCQ33 分钟前
【AI 转型实战 1】SpringAI 入门:搭建基础大模型对话能力
java·ai·agent·rag·spring ai·mcp·langchain4j
泡海椒34 分钟前
05-雷达图多维画像-信用评级多维画像
后端
王中阳Go34 分钟前
5.27 分钟干完后端和全部测试:一场三小时笔试的五个失分点,四个不在代码上
大数据·数据库·人工智能·后端·大语言模型
大哥430936 分钟前
Modbus 的"字序":一个配错就变成天文数字,或者干脆变成 0
后端
Wang's Blog38 分钟前
Java 项目实战:交友项目 - 用户体系集成总结
java·开发语言·交友
岩钧39 分钟前
New API 源码解析:一个生产级 AI 网关的架构与实现
后端
学到老活到老1 小时前
第 24 集:配置文件写了 80,Spring Boot 为什么读到 90?
java·后端·spring
用户360055579001 小时前
Kestrel_VLLM - 25 · 全注意力层设备化、整层对拍与访存粒度
后端