MyBatis常用標簽以及使用技巧總結(jié)

更新時間：2021年05月13日 10:15:27 作者：weixin_45747080

在我們的學習過程中，我們經(jīng)常使用到mybatis，這篇文章主要給大家介紹了關于MyBatis常用標簽以及使用技巧的相關資料，需要的朋友可以參考下

前言

MyBatis常用標簽及標簽使用技巧

MyBatis的常用標簽有很多，比如

<sql id="">：預定義可以復用的sql語句

<include refid="">：根據(jù)id引用定義的sql語句

<trim>：空白補全，配合<if>標簽使用

<if test="">：條件判斷，該語句返回的true，則該標簽內(nèi)的語句就生效

<bind name="" value="">：創(chuàng)建一個變量，并且可以綁定到上下文

1、統(tǒng)一的增刪改

通過我暫時的開發(fā)經(jīng)驗來說，我認為對一張表增刪改操作，起碼包括：增加一條記錄、刪除一條記錄、修改一條記錄。所以一張表的操作起碼包括：增刪改。

增加一條是主鍵id自增，刪除一條記錄是根據(jù)主鍵id刪除，修改一條記錄是根據(jù)主鍵id修改，返回值都是Integer類型的成功增刪改的記錄條數(shù)。以User對象為例：

UserMapper.java：

@Mapper
@Repository
public interface UserMapper {

    /**
     * 增加一條記錄
     * @param user 用戶對象
     * @return 增加成功的記錄數(shù)
     */
    Integer insertOne(User user);

    /**
     * 刪除一條記錄
     * @param user 用戶對象
     * @return 刪除成功的記錄數(shù)
     */
    Integer deleteOne(User user);

    /**
     * 修改用戶
     * @param user 用戶對象
     * @return 修改成功的記錄數(shù)
     */
    Integer updateOne(User user);
}

則對應的UserMapper.xml：

<mapper namespace="UserMapper">
    <!--update的條件sql（除了自增主鍵id）-->
    <sql id="updateCondition">
        <if test=" uuid!=null and uuid!='' ">
            uuid = #{uuid},
        </if>
        <if test=" username!=null and username!='' ">
            username = #{username},
        </if>
        <if test=" password!=null and password!='' ">
            password = #{password},
        </if>
    </sql>
    <!--新增一條-->
    <insert id="insertOne"
            keyProperty="id"
            useGeneratedKeys="true"
            parameterType="User">
        INSERT INTO
            user
            (uuid,username,password)
        VALUES
            (#{uuid},#{username},#{password})
    </insert>
    <!--刪除一條-->
    <delete id="deleteOne"
            parameterType="User">
        DELETE FROM user WHERE id = #{id}
    </delete>
    <!--修改一條（根據(jù)id主鍵）-->
    <update id="updateOne"
            parameterType="User">
        UPDATE
            user
        <trim prefix="SET" suffixOverrides=",">
            <include refid="updateCondition"></include>
        </trim>
        WHERE
            id = #{id}
    </update>
</mapper>

由于一般修改語句是根據(jù)id，所以在<update>標簽中，WHERE id = #{id}是寫死了的。一般修改的話，是除了id可以修改其余都是可以修改的，所以一般字段會比較多，利用<sql>標簽預定義好除了id的字段，并且利用<if>標簽包裹起來，同時特別注意：最后要加上逗號。然后在<trim>標簽中利用<include>標簽引用預定義的修改語句的條件。<include>標簽就相當于直接把該id的sql語句直接粘貼到這里，這里是為了看起整體排版比較舒服所以才這么做的。

2、統(tǒng)一的查詢

通過我暫時的開發(fā)經(jīng)驗來說，我認為對一張表查詢操作，起碼包括：查詢多條記錄（可分頁可條件）、查詢一條記錄（可條件），查詢該表的總記錄數(shù)。所以一張表的操作起碼包括：三個查詢。

查詢列表、單個查詢、查詢該表的總記錄數(shù)，同樣是以User對象為例：

UserMapper.java：

@Mapper
@Repository
public interface UserMapper {

    /**
     * 查詢所有user集合（可分頁，可多條件，可單條件）
     * @param user 用戶對象
     * @return user集合
     */
    List<User> selectList(User user);

    /**
     * 查詢一條user記錄（可多條件，可單條件）
     * @param user
     * @return  一條用戶對象
     */
    User selectOne(User user);

    /**
     * 查詢記錄數(shù)（可條件查詢）
     * @param user  用戶對象
     * @return  記錄數(shù)
     */
    Long count(User user);

}

分別返回User集合、單個User對象以及記錄數(shù)。

對應的UserMapper.xml：

<mapper namespace="UserMapper">
    <!--select的條件sql（全有）-->
    <sql id="selectCondition">
        <if test=" id!=null and id!='' ">
            AND u.id = #{id}
        </if>
        <if test=" uuid!=null and uuid!='' ">
            AND u.uuid = #{uuid}
        </if>
        <if test=" username!=null and username!='' ">
            AND u.username = #{username}
        </if>
        <if test=" password!=null and password!='' ">
            AND u.password = #{password}
        </if>
    </sql>
    <!--分頁的條件sql（當前頁，每頁記錄數(shù)）-->
    <sql id="limitCondition">
        <if test=" currentPage!=null and currentPage!='' and pageSize!=null and pageSize!='' ">
            <bind name="offset" value="pageSize*(currentPage-1)"/>
            <bind name="rows" value="pageSize"/>
            #{offset},#{rows}
        </if>
    </sql>
    <!--user表的別名-->
    <sql id="userAs">
        u.id                AS uId,
        u.uuid              AS uUuid,
        u.username          AS uUsername,
        u.password          AS uPassword
    </sql>
    <!--返回的結(jié)果集-->
    <resultMap id="userMap" type="User">
        <id column="uId" property="id"/>
        <result column="uUuid" property="uuid"/>
        <result column="uUsername" property="username"/>
        <result column="uPassword" property="password"/>
    </resultMap>
    <!--查詢所有（可分頁，可單條件，可多條件）-->
    <select id="selectList"
            parameterType="User"
            resultMap="userMap">
        SELECT
            <include refid="userAs"></include>
        FROM
            user u
        <trim prefix="WHERE" prefixOverrides="AND">
            <include refid="selectCondition"></include>
        </trim>
        ORDER BY
            u.id
        <trim prefix="LIMIT">
            <include refid="limitCondition"></include>
        </trim>
    </select>
    <!--查詢一條（可單條件，可多條件）-->
    <select id="selectOne"
            parameterType="User"
            resultMap="userMap">
        SELECT
            <include refid="userAs"></include>
        FROM
            user u
        <trim prefix="WHERE" prefixOverrides="AND">
            <include refid="selectCondition"></include>
        </trim>
    </select>
    <!--查詢記錄數(shù)（可單條件，可多條件）-->
    <select id="count"
            parameterType="User"
            resultType="long">
        SELECT
            count(u.id)
        FROM
            user u
        <trim prefix="WHERE" prefixOverrides="AND">
            <include refid="selectCondition"></include>
        </trim>
    </select>
</mapper>

根據(jù)三個需求：查詢?nèi)怼⒉樵儐蝹€兩個都可以用到條件查詢，所以都可以用到同樣的sql，所以就可以使用同樣的<sql>標簽來預定義然后復用。小結(jié)一下就是：

查詢?nèi)恚翰樵冏侄巍⒖扇珬l件、可分頁
查詢單個：查詢字段、可全條件
查詢記錄數(shù)：可全條件

得益于<trim>標簽和<if>標簽的配合（if標簽判斷條件是否成立，如果成立則if標簽內(nèi)部語句生效，trim判斷內(nèi)部是否有語句，如果有則trim生效），沒有條件傳入就查詢?nèi)?，沒有分頁傳入的時候就不分頁，做到了有條件則查條件，無條件則全查，有分頁則查分頁，無分頁則全查。同時定義好結(jié)果集映射（column是查出來的列，property是Pojo對象的屬性，需要對應好）以及配置好查詢字段的別名（AS）。定義結(jié)果集和配置查詢字段的別名是方便以后擴展。

條件查詢的<sql>需要注意的是利用AND連接。

分頁的<sql>需要注意的是利用<bind>標簽來定義變量，注意變量的換算，一般采用的是傳入當前頁（currentPage）和每頁記錄數(shù)（pageSize），而數(shù)據(jù)庫中l(wèi)imit語句的參數(shù)是limit offset,rows，offset（偏移量，也就是從表中的第幾個元素開始，0是首位），rows（記錄數(shù)，也就是返回多少個），總的來說就是從第幾個開始，返回第條記錄。然后利用簡單的數(shù)學換算，將currentPage和pageSize轉(zhuǎn)換為offset和rows。

<trim>標簽的使用，利用<include>標簽引入相應的sql語句后，再用<trim>標簽包圍，注意好prefix、suffix、prefixOverrides和suffixOverrides。

注意

SQL語句中各關鍵字的順序

3、統(tǒng)一的增刪改查

最后將增刪改和查詢總結(jié)合并起來就是：

UserMapper.java：

@Mapper
@Repository
public interface UserMapper {

    /**
     * 增加一條記錄
     * @param user 用戶對象
     * @return 增加成功的記錄數(shù)
     */
    Integer insertOne(User user);

    /**
     * 刪除一條記錄
     * @param user 用戶對象
     * @return 刪除成功的記錄數(shù)
     */
    Integer deleteOne(User user);

    /**
     * 修改用戶
     * @param user 用戶對象
     * @return 修改成功的記錄數(shù)
     */
    Integer updateOne(User user);

    /**
     * 查詢所有user集合（可分頁，可多條件，可單條件）
     * @param user 用戶對象
     * @return user集合
     */
    List<User> selectList(User user);

    /**
     * 查詢一條user記錄（可多條件，可單條件）
     * @param user
     * @return  一條用戶對象
     */
    User selectOne(User user);

    /**
     * 查詢記錄數(shù)（可條件查詢）
     * @param user  用戶對象
     * @return  記錄數(shù)
     */
    Long count(User user);

}

UserMapper.xml：

<mapper namespace="UserMapper">
    <!--select的條件sql（全有）-->
    <sql id="selectCondition">
        <if test=" id!=null and id!='' ">
            AND u.id = #{id}
        </if>
        <if test=" uuid!=null and uuid!='' ">
            AND u.uuid = #{uuid}
        </if>
        <if test=" username!=null and username!='' ">
            AND u.username = #{username}
        </if>
        <if test=" password!=null and password!='' ">
            AND u.password = #{password}
        </if>
    </sql>
    <!--update的條件sql（除了自增主鍵id）-->
    <sql id="updateCondition">
        <if test=" uuid!=null and uuid!='' ">
            uuid = #{uuid},
        </if>
        <if test=" username!=null and username!='' ">
            username = #{username},
        </if>
        <if test=" password!=null and password!='' ">
            password = #{password},
        </if>
    </sql>
    <!--分頁的條件sql（當前頁，每頁記錄數(shù)）-->
    <sql id="limitCondition">
        <if test=" currentPage!=null and currentPage!='' and pageSize!=null and pageSize!='' ">
            <bind name="offset" value="pageSize*(currentPage-1)"/>
            <bind name="rows" value="pageSize"/>
            #{offset},#{rows}
        </if>
    </sql>
    <!--user表的別名-->
    <sql id="userAs">
        u.id                AS uId,
        u.uuid              AS uUuid,
        u.username          AS uUsername,
        u.password          AS uPassword
    </sql>
    <!--返回的結(jié)果集-->
    <resultMap id="userMap" type="User">
        <id column="uId" property="id"/>
        <result column="uUuid" property="uuid"/>
        <result column="uUsername" property="username"/>
        <result column="uPassword" property="password"/>
    </resultMap>
    <!--新增一條-->
    <insert id="insertOne"
            keyProperty="id"
            useGeneratedKeys="true"
            parameterType="User">
        INSERT INTO
            user
            (uuid,username,password)
        VALUES
            (#{uuid},#{username},#{password})
    </insert>
    <!--刪除一條-->
    <delete id="deleteOne"
            parameterType="User">
        DELETE FROM user WHERE id = #{id}
    </delete>
    <!--修改一條（根據(jù)id主鍵）-->
    <update id="updateOne"
            parameterType="User">
        UPDATE
            user
        <trim prefix="SET" suffixOverrides=",">
            <include refid="updateCondition"></include>
        </trim>
        WHERE
            id = #{id}
    </update>
    <!--查詢所有（可分頁，可單條件，可多條件）-->
    <select id="selectList"
            parameterType="User"
            resultMap="userMap">
        SELECT
            <include refid="userAs"></include>
            user u
            JOIN role r on u.roleId = r.id
        <trim prefix="WHERE" prefixOverrides="AND">
            <include refid="selectCondition"></include>
        </trim>
        ORDER BY
            u.id
        <trim prefix="LIMIT">
            <include refid="limitCondition"></include>
        </trim>
    </select>
    <!--查詢一條（可單條件，可多條件）-->
    <select id="selectOne"
            parameterType="User"
            resultMap="userMap">
        SELECT
            <include refid="userAs"></include>
        FROM
            user u
        <trim prefix="WHERE" prefixOverrides="AND">
            <include refid="selectCondition"></include>
        </trim>
    </select>
    <!--查詢記錄數(shù)（可單條件，可多條件）-->
    <select id="count"
            parameterType="User"
            resultType="long">
        SELECT
            count(u.id)
        FROM
            user u
        <trim prefix="WHERE" prefixOverrides="AND">
            <include refid="selectCondition"></include>
        </trim>
    </select>
</mapper>

對一張表的操作最起碼就應該包括以上：增加一條記錄、刪除一條記錄、修改一條記錄、查詢列表（可條件、可分頁）、查詢一條（可條件）、查詢記錄數(shù)（可條件）。

4、利用IDEA的Code Templates自動生成

總結(jié)后觀察到，每張表都有這6個操作，并且代碼基本上都大致相同，差別只是對象的名字和表中字段不一樣，那我每次創(chuàng)建Mapper文件都需要手敲嗎？NoNoNo，可以利用IDEA的Code Templates功能，預先定義好Mapper Java和Mapper Xml的大致結(jié)構，然后利用傳參傳入對象名就可以了，這樣每次就能自動生成大量代碼，然后只需要修改極少部分代碼就可以了。

Code Templates文件的創(chuàng)建：

打開IDEA，左上角依次點擊：File->搜索template->找到File and Code Templates，在右側(cè)創(chuàng)建新文件，輸入文件名，擴展名Java：

#if (${PACKAGE_NAME} && ${PACKAGE_NAME} != "") package ${PACKAGE_NAME};#end

import org.apache.ibatis.annotations.Mapper;
import org.springframework.stereotype.Repository;

import java.util.List;
#parse("File Header.java")

@Mapper
@Repository
public interface ${NAME} {

    /**
     * 增加一條記錄
     * @param ${pojo} ${name}對象
     * @return 增加成功的記錄數(shù)
     */
    Integer insertOne(${Pojo} ${pojo});

    /**
     * 刪除一條記錄
     * @param ${pojo} ${name}對象
     * @return 刪除成功的記錄數(shù)
     */
    Integer deleteOne(${Pojo} ${pojo});

    /**
     * 修改一條記錄
     * @param ${pojo} ${name}對象
     * @return 修改成功的記錄數(shù)
     */
    Integer updateOne(${Pojo} ${pojo});

    /**
     * 查詢所有集合（可分頁，可多條件，可單條件）
     * @param ${pojo} ${name}對象
     * @return ${pojo}集合
     */
    List<${Pojo}> selectList(${Pojo} ${pojo});
    
    /**
     * 查詢一條${pojo}記錄（可多條件，可單條件）
     * @param ${pojo} ${name}對象
     * @return  一條${name}對象
     */
    ${Pojo} selectOne(${Pojo} ${pojo});

    /**
     * 查詢記錄數(shù)（可條件查詢）
     * @param ${pojo}  ${name}對象
     * @return  記錄數(shù)
     */
    Long count(${Pojo} ${pojo});

}

${Pojo}：Pojo對象的類名

${pojo}：Pojo對象的變量名

這樣下次在新建Mapper.java文件的時候直接利用該template創(chuàng)建就可以了。

同樣的，Mapper.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="${PRE}.mapper.${NAME}">
    <!--select的條件sql（全有）-->
    <sql id="selectCondition">
        <if test=" arg!=null and arg!='' ">
            AND arg = #{arg}
        </if>
    </sql>
    <!--update的條件sql（除了自增主鍵id）-->
    <sql id="updateCondition">
        <if test=" arg!=null and arg!='' ">
            arg = #{arg},
        </if>
    </sql>
    <!--分頁的條件sql（當前頁，每頁記錄數(shù)）-->
    <sql id="limitCondition">
        <if test=" currentPage!=null and currentPage!='' and pageSize!=null and pageSize!='' ">
            <bind name="offset" value="pageSize*(currentPage-1)"/>
            <bind name="rows" value="pageSize"/>
            #{offset},#{rows}
        </if>
    </sql>
    <!--返回的結(jié)果集-->
    <resultMap id="${Pojo}Map" type="${PRE}.pojo.${Pojo}">
        <id column="id" property="id"/>
        <result column="" property=""/>
    </resultMap>
    <!--新增一條記錄-->
    <insert id="insertOne"
            keyProperty="id"
            useGeneratedKeys="true"
            parameterType="${PRE}.pojo.${Pojo}">
        INSERT INTO
            ${TABLE_NAME}
            ()
        VALUES
            ()
    </insert>
    <!--刪除一條記錄-->
    <delete id="deleteOne"
            parameterType="${PRE}.pojo.${Pojo}">
        DELETE FROM
            ${TABLE_NAME}
        WHERE
            id = #{id}
    </delete>
    <!--修改一條記錄（根據(jù)id主鍵）-->
    <update id="updateOne"
            parameterType="${PRE}.pojo.${Pojo}">
        UPDATE
            ${TABLE_NAME}
        <trim prefix="SET" suffixOverrides=",">
            <include refid="updateCondition"></include>
        </trim>
        WHERE
            id = #{id}
    </update>
    <!--查詢所有（可分頁，可單條件，可多條件）-->
    <select id="selectList"
            parameterType="${PRE}.pojo.${Pojo}"
            resultMap="${Pojo}Map">
        SELECT
            *
        FROM
            ${TABLE_NAME}
        <trim prefix="WHERE" prefixOverrides="AND">
            <include refid="selectCondition"></include>
        </trim>
        ORDER BY
            id
        <trim prefix="LIMIT">
            <include refid="limitCondition"></include>
        </trim>
    </select>
    <!--查詢一條（可單條件，可多條件）-->
    <select id="selectOne"
            parameterType="${PRE}.pojo.${Pojo}"
            resultMap="${Pojo}Map">
        SELECT
            *
        FROM
            ${TABLE_NAME}
        <trim prefix="WHERE" prefixOverrides="AND">
            <include refid="selectCondition"></include>
        </trim>
    </select>
    <!--根據(jù)主鍵id（效率高）查詢記錄數(shù)（可單條件，可多條件）-->
    <select id="count"
            parameterType="${PRE}.pojo.${Pojo}"
            resultType="long">
        SELECT
            count(id)
        FROM
            ${TABLE_NAME}
        <trim prefix="WHERE" prefixOverrides="AND">
            <include refid="selectCondition"></include>
        </trim>
    </select>
</mapper>

${PRE}：包的前綴

${Pojo}：對象的類名

${TABLE_NAME}：表名

即可以非?？焖俚厣蒑apper.java和Mapper.xml了

5、連接關系表

因為Mybatis的特性，它可以連表查詢。同樣的，我們利用上述的方法創(chuàng)建好RoleMapper，如果想要在UserMapper中使用RoleMapper中定義好的sql，那么直接使用<include refid="包名+id">，下面是在UserMapper.xml中使用user表和role表連表查詢列表舉例：

	<!--查詢所有（可分頁，可單條件，可多條件）-->
    <select id="selectList"
            parameterType="com.fangaoxs.userserver.pojo.User"
            resultMap="userMap">
        SELECT
            <include refid="userAs"></include>,
            <include refid="com.xxx.userserver.mapper.RoleMapper.roleAs"></include>
        FROM
            user u
            JOIN role r on u.roleId = r.id
        <trim prefix="WHERE" prefixOverrides="AND">
            <include refid="selectCondition"></include>
        </trim>
        ORDER BY
            u.id
        <trim prefix="LIMIT">
            <include refid="limitCondition"></include>
        </trim>
    </select>

那么，這樣就實現(xiàn)了user表和role的聯(lián)合查詢，并且roleMapper.xml中的<sql>也在userMapper.xml中得到了復用。

總結(jié)

到此這篇關于MyBatis常用標簽以及使用技巧總結(jié)的文章就介紹到這了,更多相關MyBatis常用標簽使用技巧內(nèi)容請搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關文章希望大家以后多多支持腳本之家！

您可能感興趣的文章:

淺析Java迭代器Iterator和Iterable的區(qū)別
Java語言中，Iterator和Iterable都是用來遍歷集合類數(shù)據(jù)結(jié)構的接口，雖然它們有很多相似的地方，但在具體實現(xiàn)中卻有著一些不同之處，本文將詳細分析它們的區(qū)別，并提供相應的代碼示例,需要的朋友可以參考下
2023-07-07
深入理解Java中的Lambda表達式
這篇文章主要介紹了深入理解Java中的Lambda表達式,Lambda在各編程語言中都是非常重要的特性,而Java中則加入得有些太晚...需要的朋友可以參考下
2015-07-07
如何用Springboot快速整合shiro安全框架
這篇文章主要介紹了如何用SpringBoot快速整合shiro安全框架，shiro原名Apache Shiro 是一個Java 的安全（權限）框架。Shiro 可以非常容易的開發(fā)出足夠好的應用，感興趣的同學可以參考閱讀
2023-04-04
Idea連接GitLab的過程以及創(chuàng)建在gitlab中創(chuàng)建用戶和群組方式
本文介紹了如何在IDEA中連接GitLab,首先需安裝GitLab插件并配置SSH免密登錄,接著,創(chuàng)建GitLab個人令牌并在Git中配置,文章還提到了如何在GitLab中創(chuàng)建用戶、群組及設置權限,如Owner、Maintainer、Developer等,并強調(diào)了群組名和人員名稱的命名規(guī)范
2024-11-11
java異常和錯誤類總結(jié)(必看篇)
下面小編就為大家?guī)硪黄猨ava異常和錯誤類總結(jié)(必看篇)。小編覺得挺不錯的，現(xiàn)在就分享給大家，也給大家做個參考。一起跟隨小編過來看看吧
2016-09-09
詳解Mybatis動態(tài)sql
MyBatis的動態(tài)SQL是基于OGNL表達式的，它可以幫助我們方便的在SQL語句中實現(xiàn)某些邏輯。本文給大家介紹Mybatis動態(tài)sql小結(jié)，感興趣的朋友參考下
2016-04-04
Java如何實現(xiàn)雙向鏈表功能
雙向鏈表也叫雙鏈表，是鏈表的一種，它的每個數(shù)據(jù)結(jié)點中都有兩個指針，分別指向直接后繼和直接前驅(qū)。所以，從雙向鏈表中的任意一個結(jié)點開始，都可以很方便地訪問它的前驅(qū)結(jié)點和后繼結(jié)點。一般我們都構造雙向循環(huán)鏈表
2021-11-11
Spring注解之@Import使用方法講解
@Import是Spring基于Java注解配置的主要組成部分,下面這篇文章主要給大家介紹了關于Spring注解之@Import的簡單介紹,文中通過示例代碼介紹的非常詳細,需要的朋友可以參考下
2023-01-01
MyBatis-Plus邏輯刪除和字段自動填充的實現(xiàn)
本文主要介紹了MyBatis-Plus邏輯刪除和字段自動填充的實現(xiàn)，文中通過示例代碼介紹的非常詳細，對大家的學習或者工作具有一定的參考學習價值，需要的朋友們下面隨著小編來一起學習學習吧
2022-08-08
java判斷是否為圖片的步驟和方法
在本篇內(nèi)容里小編給大家分享的是關于java判斷是否為圖片的做法和步驟，需要的朋友們學習下。
2018-12-12