ibatis中使用List作为传入参数的使用方法及 CDATA使用

ibatis中list做回参很简单，resultClass设为list中元素类型，dao层调用:

(List)getSqlMapClientTemplate().queryForList("sqlName", paraName);

并经类型转换即可，做入参还需要稍微调整下，本文主要讲list做入参碰到的几个小问题:

入参主要有两种方法一种是以list直接作为入参，另一种是将list作为map的元素之一为入参，个人觉得第一种明显优势，就一个list为入参，还用map包装一层多蛋疼。下面的介绍都以这个sql为例

 "getProjectJobIdsByProjectIds" resultClass="java.lang.Integer"  parameterClass="java.util.ArrayList">  SELECT id   FROM cic_job   WHERE last_buildid <> 'NULL'  "AND" open="(" close=")" conjunction="or">  CRID=#projectIdList[]#

以上是正确的写法，意义大家不用关注，重点放在倒数2到4行，表示以list为入参，其中projectIdList为dao层传入的参数名。主要写法就是parameterClass="java.util.ArrayList"，然后加上

"AND" open="(" close=")" conjunction="or">  
CRID=#projectIdList[]#

意思就是迭代器循环projectIdList，并用or拼接形成sql，拼接完后用()括起来，在加上前缀and。

1、iterate property的问题

网上很多写法是:

property="projectIdList" prepend="AND" open="(" close=")" conjunction="or">

即多了一个property，这个时候ibatis会从参数中寻找属性为projectIdList的对象，而list是一个对象没有属性就会报错:

Cause: com.ibatis.common.beans.ProbeException: Error getting ordinal list from JavaBean. 
Cause java.lang.StringIndexOutOfBoundsException: String index out of range: -1

异常，解决方法就是去掉property="projectIdList"

其实这种写法是相对第二种以map为参数而言的，你可以使用map传入参数设置属性为 property对应名即可。

2、< ! [ CDATA[的问题

大家注意到上面sql添加有 ! [ CDATA[，它的作用是对一些字符进行转移，具体可以参见http://renren.it/a/JAVAbiancheng/iBATIS/20111105/139874.html

但上面sql如果写成:

 <select id="getProjectJobIdsByProjectIds" resultClass="java.lang.Integer"  parameterClass="java.util.ArrayList">  <![CDATA[  SELECT id   FROM cic_job   WHERE last_buildid <> 'NULL'  <iterate prepend="AND" open="(" close=")" conjunction="or">  CRID=#projectIdList[]#  </iterate>  ]]>  
</select>

扩大转义范围会出现如下错误:

com.ibatis.common.beans.ProbeException: There is no READABLE property named 'projectIdList[]' in class 'java.util.ArrayList'

解决方法，就是缩小 CDATA的范围。原因是CDATA导致系统无法识别动态判断部分。

在使用ibatis时，经常需要配置待执行的sql语句。使用过ibatis的朋友都知道，无可避免的都会碰到一些不兼容、冲突的字符，多数人也都知道用<![CDATA[ ]]>标记避免Sql中与xml规范相冲突的字符对xml映射文件的合法性造成影响。但是，如果在ibatis中使用了动态语句的时候，还是有一些细节需要注意。下面举例说明一下：

环境：oracle、ibatis、java

错误例1：符号“<=”会对xml映射文件的合法性造成影响

<select id="find" parameterClass="java.util.Map" resultClass="java.lang.Long">  select idfrom tableA a,tableB b<dynamic prepend="WHERE"><isNotNull prepend="AND" property="startDate">a.act_time >= #startDate# and a.act_time <= #endDate#and a.id = b.id </isNotNull>    </dynamic>  </select>

错误例2：将整个sql语句用<![CDATA[ ]]>标记来避免冲突，在一般情况下都是可行的，但是由于该sql配置中有动态语句（where部分），将导致系统无法识别动态判断部分，导致整个sql语句非法。

<select id="find" parameterClass="java.util.Map" resultClass="java.lang.Long">< ![CDATA[   select idfrom tableA a,tableB b<dynamic prepend="WHERE"><isNotNull prepend="AND" property="startDate">a.act_time >= #startDate# and a.act_time <= #endDate#and a.id = b.id </isNotNull>    </dynamic>  ]]></select>

正确做法：缩小范围，只对有字符冲突部分进行合法性调整。

<select id="find" parameterClass="java.util.Map" resultClass="java.lang.Long">  select idfrom tableA a,tableB b<dynamic prepend="WHERE"><isNotNull prepend="AND" property="startDate">a.act_time >= #startDate# < ![CDATA[ and a.act_time <= #endDate#  ]]>and a.id = b.id </isNotNull>    </dynamic>  </select>