Spring Boot入門系列（十九）整合mybatis，使用註解實現動態Sql、引數傳遞等常用操作！

章為忠發表於2020-08-24

前面介紹了Spring Boot 整合mybatis 使用註解的方式實現資料庫操作，介紹瞭如何自動生成註解版的mapper 和pojo類。接下來介紹使用mybatis 常用註解以及如何傳引數等資料庫操作中的常用操作。

其實，mybatis 註解方式和 XML配置方式兩者的使用基本上相同，只有在構建 SQL 指令碼有所區別，所以這裡重點介紹兩者之間的差異，以及增刪改查，引數傳遞等註解的常用操作。

Spring Boot 整合mybatis 使用xml配置版之前已經介紹過了，不清楚的朋友可以看看之前的文章：https://www.cnblogs.com/zhangweizhong/category/1657780.html。

註解介紹

mybatis 註解方式的最大特點就是取消了 Mapper 的 XML 配置，具體的 SQL 指令碼直接寫在 Mapper 類或是 SQLProvider 中的方法動態生成。
mybatis 提供的常用註解有： @Insert 、@Update 、@Select、 @Delete 等標籤，這些註解其實就是 MyBatis 提供的來取代其 XML配置文件的。

1、@Select 註解

@Select，主要在查詢的時候使用，查詢類的註解，一般簡單的查詢可以使用這個註解。

@Select({
    "select",
    "id, company_id, username, password, nickname, age, sex, job, face_image, province, ",
    "city, district, address, auth_salt, last_login_ip, last_login_time, is_delete, ",
    "regist_time",
    "from sys_user",
    "where id = #{id,jdbcType=VARCHAR}"
})
@Results({
    @Result(column="id", property="id", jdbcType=JdbcType.VARCHAR, id=true),
    @Result(column="company_id", property="companyId", jdbcType=JdbcType.VARCHAR),
    @Result(column="face_image", property="faceImage", jdbcType=JdbcType.VARCHAR),
    @Result(column="auth_salt", property="authSalt", jdbcType=JdbcType.VARCHAR),
    @Result(column="last_login_ip", property="lastLoginIp", jdbcType=JdbcType.VARCHAR),
    @Result(column="last_login_time", property="lastLoginTime", jdbcType=JdbcType.TIMESTAMP),
    @Result(column="is_delete", property="isDelete", jdbcType=JdbcType.INTEGER),
    @Result(column="regist_time", property="registTime", jdbcType=JdbcType.TIMESTAMP)
})
User selectByPrimaryKey(String id);

注意：如果是多個引數，需要將 #後面的引數和傳入的變數名保持一致。

2、@Insert 註解

@Insert，插入資料時使用，直接傳入資料實體類，mybatis 會屬性自動解析到對應的引數。所以需要將 #後面的引數和實體類屬性保持一致。

    @Insert({
        "insert into sys_user (id, company_id, ",
        "username, password, ",
        "nickname, age, sex, ",
        "job, face_image, ",
        "province, city, ",
        "district, address, ",
        "auth_salt, last_login_ip, ",
        "last_login_time, is_delete, ",
        "regist_time)",
        "values (#{id,jdbcType=VARCHAR}, #{companyId,jdbcType=VARCHAR}, ",
        "#{username,jdbcType=VARCHAR}, #{password,jdbcType=VARCHAR}, ",
        "#{nickname,jdbcType=VARCHAR}, #{age,jdbcType=INTEGER}, #{sex,jdbcType=INTEGER}, ",
        "#{job,jdbcType=INTEGER}, #{faceImage,jdbcType=VARCHAR}, ",
        "#{province,jdbcType=VARCHAR}, #{city,jdbcType=VARCHAR}, ",
        "#{district,jdbcType=VARCHAR}, #{address,jdbcType=VARCHAR}, ",
        "#{authSalt,jdbcType=VARCHAR}, #{lastLoginIp,jdbcType=VARCHAR}, ",
        "#{lastLoginTime,jdbcType=TIMESTAMP}, #{isDelete,jdbcType=INTEGER}, ",
        "#{registTime,jdbcType=TIMESTAMP})"
    })
    int insert(User record);

注意：需要將 #後面的引數和實體類屬性保持一致。

3、@Update 註解

@Update，一般資料更新操作可以使用 @Update註解實現。

@Update({
        "update sys_user",
        "set company_id = #{companyId,jdbcType=VARCHAR},",
          "username = #{username,jdbcType=VARCHAR},",
          "password = #{password,jdbcType=VARCHAR},",
          "nickname = #{nickname,jdbcType=VARCHAR},",
          "age = #{age,jdbcType=INTEGER},",
          "sex = #{sex,jdbcType=INTEGER},",
          "job = #{job,jdbcType=INTEGER},",
          "face_image = #{faceImage,jdbcType=VARCHAR},",
          "province = #{province,jdbcType=VARCHAR},",
          "city = #{city,jdbcType=VARCHAR},",
          "district = #{district,jdbcType=VARCHAR},",
          "address = #{address,jdbcType=VARCHAR},",
          "auth_salt = #{authSalt,jdbcType=VARCHAR},",
          "last_login_ip = #{lastLoginIp,jdbcType=VARCHAR},",
          "last_login_time = #{lastLoginTime,jdbcType=TIMESTAMP},",
          "is_delete = #{isDelete,jdbcType=INTEGER},",
          "regist_time = #{registTime,jdbcType=TIMESTAMP}",
        "where id = #{id,jdbcType=VARCHAR}"
    })
    int updateByPrimaryKey(User record);

4、@Delete 註解
@Delete 資料刪除的註解

    @Delete({
        "delete from sys_user",
        "where id = #{id,jdbcType=VARCHAR}"
    })
    int deleteByPrimaryKey(String id);

5、@Results 和 @Result 註解

@Results 和 @Result 主要作用是，當有一些特殊的場景需要處理，查詢的返回結果與期望的資料格式不一致時，可以將將資料庫中查詢到的數值自動轉化為具體的屬性或型別，，修飾返回的結果集。比如查詢的物件返回值屬性名和欄位名不一致，或者物件的屬性中使用了列舉等。如果實體類屬性和資料庫屬性名保持一致，就不需要這個屬性來修飾。

@Select({
    "select",
    "id, company_id, username, password, nickname, age, sex, job, face_image, province, ",
    "city, district, address, auth_salt, last_login_ip, last_login_time, is_delete, ",
    "regist_time",
    "from sys_user",
    "where id = #{id,jdbcType=VARCHAR}"
})
@Results({
    @Result(column="id", property="id", jdbcType=JdbcType.VARCHAR, id=true),
    @Result(column="company_id", property="companyId", jdbcType=JdbcType.VARCHAR),
    @Result(column="face_image", property="faceImage", jdbcType=JdbcType.VARCHAR),
    @Result(column="auth_salt", property="authSalt", jdbcType=JdbcType.VARCHAR),
    @Result(column="last_login_ip", property="lastLoginIp", jdbcType=JdbcType.VARCHAR),
    @Result(column="last_login_time", property="lastLoginTime", jdbcType=JdbcType.TIMESTAMP),
    @Result(column="is_delete", property="isDelete", jdbcType=JdbcType.INTEGER),
    @Result(column="regist_time", property="registTime", jdbcType=JdbcType.TIMESTAMP)
})
User selectByPrimaryKey(String id);

上面的例子可以看到，資料庫中的company_id 欄位和實體類中定義的 companyId 屬性的名稱不一致，需要Result 轉換。

以上就是專案中常用的增、刪、改、查的操作，其實這些在基本的方法不需要手動寫，用前面講過的mybatis generator 自動生成即可。講這些主要是熟悉這些常用的註解。

傳參方式

上面介紹了mybatis 常用的註解，如何實現增刪改查的操作，相信很多人會有疑問了： mybatis 是如何將引數傳遞到 SQL 中的呢，都有哪幾種傳參方式呢？下面就來一一介紹mybatis 註解版的傳參方式。

1、直接傳參

對於單個引數的方法，可直接使用 #{id} 的方式接收同名的變數引數。

    @Delete("delete from sys_user where id = #{id,jdbcType=VARCHAR}")
    int deleteByPrimaryKey(String id);

2、使用 @Param 註解

@Param註解的作用是給引數命名，引數命名後就能根據名字得到引數值，正確的將引數傳入sql語句中。如果你的方法有多個引數，@Param 註解會在方法的引數上就能為它們取自定義名字，引數則先以 "param" 作字首，再加上它們的引數位置作為引數別名。例如， #{param1}、 #{param2}，這個是預設值。如果註解是 @Param("person")，那麼引數就會被命名為 #{person}。

@Select("SELECT * FROM sys_user WHERE username = #{username} and password = #{password}")
List<User> getListByUserSex(@Param("username") String userName, @Param("password") String password);

// 不自定義param 時，預設使用 param + 引數序號 或者 0，1，值就是引數的值。
@Select("SELECT * FROM sys_user WHERE username = #{param1} and password = #{param2}")
List<User> getListByUserSex(String userName, String password);

3、Map 傳值
需要傳送多個引數時，也可以考慮使用 Map的形式。

@Select("SELECT * FROM sys_user WHERE username=#{username} AND password = #{password}")
List<User> getListByNameAndSex(Map<String, Object> map);

呼叫時將引數依次加入到 Map 中即可。

Map param= new HashMap();
param.put("username","admin");
param.put("password","123456");
List<User> users = userMapper.getListByNameAndSex(param)

4、使用pojo物件
使用pojo物件傳參是比較常用的傳參方式。像上面的insert、update 等方法。都是直接傳入user物件。

@Update({
    "update sys_user",
    "set company_id = #{companyId,jdbcType=VARCHAR},",
      "username = #{username,jdbcType=VARCHAR},",
      "password = #{password,jdbcType=VARCHAR},",
      "nickname = #{nickname,jdbcType=VARCHAR},",
      "age = #{age,jdbcType=INTEGER},",
      "sex = #{sex,jdbcType=INTEGER},",
      "job = #{job,jdbcType=INTEGER},",
      "face_image = #{faceImage,jdbcType=VARCHAR},",
      "province = #{province,jdbcType=VARCHAR},",
      "city = #{city,jdbcType=VARCHAR},",
      "district = #{district,jdbcType=VARCHAR},",
      "address = #{address,jdbcType=VARCHAR},",
      "auth_salt = #{authSalt,jdbcType=VARCHAR},",
      "last_login_ip = #{lastLoginIp,jdbcType=VARCHAR},",
      "last_login_time = #{lastLoginTime,jdbcType=TIMESTAMP},",
      "is_delete = #{isDelete,jdbcType=INTEGER},",
      "regist_time = #{registTime,jdbcType=TIMESTAMP}",
    "where id = #{id,jdbcType=VARCHAR}"
})
int updateByPrimaryKey(User record);

以上，就是Mybatis 傳參的四種方式。根據方法的引數選擇合適的傳值方式。

動態 SQL

實際專案中，除了使用一些常用的增刪改查的方法之外，有些複雜的需求，可能還需要執行一些自定義的動態sql。mybatis 除了提供了@Insert、@Delete 這些常用的註解，還提供了多個註解如：@InsertProvider,@UpdateProvider,@DeleteProvider和@SelectProvider，用來建立動態sql 和讓 mybatis 執行這些sql 的註解。下面就來實現按欄位更新的功能。

1、首先在 UserSqlProvider 中建立拼接sql的方法。

public String updateByPrimaryKeySelective(User record) {
        BEGIN();
        UPDATE("sys_user");
        
        if (record.getCompanyId() != null) {
            SET("company_id = #{companyId,jdbcType=VARCHAR}");
        }
        
        if (record.getUsername() != null) {
            SET("username = #{username,jdbcType=VARCHAR}");
        }
        
        if (record.getPassword() != null) {
            SET("password = #{password,jdbcType=VARCHAR}");
        }
        
        if (record.getNickname() != null) {
            SET("nickname = #{nickname,jdbcType=VARCHAR}");
        }
        
        if (record.getAge() != null) {
            SET("age = #{age,jdbcType=INTEGER}");
        }
        
        if (record.getSex() != null) {
            SET("sex = #{sex,jdbcType=INTEGER}");
        }
        
        if (record.getJob() != null) {
            SET("job = #{job,jdbcType=INTEGER}");
        }
        
        if (record.getFaceImage() != null) {
            SET("face_image = #{faceImage,jdbcType=VARCHAR}");
        }
        
        if (record.getProvince() != null) {
            SET("province = #{province,jdbcType=VARCHAR}");
        }
        
        if (record.getCity() != null) {
            SET("city = #{city,jdbcType=VARCHAR}");
        }
        
        if (record.getDistrict() != null) {
            SET("district = #{district,jdbcType=VARCHAR}");
        }
        
        if (record.getAddress() != null) {
            SET("address = #{address,jdbcType=VARCHAR}");
        }
        
        if (record.getAuthSalt() != null) {
            SET("auth_salt = #{authSalt,jdbcType=VARCHAR}");
        }
        
        if (record.getLastLoginIp() != null) {
            SET("last_login_ip = #{lastLoginIp,jdbcType=VARCHAR}");
        }
        
        if (record.getLastLoginTime() != null) {
            SET("last_login_time = #{lastLoginTime,jdbcType=TIMESTAMP}");
        }
        
        if (record.getIsDelete() != null) {
            SET("is_delete = #{isDelete,jdbcType=INTEGER}");
        }
        
        if (record.getRegistTime() != null) {
            SET("regist_time = #{registTime,jdbcType=TIMESTAMP}");
        }
        
        WHERE("id = #{id,jdbcType=VARCHAR}");
        
        return SQL();
    }

2、Mapper 中引入 updateByPrimaryKeySelective 方法

    @UpdateProvider(type=UserSqlProvider.class, method="updateByPrimaryKeySelective")
    int updateByPrimaryKeySelective(User record);

說明：

　　type：動態⽣成 SQL 的類

　　method：類中具體的方法名

以上，就是使用sqlprovider 動態建立sql，除了示例中的 @UpdateProvider ，，還有 @InsertProvider、 @SelectProvider 、@DeleteProvider 提供給插入、查詢、刪除的時使用。

最後

上面，介紹了使用mybatis 常用註解實現增、刪、改、查。以及mybatis 常用的四種引數傳遞方式。

這個系列課程的完整原始碼，也會提供給大家。大家關注我的微信公眾號（架構師精進），回覆：springboot原始碼。獲取這個系列課程的完整原始碼。

MyBatis引數傳入集合之foreach動態sql
2012-09-28
MyBatisSQL
Spring Boot 入門系列（二十三）整合Mybatis，實現多資料來源配置！
2021-09-02
Spring BootMyBatis
Mybatis引數傳遞
2023-02-28
MyBatis
Spring Boot系列十九 Spring boot整合 swagger
2019-03-03
Spring BootSwagger
Spring Boot入門(三)：使用Scheduled註解實現定時任務
2019-04-09
Spring Boot
Spring Boot入門系列（十七）整合Mybatis，建立自定義mapper 實現多表關聯查詢！
2020-07-02
Spring BootMyBatisAPP
Spring Boot 整合 MyBatis和 SQL Server實踐
2018-12-17
Spring BootMyBatisSQLServer
Spring Boot入門(六)：使用MyBatis訪問MySql資料庫(註解方式)
2019-06-11
Spring BootMyBatisMySql資料庫
Spring Boot系列十八 Spring AOP + 註解實現統一註解
2018-05-08
Spring Boot
Spring boot入門（二）：Spring boot整合MySql,Mybatis和PageHelper外掛
2019-02-28
Spring BootMySqlMyBatis
Spring Boot整合MyBatis實現通用Mapper
2018-08-22
Spring BootMyBatisAPP
Spring Boot入門系列（十六）使用pagehelper實現分頁功能
2020-06-28
Spring Boot
Spring Boot系列（三）：Spring Boot整合Mybatis原始碼解析
2020-08-20
Spring BootMyBatis原始碼
Spring Boot（六）整合 MyBatis 操作 MySQL 8
2018-09-12
Spring BootMyBatisMySql
MongoDB 入門教程系列之二：使用 Spring Boot 操作 MongoDB
2022-05-10
MongoDBSpring Boot
MyBatis 註解版（五）Spring boot 註解系列插入物件返回 id
2017-11-07
MyBatisSpring Boot物件
mybatis 傳遞多個引數 --解決mybatis查詢使用多個引數方法--javabean傳統方法和map方法
2014-07-27
MyBatisJavaBean
mybatis入門基礎(五)----動態SQL
2015-07-01
MyBatisSQL
Spring Boot 整合 MyBatis
2022-05-13
Spring BootMyBatis
spring boot 整合mybatis
2017-12-14
Spring BootMyBatis
Spring Boot 整合 Redis 實現快取操作
2017-04-15
Spring BootRedis快取
spring boot使用註解的方式整合mybaits
2020-12-24
Spring BootAI
Spring Boot入門(四)：開發Web Api介面常用註解總結
2019-04-24
Spring BootWebAPI
Spring Boot從入門到實戰：整合Web專案常用功能
2019-06-21
Spring BootWeb
【Spring註解驅動開發】使用@Lazy註解實現懶載入
2020-06-09
Spring
從零開始學Spring Boot系列-整合mybatis
2024-03-10
Spring BootMyBatis
Vue3學習（十九） - 使用Vue完成頁面引數傳遞
2024-02-26
Vue
Mybatis parameterType 傳入多個引數的使用
2021-08-04
MyBatis
Spring boot 六整合 MyBatis
2017-11-07
Spring BootMyBatis
Spring Boot系列(一)：Spring Boot 入門篇
2019-04-26
Spring Boot
Spring Boot整合hessian入門
2019-01-19
Spring Boot
Mybatis動態傳入order by 引數的時候不生效的問題解決方案
2019-01-30
MyBatis
mybatis 傳入多個引數
2018-08-28
MyBatis
MyBatis傳入多個引數
2017-02-07
MyBatis
SpringBoot系列Mybatis之引數傳遞的幾種姿勢
2021-09-25
Spring BootMyBatis
SPRING實踐總結--引數註解的使用
2017-07-31
Spring
Spring Boot 入門（六）：整合 treetable 和 zTree 實現樹形圖
2019-03-17
Spring Boot
Vue + Spring Boot——axios使用GET以引數的方式傳遞物件到SpringMVC解決方案
2020-11-11
VueSpring BootiOS物件SpringMVC

Spring Boot入門系列（十九）整合mybatis，使用註解實現動態Sql、引數傳遞等常用操作！

註解介紹

傳參方式

動態 SQL

最後

相關文章