Mybatis映射文件详解之mapper.xml文件

更新时间：2024年09月28日 14:54:34 作者：字节探索者

本文详细介绍了Mybatis映射文件的结构、标签和使用方法,包括mapper元素、标签的主要属性如id、parameterType、resultType以及动态SQL和结果映射的使用,通过映射文件,可以将数据库表与Java对象映射,支持查询、插入、更新、删除等操作,提高了SQL语句的灵活性和可重用性

在Mybatis中，Mapper XML文件是用于定义SQL语句和Java方法之间映射关系的核心配置文件。通过这些文件，开发者可以将数据库中的表与Java对象进行映射，实现数据的持久化操作。本文将详细介绍Mybatis映射文件的相关知识，包括其结构、标签以及如何编写和使用。

一、Mybatis映射文件概述

Mybatis是一个Java持久层框架，它提供了一种简单易用的方式来访问和操作数据库。在Mybatis中，映射文件（Mapper XML）起到了至关重要的作用，它们定义了SQL语句与Java方法之间的映射关系。

二、映射文件的结构

Mapper XML文件通常用于定义与数据库交互的SQL语句和操作。它的基本结构如下所示：

<?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="cn.tedu.tea.admin.server.content.dao.persist.mapper.TagMapper">
        <!--    TagStandardVO getStandardById(Long id);-->
        <select id="getStandardById" resultMap="StandardResultMap">
            SELECT id,name,parent_id,enable,sort
            FROM content_tag
            WHERE id=#{id}
        </select>
    <resultMap id="StandardResultMap" type="cn.tedu.tea.admin.server.content.pojo.vo.TagStandardVO">
        <id column="id" property="id"></id>
        <result column="name" property="name"></result>
        <result column="parent_id" property="parentId"></result>
        <result column="enable" property="enable"></result>
        <result column="sort" property="sort"></result>
    </resultMap>
</mapper>

Mapper XML文件详解

mapper元素是Mapper XML文件的根元素，它有一个namespace属性用于指定对应的Mapper接口或命名空间。

<mapper namespace="cn.tedu.tea.admin.server.content.dao.persist.mapper.TagMapper">
</mapper>

定义SQL语句和对应的操作：

: 用于执行查询操作。
: 用于执行插入操作。
: 用于执行更新操作。
: 用于执行删除操作。

每个标签有以下主要属性：

id: SQL语句的唯一标识符，可以通过这个id在Java代码中调用对应的SQL语句。
parameterType: SQL语句的参数类型，指定了传入SQL语句的参数类型。
resultType 或 resultMap: 如果是查询操作，可以通过resultType指定返回结果的类型，或者使用resultMap自定义结果映射规则。

查询操作

 <select id="selectByType"
            resultType="cn.tedu.baking.pojo.vo.ContentManagementVO">
        SELECT c.id,
               c.title,
               c.img_url,
               c.brief,
               c.type,
               cat.name categoryName,
               c.view_count,
               c.comment_count,
               c.create_time
        FROM t_content c
                 JOIN t_category cat ON c.category_id = cat.id
        WHERE c.type = #{type}
          AND c.create_by = #{id}
    </select>

这个示例中，标签定义了一个查询操作，id为selectUserById，返回结果类型为User，SQL语句为SELECT * FROM users WHERE id = #{id}。#{id}是占位符，表示动态传入的参数。

插入操作

 <insert id="insert">
        INSERT INTO t_content
        VALUES (NULL, #{title}, #{imgUrl}, #{videoUrl},
                #{content}, #{type}, 0, 0, #{createBy},
                #{createTime}, null, null,
                #{brief}, #{categoryId})
    </insert>

这个示例中，标签定义了一个插入操作，id为insertUser，参数类型为User，SQL语句为INSERT INTO users (username, password) VALUES (#{username}, #{password})。#{username}和#{password}分别表示User对象中的属性。

更新操作

<update id="updateUser" parameterType="User">
    UPDATE users SET username = #{username}, password = #{password} WHERE id = #{id}
</update>

这个示例中，标签定义了一个更新操作，id为updateUser，参数类型为User，SQL语句为UPDATE users SET username = #{username}, password = #{password} WHERE id = #{id}。这里的#{id}、#{username}和#{password}都是User对象的属性。

删除操作

  <delete id="deleteById">
        DELETE
        FROM t_content
        WHERE id = #{id}
    </delete>

这个示例中，标签定义了一个删除操作，id为deleteUser，SQL语句为DELETE FROM users WHERE id = #{id}，其中#{id}是动态传入的参数。

动态SQL

MyBatis支持使用、、、等标签来构建动态SQL语句，根据条件动态生成SQL片段，提高SQL语句的灵活性和可重用性。

<update id="update">
        UPDATE t_content
        <set>
            <if test="title!=null">title=#{title},</if>
            <if test="imgUrl!=null">img_url=#{imgUrl},</if>
            <if test="brief!=null">brief=#{brief},</if>
            <if test="videoUrl!=null">video_url=#{videoUrl},</if>
            <if test="type!=null">type=#{type},</if>
            <if test="categoryId!=null">category_id=#{categoryId},</if>
            <if test="viewCount!=null">view_count=#{viewCount},</if>
            <if test="commentCount!=null">comment_count=#{commentCount},</if>
            <if test="updateBy!=null">update_by=#{updateBy},</if>
            <if test="updateTime!=null">update_time=#{updateTime},</if>
            <if test="content!=null">content=#{content}</if>
        </set>
        WHERE id=#{id}
    </update>

结果映射

除了简单的resultType属性外，还可以使用标签自定义复杂的结果映射关系，将数据库中的查询结果映射到Java对象的属性中。

<select id="getStandardById" resultMap="StandardResultMap">
            SELECT id,name,parent_id,enable,sort
            FROM content_tag
            WHERE id=#{id}
        </select>
    <resultMap id="StandardResultMap" type="cn.tedu.tea.admin.server.content.pojo.vo.TagStandardVO">
        <id column="id" property="id"></id>
        <result column="name" property="name"></result>
        <result column="parent_id" property="parentId"></result>
        <result column="enable" property="enable"></result>
        <result column="sort" property="sort"></result>
    </resultMap>

到此这篇关于Mybatis映射文件详解-mapper.xml文件的文章就介绍到这了,更多相关Mybatis mapper.xml文件内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家！

您可能感兴趣的文章:

Spring容器刷新obtainFreshBeanFactory示例详解
这篇文章主要为大家介绍了Spring容器刷新obtainFreshBeanFactory示例详解，有需要的朋友可以借鉴参考下，希望能够有所帮助，祝大家多多进步，早日升职加薪
2023-03-03
java代码获取UUID的实现示例
本文主要介绍了java代码获取UUID的实现示例，文中通过示例代码介绍的非常详细，对大家的学习或者工作具有一定的参考学习价值，需要的朋友们下面随着小编来一起学习学习吧
2023-06-06
Struts2中Action中是否需要实现Execute方法
这篇文章主要介绍了Struts2中Action中是否需要实现Execute方法的相关资料,需要的朋友可以参考下
2016-03-03
详细讲解springboot如何实现异步任务
异步：异步与同步相对，当一个异步过程调用发出后，调用者在没有得到结果之前，就可以继续执行后续操作。也就是说无论异步方法执行代码需要多长时间，跟主线程没有任何影响，主线程可以继续向下执行
2022-04-04
springboot全局异常处理详解
本篇文章主要介绍了springboot全局异常处理详解，小编觉得挺不错的，现在分享给大家，也给大家做个参考。一起跟随小编过来看看吧
2017-05-05
Spring常用注解使用注解来构造IoC容器的方法
下面小编就为大家分享一篇Spring常用注解使用注解来构造IoC容器的方法，具有很好的参考价值，希望对大家有所帮助。一起跟随小编过来看看吧
2018-01-01
JVM性能调优实现原理及配置
这篇文章主要介绍了JVM性能调优实现原理及配置,文中通过示例代码介绍的非常详细，对大家的学习或者工作具有一定的参考学习价值,需要的朋友可以参考下
2020-12-12
Mybatis示例之SelectKey的应用
今天小编就为大家分享一篇关于Mybatis示例之SelectKey的应用，小编觉得内容挺不错的，现在分享给大家，具有很好的参考价值，需要的朋友一起跟随小编来看看吧
2018-12-12
es创建索引和mapping的实例
这篇文章主要介绍了es创建索引和mapping的实例，具有很好的参考价值，希望对大家有所帮助。如有错误或未考虑完全的地方，望不吝赐教
2023-02-02
IntelliJ IDEA中如何调试Java Stream操作
这篇文章主要介绍了IntelliJ IDEA中如何优雅的调试Java Stream操作,在强大的IDEA插件支持下，stream的调试其实也没那么难了，下面就来学习一下在IDEA中如何调试stream操作吧
2022-05-05