ibatis 动态映射多条件查询-动态sql语句

动态Mapped Statement

直接使用JDBC一个非常普遍的问题是动态SQL。使用参数值、参数本身和数据列都是动态的SQL，通常非常困难。典型的解决方法是，使用一系列if-else条件语句和一连串讨厌的字符串连接。对于这个问题，SQL Map API使用和mapped statement非常相似的结构，提供了较为优雅的方法。

一个简单的例子：

 

<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>

  

上面的例子中，根据参数bean"id"属性的不同情况，可创建两个可能的语句。
如果参数"id"大于0，将创建下面的语句：
   select * from ACCOUNT where ACC_ID = ?

或者，如果“id”参数小于等于0，将创建下面的语句：
   select * from ACCOUNT

 

在更复杂的例子中，动态Mapped Statement的用处更明显。如下面比较复杂的例子：

 

<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 >

 
根据不同的条件，上面动态的语句可以产生16条不同的查询语句。使用if-else结构和字符串，会产生上百行很乱的代码。

而使用动态Statement，和在SQL的动态部位周围插入条件标签一样容易。例如：

<statement id="someName" resultMap="account-result" > 
   select * from ACCOUNT 
      <dynamic prepend="where"> 
         <isGreaterThan prepend="and" property="id" compareValue="0"> 
            ACC_ID = #id# 
         </isGreaterThan> 
         <isNotNull prepend=”and" property="lastName"> 
            ACC_LAST_NAME = #lastName# 
         </isNotNull> 
      </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>