SQL映射XML文件

这篇博客详细介绍了MyBatis中SQL映射XML文件的使用,包括mapper的namespace属性、select元素的一对一和一对多映射、resultMap的高级结果映射以及insert、update、delete操作。讲解了如何通过parameterType和resultType指定参数和返回值类型,以及在多条件查询和结果展现中的应用。

摘要生成于 C知道 ,由 DeepSeek-R1 满血版支持, 前往体验 >

SQL映射的XML文件

mapper 

映射文件的根元素节点,只有一个属性namespace(命名空间)

namespace和子元素id联合保证唯一,区别不同的mapper

注:namespace的命名必须要跟某个DAO接口同名,同属DAO层,故代码结构上,映射文件与该DAO接口应放置在统一package下(如com.msds.dao),并且习惯上都以Mapper结尾(UserMapper.java、UserMapper.xml)

在不同的mapper文件中,子元素的id可以相同,MyBatis通过namespace和子元素的id联合区分。接口中的方法与映射文件中的SQL语句id应一一对应

使用select完成单一条件查询

select是MyBatis中最常用的元素之一


Dao接口


    //根据用户名称查询用户列表  模糊查询
    List<User> getUserListByName(String name);

Dao接口映射文件


    <!--根据用户名称查询用户列表  模糊查询-->
    <select id="getUserListByName" resultType="user" parameterType="string">
        SELECT * FROM smbms_user WHERE userName LIKE CONCAT ('%',#{name},'%')
    </select>


id:命名空间唯一的标识符、接口中的方法与映射文件中的SQL语句id一一对应

parameterType:传入SQL语句的参数类型

resultType:SQL语句返回值类型的完整类型名或别名

参数传递------>#{参数名}

注:数据库表的字段名与JavaBean的属性名一致

 使用select完成多条件查询

方式一:传递的参数是简单数据类型 

Dao接口
    //根据用户名称和角色查询用户列表,用户名实现模糊查询  参数是基础数据类型    List<User> getUserListByNameAndRole1(@Param("xm") String name,@Param("js") Integer role);
Dao接口映射文件

    <!--根据用户名称和角色查询用户列表,用户名实现模糊查询  参数是基础数据类型-->

    <select id="getUserListByNameAndRole1" resultType="user">

     SELECT * FROM smbms_user WHERE userName LIKE CONCAT ('%',#{xm},'%') 
            AND userRole=#{js}
    </select>

 

方式二:传递的参数是对象 

Dao接口 
   //根据用户名称和角色查询用户列表,用户名实现模糊查询  参数是对象 

   List<User> getUserListByNameAndRole2User(User user);
Dao接口映射文件

    <!--根据用户名称和角色查询用户列表,用户名实现模糊查询  参数是对象   #{对象的属性名}-->

    <select id="getUserListByNameAndRole2User" resultType="user" parameterType="user">

        SELECT * FROM smbms_user WHERE userName LIKE CONCAT ('%',#{userName},'%')

             AND userRole=#{userRole}

    </select>

方式三:传递的参数是Map集合 

Dao接口

    //根据用户名称和角色查询用户列表,用户名实现模糊查询  参数是Map集合

    List<User> getUserListByNameAndRole3Map(Map<String,String> userMap);
Dao接口映射文件

    <!--根据用户名称和角色查询用户列表,用户名实现模糊查询  参数是Map集合 #{map的Key}-->

    <select id="getUserListByNameAndRole3Map" resultType="user" parameterType="
### MyBatis SQL 映射 XML 文件的头文件定义 MyBatis 的 SQL 映射 XML 文件主要用于定义 SQL 查询语句及其映射关系。其头部通常通过 `<mapper>` 标签来声明,并包含 `namespace` 属性,该属性指定了与之关联的 DAO 接口或 Mapper 类的全限定名。 以下是 MyBatis SQL 映射 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"> </mapper> ``` #### 解析说明 1. **XML 声明**: 使用标准的 XML 声明语法 `<?xml version="1.0" encoding="UTF-8" ?>` 来指定文档版本和编码方式[^1]。 2. **DOCTYPE 定义**: DOCTYPE 是用来验证 XML 文档是否符合特定 DTD (Document Type Definition) 的规范。MyBatis 提供了一个官方的 DTD 文件用于校验映射文件的合法性。它的定义如下: ```xml <!DOCTYPE mapper PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN" "http://mybatis.org/dtd/mybatis-3-mapper.dtd"> ``` 3. **<mapper> 标签**: - `<mapper>` 是整个映射文件的根标签,表示一个映射器配置。 - `namespace` 属性是必需的,它唯一标识了当前映射器所属的命名空间,通常是对应的 DAO 或 Mapper 接口的全限定类名[^4]。 例如,在上述示例中,`namespace` 被设置为 `"com.example.mapper.UserMapper"`,这意味着此映射文件对应于名为 `UserMapper` 的接口,位于包路径 `com.example.mapper` 中。 --- ### 示例完整的 MyBatis 映射文件 以下是一个更具体的例子,展示了如何编写一个完整的 MyBatis 映射文件: ```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"> <!-- resultMap 定义 --> <resultMap id="BaseResultMap" type="com.example.model.User"> <id property="userId" column="user_id"/> <result property="userName" column="user_name"/> <result property="email" column="email"/> </resultMap> <!-- 查询语句 --> <select id="selectUsers" resultMap="BaseResultMap"> SELECT user_id, user_name, email FROM users </select> </mapper> ``` 在此示例中: - `resultMap` 定义了 Java 对象字段与数据库列之间的映射关系。 - `select` 标签定义了一条查询语句,返回的结果会按照 `resultMap` 所描述的方式进行映射。 --- ### 注意事项 1. 如果未正确配置 `namespace`,可能导致运行时无法找到相应的 SQL 方法。 2. 确保 DOCTYPE 声明中的 URL 地址指向的是 MyBatis 官方提供的最新 DTD 文件地址[^5]。 3. 映射文件的位置应与 MyBatis 主配置文件 (`mybatis-config.xml`) 中的资源路径一致。 ---
评论 3
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包

打赏作者

Qinꦿ.๓

你的鼓励将是我创作的最大动力

¥1 ¥2 ¥4 ¥6 ¥10 ¥20
扫码支付:¥1
获取中
扫码支付

您的余额不足,请更换扫码支付或充值

打赏作者

实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值