Mybatis常見注解有哪些(總結(jié))
當(dāng)下,注解非常流行,以前很長篇的代碼,現(xiàn)在基本上一個注解就能搞定。
那,在Mybatis中又有哪些注解呢?
Mybatis中的注解基本上都在org.apache.ibatis.annotations目錄下:
該注解存在著爭議,但不可否認(rèn)的是這個注解確實(shí)是Mybatis的注解,是為了集成Spring而寫的注解。該注解主要是掃描某個包目錄下的Mapper,將Mapper接口類交給Spring進(jìn)行管理。
org.mybatis.spring.annotation.MapperScan使用方式
@SpringBootApplication@MapperScan('com.tian.mybatis.mapper')public class Application {}
其實(shí),從名字上就能看出,是用來掃描的Mapper的。
掃描包路徑可以是一個或者多個,也可以在路徑中可以使用 * 作為通配符對包名進(jìn)行匹配 。
@SpringBootApplication@MapperScan('com.tian.*.mapper')public class Application {}@SpringBootApplication@MapperScan({'com.tian.mybatis.mapper','com.tian.mybatis.mapper1'})public class Application {}
靈活度相當(dāng)高,這樣在實(shí)際上項(xiàng)目中,我們就可以指定掃描想要被掃描的包路徑。
@Mapper該注解目的就是為了不再寫mapper映射文件 (UserMapper.xml)??梢源蟠蟮暮喕帉憍ml的繁瑣。該注解是由Mybatis框架中定義的一個描述數(shù)據(jù)層接口的注解,注解往往起到的都是一個描述性作用,用于告訴Spring框架此接口的實(shí)現(xiàn)類由Mybatis負(fù)責(zé)創(chuàng)建,并將其實(shí)現(xiàn)類對象存儲到spring容器中。
使用方式@Mapperpublic interface UserMapper { User selectById(Integer id); }@Insert
插入記錄的時候主鍵如何生成?對此基本上有三種方案,分別是:手動指定(應(yīng)用層)、自增主鍵(數(shù)據(jù)層單表)、選擇主鍵(數(shù)據(jù)層多表)。
對應(yīng)xml文件中的<insert>標(biāo)簽。
在應(yīng)用層手動指定主鍵手動指定的方式不把主鍵區(qū)別看待,插入之前在應(yīng)用層生成對象的時候就會給主鍵一個值,插入的時候與普通字段沒啥區(qū)別。
/*** 插入記錄,手動分配主鍵 */@Insert('INSERT INTO t_user (id, username, passwd) VALUES (#{id}, #{username}, #{passwd})')int addUserAssignKey(User user);
在上面的這個例子中,mybatis并不知道到底哪個字段是主鍵,id雖然是主鍵字段,但并沒有被區(qū)別對待。
「注意」
#{username}這種寫法,是把User作為了當(dāng)前上下文,這樣訪問User的屬性的時候直接寫屬性名字就可以了。
表自增主鍵自增主鍵對應(yīng)著XML配置中的主鍵回填,一個簡單的例子:
/*** 插入記錄,數(shù)據(jù)庫生成主鍵 */@Options(useGeneratedKeys = true, keyProperty = 'id')@Insert('INSERT INTO t_user (username, passwd) VALUES (#{username}, #{passwd})')int addUserGeneratedKey(User user);
使用Option來對應(yīng)著XML設(shè)置的select標(biāo)簽的屬性,userGeneratordKeys表示要使用自增主鍵,keyProperty用來指定主鍵字段的字段名。自增主鍵會使用數(shù)據(jù)庫底層的自增特性。
選擇主鍵選擇主鍵從數(shù)據(jù)層生成一個值,并用這個值作為主鍵的值。
/** * 插入記錄,選擇主鍵 */@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類型是被成功刪除的記錄數(shù)。對應(yīng)xml文件中的<delete>標(biāo)簽。
/** * 刪除記錄 */@Delete('DELETE FROM t_user WHERE id=#{id}')int delete(Long id);@Update
修改的時候和刪除一樣只要把SQL語句寫在@Update的value中就好了,返回一個int類型表示被修改的記錄行數(shù)。
對應(yīng)xml文件中的<update>標(biāo)簽。
/** * 修改記錄 */@Update('UPDATE t_user SET username=#{username}, passwd=#{passwd} WHERE id=#{id}')int update(User user);@Select
查詢的時候稍稍有些復(fù)雜,因?yàn)椴樵儠婕暗饺绾螌⒉槌鰜淼淖侄卧O(shè)置到對象上,對應(yīng)xml文件中的<select>標(biāo)簽。
通常有那么三種辦法:
在SQL語句中手動指定別名來匹配在寫SQL語句的時候,手動為每一個字段指定一個別名來跟對象的屬性做匹配,適用于表字段名與對象屬性名差異很大沒有規(guī)律并且表字段不多的情況。
/** * 根據(jù)ID查詢,手動設(shè)置別名 */@Select('SELECT id, username, passwd, birth_day AS birthDay FROM t_user WHERE id=#{id}')User loadByIdHandAlias(Long id);使用mybatis的自動下劃線駝峰轉(zhuǎn)換
mybatis有一個選項(xiàng)叫mapUnderscoreToCamelCase,當(dāng)表中的字段名與對象的屬性名相同只是下劃線和駝峰寫法的差異時適用。
配置了mapUnderscoreToCamelCase之后mybatis在將ResultSet查出的數(shù)據(jù)設(shè)置到對象的時候會嘗試先將下劃線轉(zhuǎn)換為駝峰然后前面拼接set去設(shè)置屬性。
開啟轉(zhuǎn)換:
然后查詢
/** * 根據(jù)ID查詢,開了自動駝峰轉(zhuǎn)換 */@Select('SELECT * FROM t_user WHERE id=#{id}')User loadByIdAutoAlias(Long id);
查看打印的結(jié)果,birth_day屬性填充到了對象中:
對于表的字段名和對象的屬性名沒有太大相同點(diǎn)并且表中的字段挺多的情況下,應(yīng)該使用ResultMap做適配。
/** * 使用ResultMap */@Results(id = 'userMap', value = { //可以使用這種方式來處理字段名和數(shù)據(jù)庫表字段名不一致的情況 @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對應(yīng)著XML中的ResultMap,同時可以為其指定一個id,其它地方可以使用這個id來引用它,比如要引用上面的這個Results:
/** * 引用其他的Result */@ResultMap('userMap')@Select('SELECT * FROM t_user WHERE id=#{id}')User loadByIdResultMapReference(Long id);
使用@ResultMap來引用一個已經(jīng)存在的ResultMap,這個ResultMap可以是在Java中使用@Results注解定義的,也可以是在XML中使用resultMap標(biāo)簽定義的。
增刪改查注解總結(jié)
@Results:結(jié)果映射的列表, 包含了一個特別結(jié)果列如何被映射到屬性或字段的詳情。屬 性:value, id。value 屬性是 Result 注解的數(shù)組。對應(yīng)xml中的<resultMap> 標(biāo)簽。
@Result:在列和屬性或字段之間的單獨(dú)結(jié)果映 射。屬 性:id,column, property, javaType ,jdbcType ,type Handler, one,many。id 屬性是一個布爾值,表 示了應(yīng)該被用于比較(和在 XML 映射 中的相似)的屬性。one 屬性是單 獨(dú) 的 聯(lián) 系, 和 <association> 相 似 , 而 many 屬 性 是 對 集 合 而 言 的 , 和 <collection>相似。它們這樣命名是為了 避免名稱沖突。類似于<resultMap>的子標(biāo)簽 <result>``<id>。
@One:復(fù)雜類型的單獨(dú)屬性值映射。屬性: select,已映射語句(也就是映射器方 法)的完全限定名,它可以加載合適類 型的實(shí)例。注意:聯(lián)合映射在注解 API 中是不支持的。這是因?yàn)?Java 注解的 限制,不允許循環(huán)引用。類似于<association>標(biāo)簽。
@Many:與@One類似,一對多的關(guān)系,類似于<collection>
@Param :參數(shù)標(biāo)簽,我們在Mapper的方法簽名上標(biāo)注的參數(shù),我們可以指定參數(shù)名稱,然后在注解中或者xml中的SQL里就可以使用我們自定義的參數(shù)名稱。
@SelectKey :獲取最新插入id。
@CacheNamespace :為給定的命名空間 (比如類) 配置緩存。對應(yīng)xml中的<cache>。
@CacheNamespaceRef :參照另外一個命名空間的緩存來使用。屬性:value,應(yīng)該是一個名空間的字 符串值(也就是類的完全限定名) 。對應(yīng)xml中的<cacheRef>標(biāo)簽。
@ConstructorArgs :收集一組結(jié)果傳遞給一個劫奪對象的 構(gòu)造方法。屬性:value,是形式參數(shù) 的數(shù)組。
@Arg :單 獨(dú) 的 構(gòu) 造 方 法 參 數(shù) , 是 ConstructorArgs 集合的一部分。屬性: id,column,javaType,typeHandler。id 屬性是布爾值, 來標(biāo)識用于比較的屬 性,和XML 元素相似。對應(yīng)xml中的<arg>標(biāo)簽。
@Case :單獨(dú)實(shí)例的值和它對應(yīng)的映射。屬性: value,type,results。Results 屬性是結(jié) 果數(shù)組,因此這個注解和實(shí)際的 ResultMap 很相似,由下面的 Results 注解指定。對應(yīng)xml中標(biāo)簽<case>。
Mybatis常用注解對應(yīng)的目標(biāo)和標(biāo)簽
mybatis最初配置信息是基于 XML ,映射語句(SQL)也是定義在 XML 中的。而到了 MyBatis 3提供了新的基于注解的配置。mybatis提供的注解有很多,筆者進(jìn)行了分類:
「增刪改查:」@Insert、@Update、@Delete、@Select、@MapKey、@Options、@SelelctKey、@Param、@InsertProvider、@UpdateProvider、@DeleteProvider、@SelectProvider 「結(jié)果集映射:」@Results、@Result、@ResultMap、@ResultType、@ConstructorArgs、@Arg、@One、@Many、@TypeDiscriminator、@Case 「緩存:」@CacheNamespace、@Property、@CacheNamespaceRef、@Flush絕大部分注解,在xml映射文件中都有元素與之對應(yīng),但是不是所有。此外在mybatis-spring中提供了@Mapper注解和@MapperScan注解,用于和spring進(jìn)行整合。
到此這篇關(guān)于Mybatis常見注解有哪些(總結(jié))的文章就介紹到這了,更多相關(guān)Mybatis常見注解內(nèi)容請搜索好吧啦網(wǎng)以前的文章或繼續(xù)瀏覽下面的相關(guān)文章希望大家以后多多支持好吧啦網(wǎng)!
相關(guān)文章:
1. SQL Server數(shù)據(jù)庫的三種創(chuàng)建方法匯總2. ubuntu下使用SQLite3的基本命令3. SQLite教程(四):內(nèi)置函數(shù)4. SQLite數(shù)據(jù)庫安裝及基本操作指南5. DB2 自動遞增字段實(shí)現(xiàn)方法6. MySQL存儲過程in、out和inout參數(shù)示例和總結(jié)7. 目前學(xué)習(xí)到的常用命令之Mariadb8. python之sqlalchemy創(chuàng)建表的實(shí)例詳解9. 國內(nèi)學(xué)院派專家對DB2 9新產(chǎn)品贊不絕口10. sql語句LEFT JOIN拼接表詳解
