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

<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”是不需要的，事实上，加上它肯定会出错。以下小节讨论不同的条件元素，包括二元条件元素，一元条件元素和其他动态元素。

二元条件元素的属性：

prepend － 可被覆盖的SQL语句组成部分，添加在语句的前面（可选）

property － 被比较的属性（必选）

compareProperty － 另一个用于和前者比较的属性（必选或选择compareValue）

compareValue － 用于比较的值（必选或选择compareProperty）

一元条件元素的属性：
prepend － 可被覆盖的SQL语句组成部分，添加在语句的前面（可选）
property － 被比较的属性（必选）

Dynamic节点和判定节点中的prepend属性，指明了本节点中定义的SQL子句在
主体SQL中出现时的前缀。
如：

<dynamic prepend="WHERE">
<isNotEmpty prepend="AND" property="name">
(name like #name#)
</isNotEmpty>
<isNotEmpty prepend="AND" property="address">
(address like #address#)
</isNotEmpty>
</dynamic>

假设"name"属性的值为“Erica”, "address"属性的值为“Beijing”，则会
生成类似下面的SQL子句（实际运行期将生成带占位符的PreparedStatement，之
后再为其填充数据）：
WHERE (name like ‘ Erica’) AND (address like ‘Beijing’)
其中WHERE 之后的语句是在dynamic 节点中所定义，因此以dynamic 节点的
prepend设置（"WHERE"）作为前缀，而其中的”AND”，实际上是address属性所对
应的isNotEmpty节点的prepend设定，它引领了对应节点中定义的SQL子句。至于
name属性对应的isNotEmpty节点，由于ibatis会自动判定是否需要追加prepend
前缀，这里(name like #name#)是WHERE 子句中的第一个条件子句，无需AND 前
缀，所以自动省略。