IBatis.net动态SQL语句

在学习动态SQL语句之前，首先必须对条件查询有一定了解，先来学习如何向IBatis.Net的映射文件里传入参数。

一、条件查询

　　1、传递单个参数

　　如根据Id查询：

<select id="SelectPersonById" resultMap="Person" parameterClass="Int32" >
SELECT * FROM Person WHERE Id = #Id#　　--这样传入一个参数
</select>

　　调用的方法是：

PersonModel p = mapper.QueryForObject<PersonModel>("SelectPersonById", 3); 　　//3就是传到SQL语句中的参数

　　因此，最后生成的SQL语句为：

SELECT * FROM Person WHERE Id = 3

　　以上只最简单的方式，我连parameterClass都没。

　　2、传递多个参数

　　传递多个参数通常使用键值对，如HashTable或实体类。

　　1、键值对的方式

　　键值对的方式可以使用HashTable或Dictionary<TKey,TValue>，当为后者时映射文件中的parameterClass的值要为：System.Collections.IDictionary。

<select id="SelectPersonById" resultMap="Person" parameterClass="HashTable">
SELECT * FROM Person WHERE Id = #Id# AND Name = #Name#
</select>

　　调用方法：

Hashtable ht = new Hashtable();
ht.Add("Id",1);
ht.Add("Name","刘备");
PersonModel p = mapper.QueryForObject<PersonModel>("SelectPersonById", ht);

　　实际生成的SQL语句如下：

exec sp_executesql N'SELECT * FROM Person WHERE Id =  @param0  AND Name =  @param1',N'@param0 int,@param1 nvarchar(2)',@param0=1,@param1=N'刘备'

　　IBatis.Net还不错哦，自动缓存参数化查询的执行计划。

　　2、自定义参数类

　　自定义参数类通常是使用本实体类，当然你也可以自定义一个参数类(与SQL语句中的参数同名就可以)。

<select id="SelectPersonById" resultMap="Person" parameterClass="Ibatis.Net.Domain.PersonModel">
SELECT * FROM Person WHERE Id = #Id# AND Name = #Name#
</select>

　　调用方法:

PersonModel p = new PersonModel();
p.Id = 1;
p.Name = "刘备";
PersonModel p1 = mapper.QueryForObject<PersonModel>("SelectPersonById", p);

二、动态查询

　　动态查询的意思就是说，当满足一定的条件，才拼接某一段SQL代码。

　　还是用刚才的示例说明问题：

<select id="SelectPersonById" resultMap="Person" parameterClass="Hashtable" >
SELECT TOP 1 * FROM Person WHERE 1=1
<dynamic prepend="AND">
<isLessEqual prepend="AND" property="Id" compareValue="3">  <!--当传入的参数Id小于3时，才拼接该子句-->
Id = #Id#
</isLessEqual>
<isNotEmpty prepend="AND" property="Name">  <!--当传入的参数Name不为""或Null时，才拼接该子句-->
Name = #Name#
</isNotEmpty>
</dynamic>
</select>

　　调用的方法不变，有意思的地方在这里，假如传入的参数为：ht.Add("Id",4);

　　则生成的SQL语句为：

SELECT TOP 1 * FROM Person WHERE 1=1

　　假如传入的参数为：ht.Add("Id",2);

　　则生成的SQL语句为：

SELECT TOP 1 * FROM Person WHERE 1=1 AND Id = @param0',N'@param0 int',@param0=2

　　假如传入的参数为：ht.Add("Id",2); ht.Add("Name","诸葛亮");

　　则生成的SQL语句为：

exec sp_executesql N'SELECT TOP 1 * FROM Person WHERE 1=1 AND Id =  @param0 AND Name =  @param1',N'@param0 int,@param1 nvarchar(3)',@param0=2,@param1=N'诸葛亮'

　　动态查询就是这样，根据一定的判断条件，去判断是否应该拼接某段SQL代码。

　　更多的判断条件如下：

属性关键字	含义
<isEqual>	如果参数相等于值则查询条件有效。
<isNotEqual>	如果参数不等于值则查询条件有效。
<isGreaterThan>	如果参数大于值则查询条件有效。
<isGreaterEqual>	如果参数大于等于值则查询条件有效。
<isLessEqual>	如果参数小于值则查询条件有效。
<isPropertyAvailable>	如果参数中有此属性则查询条件有效。
<isNotPropertyAvailable>	如果参数中没有此属性则查询条件有效。
<isNull>	如果参数为NULL则查询条件有效。
<isNotNull>	如果参数不为NULL则查询条件有效。
<isEmpty>	如果参数为空则查询条件有效。
<isNotEmpty>	如果参数不为空则查询条件有效。
<isParameterPresent>	如果存在参数对象则查询条件有效。
<isNotParameterPresent>	如果不存在参数对象则查询条件有效。

　　属性说明：

perpend——可被覆盖的SQL语句组成部分，添加在语句的前面，该属性为可选。

property——是比较的属性，该属性为必选。

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

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

　　还有一个比较特别的判断条件:iterate。这个东西用于循环生成多个SQL片段。

<select id="SelectPersonWithCountryName" resultMap="Person">
SELECT Person.Id,Person.Age,Person.Name,Country.CountryName FROM Person INNER JOIN Country ON Person.CountryId = Country.Id
</select>
<select id="SelectPersonById" resultMap="Person" parameterClass="Hashtable" >
SELECT * FROM Person
<dynamic prepend="WHERE">
<isNotNull prepend="And" property="NameList">　　<!--遍历NameList参数，对于每一个生成一个Name in NameList[i]-->
Name in
<iterate property="NameList" open="(" close=")" conjunction=",">
#NameList[]#
</iterate>
</isNotNull>
</dynamic>
</select>

　　调用方法为：

List<string> ListStr = new List<string>();
ListStr.Add("刘备");
ListStr.Add("黄忠");
ListStr.Add("曹操");
Hashtable ht = new Hashtable();
ht.Add("NameList",ListStr);
IList<PersonModel> ListP = mapper.QueryForList<PersonModel>("SelectPersonById", ht);

　　生成的SQL语句为：

exec sp_executesql N'SELECT * FROM Person WHERE Name in (@param0,@param1,@param2)',N'@param0 nvarchar(2),@param1 nvarchar(2),@param2 nvarchar(2)',@param0=N'刘备',@param1=N'黄忠',@param2=N'曹操'

　　Iterate的属性：

prepend——可被覆盖的SQL语句组成部分，添加在语句的前面，该属性为可选。

property——类型为List的用于遍历的元素属性，该属性为必选。

open——整个遍历内容体开始的字符串，用于定义括号，该属性为可选。

close ——整个遍历内容体结束的字符串，用于定义括号，该属性为可选。

conjunction——每次遍历内容之间的字符串，用于定义AND或OR，该属性为可选。

　　最后附上好不容易才找到的1.62的源代码 http://mybatisnet.googlecode.com/svn/tags/cs_release_1.6.2/