前面学习了config.xml,下面就要进入MyBatis的核心SQL映射了,第一篇文章的时候,student.xml里面是这么写的:
<?xml version="1.0" encoding="UTF-8" ?> <!DOCTYPE mapper PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN" "http://mybatis.org/dtd/mybatis-3-mapper.dtd"> <mapper namespace="com.xrq.StudentMapper"> <select id="selectStudentById" parameterType="int" resultType="Student"> <![CDATA[ select * from student where studentId = #{id} ]]> </select> </mapper>
基于这个xml,进行扩展和学习。
上面的配置文件中,大家一定注意到了一个细节,就是SQL语句用<![CDATA[ ... ]]>这对标签包含起来了,那么为什么要这么做呢?不妨把上面内容稍微修改一下:
<?xml version="1.0" encoding="UTF-8" ?> <!DOCTYPE mapper PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN" "http://mybatis.org/dtd/mybatis-3-mapper.dtd"> <mapper namespace="com.xrq.StudentMapper"> <select id="selectStudentById" parameterType="int" resultType="Student"> select * from student where studentId = #{id} or studentAge < 10 or studentAge > 20; </select> </mapper>
当然这句SQL语句没有任何含义,只是瞎写的演示用而已,运行一下看一下结果:
Exception in thread "main" java.lang.ExceptionInInitializerError at com.xrq.test.MyBatisTest.main(MyBatisTest.java:9) Caused by: org.apache.ibatis.exceptions.PersistenceException: ### Error building SqlSession. ### The error may exist in student.xml ...
后面的异常信息就不列了。按理说很正常的一句SQL语句,怎么会报错呢?仔细想来,错误的根本原因 就是student.xml本身是一个xml文件,它并不是专门为MyBatis服务的,它首先具有xml文件的语法 。因此,”< 10 or studentAge >”这段,会先被解析为xml的标签,xml哪有这种形式的标签的?所以当然报错了。
所以,使用<![CDATA[ ... ]]>, 它可以保证如论如何<![CDATA[ ... ]]>里面的内容都会被解析成SQL语句 。因此,建议每一条SQL语句都使用<![CDATA[ ... ]]>包含起来,这也是一种规避错误的做法。
SQL映射中有几个顶级元素,其中最常见的四个就是insert、delete、update、select,分别对应于增、删、改、查,下面先对于select元素进行学习。
前面的select语句只有一个条件,下面看一下多条件查询如何做,首先是student.xml:
<select id="selectStudentByIdAndName" parameterType="Student" resultType="Student"> <![CDATA[ select * from student where studentId = #{studentId} and studentName = #{studentName}; ]]> </select>
注意这里的parameter只能是一个实体类,然后参数要和实体类里面定义的一样,比如studentId、studentName,MyBatis将会自动查找这些属性,然后将它们的值传递到预处理语句的参数中去。
还有一个很重要的地方是,使用参数的时候使用了”#”,另外还有一个符号”$”也可以引用参数, 使用”#”最重要的作用就是防止SQL注入 。
接着看一下Java代码的写法:
public Student selectStudentByIdAndName(int studentId, String studentName) { SqlSession ss = ssf.openSession(); Student student = null; try { student = ss.selectOne("com.xrq.StudentMapper.selectStudentByIdAndName", new Student(studentId, studentName, 0, null)); } finally { ss.close(); } return student; }
这里selectOne方法的第二个参数传入一个具体的Student进去就可以了,运行就不演示了,结果没有问题。
上面的演示查询的是一个结果,对于select来说,重要的当然是查询多个结果,查询多个结果有相应的写法,看一下:
<select id="selectAll" parameterType="int" resultType="Student" flushCache="false" useCache="true" timeout="10000" fetchSize="100" statementType="PREPARED" resultSetType="FORWARD_ONLY"> <![CDATA[ select * from student where studentId > #{id}; ]]> </select>
这里稍微玩了一些花样,select里面多放了一些属性,设置了每条语句的作用细节,分别解释下这些属性的作用:
xml写完了,看一下如何写Java程序,比较简单,使用selectList方法即可:
public List<Student> selectStudentsById(int studentId) { SqlSession ss = ssf.openSession(); List<Student> list = null; try { list = ss.selectList("com.xrq.StudentMapper.selectAll", studentId); } finally { ss.close(); } return list; }
同样,结果也就不演示了,查出来和数据库内的数据相符。
上面使用的是resultType来接收查询结果,下面来看另外一种方式—-使用resultMap,被MyBatis称为MyBatis中最重要最强大的元素。
上面使用resultType的方式是有前提的,那就是假定列名和Java Bean中的属性名存在对应关系,如果名称不对应,也没关系,可以采用类似下面的方式:
<select id="selectAll" parameterType="int" resultType="Student" flushCache="false" useCache="true" timeout="10000" fetchSize="100" statementType="PREPARED" resultSetType="FORWARD_ONLY"> <![CDATA[ select student_id as "studentId",student_name as "studentName",student_age as "studentAge", student_phone as "studentPhone" from student whehre restudentId > #{id}; ]]> </select>
毫无疑问,这样很繁琐,我们可以采用resultMap来解决列名不匹配的问题,把2由resultType的形式改成resultMap的形式,Java代码不需要动:
<resultMap type="Student" id="studentResultMap"> <id property="studentId" column="studentId" /> <result property="studentName" column="studentName" /> <result property="studentAge" column="studentAge" /> <result property="studentPhone" column="studentPhone" /> </resultMap> <select id="selectAll" parameterType="int" resultMap="studentResultMap" flushCache="false" useCache="true" timeout="10000" fetchSize="100" statementType="PREPARED" resultSetType="FORWARD_ONLY"> <![CDATA[ select * from student where studentId > #{id}; ]]> </select>
这样就可以了,注意两点:
1、resultMap定义中主键要使用id
2、resultMap和resultType不可以同时使用
对resultMap有很好的理解的话,许多复杂的映射问题就很好解决了。
select看完了,接着看一下插入的方法。首先是student.xml的配置方法,由于插入数据涉及一个主键问题,我用的是MySQL,我试了一下使用以下两种方式都可以:
<insert id="insertOneStudent" parameterType="Student"> <![CDATA[ insert into student values(null, #{studentName}, #{studentAge}, #{studentPhone}); ]]> </insert>
<insert id="insertOneStudent" parameterType="Student" useGeneratedKeys="true" keyProperty="studentId"> <![CDATA[ insert into student(studentName, studentAge, studentPhone) values(#{studentName}, #{studentAge}, #{studentPhone}); ]]> </insert>
前一种是MySQL本身的语法,主键字段在insert的时候传入null,后者是MyBatis支持的生成主键方式,useGeneratedKeys表示让数据库自动生成主键,keyProperty表示生成主键的列。
Java代码比较容易:
public void insertOneStudent(String studentName, int studentAge, String studentPhone) { SqlSession ss = ssf.openSession(); try { ss.insert("com.xrq.StudentMapper.insertOneStudent", new Student(0, studentName, studentAge, studentPhone)); ss.commit(); } catch (Exception e) { ss.rollback(); } finally { ss.close(); } }
还是一样,insert方法比如传入Student的实体类,如果insertOneStudent方法要传入的参数比较多的话,建议不要把每个属性单独作为形参,而是直接传入一个Student对象,这样也比较符合面向对象的编程思想。
然后还有一个问题,这个我回头还得再看一下。照理说设置了transactionManager的type为JDBC,对事物的处理应该和底层JDBC是一致的,JDBC默认事物是自动提交的,这里事物却得手动提交,抛异常了得手动回滚才行。
修改和删除元素比较类似,就看一下student.xml文件怎么写,Java代码就不列了,首先是修改元素:
<update id="updateStudentAgeById" parameterType="Student"> <![CDATA[ update student set studentAge = #{studentAge} where studentId = #{studentId}; ]]> </update>
接着是删除元素:
<delete id="deleteStudentById" parameterType="int"> <![CDATA[ delete from student where studentId = #{studentId}; ]]> </delete>
这里我又发现一个问题,记录一下,update的时候Java代码是这么写的:
public void updateStudentAgeById(int studentId, int studentAge) { SqlSession ss = ssf.openSession(); try { ss.update("com.xrq.StudentMapper.updateStudentAgeById", new Student(studentId, null, studentAge, null)); ss.commit(); } catch (Exception e) { ss.rollback(); } finally { ss.close(); } }
studentId和studentAge必须是这个顺序,互换位置就更新不了学生的年龄了,这个是为什么我还要后面去研究一下,也可能是写代码的问题。
SQL可以用来定义可重用的SQL代码段,可以包含在其他语句中,比如我把上面的插入换一下,先定义一个SQL:
<sql id="insertColumns"> studentName, studentAge, studentPhone </sql>
然后在修改一下insert:
<insert id="insertOneStudent" parameterType="Student" useGeneratedKeys="true" keyProperty="studentId"> insert into student(<include refid="insertColumns" />) values(#{studentName}, #{studentAge}, #{studentPhone}); </insert>
注意这里要把”<![CDATA[ ... ]]>”给去掉,否则”<”和”>”就被当成SQL里面的小于和大于了,因此使用SQL的写法有一定限制,使用前要注意一下避免出错。