IBATIS动态标签



IBATIS动态标签

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


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

这里例举一些例子:

  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查询语句,符合动态标签判断条件的则执行条件里的内容个,否则不进行拼接.

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

  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的映射,但使用了稍微不同的语法。

考虑下面的例子:

 

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

 

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

  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>
  8. 了解和熟练使用Ibatis的动态标签,才能发挥出ibatis的强大优势,能节省和复用很多sql语句.