首页 > 代码库 > IBATIS动态SQL

IBATIS动态SQL

直接使用JDBC一个非常普遍的问题就是动态SQL。使用参数值、参数本身和数据列都是动态SQL,通常是非常困难的。典型的解决办法就是用上一堆的IF-ELSE条件语句和一连串的字符串连接。对于这个问题,Ibatis提供了一套标准的相对比较清晰的方法来解决一个问题,这里有个简单的例子:

<select id="getUserList" resultMap="user">  select * from user  <dynamic prepend="where">     <isGreaterThan prepend="and" property="id" compareValue="0">       user_id = #userId#     </isGreaterThan>   </dynamic>  order by createTime desc</select>

上面的例子中,根据参数bean“id”属性的不同情况,可创建两个可能的语句。如果参数“id”大于0,将创建下面的语句:

select * from user where user_id = ?  order by createTime desc

或者,如果“id”参数小于等于0,将创建下面的语句:

select * from user  order by createTime desc

以上的这个例子是否可以看出Ibatis里提供的简单的写法来实现了复杂拖沓的动态SQL呢?我们在做查询的时候,对于同一个表,甚至可以用来定义一个动态SQL,做到重用的地步,还是上面那个例子:

<sql id="queryCondition">  <dynamic prepend="WHERE">    <isGreaterThan prepend="and" property="id" compareValue="0">      where user_id = #userId#    </isGreaterThan>
  </dynamic></sql><select id="getUserList" resultMap="user">  select * from user  <!-- 引入动态的查询条件 -->
  <include refid="queryCondition"/>
  order by createTime desc
</select>

在Ibatis中,动态的条件元素包含一下几种:二元条件元素、一元条件元素和其他条件元素:

(1)、二元条件元素:将一个属性值和静态值或另一个属性值比较,如果条件为真,元素将被包容在查询SQL语句中。

       二元条件元素的属性:

       prepend——可被覆盖的SQL语句组成部分,添加在语句的前面(可选)

       property——是比较的属性(必选)

       compareProperty——另一个用于和前者比较的属性(必选或选择compareValue)

       compareValue——用于比较的值(必选或选择compareProperty)

 <isEqual> 比较属性值和静态值或另一个属性值是否相等。
 <isNotEqual> 比较属性值和静态值或另一个属性值是否不相等。
 <isGreaterThan> 比较属性值是否大于静态值或另一个属性值。
 <isGreaterEqual> 比较属性值是否大于等于静态值或另一个属性值。
 <isLessThan> 比较属性值是否小于静态值或另一个属性值。
 <isLessEqual> 比较属性值是否小于等于静态值或另一个属性值。

(2)、一元条件元素:一元条件元素检查属性的状态是否符合特定的条件。

        一元条件元素的属性:

        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>

(3)、其他元素条件

(a).Parameter Present:这些元素检查参数对象是否存在

     Parameter Present条件的属性

     prepend - 可被覆盖的SQL语句组成部分,添加在语句的前面(可选)

 <isParameterPresent> 检查是否存在参数对象(不为null)
 <isNotParameterPresent> 例子:
<isNotParameterPresent prepend=”AND”>
EMPLOYEE_TYPE = ‘DEFAULT’
</isNotParameterPresent>

(b)、Iterate:这属性遍历整个集合,并为List集合中的元素重复元素体的内容。

       Iterate的属性:

       prepend - 可被覆盖的SQL语句组成部分,添加在语句的前面(可选)
       property - 类型为java.util.List的用于遍历的元素(必选)
       open - 整个遍历内容体开始的字符串,用于定义括号(可选)
       close -整个遍历内容体结束的字符串,用于定义括号(可选)
       conjunction - 每次遍历内容之间的字符串,用于定义AND或OR(可选)

 <iterate>遍历类型为java.util.List的元素。
例子:
<iterate prepend="AND"  property="userNameList"
open="(" close=")" conjunction="OR">
username=#userNameList[]#
</iterate>
注意:使用<iterate>时,在List元素名后面包括方括号[]非常重要,方括号[]将对象标记为List,以防解析器简单地将List输出成String。 

   to be continued.