前面介紹了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原始碼。獲取這個系列課程的完整原始碼。