IBATIS动态标签

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

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

         这里例举一些例子：

< select  id ="dynamicGetAccountList"  cacheModel ="account-cache"  resultMap ="account-result"   >  
      select * from ACCOUNT 
    < isGreaterThan  prepend ="and"  property ="id"  compareValue ="0" > 
           where ACC_ID = #id# 
    </ isGreaterThan >  
       order by ACC_LAST_NAME 
</ select >

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

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

<statement id="dynamicGetAccountList" resultMap="account-result" > 
      select * from ACCOUNT 
     <dynamic prepend="WHERE">
              <isNotNull prepend="AND" property="firstName"> 
                    (ACC_FIRST_NAME = #firstName# 
              <isNotNull prepend="OR" property="lastName"> 
                        ACC_LAST_NAME = #lastName#   
              </isNotNull> 
                  ) 
           </isNotNull>
            <isNotNull prepend="AND" property="emailAddress"> 
                    ACC_EMAIL like #emailAddress# 
             </isNotNull>
             <isGreaterThan prepend="AND" property="id" compareValue="0"> 
                     ACC_ID = #id# 
             </isGreaterThan>
     </dynamic>
     order by ACC_LAST_NAME
</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的映射，但使用了稍微不同的语法。

         考虑下面的例子：

 

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

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

<statement id=”getProduct” resultMap=”get-product-result”> 
     SELECT * FROM PRODUCT 
     <dynamic prepend=”WHERE”>
        <isNotEmpty property=”description”>   
            PRD_DESCRIPTION $operator$ #description# </isNotEmpty> 
     </dynamic> 
</statement>

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