意義 rom 存在 問題 rri 也會 輸出 ray 便是

MyBatis 的強大特性之一便是它的動態 SQL。如果你有使用 JDBC 或其他類似框架的經驗，你就能體會到根據不同條件拼接 SQL 語句有多麽痛苦。拼接的時候要確保不能忘了必要的空格，還要註意省掉列名列表最後的逗號。利用動態 SQL 這一特性可以徹底擺脫這種痛苦。

最常用的就是 if where foreach這幾個，一定要重點掌握.

名詞解析：OGNL表達式

OGNL，全稱為Object-Graph Navigation Language，它是一個功能強大的表達式語言，用來獲取和設置Java對象的屬性，它旨在提供一個更高的更抽象的層次來對Java對象圖進行導航。

OGNL表達式的基本單位是"導航鏈"，一般導航鏈由如下幾個部分組成：

（1）屬性名稱（property）

（2）方法調用（method invoke）

（3）數組元素

所有的OGNL表達式都基於當前對象的上下文來完成求值運算，鏈的前面部分的結果將作為後面求值的上下文。例如：names[0].length()。

---

mybatis 的動態sql語句是基於OGNL表達式的。可以方便的在 sql 語句中實現某些邏輯. 總體說來mybatis 動態SQL 語句主要有以下幾類:
　　1. if 語句 (簡單的條件判斷)
　　2. choose (when,otherwize) ,相當於java 語言中的 switch ,與 jstl 中的choose 很類似.
　　3. trim

(對包含的內容加上 prefix,或者 suffix 等，前綴，後綴)
　　4. where (主要是用來簡化sql語句中where條件判斷的，能智能的處理 and or ,不必擔心多余導致語法錯誤)
　　5. set (主要用於更新時)
　　6. foreach (在實現 mybatis in 語句查詢時特別有用)
下面分別介紹這幾種處理方式

1、mybatis if語句處理

<select id="dynamicIfTest" parameterType="Blog" resultType="Blog">
    select * from t_blog where 1 = 1
    <if test="title != null">
        and title = #{title}
    </if>
    <if test="content != null">
        and content = #{content}
    </if>
    <if test="owner != null">
        and owner = #{owner}
    </if>
</select>

解析：

　　如果你提供了title參數，那麽就要滿足title=#{title}，同樣如果你提供了Content和Owner的時候，它們也需要滿足相應的條件，之後就是返回滿足這些條件的所有Blog，這是非常有用的一個功能。

　　以往我們使用其他類型框架或者直接使用JDBC的時候， 如果我們要達到同樣的選擇效果的時候，我們就需要拼SQL語句，這是極其麻煩的，比起來，上述的動態SQL就要簡單多了。

2、choose (when,otherwize) ,相當於java 語言中的 switch ,與 jstl 中的choose 很類似

<select id="dynamicChooseTest" parameterType="Blog" resultType="Blog">
    select * from t_blog where 1 = 1 
    <choose>
        <when test="title != null">
            and title = #{title}
        </when>
        <when test="content != null">
            and content = #{content}
        </when>
        <otherwise>
            and owner = "owner1"
        </otherwise>
    </choose>
</select>

when元素表示當when中的條件滿足的時候就輸出其中的內容，跟JAVA中的switch效果差不多的是按照條件的順序，當when中有條件滿足的時候，就會跳出choose，即所有的when和otherwise條件中，只有一個會輸出，當所有的我很條件都不滿足的時候就輸出otherwise中的內容。所以上述語句的意思非常簡單，當title!=null的時候就輸出and titlte = #{title}，不再往下判斷條件，當title為空且content!=null的時候就輸出and content = #{content}，當所有條件都不滿足的時候就輸出otherwise中的內容。

3、trim (對包含的內容加上 prefix,或者 suffix 等，前綴，後綴)

<select id="dynamicTrimTest" parameterType="Blog" resultType="Blog">
    select * from t_blog 
    <trim prefix="where" prefixOverrides="and |or">
        <if test="title != null">
            title = #{title}
        </if>
        <if test="content != null">
            and content = #{content}
        </if>
        <if test="owner != null">
            or owner = #{owner}
        </if>
    </trim>
</select>

trim元素的主要功能是可以在自己包含的內容前加上某些前綴，也可以在其後加上某些後綴，與之對應的屬性是prefix和suffix；可以把包含內容的首部某些內容覆蓋，即忽略，也可以把尾部的某些內容覆蓋，對應的屬性是prefixOverrides和suffixOverrides；正因為trim有這樣的功能，所以我們也可以非常簡單的利用trim來代替where元素的功能。

trim標記是一個格式化的標記，可以完成set或者是where標記的功能，如下代碼：

select * from user 
<trim prefix="WHERE" prefixoverride="AND |OR">
    <if test="name != null and name.length()>0"> 
        AND name=#{name}
    </if>
    <if test="gender != null and gender.length()>0"> 
        AND gender=#{gender}
    </if>
</trim>

假如說name和gender的值都不為null的話打印的SQL為：select * from user where name = ‘xx‘ and gender = ‘xx‘

在紅色標記的地方是不存在第一個and的，上面兩個屬性的意思如下：

prefix：前綴　　　　　　

prefixoverride：去掉第一個and或者是or

update user
<trim prefix="set" suffixoverride="," suffix=" where id = #{id} ">
    <if test="name != null and name.length()>0">
        name=#{name} ,
    </if>
    <if test="gender != null and gender.length()>0">
        gender=#{gender} ,  
    </if>
</trim>

假如說name和gender的值都不為null的話打印的SQL為：update user set name=‘xx‘ , gender=‘xx‘ where id=‘x‘

在紅色標記的地方不存在逗號，而且自動加了一個set前綴和where後綴，上面三個屬性的意義如下，其中prefix意義如上：

suffixoverride：去掉最後一個逗號（也可以是其他的標記，就像是上面前綴中的and一樣）

suffix：後綴

4、where (主要是用來簡化sql語句中where條件判斷的，能智能的處理 and or 條件)

<select id="dynamicWhereTest" parameterType="Blog" resultType="Blog">
    select * from t_blog 
    <where>
        <if test="title != null">
            title = #{title}
        </if>
        <if test="content != null">
            and content = #{content}
        </if>
        <if test="owner != null">
            and owner = #{owner}
        </if>
    </where>
</select>

where元素的作用是會在寫入where元素的地方輸出一個where，另外一個好處是你不需要考慮where元素裏面的條件輸出是什麽樣子的，MyBatis會智能的幫你處理，如果所有的條件都不滿足那麽MyBatis就會查出所有的記錄，如果輸出後是and 開頭的，MyBatis會把第一個and忽略，當然如果是or開頭的，MyBatis也會把它忽略；此外，在where元素中你不需要考慮空格的問題，MyBatis會智能的幫你加上。像上述例子中，如果title=null， 而content != null，那麽輸出的整個語句會是select * from t_blog where content = #{content}，而不是select * from t_blog where and content = #{content}，因為MyBatis會智能的把首個and 或 or 給忽略。

5、set (主要用於更新時)

<update id="dynamicSetTest" parameterType="Blog">
    update t_blog
    <set>
        <if test="title != null">
            title = #{title},
        </if>
        <if test="content != null">
            content = #{content},
        </if>
        <if test="owner != null">
            owner = #{owner}
        </if>
    </set>
    where id = #{id}
</update>

set元素主要是用在更新操作的時候，它的主要功能和where元素其實是差不多的，主要是在包含的語句前輸出一個set，然後如果包含的語句是以逗號結束的話將會把該逗號忽略，如果set包含的內容為空的話則會出錯。有了set元素我們就可以動態的更新那些修改了的字段。

6、foreach (在實現 mybatis in 語句查詢時特別有用)

foreach的主要用在構建in條件中，它可以在SQL語句中進行叠代一個集合。foreach元素的屬性主要有item，index，collection，open，separator，close。

（1）item表示集合中每一個元素進行叠代時的別名。

（2）index指定一個名字，用於表示在叠代過程中，每次叠代到的位置。

（3）open表示該語句以什麽開始。

（4）separator表示在每次進行叠代之間以什麽符號作為分隔符。

（5）close表示以什麽結束。

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

（1）如果傳入的是單參數且參數類型是一個List的時候，collection屬性值為list

（2）如果傳入的是單參數且參數類型是一個array數組的時候，collection的屬性值為array

（3）如果傳入的參數是多個的時候，我們就需要把它們封裝成一個Map了，當然單參數也可以封裝成map，實際上如果你在傳入參數的時候，在MyBatis裏面也是會把它封裝成一個Map的，map的key就是參數名，所以這個時候collection屬性值就是傳入的List或array對象在自己封裝的map裏面的key。

6.1、單參數List的類型

<select id="dynamicForeachTest" resultType="com.mybatis.entity.User">
    select * from t_user where id in
    <foreach collection="list" index="index" item="item" open="(" separator="," close=")">
        #{item}
    </foreach>
</select>

上述collection的值為list，對應的Mapper是這樣的：

/**mybatis Foreach測試 */
public List<User> dynamicForeachTest(List<Integer> ids); 

測試代碼：

@Test
public void dynamicForeachTest() {
    SqlSession sqlSession = sqlSessionFactory.openSession();
    UserMapper mapper = sqlSession.getMapper(UserMapper.class);
    List<Integer> ids = new ArrayList<Integer>();
    ids.add(1);
    ids.add(2);
    ids.add(6);
    List<User> userList = mapper.dynamicForeachTest(ids);
    for (User user : userList){
        System.out.println(user);
    }
    sqlSession.close();
}

6.2、數組類型的參數

<select id="dynamicForeach2Test" resultType="com.mybatis.entity.User">
    select * from t_user where id in
    <foreach collection="array" index="index" item="item" open="(" separator="," close=")">
        #{item}
    </foreach>
</select>

對應mapper：

public List<User> dynamicForeach2Test(int[] ids);  

測試代碼：

@Test
public void dynamicForeach2Test() {
    SqlSession sqlSession = sqlSessionFactory.openSession();
    UserMapper mapper = sqlSession.getMapper(UserMapper.class);
    int[] ids = {1,2,6};
    List<User> userList = mapper.dynamicForeach2Test(ids);
    for (User user : userList){
        System.out.println(user);
    }
    sqlSession.close();
}

6.3、Map類型的參數

<select id="dynamicForeach3Test" resultType="com.mybatis.entity.User">
    select * from t_user where username like ‘%${username}%‘ and id in
    <foreach collection="ids" index="index" item="item" open="(" separator="," close=")">
        #{item}
    </foreach>
</select>

mapper 應該是這樣的接口:

/**mybatis Foreach測試 */
public List<User> dynamicForeach3Test(Map<String, Object> params); 

測試方法：

@Test
public void dynamicForeach3Test() {
    SqlSession sqlSession = sqlSessionFactory.openSession();
    UserMapper mapper = sqlSession.getMapper(UserMapper.class);
    List<Integer> ids = new ArrayList<Integer>();
    ids.add(1);
    ids.add(2);
    ids.add(6);
    Map map =new HashMap();
    map.put("username", "小");
    map.put("ids", ids);
    List<User> userList = mapper.dynamicForeach3Test(map);
    System.out.println("------------------------");
    for (User user : userList){
        System.out.println(user);
    }
    sqlSession.close();
}

通過以上方法，就能完成一般的mybatis 的 動態SQL 語句.

Mybatis 動態Sql語句《常用》