新聞中心
本文轉載自微信公眾號「Java后端技術全?!梗髡咛锞S常。轉載本文請聯(lián)系Java后端技術全棧公眾號。

成都創(chuàng)新互聯(lián)作為成都網站建設公司,專注網站建設公司、網站設計,有關成都企業(yè)網站定制方案、改版、費用等問題,行業(yè)涉及廣告推廣等多個領域,已為上千家企業(yè)服務,得到了客戶的尊重與認可。
MyBatis 提供了XML配置和注解配置兩種方式。今天就來搞搞這兩種方式是如何實現(xiàn)的。
MyBatis 的真正強大在于它的語句映射,這是它的魔力所在。由于它的異常強大,映射器的 XML 文件就顯得相對簡單。如果拿它跟具有相同功能的JDBC 代碼進行對比,你會立即發(fā)現(xiàn)省掉了將近 95% 的代碼。MyBatis 致力于減少使用成本,讓用戶能更專注于 SQL 代碼。
來自官網。
Mybatis映射九個頂級元素:
- mapper:映射文件的根節(jié)點,只有一個屬性namespace(命名空間),作用如下:
- 用于區(qū)分不同的mapper,全局唯一。
- 綁定DAO接口,即面向接口編程,當綁定一個接口,就不用寫此接口的實現(xiàn)類,會通過接口的完全限定名找到對應的mapper配置來執(zhí)行SQL語句,所以,namespace的命名必須要寫接口的完全限定名。
- cache:配置給定命名空間的緩存。
- cache-ref:從其他命名空間引用緩存配置。
- resultMap:用來描述數(shù)據庫結果集和對象的對應關系。
- sql:可以重用的SQL塊,也可以被其他語句引用。通常時存放一些公用性的SQL。
- insert:映射插入語句。
- update:更新映射語句。
- delete:刪除映射語句。
- select:映射查詢語句。
xml方式
九個頂級映射元素對應標簽:
select詳解
可以看得出,后面可選項還是蠻多的。下面是官網對每項的解釋。
select使用案例
- PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN"
- "http://mybatis.org/dtd/mybatis-3-mapper.dtd">
- select * from m_user where id = #{id}
- id必須在這個Mapper中是唯一的,可以被用來引用這條語句 ,這個id必須與只對應的是XxxMapper.java中的方法,必須是一一對應。
- 返回類型:User類型,resultType:查詢語句返回結果類型的完全限定名或別名。別名使用方式和parameterType是一樣的。
- 參數(shù):整形,表示查詢語句傳入參數(shù)的類型和完全限定名或別名。支持基礎數(shù)據類型和復雜數(shù)據類型。
#{參數(shù)名}:告訴MyBatis生成的PreparedStatement參數(shù),相對于JDBC中,改參數(shù)被標識為‘?’。
別名與參數(shù)映射類型如下:
返回類型中別名的使用,注意:
如果是我們的entity類,那么resultType是無法使用別名的,只能使用resultMap才可以使用別名。
- PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN"
- "http://mybatis.org/dtd/mybatis-3-mapper.dtd">
- select * from m_user where id = #{id}
但是如果使用的上面映射表里,也可以直接使用別名。
數(shù)據庫里有兩條數(shù)據:
UserMapper.xml
- PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN"
- "http://mybatis.org/dtd/mybatis-3-mapper.dtd">
- select count(1) from m_user
UserMapper.java
- import com.tian.mybatis.entity.User;
- public interface UserMapper {
- int countUser();
- }
測試類:
- public class MybatisApplication {
- public static final String URL = "jdbc:mysql://localhost.com:3306/mblog?useUnicode=true";
- public static final String USER = "root";
- public static final String PASSWORD = "123456";
- public static void main(String[] args) {
- String resource = "mybatis-config.xml";
- InputStream inputStream = null;
- SqlSession sqlSession = null;
- try {
- inputStream = Resources.getResourceAsStream(resource);
- //工廠模式
- SqlSessionFactory sqlSessionFactory = new SqlSessionFactoryBuilder().build(inputStream);
- //獲取sql操作會話
- sqlSession = sqlSessionFactory.openSession();
- //構造對象(這里比較特殊,這里構造對象的方式后面會專門分享)
- UserMapper userMapper = sqlSession.getMapper(UserMapper.class);
- //查詢統(tǒng)計
- System.out.println(userMapper.countUser());
- } catch (Exception e) {
- e.printStackTrace();
- } finally {
- try {
- inputStream.close();
- } catch (IOException e) {
- e.printStackTrace();
- }
- sqlSession.close();
- }
- }
- }
輸出:2
當數(shù)據庫表中的字段名和我們entity中的字段名不一致,怎么處理?
在實際開發(fā)中,這種常見是在所難免。我們可以使用下面的這種方式解決。
實體類User
- public class User {
- private Integer id;
- private String userName;
- private Integer age;
- //set get toString方法這里就不貼了
- }
UserMapper.xml文件內容:
- PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN"
- "http://mybatis.org/dtd/mybatis-3-mapper.dtd">
- select * from m_user where id = #{id}
- type:對應的是我們的實體類,全路徑名。
- id:可以理解為別名。
- id:唯一標識,此id值用于select元素resultMap屬性的引用。
- column:對應我們數(shù)據庫表中的字段名稱。
- property:對應我們的實體類的屬性,比如:User中的屬性userName,要和數(shù)據庫表m_user中的name對應。
- result:標識一些簡單屬性,其中column屬性代表數(shù)據庫的字段名,property代表查詢出來的字段名映射到實體類的某個屬性。
繼續(xù)使用我們前面的測試類進行測試:
- UserMapper userMapper = sqlSession.getMapper(UserMapper.class);
- System.out.println(userMapper.selectUserById(1));
輸出:User{id=1, userName='tian', age=22}
注意:實體類的get set 和toString()方法這里給省略, 希望大家在使用的使用,使用快捷鍵很簡單的就搞定了。
上面提到過resultType和resultMap,那么他們兩到底有什么區(qū)別呢?
resultType和resultMap 有什么區(qū)別?
- resultType:直接表示返回類型, 包括基本數(shù)據類型和復雜數(shù)據類型。
- resultMap:外部resultMap定義的引用,通過對應的外部resultMap的id,表示結果映射到哪個resultMap上,一般用于字段名和屬性名不一致的情況,或者需要做復雜的聯(lián)合查詢以便自由控制映射結果。
兩者的關聯(lián)
當進行查詢時,查詢出來的每個字段都會放在一個Map里,當查詢元素返回屬性是resultType的時候,會將鍵值對取出賦所指定的屬性。其實MyBatis的每個查詢映射的返回類型都是resultMap,只是當我們使用resultType的時候,會自動把對應的值賦給所指定的對象屬性,當使用resultMap時候,因為map不是很好的表示領域,我們就進一步的轉化為對應的實體對象。resultMap主要作用于復雜的聯(lián)合查詢上。
resultMap的自動映射級別:默認級別為PARTIAL,也可以在settings更改值。
注意:resultType和resultMap本質是一樣的,都是Map數(shù)據結構,但是二者不能同時存在。
增刪改案例
insert
從這里可以知道,關于增加insert是沒有返回值類型可以讓我們指定的。默認返回int類型。
- INSERT INTO m_user(`name`,age) VALUES ( #{userName},#{age})
對應Mapper中的方法
- int insert(User user);
另外的update和delete類似,這里就沒有必要逐一演示了。
注解方式
九個頂級映射元素對應注解:
其他部分注解是配合九個注解進行使用的。
select注解
把本地的UserMapper.xml刪掉,然后改一下mybatis-config.xml,把其中的UserMapper.xml給注釋掉。添加
UserMapper.java添加注解
- public interface UserMapper {
- @Select("select * from m_user where id = #{id}")
- User selectUserById(Integer id);
- }
再次測試
- User user = sqlSession.selectOne("com.tian.mybatis.mapper.UserMapper.selectUserById", 1);
- System.out.println(user);
輸出:
- User{id=1, userName='null', age=22}
從輸出內容看到,userName為null,這也是因為和數(shù)據庫表匯中的字段name不一致導致的,那么如何處理呢?
這么搞,再添加一個注解:
- public interface UserMapper {
- @Select("select * from m_user where id = #{id}")
- @Results( @Result(column = "name",property = "userName"))
- User selectUserById(Integer id);
- }
輸出:
- User{id=1, userName='tian', age=22}
這樣也就是在使用注解的時候,處理實體屬性名和數(shù)據庫表字段名不一樣的問題的辦法。
insert、update、delete同樣也可以使用注解來搞定了。
@Insert、@Update、@Delete配上相應的SQL語句。
注解和xml是否可以共存?
- update m_user
- `name` = #{userName},
- gender = #{gender},
- age = #{age},
- where id=#{id}
同時在UserMapper.java中的方法上添加注解
- @Update("update m_user set `name` = #{userName},gender = #{gender},age = #{age} where id=#{id}")
- int updateAuthorIfNecessary(User user);
再次中子星的時候回報異常的:
- nested exception is java.lang.IllegalArgumentException:
- Mapped Statements collection already contains value for com.tian.mybatis.mapper.UserMapper.updateAuthorIfNecessary.
- please check file [D:\workspace\my_code\mybatis\target\classes\mapper\UserMapper.xml] and com/tian/mybatis/mapper/UserMapper.java (best guess)
大致意思就是說,已經存在了,即就是不能同時使用xml和注解。二者選其一。
xml可以喝注解結合使用,但是得保證同一個方法不能同時存在xml和注解。
建議
簡單的sql處理可以使用注解,復雜的sql使用xml。但是實際工作還得看你待的項目中有沒有對這個進行規(guī)范化。
在項目中無非就三種:
1.全部必須使用xml方式。
2.全部必須使用注解方式。
3.可以同時使用xml和注解。
高級映射
association
映射到JavaBean的某個復雜的”數(shù)據類型”屬性,僅處理一對一的關聯(lián)關系。
association的屬性節(jié)點:
- property:映射數(shù)據庫列的實體對象屬性名。
- javaType:完整的java類名和限定名。propert所映射的屬性的類型。
子元素
- id:一般為映射主鍵,可以提高性能。
- result:
- column:映射的數(shù)據庫的字段名。
- property:映射的數(shù)據列對應的實體對象屬性。
collection
映射到JavaBean的某個復雜的”數(shù)據類型”屬性,這個屬性是一個集合列表,處理一對多的關聯(lián)關系。
ofType:完整的Java類名和限定名。propert所映射的屬性的類型。
其余和association基本一致。
association和collection都具備延遲加載功能。
延遲加載:先從單表查詢,需要時再查關聯(lián)表,大大的提高了數(shù)據庫性能,因為相對來說單表查詢比多表查詢要快。
xml和注解的關系
上面我們已經講了兩種方式的實現(xiàn),下面來對比一下,兩種方式的關系:
xml方式
必須有個一個XxxMapper.xml與之對應,方法名對應xml中的id,方法入參和方法出參都必須對應起來,很容易出問題。我們在開發(fā)的時候有的是可以使用代碼生成器生成,但是有的是必須自己手寫,有的公司也是要求必須手寫,所以這里需要注意。
注解方式
不需要XxxMapper.xml文件,只需要在對應XxxMapper.java中的方法上加上注解就搞定了,但是這里是有坑的。畢竟把sql放到了我們的Java代碼里了。
優(yōu)缺點
xml方式: 增加了xml文件,修改麻煩,條件不確定(ifelse判斷),容易出錯,特殊轉義字符比如大于小于 。
注解方式:復雜sql不好用,搜集sql不方便,管理不方便,修改需重新編譯
總結
本文講述了Mybatis的兩種映射方式,以及一些注意點,一些關系和區(qū)別。
實體屬性名和數(shù)據庫表字段名不一樣的情況下,xml和注解分別是如何處理的。resultType和resultMap的區(qū)別。
網站名稱:Mybatis中xml和注解映射,soeasy啦
地址分享:http://m.fisionsoft.com.cn/article/cooepip.html


咨詢
建站咨詢
