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语句.