iBATIS動態映射都是用在復雜查詢過程中,我們常常需要根據用戶的選擇決定查詢條件,這裡發生變化的並不只是SQL 中的參數,包括Select 語句中所包括的字段和限定條件,都可能發生變化。典型情況,如在一個復雜的組合查詢頁面,我們必須根據用戶的選擇和輸入決定查詢的條件組合。
iBATIS動態映射的一個典型的頁面如下:
對於這個組合查詢頁面,根據用戶選擇填寫的內容,我們應為其生成不同的查詢語句。如用戶沒有填寫任何信息即提交查詢請求,我們應該返回所有記錄:
Select * from t_user;
如用戶只在頁面上填寫了姓名“Erica”,我們應該生成類似:
Select * from t_user where name like ‘%Erica%’ ;的SQL查詢語句。
如用戶只在頁面上填寫了地址“Beijing”,我們應該生成類似:
Select * from t_user where address like ‘%Beijing%”;的SQL。
而如果用戶同時填寫了姓名和地址(”Erica”&’Beijing’),則我們應生成類似:
Select * from t_user where name like ‘%Erica%’ and address like ‘%Beijing%”的SQL查詢語句。
對於iBATIS 這樣需要預先指定SQL 語句的ORM 實現而言,傳統的做法無非通過if-else 語句對輸入參數加以判定,然後針對用戶選擇調用不同的statement 定義。對於上面這種簡單的情況(兩種查詢條件的排列組合,共4 種情況)而言,statement 的重復定義工作已經讓人不厭其煩,而對於動辄擁有七八個查詢條件,乃至十幾個查詢條件
的排列組合而言,瑣碎反復的statement定義實在讓人不堪承受。
考慮到這個問題,iBATIS引入了動態映射機制,即在statement定義中,根據不同的
iBATIS動態映射查詢參數,設定對應的SQL語句。
還是以上面的示例為例:
select
id,
name,
sex
from t_user
(name like #name#)
(address like #address#)
通過dynamic 節點,我們定義了一個動態的WHERE 子句。此WHERE 子句中將
可能包含兩個針對name 和address 字段的判斷條件。而這兩個字段是否加入檢索取決於用戶所提供的查詢條件(字段是否為空[isNotEmpty])。
對於一個典型的Web程序而言,我們通過HttpServletRequest獲得表單中的字段名並將其設入查詢參數,如:
user.setName(request.getParameter("name"));
user.setAddress(request.getParameter("address"));
sqlMap.queryForList("User.getUsers", user);
在執行queryForList("User.getUsers", user)時,ibatis 即根據配置文
件中設定的SQL動態生成規則,創建相應的SQL語句。
上面的示例中,我們通過判定節點isNotEmpty,指定了關於name 和address 屬
性的動態規則:
(name like #name#)
這個節點對應的語義是,如果參數類的"name"屬性非空(isNotEmpty,即非空
字符串””),則在生成的SQL Where字句中包括判定條件(name like #name#),其
中#name#將以參數類的name屬性值填充。
Address屬性的判定生成與name屬性完全相同,這裡就不再贅述。
這樣,我們通過在statement 定義中引入dynamic 節點,很簡單的實現了SQL 判定子句的動態生成,對於復雜的組合查詢而言,這將帶來極大的便利。判定節點的定義可以非常靈活,我們甚至可以使用嵌套的判定節點來實現復雜的動態映射,如:
( name=#name#address=#address#)
這段定義規定,只有用戶提供了姓名信息時,才能結合地址數據進行查詢(如果只提供地址數據,而將姓名信息忽略,將依然被視為全檢索)。Dynamic節點和判定節點中的prepend屬性,指明了本節點中定義的SQL子句在
主體SQL中出現時的前綴。如:
(name like #name#)
(address like #address#)
假設"name"屬性的值為“Erica”, "address"屬性的值為“Beijing”,則會生成類似下面的SQL子句(實際運行期將生成帶占位符的PreparedStatement,之後再為其填充數據):
WHERE (name like ‘Beijing’) AND (address like ‘Beijing’)
其中WHERE 之後的語句是在dynamic 節點中所定義,因此以dynamic 節點的prepend設置("WHERE")作為前綴,而其中的”AND”,實際上是address屬性所對應的isNotEmpty節點的prepend設定,它引領了對應節點中定義的SQL子句。至於name屬性對應的isNotEmpty節點,由於iBATIS會自動判定是否需要追加prepend前綴,這裡(name like #name#)是WHERE 子句中的第一個條件子句,無需AND 前綴,所以自動省略。
判定節點並非僅限於isNotEmpty,iBATIS中提供了豐富的判定定義功能。判定節點分兩類:
Ø 一元判定
一元判定是針對屬性值本身的判定,如屬性是否為NULL,是否為空值等。
上面示例中isNotEmpty就是典型的一元判定。
一元判定節點有:
節點名 描述
參數類中是否提供了此屬性
與相反
屬性值是否為NULL
與相反
如果屬性為Collection或者String,其size是否 與相反。
Ø 二元判定
二元判定有兩個判定參數,一是屬性名,而是判定值,如
(age=#age#)
其中,property="age"指定了屬性名”age”,compareValue=”18”指明了判定值為”18”。上面判定節點isGreaterThan 對應的語義是:如果age 屬性大於18(compareValue),則在SQL中加入(age=#age#)條件。
二元判定節點有:
節點名 屬性值與compareValues的關系
相等。
不等。
大於。
大於等於。
小於。
小於等於。
iBATIS動態映射的情況我們就介紹到這裡,希望這篇關於iBATIS動態映射的文檔對你認識iBATIS動態映射有幫助。