IBATIS动态标签

    IBATIS的优势体现在他的sql语句上,动态sql生成是Ibatis的一大特色.介绍IBATIS的动态标签.

         动态标签的作用是动态构建SQL语句，根据不同的一元或二元运算条件构建复杂的SQL语句，这功能非常好，这样就可以把写的BO层的SQL语句构造移值到SQL MAP 文件里。

         这里例举一些例子：

[sql]  view plain  copy

1. < select  id ="dynamicGetAccountList"  cacheModel ="account-cache"  resultMap ="account-result"   >    
2.       select * from ACCOUNT   
3.     < isGreaterThan  prepend ="and"  property ="id"  compareValue ="0" >   
4.            where ACC_ID = #id#   
5.     </ isGreaterThan >    
6.        order by ACC_LAST_NAME   
7. </ select >  

         上面语句中可以根据参数id的不同值能构造出两条SQL查询语句，符合动态标签判断条件的则执行条件里的内容个,否则不进行拼接.    

          下面是一个比较复杂的例子：

[sql]  view plain  copy

1. <statement id="dynamicGetAccountList" resultMap="account-result" >   
2.       select * from ACCOUNT   
3.      <dynamic prepend="WHERE">  
4.               <isNotNull prepend="AND" property="firstName">   
5.                     (ACC_FIRST_NAME = #firstName#   
6.               <isNotNull prepend="OR" property="lastName">   
7.                         ACC_LAST_NAME = #lastName#     
8.               </isNotNull>   
9.                   )   
10.            </isNotNull>  
11.             <isNotNull prepend="AND" property="emailAddress">   
12.                     ACC_EMAIL like #emailAddress#   
13.              </isNotNull>  
14.              <isGreaterThan prepend="AND" property="id" compareValue="0">   
15.                      ACC_ID = #id#   
16.              </isGreaterThan>  
17.      </dynamic>  
18.      order by ACC_LAST_NAME  
19. </statement>  

        上面的例子中，<dynamic>元素划分出SQL语句的动态部分。动态部分可以包含任意多的条件标签元素，条件标签决定是否在语句中包含其中的SQL代码。所有的条件标签元素将根据传给动态查询Statement的参数对象的情况来工作。<dynamic>元素和条件元素都有“prepend”属性，它是动态SQL代码的一部分，在必要情况下，可以被父元素的“prepend”属性覆盖。上面的例子中，prepend属性“where”将覆盖第一个为“真”的条件元素。这对于确保生成正确的SQL语句是有必要的。例如，在第一个为“真”的条件元素中，“AND”是不需要的，事实上，加上它肯定会出错。以下小节讨论不同的条件元素，包括二元条件元素，一元条件元素和其他动态元素。

二元条件元素 

         二元条件元素将一个属性值和一个静态值或另一个属性值比较，如果条件为“真”，元素体的内容将被包括在查询SQL语句中。

         二元条件元素的属性： 

         prepend － 可被覆盖的SQL语句组成部分，添加在语句的前面（可选）property － 被比较的属性（必选）
         compareProperty － 另一个用于和前者比较的属性（必选或选择compareValue）
         compareValue － 用于比较的值（必选或选择compareProperty）

二元条件元系的属性

<isEqual>	比较属性值和静态值或另一个属性值是否相等。
<isNotEqual>	比较属性值和静态值或另一个属性值是否不相等。
<isGreaterThan>	比较属性值是否大于静态值或另一个属性值。
<isGreaterEqual>	比较属性值是否大于等于静态值或另一个属性值。
<isLessThan>	比较属性值是否小于静态值或另一个属性值。
<isLessEqual>	比较属性值是否小于等于静态值或另一个属性值。 例子： <isLessEqual prepend=”AND” property=”age” compareValue=”18”> ADOLESCENT = ‘TRUE’ </isLessEqual>

一元条件元素
          一元条件元素检查属性的状态是否符合特定的条件。
          一元条件元素的属性：
          prepend － 可被覆盖的SQL语句组成部分，添加在语句的前面（可选）
          property － 被比较的属性（必选）

<isPropertyAvailable>	检查是否存在该属性（存在parameter bean的属性）。
<isNotPropertyAvailable>	检查是否不存在该属性（不存在parameter bean的属性）。
<isNull>	检查属性是否为null。
<isNotNull>	检查属性是否不为null。
<isEmpty>	检查Collection.size()的值，属性的String或String.valueOf()值,是否为null或空（“”或size() < 1）。
<isNotEmpty>	检查Collection.size()的值，属性的String或String.valueOf()值,是否不为null或不为空（“”或size() > 0）。 例子：  <isNotEmpty prepend=”AND” property=”firstName” > FIRST_NAME=#firstName# </isNotEmpty>

还有两个其它的条件元素，<isParameterPresent>，<iterate>就不说了，用到的时候可以再查。

        简单的动态SQL元素

        虽然动态Mapped Statement API功能强大，但有时仅需要一小部分的动态SQL即可。为此，SQL statement和statement都可以包含简单的动态SQL元素，以帮助实现动态的order by子句，动态的查询字段或SQL语句的其他动态部分。简单动态SQL元素的概念有点象inline parameter的映射，但使用了稍微不同的语法。

         考虑下面的例子：

 

[sql]  view plain  copy

1. <statement id=”getProduct” resultMap=”get-product-result”>  
2.        select * from PRODUCT order by $preferredOrder$   
3. </statement>  

         简单动态元素可以包含在<dynamic-mapped-statement>中，当要修改SQL语句本身时它能派上用场。例如：

[sql]  view plain  copy

1. <statement id=”getProduct” resultMap=”get-product-result”>   
2.      SELECT * FROM PRODUCT   
3.      <dynamic prepend=”WHERE”>  
4.         <isNotEmpty property=”description”>     
5.             PRD_DESCRIPTION $operator$ #description# </isNotEmpty>   
6.      </dynamic>   
7. </statement>  

             了解和熟练使用Ibatis的动态标签,才能发挥出ibatis的强大优势,能节省和复用很多sql语句.