在学习动态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/
