這篇文章將為大家詳細(xì)講解有關(guān)foreach怎么在mybatis中使用，文章內(nèi)容質(zhì)量較高，因此小編分享給大家做個(gè)參考，希望大家閱讀完這篇文章后對相關(guān)知識(shí)有一定的了解。

創(chuàng)新互聯(lián)公司技術(shù)團(tuán)隊(duì)10多年來致力于為客戶提供網(wǎng)站建設(shè)、網(wǎng)站制作、高端網(wǎng)站設(shè)計(jì)、成都營銷網(wǎng)站建設(shè)、搜索引擎SEO優(yōu)化等服務(wù)。經(jīng)過多年發(fā)展，公司擁有經(jīng)驗(yàn)豐富的技術(shù)團(tuán)隊(duì)，先后服務(wù)、推廣了近千家網(wǎng)站，包括各類中小企業(yè)、企事單位、高校等機(jī)構(gòu)單位。

foreach元素的屬性主要有item，index，collection，open，separator，close。

• item：集合中元素迭代時(shí)的別名，該參數(shù)為必選。

• index：在list和數(shù)組中,index是元素的序號，在map中，index是元素的key，該參數(shù)可選

• open：foreach代碼的開始符號，一般是(和close=")"合用。常用在in(),values()時(shí)。該參數(shù)可選

• separator：元素之間的分隔符，例如在in()的時(shí)候，separator=","會(huì)自動(dòng)在元素中間用“,“隔開，避免手動(dòng)輸入逗號導(dǎo)致sql錯(cuò)誤，如in(1,2,)這樣。該參數(shù)可選。

• close: foreach代碼的關(guān)閉符號，一般是)和open="("合用。常用在in(),values()時(shí)。該參數(shù)可選。

• collection: 要做foreach的對象，作為入?yún)r(shí)，List對象默認(rèn)用"list"代替作為鍵，數(shù)組對象有"array"代替作為鍵，Map對象沒有默認(rèn)的鍵。當(dāng)然在作為入?yún)r(shí)可以使用@Param("keyName")來設(shè)置鍵，設(shè)置keyName后，list,array將會(huì)失效。 除了入?yún)⑦@種情況外，還有一種作為參數(shù)對象的某個(gè)字段的時(shí)候。舉個(gè)例子：如果User有屬性List ids。入?yún)⑹荱ser對象，那么這個(gè)collection = "ids".如果User有屬性Ids ids;其中Ids是個(gè)對象，Ids有個(gè)屬性List id;入?yún)⑹荱ser對象，那么collection = "ids.id"

在使用foreach的時(shí)候最關(guān)鍵的也是最容易出錯(cuò)的就是collection屬性，該屬性是必須指定的，但是在不同情況下，該屬性的值是不一樣的，主要有一下3種情況：

• 如果傳入的是單參數(shù)且參數(shù)類型是一個(gè)List的時(shí)候，collection屬性值為list .

• 如果傳入的是單參數(shù)且參數(shù)類型是一個(gè)array數(shù)組的時(shí)候，collection的屬性值為array .

• 如果傳入的參數(shù)是多個(gè)的時(shí)候，我們就需要把它們封裝成一個(gè)Map了，當(dāng)然單參數(shù)也可以封裝成map，實(shí)際上如果你在傳入?yún)?shù)的時(shí)候，在MyBatis里面也是會(huì)把它封裝成一個(gè)Map的，map的key就是參數(shù)名，所以這個(gè)時(shí)候collection屬性值就是傳入的List或array對象在自己封裝的map里面的key.

針對最后一條，我們來看一下官方說法：

注意 你可以將一個(gè) List 實(shí)例或者數(shù)組作為參數(shù)對象傳給 MyBatis，當(dāng)你這么做的時(shí)候，MyBatis 會(huì)自動(dòng)將它包裝在一個(gè) Map 中并以名稱為鍵。List 實(shí)例將會(huì)以“l(fā)ist”作為鍵，而數(shù)組實(shí)例的鍵將是“array”。

所以，不管是多參數(shù)還是單參數(shù)的list,array類型，都可以封裝為map進(jìn)行傳遞。如果傳遞的是一個(gè)List，則mybatis會(huì)封裝為一個(gè)list為key，list值為object的map，如果是array，則封裝成一個(gè)array為key，array的值為object的map，如果自己封裝呢，則colloection里放的是自己封裝的map里的key值。

源碼分析

由于官方文檔對這塊的使用，描述的比較簡短，細(xì)節(jié)上也被忽略掉了(可能是開源項(xiàng)目文檔一貫的問題吧)，也使用不少同學(xué)在使用中遇到了問題。特別是foreach這個(gè)函數(shù)中，collection屬性做什么用，有什么注意事項(xiàng)。由于文檔不全，這塊只能通過源代碼剖析的方式來分析一下各個(gè)屬性的相關(guān)要求。

collection屬性的用途是接收輸入的數(shù)組或是List接口實(shí)現(xiàn)。但對于其名稱的要求，Mybatis在實(shí)現(xiàn)中還是有點(diǎn)不好理解的，所以需要特別注意這一點(diǎn)。

下面開始分析源代碼(筆記使用的是Mybatis 3.0.5版本)

先找到Mybatis執(zhí)行SQL配置解析的入口

MapperMethod.java類中publicObject execute(Object[] args)該方法是執(zhí)行的入口.

針對in集合查詢，對應(yīng)用就是selectForList或SelctForMap方法。

但不管調(diào)用哪個(gè)方法，都會(huì)對原來JDK傳入的參數(shù) Object[]類型，通過 getParam方法轉(zhuǎn)換成一個(gè)Object,那這個(gè)方法是做什么的呢？分析源碼如下：

上圖中標(biāo)紅的兩處，很驚訝的發(fā)現(xiàn)，一個(gè)參數(shù)與多個(gè)參數(shù)的處理方式是不同的(后續(xù)很多同學(xué)遇到的問題，就有一大部分出自這個(gè)地方)。如果參數(shù)個(gè)數(shù)大于一個(gè)，則會(huì)被封裝成Map, key值如果使用了Mybatis的 Param注解，則會(huì)使用該key值，否則默認(rèn)統(tǒng)一使用數(shù)據(jù)序號,從1開始。這個(gè)問題先記下，繼續(xù)分析代碼，接下來如果是selectForList操作(其它操作就對應(yīng)用相應(yīng)方法),會(huì)調(diào)用DefaultSqlSession的publicListselectList(String statement, Object parameter, RowBounds rowBounds)方法

又一個(gè)發(fā)現(xiàn)，見源代碼如下：

上圖標(biāo)紅部分，對參數(shù)又做了一次封裝，我們看一下代碼

現(xiàn)在有點(diǎn)清楚了，如果參數(shù)類型是List,則必須在collecion中指定為list, 如果是數(shù)據(jù)組，則必須在collection屬性中指定為 array.

現(xiàn)在就問題就比較清楚了，如果是一個(gè)參數(shù)的話，collection的值取決于你的參數(shù)類型。

如果是多個(gè)值的話，除非使用注解Param指定，否則都是數(shù)字開頭，所以在collection中指定什么值都是無用的。下圖是debug顯示結(jié)果。

使用方法

單參數(shù)List 類型

select count(*) from users
 
  id in
  
   #{item.id, jdbcType=NUMERIC}
  
 

測試代碼：

@Test
 public void shouldHandleComplexNullItem() {
  SqlSession sqlSession = sqlSessionFactory.openSession();
  try {
   Mapper mapper = sqlSession.getMapper(Mapper.class);
   User user1 = new User();
   user1.setId(2);
   user1.setName("User2");
   List users = new ArrayList();
   users.add(user1);
   users.add(null);
   int count = mapper.countByUserList(users);
   Assert.assertEquals(1, count);
  } finally {
   sqlSession.close();
  }
 }

上述collection為array，對應(yīng)的Mapper代碼：

public List dynamicForeach3Test(int[] ids);

對應(yīng)的測試代碼：

@Test
 public void dynamicForeach3Test() {
     SqlSession session = Util.getSqlSessionFactory().openSession();
     BlogMapper blogMapper = session.getMapper(BlogMapper.class);
     int[] ids = new int[] {1,3,6,9};
     List blogs = blogMapper.dynamicForeach3Test(ids);
     for (Blog blog : blogs)
     System.out.println(blog);  
     session.close();
 }

3.自己把參數(shù)封裝成Map的類型

     select * from t_blog where title like "%"#{title}"%" and id in
     
        #{item}
     
 

上述collection的值為ids，是傳入的參數(shù)Map的key，對應(yīng)的Mapper代碼：

public List dynamicForeach4Test(Map params);

對應(yīng)測試代碼：

@Test
  public void dynamicForeach4Test() {
    SqlSession session = Util.getSqlSessionFactory().openSession();
     BlogMapper blogMapper = session.getMapper(BlogMapper.class);
     final List ids = new ArrayList();
     ids.add(1);
     ids.add(2);
     ids.add(3);
     ids.add(6);
     ids.add(7);
     ids.add(9);
    Map params = new HashMap();
     params.put("ids", ids);
     params.put("title", "中國");
    List blogs = blogMapper.dynamicForeach4Test(params);
     for (Blog blog : blogs)
       System.out.println(blog);
     session.close();
   }

關(guān)于foreach怎么在mybatis中使用就分享到這里了，希望以上內(nèi)容可以對大家有一定的幫助，可以學(xué)到更多知識(shí)。如果覺得文章不錯(cuò)，可以把它分享出去讓更多的人看到。