动态SQL

动态 SQL，主要用于解决查询条件不确定的情况：在程序运行期间，根据用户提交的查询条件进行查询。提交的查询条件不同，执行的 SQL 语句不同。若将每种可能的情况均逐一列出，对所有条件进行排列组合，将会出现大量的 SQL 语句。此时，可使用动态 SQL 来解决这样的问题。

动态 SQL，即通过 MyBatis 提供的各种标签对条件作出判断以实现动态拼接 SQL 语句。这里的条件判断使用的表达式为 OGNL 表达式。 常用的动态 SQL 标签有<if/>、 <where/>、<choose/>、<foreach/>等。

MyBatis 的动态 SQL 语句，与 JSTL 中的语句非常相似。

项目实例

（1） 定义数据库表

（2） 定义实体

public class Student {private Integer id;private String name;private int age;private double score;}

（3） 创建工具类

public class MyBatisUtils {private static SqlSessionFactory sqlSessionFactory;public static SqlSession getSqlSession() {try {InputStream is = Resources.getResourceAsStream("mybatis.xml");if (sqlSessionFactory == null) {sqlSessionFactory = new SqlSessionFactoryBuilder().build(is);}return sqlSessionFactory.openSession();} catch (IOException e) {e.printStackTrace();}return null;}
}

（4）定义测试类

定义 @Before 与 @After 方法

public class MyTest {private IStudentDao dao;private SqlSession sqlSession;@Beforepublic void setUp() {sqlSession = MyBatisUtils.getSqlSession();dao = sqlSession.getMapper(IStudentDao.class);}@Afterpublic void tearDown() {if (sqlSession != null) {sqlSession.close();}}}

注意：
在 mapper 的动态 SQL 中若出现大于号（>）、小于号（<）、大于等于号（>=），小于等于号（<=）等符号，最好将其转换为实体符号。否则， XML 可能会出现解析出错问题。特别是对于小于号（<），在 XML 中是绝对不能出现的。否则，一定出错。

<if/>标签

对于该标签的执行，当 test 的值为 true 时，会将其包含的 SQL 片断拼接到其所在的 SQL语句中。这引发的问题是，查询条件不确定，查询条件依赖于用户提交的内容。此时，就可使用动态 SQL 语句，根据用户提交内容对将要执行的 SQL 进行拼接。

（1）定义 Dao 接口

public interface IStudentDao {List<Student> selectStudentsByIf(Student student);}

（2）定义映射文件

为了解决两个条件均未做设定的情况，在 where 后添加了一个“1=1”的条件。这样就不至于两个条件均未设定而出现只剩下一个 where，而没有任何可拼接的条件的不完整 SQL 语句。

    <!-- if标签 --><select id="selectStudentsByIf" resultType="Student">select id,name,age,score from student where 1 = 1<if test="name != null and name != ''">and name like '%' #{name} '%'</if><if test="age > 0">and age > #{age}</if></select>

（3）修改测试类

	@Testpublic void test01() {Student stu = new Student("张", 18, 0);
//		Student stu = new Student("", 23, 0);
//		Student stu = new Student("", 0, 0);List<Student> students = dao.selectStudentsByIf(stu);for (Student student : students) {System.out.println(student);}}

（4）运行结果

<where/>标签

<if/>标签的中存在一个比较麻烦的地方：需要在 where 后手工添加 1=1 的子句。因为，
若 where 后的所有<if/>条件均为 false，而 where 后若又没有 1=1 子句，则 SQL 中就会只剩下一个空的 where， SQL 出错。所以，在 where 后，需要添加永为真子句 1=1，以防止这种情况的发生。但当数据量很大时，会严重影响查询效率。

（1）修改 Dao 接口

	List<Student> selectStudentsByWhere(Student student);

（2）定义映射文件

	<!-- where标签 --><select id="selectStudentsByWhere" resultType="Student">select id,name,age,score from student <where><if test="name != null and name != ''">and name like '%' #{name} '%'</if><if test="age > 0">and age > #{age}</if></where></select>

（3）修改测试类

	@Testpublic void test02() {Student stu = new Student("张", 18, 0);
//		 Student stu = new Student("", 23, 0);
//		 Student stu = new Student("", 0, 0);List<Student> students = dao.selectStudentsByWhere(stu);for (Student student : students) {System.out.println(student);}}

（4）运行结果

<choose/>标签

该标签中只可以包含<when/><otherwise/>，可以包含多个与一个<otherwise/>。它们联合使用，完成 Java 中的开关语句 switch…case 功能。

（1）修改 Dao 接口

	List<Student> selectStudentsByChoose(Student student);

（2）定义映射文件

	<!-- choose标签 --><select id="selectStudentsByChoose" resultType="Student">select id,name,age,score from student <where><choose><when test="name != null and name !=''">and name like '%' #{name} '%'</when><when test="age > 0">and age > #{age}</when><otherwise>1 = 2</otherwise></choose></where></select>

（3）修改测试类

	@Testpublic void test03() {
//		Student stu = new Student("张", 18, 0);Student stu = new Student("", 23, 0);
//		Student stu = new Student("", 0, 0);List<Student> students = dao.selectStudentsByChoose(stu);for (Student student : students) {System.out.println(student);}}

<foreach/>标签

<foreach/>标签用于实现对于数组与集合的遍历。对其使用，需要注意：

• collection 表示要遍历的集合类型，这里是数组，即 array。
• open、 close、 separator 为对遍历内容的 SQL 拼接。

（1）修改 Dao 接口

	List<Student> selectStudentsByForeach(int[] ids);List<Student> selectStudentsByForeach2(List<Integer> ids);List<Student> selectStudentsByForeach3(List<Student> ids);

（2）定义映射文件

	<!-- foreach标签 ，遍历数组--><select id="selectStudentsByForeach" resultType="Student"><!-- select id,name,age,score from student where id in (1,3,5) -->select id,name,age,score from student <if test="array.length > 0">where id in <foreach collection="array" item="myid" open="(" close=")" separator=",">#{myid}</foreach></if></select><!-- foreach标签 ，遍历泛型为基本类型的 List--><select id="selectStudentsByForeach2" resultType="Student"><!-- select id,name,age,score from student where id in (1,3,5) -->select id,name,age,score from student <if test="list.size > 0">where id in <foreach collection="list" item="myid" open="(" close=")" separator=",">#{myid}</foreach></if></select><!-- foreach标签遍历泛型为自定义类型的 List --><select id="selectStudentsByForeach3" resultType="Student"><!-- select id,name,age,score from student where id in (1,3,5) -->select id,name,age,score from student <if test="list.size > 0">where id in <foreach collection="list" item="stu" open="(" close=")" separator=",">#{stu.id}</foreach></if></select>

（3）修改测试类

	@Testpublic void test04() {int[] ids = {1, 3, 4};List<Student> students = dao.selectStudentsByForeach(ids);for (Student student : students) {System.out.println(student);}}@Testpublic void test05() {List<Integer> ids = new ArrayList<>();ids.add(1);ids.add(3);List<Student> students = dao.selectStudentsByForeach2(ids);for (Student student : students) {System.out.println(student);}}@Testpublic void test06() {Student stu1 = new Student();stu1.setId(1);Student stu2 = new Student();stu2.setId(3);List<Student> stus = new ArrayList<>();stus.add(stu1);stus.add(stu2);List<Student> students = dao.selectStudentsByForeach3(stus);for (Student student : students) {System.out.println(student);}}

<sql/>标签

<sql/>标签用于定义 SQL 片断，以便其它 SQL 标签复用。而其它标签使用该 SQL 片断，
需要使用<include/>子标签。 该<sql/>标签可以定义 SQL 语句中的任何部分，所以<include/>子标签可以放在动态 SQL 的任何位置。

（1）修改 Dao 接口

	List<Student> selectStudentsBySqlFragment(List<Student> ids);

（2）定义映射文件

	<!-- sql标签 --><select id="selectStudentsBySqlFragment" resultType="Student"><!-- select id,name,age,score from student where id in (1,3,5) -->select <include refid="selectColumns"/>from student <if test="list.size > 0">where id in <foreach collection="list" item="stu" open="(" close=")" separator=",">#{stu.id}</foreach></if></select><sql id="selectColumns">id,name,age,score </sql>

（3）修改测试类

	@Testpublic void test07() {Student stu1 = new Student();stu1.setId(1);Student stu2 = new Student();stu2.setId(3);List<Student> stus = new ArrayList<>();stus.add(stu1);stus.add(stu2);List<Student> students = dao.selectStudentsBySqlFragment(stus);for (Student student : students) {System.out.println(student);}}

（4）运行结果