[[433687]]

1. 動態SQL中的元素

動態SQL有什么作用?

“開發人員在使用JDBC或其他類似的框架進行數據庫開發時，通常都要根據需求去手動拼裝SQL，這是一個非常麻煩且痛苦的工作，而MyBatis提供的對SQL語句動態組裝的功能，恰能很好的解決這一麻煩工作。

動態SQL是MyBatis的強大特性之一，MyBatis3采用了功能強大的基于OGNL的表達式來完成動態SQL。動態SQL主要元素如下表所示：

2. < if >元素

“在MyBatis中，< if >元素是最常用的判斷語句，它類似于Java中的if語句，主要用于實現某些簡單的條件選擇。其基本使用示例如下：

select * from t_customer where 1=1  
     <if test="username !=null and username !=''"> 
  and username like concat('%',#{username}, '%') 
     </if> 
     <if test="jobs !=null and jobs !=''"> 
  and jobs= #{jobs} 
     </if> 

使用< if >元素對username和jobs進行非空判斷，并動態組裝SQL

“在實際應用中，我們可能會通過多個條件來精確的查詢某個數據。例如，要查找某個客戶的信息，可以通過姓名和職業來查找客戶，也可以不填寫職業直接通過姓名來查找客戶，還可以都不填寫而查詢出所有客戶，此時姓名和職業就是非必須條件。

3. < choose >及其子元素

<!--<choose>(<when>、<otherwise>)元素使用 --> 
    <select id="findCustomerByNameOrJobs" parameterType="com.nateshao.po.Customer" 
            resultType="com.nateshao.po.Customer"> 
        select * from t_customer where 1=1 
        <choose> 
            <when test="username !=null and username !=''"> 
                and username like concat('%',#{username}, '%') 
            </when> 
            <when test="jobs !=null and jobs !=''"> 
                and jobs= #{jobs} 
            </when> 
            <otherwise> 
                and phone is not null 
            </otherwise> 
        </choose> 
    </select> 

使用< choose >及其子元素依次對條件進行非空判斷，并動態組裝SQL。

4. < when >、< trim >元素

在前面中，映射文件中編寫的SQL后面都加入了“where 1=1”的條件，那么到底為什么要這么寫呢?如果將where后“1=1”的條件去掉，那么MyBatis所拼接出來的SQL將會如下所示：

select * from t_customer where and username like concat('%',?, '%') 

可以看出上面SQL語句明顯存在SQL語法錯誤，而加入了條件“1=1”后，既保證了where后面的條件成立，又避免了where后面第一個詞是and或者or之類的關鍵詞。不過“where 1=1”這種寫法對于初學者來將不容易理解，并且也不夠雅觀。

針對上述情況中“where 1=1”，在MyBatis的SQL中就可以使用< where >或< trim >元素進行動態處理。

動態SQL處理

select * from t_customer 
      <where> 
           <if test="username !=null and username !=''"> 
                 and username like concat('%',#{username}, '%') 
           </if> 
           <if test="jobs !=null and jobs !=''"> 
                 and jobs= #{jobs} 
           </if> 
      </where> 

< where >元素處理

< where >會自動判斷SQL語句，只有< where >內的條件成立時，才會在拼接SQL中加入where關鍵字，否則將不會添加;還會去除多余的“AND”或“OR”。

select * from t_customer 
     <trim prefix="where" prefixOverrides="and"> 
            <if test="username !=null and username !=''"> 
                  and username like concat('%',#{username}, '%') 
            </if> 
            <if test="jobs !=null and jobs !=''"> 
                  and jobs= #{jobs} 
            </if> 
     </trim> 

5. < set >元素

“在Hibernate中，想要更新某個對象，就需要發送所有的字段給持久化對象，這種想更新的每一條數據都要將其所有的屬性都更新一遍的方法，其執行效率是非常差的。為此，在MyBatis中可以使用動態SQL中的< set >元素進行處理：

<!-- <set>元素 --> 
    <update id="updateCustomer" parameterType="com.nateshao.po.Customer"> 
        update t_customer 
        <set> 
            <if test="username !=null and username !=''"> 
                username=#{username}, 
            </if> 
            <if test="jobs !=null and jobs !=''"> 
                jobs=#{jobs}, 
            </if> 
            <if test="phone !=null and phone !=''"> 
                phone=#{phone}, 
            </if> 
        </set> 
        where id=#{id} 
    </update> 

使用< set >和< if >元素對username和jobs進行更新判斷，并動態組裝SQL。這樣就只需要傳入想要更新的字段即可

代碼實現：

6. < foreach >元素

假設如下需求：在一個客戶表中有1000條數據，現在需要將id值小于100的客戶信息全部查詢出來，這要怎么做呢?

一條一條的查詢 ：那如果要查詢1000條數據呢,豈不是很累?

在Java中用for循環查詢 ：考慮過N條查詢語句時的查詢效率了嗎?

針對上述需求，理想的解決方法就是使用MyBatis中動態SQL的< foreach >元素進行處理。其基本使用示例如下所示：

<!--<foreach>元素使用 --> 
    <select id="findCustomerByIds" parameterType="List" 
            resultType="com.nateshao.po.Customer"> 
        select * from t_customer where id in 
        <foreach item="id" index="index" collection="list" open="(" 
                 separator="," close=")"> 
            #{id} 
        </foreach> 
    </select> 

關于上述示例中< foreach >元素中使用的幾種屬性的描述具體如下：

• item：配置的是循環中當前的元素。
• index：配置的是當前元素在集合的位置下標。
• collection：配置的list是傳遞過來的參數類型(首字母小寫)，它可以是一個array、list(或collection)、Map集合的鍵、POJO包裝類中數組或集合類型的屬性名等。
• open和close：配置的是以什么符號將這些集合元素包裝起來。
• separator：配置的是各個元素的間隔符。

在使用< foreach >時最關鍵也是最容易出錯的就是collection屬性，該屬性是必須指定的，而且在不同情況下，該屬性的值是不一樣的。主要有以下3種情況：

• 如果傳入的是單參數且參數類型是一個數組或者List的時候，collection屬性值分別為array和list(或collection)。
• 如果傳入的參數是多個的時候，就需要把它們封裝成一個Map了，當然單參數也可以封裝成Map集合，這時候collection屬性值就為Map的鍵。
• 如果傳入的參數是POJO包裝類的時候，collection屬性值就為該包裝類中需要進行遍歷的數組或集合的屬性名。

7. < bind >元素

在入門案例中模糊查詢的SQL語句中?

select * from t_customer where username like '%${value}%' 

上述SQL語句有什么不妥?

• 如果使用“${}”進行字符串拼接，則無法防止SQL注入問題;
• 如果改用concat函數進行拼接，則只針對MySQL數據庫有效;
• 如果改用“||”進行字符串拼接，則只針對Oracle數據庫有效。

小提示：這樣，映射文件中的SQL就要根據不同的情況提供不同形式的實現，這顯然是比較麻煩的，且不利于項目的移植。為了減少這種麻煩，就可以使用MyBatis的< bind >元素來解決這一問題。

MyBatis的< bind >元素可以通過OGNL表達式來創建一個上下文變量，其使用方式如下：

<!--<bind>元素的使用：根據客戶名模糊查詢客戶信息 --> 
    <select id="findCustomerByName" parameterType="com.nateshao.po.Customer" 
            resultType="com.nateshao.po.Customer"> 
        <!--_parameter.getUsername()也可直接寫成傳入的字段屬性名，即username --> 
        <bind name="pattern_username" value="'%'+_parameter.getUsername()+'%'"/> 
        select * from t_customer 
        where 
        username like #{pattern_username} 
    </select> 

_parameter.getUsername()表示傳遞進來的參數(也可以直接寫成對應的參數變量名，如username)。

總結 

好了，最后我們可以了解常用動態SQL元素的主要作用，并能夠掌握這些元素在實際開發中如何使用。因為千羽在實際開發MyBatis框架中，這些動態SQL元素的使用十分重要，熟練的掌握它們能夠極大的提高開發效率。