Mybatis常見註解有哪些(總結)

Posted on by

當下，註解非常流行，以前很長篇的代碼，現在基本上一個註解就能搞定。

那，在Mybatis中又有哪些註解呢？

5e918565fd0ca1740e9e14337ddf83b3.png

Mybatis中的註解基本上都在org.apache.ibatis.annotations目錄下：

4e258b99972668d3048d7ccfd3030991.png 

@MapperScan

該註解存在著爭議，但不可否認的是這個註解確實是Mybatis的註解，是為瞭集成Spring而寫的註解。該註解主要是掃描某個包目錄下的Mapper，將Mapper接口類交給Spring進行管理。

org.mybatis.spring.annotation.MapperScan

使用方式

@SpringBootApplication
@MapperScan("com.tian.mybatis.mapper")
public class Application {
}

其實，從名字上就能看出，是用來掃描的Mapper的。

掃描包路徑可以是一個或者多個，也可以在路徑中可以使用 * 作為通配符對包名進行匹配 。

@SpringBootApplication
@MapperScan("com.tian.*.mapper")
public class Application {
}
@SpringBootApplication
@MapperScan({"com.tian.mybatis.mapper","com.tian.mybatis.mapper1"})
public class Application {
}

靈活度相當高，這樣在實際上項目中，我們就可以指定掃描想要被掃描的包路徑。

@Mapper

該註解目的就是為瞭不再寫mapper映射文件 （UserMapper.xml）。可以大大的簡化編寫xml的繁瑣。該註解是由Mybatis框架中定義的一個描述數據層接口的註解，註解往往起到的都是一個描述性作用，用於告訴Spring框架此接口的實現類由Mybatis負責創建，並將其實現類對象存儲到spring容器中。

使用方式

@Mapper
public interface UserMapper { 
  User selectById(Integer id); 
}

@Insert

插入記錄的時候主鍵如何生成？對此基本上有三種方案，分別是：手動指定(應用層)、自增主鍵(數據層單表)、選擇主鍵(數據層多表)。

對應xml文件中的<insert>標簽。

在應用層手動指定主鍵

手動指定的方式不把主鍵區別看待，插入之前在應用層生成對象的時候就會給主鍵一個值，插入的時候與普通字段沒啥區別。

/**
* 插入記錄，手動分配主鍵 
*/
@Insert("INSERT INTO t_user (id, username, passwd) VALUES (#{id}, #{username}, #{passwd})")
int addUserAssignKey(User user);

在上面的這個例子中，mybatis並不知道到底哪個字段是主鍵，id雖然是主鍵字段，但並沒有被區別對待。

「註意」

#{username}這種寫法，是把User作為瞭當前上下文，這樣訪問User的屬性的時候直接寫屬性名字就可以瞭。

表自增主鍵

自增主鍵對應著XML配置中的主鍵回填，一個簡單的例子：

/**
* 插入記錄，數據庫生成主鍵 
*/
@Options(useGeneratedKeys = true, keyProperty = "id")
@Insert("INSERT INTO t_user (username, passwd) VALUES (#{username}, #{passwd})")
int addUserGeneratedKey(User user);

使用Option來對應著XML設置的select標簽的屬性，userGeneratordKeys表示要使用自增主鍵，keyProperty用來指定主鍵字段的字段名。自增主鍵會使用數據庫底層的自增特性。

選擇主鍵

選擇主鍵從數據層生成一個值，並用這個值作為主鍵的值。

/**
 * 插入記錄，選擇主鍵 
 */
@Insert("INSERT INTO t_user (username, passwd) VALUES (#{username}, #{passwd})")
@SelectKey(statement = "SELECT UNIX_TIMESTAMP(NOW())", keyColumn = "id", keyProperty = "id", resultType = Long.class, before = true)
int addUserSelectKey(User user);

@Delete

刪除的時候隻要把語句條件神馬的寫在@Delete註解的value裡就好瞭，返回一個int類型是被成功刪除的記錄數。對應xml文件中的<delete>標簽。

/**
 * 刪除記錄 
 */
@Delete("DELETE FROM t_user WHERE id=#{id}")
int delete(Long id);

@Update

修改的時候和刪除一樣隻要把SQL語句寫在@Update的value中就好瞭，返回一個int類型表示被修改的記錄行數。

對應xml文件中的<update>標簽。

/**
 * 修改記錄 
 */
@Update("UPDATE t_user SET username=#{username}, passwd=#{passwd} WHERE id=#{id}")
int update(User user);

@Select

查詢的時候稍稍有些復雜，因為查詢會涉及到如何將查出來的字段設置到對象上，對應xml文件中的<select>標簽。

通常有那麼三種辦法：

在SQL語句中手動指定別名來匹配

在寫SQL語句的時候，手動為每一個字段指定一個別名來跟對象的屬性做匹配，適用於表字段名與對象屬性名差異很大沒有規律並且表字段不多的情況。

/**
 * 根據ID查詢，手動設置別名 
 */
@Select("SELECT id, username, passwd, birth_day AS birthDay FROM t_user WHERE id=#{id}")
User loadByIdHandAlias(Long id);

使用mybatis的自動下劃線駝峰轉換

mybatis有一個選項叫mapUnderscoreToCamelCase，當表中的字段名與對象的屬性名相同隻是下劃線和駝峰寫法的差異時適用。

配置瞭mapUnderscoreToCamelCase之後mybatis在將ResultSet查出的數據設置到對象的時候會嘗試先將下劃線轉換為駝峰然後前面拼接set去設置屬性。

開啟轉換：

70943cdbb95f3ac3f19fc71c43010a86.png

然後查詢

/**
 * 根據ID查詢，開瞭自動駝峰轉換 
 */
@Select("SELECT * FROM t_user WHERE id=#{id}")
User loadByIdAutoAlias(Long id);

查看打印的結果，birth_day屬性填充到瞭對象中：

e35c24ba10367397879f3ff38d702193.png 

使用ResultMap

對於表的字段名和對象的屬性名沒有太大相同點並且表中的字段挺多的情況下，應該使用ResultMap做適配。

/**
 * 使用ResultMap 
 */
@Results(id = "userMap", value = {
    //可以使用這種方式來處理字段名和數據庫表字段名不一致的情況
    @Result(id=true, column = "id", property = "id"),
    @Result(column = "username", property = "username"),
    @Result(column = "passwd", property = "passwd"),
    @Result(column = "birth_day", property = "birthDay")
})
@Select("SELECT * FROM t_user WHERE id=#{id}")
User loadByIdResultMap(Long id);

@Results對應著XML中的ResultMap，同時可以為其指定一個id，其它地方可以使用這個id來引用它，比如要引用上面的這個Results：

/**
 * 引用其他的Result 
 */
@ResultMap("userMap")
@Select("SELECT * FROM t_user WHERE id=#{id}")
User loadByIdResultMapReference(Long id);

使用@ResultMap來引用一個已經存在的ResultMap，這個ResultMap可以是在Java中使用@Results註解定義的，也可以是在XML中使用resultMap標簽定義的。

增刪改查註解總結

865515ac8c7d87003f155fdc99d2d321.png 

其他註解

@Results:結果映射的列表, 包含瞭一個特別結果列如何被映射到屬性或字段的詳情。屬 性:value, id。value 屬性是 Result 註解的數組。對應xml中的<resultMap> 標簽。

@Result:在列和屬性或字段之間的單獨結果映 射。屬 性:id,column, property, javaType ,jdbcType ,type Handler, one,many。id 屬性是一個佈爾值,表 示瞭應該被用於比較(和在 XML 映射 中的相似)的屬性。one 屬性是單 獨 的 聯 系, 和 <association> 相 似 , 而 many 屬 性 是 對 集 合 而 言 的 , 和 <collection>相似。它們這樣命名是為瞭 避免名稱沖突。類似於<resultMap>的子標簽 <result>``<id>。

@One：復雜類型的單獨屬性值映射。屬性: select,已映射語句(也就是映射器方 法)的完全限定名,它可以加載合適類 型的實例。註意:聯合映射在註解 API 中是不支持的。這是因為 Java 註解的 限制,不允許循環引用。類似於<association>標簽。

@Many：與@One類似，一對多的關系，類似於<collection>

@Param :參數標簽，我們在Mapper的方法簽名上標註的參數，我們可以指定參數名稱，然後在註解中或者xml中的SQL裡就可以使用我們自定義的參數名稱。

@SelectKey ：獲取最新插入id。

@CacheNamespace ：為給定的命名空間 (比如類) 配置緩存。對應xml中的<cache>。

@CacheNamespaceRef ：參照另外一個命名空間的緩存來使用。屬性:value,應該是一個名空間的字 符串值(也就是類的完全限定名) 。對應xml中的<cacheRef>標簽。

@ConstructorArgs ：收集一組結果傳遞給一個劫奪對象的 構造方法。屬性:value,是形式參數 的數組。

@Arg ：單 獨 的 構 造 方 法 參 數 , 是 ConstructorArgs 集合的一部分。屬性: id,column,javaType,typeHandler。id 屬性是佈爾值, 來標識用於比較的屬 性,和XML 元素相似。對應xml中的<arg>標簽。

@Case ：單獨實例的值和它對應的映射。屬性: value,type,results。Results 屬性是結 果數組,因此這個註解和實際的 ResultMap 很相似,由下面的 Results 註解指定。對應xml中標簽<case>。

Mybatis常用註解對應的目標和標簽

c7ff276e375ce7513baf70e390cb91e1.png 

總結

mybatis最初配置信息是基於 XML ,映射語句(SQL)也是定義在 XML 中的。而到瞭 MyBatis 3提供瞭新的基於註解的配置。mybatis提供的註解有很多，筆者進行瞭分類：

  • 「增刪改查：」@Insert、@Update、@Delete、@Select、@MapKey、@Options、@SelelctKey、@Param、@InsertProvider、@UpdateProvider、@DeleteProvider、@SelectProvider
  • 「結果集映射：」@Results、@Result、@ResultMap、@ResultType、@ConstructorArgs、@Arg、@One、@Many、@TypeDiscriminator、@Case
  • 「緩存：」@CacheNamespace、@Property、@CacheNamespaceRef、@Flush

絕大部分註解，在xml映射文件中都有元素與之對應，但是不是所有。此外在mybatis-spring中提供瞭@Mapper註解和@MapperScan註解，用於和spring進行整合。

到此這篇關於Mybatis常見註解有哪些(總結)的文章就介紹到這瞭,更多相關Mybatis常見註解內容請搜索WalkonNet以前的文章或繼續瀏覽下面的相關文章希望大傢以後多多支持WalkonNet！

推薦閱讀：