iBatis第四章：动态SQL的用法

一、什么是动态SQL，以及使用动态SQL的好处
所谓动态SQL，是针对静态SQL而言的，静态SQL的SQL语句是固定的，使用动态SQL是为了增强SQL的灵活性和复用性，可以用一个动态SQL达到在不同条件下执行不同的SQL语句的效果，如果不用动态SQL，我们可能需要使用几个不同的SQL语句才能达到目的，但是使用动态SQL，只需要一个SQL就可以实现。
例如下面是一个动态SQL的例子：
select * from t_user
<dynamic prepend="where">
<isNull property="id">
id is null
</isNull>
<isNotNull>
id = #id#
</isNotNull>
</dynamic>
上面的SQL语句会根据调用这个SQL语句的入参来组装成不同的SQL语句，当id为null时，其语句如下：
select * from t_user where id is null
当id不为null时，其SQL语句如下：
select * from t_user where id = #id#
由此可见，我们通过一个动态SQL就达到了两个静态SQL的目的，分别处理了两种不同的情况，这就是动态SQL的好处。

注意：在数据库中，查询值为null的情况不能用=来处理，例如select * from t_user where id is null和select * from t_user where id = ''是不同的！

二、如何使用动态SQL
iBatis 为我们处理动态SQL提供了一组相应的标签，我们只需要使用者一套动态标签就可以享受动态SQL带给我们的便利之处了。下面分别讨论 iBatis 的动态标签，它分为5大类：
1、<dynamic>标签
2、二元标签
3、一元标签
4、参数标签
5、<iterate>标签
在讨论这些动态标签之前，我们先说明一下，有一些标签的属性是共享的，例如 prepend、open、close等这几个属性。其中prepend表示添加前缀、open和close分别表示开始和结尾，后面例子详细说明。

-----------------1、<dynamic>标签
<dynamic>是动态标签的最顶层标签，也就是说它不能嵌套，它用来划分一个动态SQL片段。
其属性如下：
prepend:前缀
open:以XX开始
close:以XX结束

示例：
<select id="select_stulist" parameterClass="com.test.bean.Student" resultClass="com.test.bean.Student">
select id,name,sex from t_stu
<dynamic prepend="where">
<isNotNull property="sex">
sex = #sex#
</isNotNull>
</dynamic>
</select>

/**
* 测试动态标签 <dynamic>
*/
private void testDynamic(){
SqlMapClient sqlMapClient = BaseDAO.getInstance();
Student student = new Student();
try {
student.setSex("女");
List<Student> stuList = sqlMapClient.queryForList("select_stulist", student);
if(stuList != null && stuList.size()>0){
for(Student stu:stuList){
System.out.println(stu.getName()+" "+stu.getSex());
}
}
} catch (SQLException e) {
// TODO Auto-generated catch block
e.printStackTrace();
}
}

动态标签的好处就是可以根据我们的参数不同实现不同的 sql查询功能。

-----------------2、二元标签
二元标签的作用就是将我们的参数同另外一个值或者参数进行比较，如果结果为true，则包含二元标签内的内容，否则就不包含。
常用的二元标签如下：
<isEqual> 用于比较值是否相同
<isNotEqual> 用于比较值是否不同
<isGreaterThan> 比较值是否大于
<isGreaterEqual> 比较值是否大于等于
<isLessThan> 比较值是否小于
<isLessEqual> 比较值是否小于等于

二元标签的常用属性：
property：指定需要比较的属性
compareProperty:指定需要与property比较的属性
compareValue:指定一个静态值，用于同property的属性值比较【注意compareProperty和compareValue必须指定其中一个】

prepend：前缀作用
open:以XX开始
close:以XX结束

示例：
<typeAlias alias="student" type="com.test.bean.Student"></typeAlias>
<!-- 测试 二元 标签 ：如果入参性别为男 则查询编号大于给定值的学生信息-->
<select id="select_stulist1" parameterClass="student" resultClass="student">
select id,name,sex from t_stu
<dynamic prepend="where">
<isEqual property="sex" compareValue="男">
id > #id#
</isEqual>
</dynamic>
</select>

private void testBinaryTag(){
SqlMapClient sqlMapClient = BaseDAO.getInstance();
Student student = new Student();
try {
student.setId(2);
student.setSex("男");

List<Student> stuList = sqlMapClient.queryForList("select_stulist1", student);
if(stuList != null && stuList.size()>0){
for(Student stu:stuList){
System.out.println(stu.getId()+"______"+stu.getName()+" "+stu.getSex());
}
}
} catch (SQLException e) {
// TODO Auto-generated catch block
e.printStackTrace();
}
}
二元标签可以用我们的入参与给定值进行比较。满足根据是否满足一定条件来生成不同的SQL。

-----------------3、一元标签
一元标签用于参考入参的某个属性是否满足一定条件，如果满足，则包含标签内的内容，否则忽略标签体得内容。
常用一元标签：
<isNull> 确定所指定的字段是否为null
<isNotNull> 确定所指定的字段是否不为null
<isEmpty> 确定所指定的字段是否为null、或者" "、以及是否为空的集合
<isNotEmpty> 确定所指定的字段是否不为null、或者不为" "、以及是否不为空的集合
<isPropertyAvailable> 是否存在所指定的字段，对于Bean它寻找属性，对于集合它寻找键值
<isNotPropertyAvailable> 与上面相反

一元标签常用属性：
property：指定需要比较的属性
prepend：前缀作用
open:以XX开始
close:以XX结束

示例：
<typeAlias alias="student" type="com.test.bean.Student"></typeAlias>

<!-- 测试 一元 标签 -->
<select id="select_stulist2" parameterClass="student" resultClass="student">
select id,name,sex from t_stu
<dynamic prepend="where">
<isNotNull property="sex">
sex = #sex#
</isNotNull>
</dynamic>
</select>

private void testUnaryTag(){
SqlMapClient sqlMapClient = BaseDAO.getInstance();
Student student = new Student();
try {

//如果性别不为null,则查询指定性别的数据
student.setSex("女");

List<Student> stuList = sqlMapClient.queryForList("select_stulist2", student);
if(stuList != null && stuList.size()>0){
for(Student stu:stuList){
System.out.println(stu.getId()+"______"+stu.getName()+" "+stu.getSex());
}
}
} catch (SQLException e) {
// TODO Auto-generated catch block
e.printStackTrace();
}
}

-----------------4、参数标签
参数标签用于检查某个参数是否传递进来了，主要有下面两个标签：
<isParameterPresent>和<isNotParameterPresent> ，这个不常用，了解即可。以后用到在做详细学习。

-----------------5、<iterate>标签
<iterate>允许一个集合或者数组作为一个属性传递到映射语句，我们通过遍历这个集合或者数组，得到一个具体的SQL。它仅有<iterate>这个个标签，主要有如下几个属性：
property：指定需要比较的属性
prepend：前缀作用
open:以XX开始
close:以XX结束
<conjunction>: 用于连接集合或者数组产生的SQL的字符或者符号。

示例：
<typeAlias alias="student" type="com.test.bean.Student"></typeAlias>
<!-- 测试 iterate标签 -->
<select id="select_stulist3" parameterClass="student" resultClass="student">
select id,name,sex from t_stu
<dynamic prepend="where name in">
<iterate property="names" open="(" close=")" conjunction=",">
#names[]#
</iterate>
</dynamic>
</select>

private void testIterateTag(){
SqlMapClient sqlMapClient = BaseDAO.getInstance();
Student student = new Student();
try {

List<String> names = new ArrayList<String>();
names.add("修改后的姓名");
names.add("新增学生测试");

student.setNames(names);

List<Student> stuList = sqlMapClient.queryForList("select_stulist3", student);
if(stuList != null && stuList.size()>0){
for(Student stu:stuList){
System.out.println(stu.getId()+"______"+stu.getName()+" "+stu.getSex());
}
}
} catch (SQLException e) {
// TODO Auto-generated catch block
e.printStackTrace();
}
}