mybaties基础教程之四：SQL语句映射文件(1)-蒲公英云

MyBatis真正的力量是在映射语句当中。这里是奇迹发生的地方。SQL映射的XML文件十分简单，但你将它们和对等功能的JDBC代码相比较，发现映射文件节省了大约95% 的代码量。MyBtis的构建就聚集于SQL的，使其远离普通的方式。

MyBatis SQL语句映射标签分类：

Center

4.1 select

一个select 元素非常简单。例如：

<!-- 查询学生，根据id -->
<select id="getStudent" parameterType="String" resultMap="studentResultMap">
    SELECT ST.STUDENT_ID,
               ST.STUDENT_NAME,
               ST.STUDENT_SEX,
               ST.STUDENT_BIRTHDAY,
               ST.CLASS_ID
          FROM STUDENT_TBL ST
         WHERE ST.STUDENT_ID = #{studentID}
</select>

这条语句就叫做‘getStudent，有一个String参数，并返回一个StudentEntity类型的对象。
注意参数的标识是：#{studentID}。

select 语句属性配置细节：

属性	描述	取值	默认
id	在这个模式下唯一的标识符，可被其它语句引用
parameterType	传给此语句的参数的完整类名或别名
resultType	语句返回值类型的整类名或别名。注意，如果是集合，那么这里填写的是集合的项的整类名或别名，而不是集合本身的类名。（resultType 与resultMap 不能并用）
resultMap	引用的外部resultMap 名。结果集映射是MyBatis 中最强大的特性。许多复杂的映射都可以轻松解决。（resultType 与resultMap 不能并用）
flushCache	如果设为true，则会在每次语句调用的时候就会清空缓存。select 语句默认设为false	true\|false	false
useCache	如果设为true，则语句的结果集将被缓存。select 语句默认设为false true\|false false timeout 设置驱动器在抛出异常前等待回应的最长时间，默认为不设值，由驱动器自己决定	true\|false	false
timeout	设置驱动器在抛出异常前等待回应的最长时间，默认为不设值，由驱动器自己决定	正整数	未设置
fetchSize	设置一个值后，驱动器会在结果集数目达到此数值后，激发返回，默认为不设值，由驱动器自己决定	正整数	驱动器决定
statementType	statement，preparedstatement，callablestatement。预准备语句、可调用语句	STATEMENT PREPARED CALLABLE	PREPARED
resultSetType	forward_only，scroll_sensitive，scroll_insensitive 只转发，滚动敏感，不区分大小写的滚动	FORWARD_ONLY SCROLL_SENSITIVE SCROLL_INSENSITIVE	驱动器决定

4.2 insert

一个简单的insert语句：

<!-- 插入学生 -->
<insert id="insertStudent" parameterType="StudentEntity">
        INSERT INTO STUDENT_TBL (STUDENT_ID,
                                           STUDENT_NAME,
                                           STUDENT_SEX,
                                           STUDENT_BIRTHDAY,
                                           CLASS_ID)
              VALUES   (#{studentID},
                          #{studentName},
                          #{studentSex},
                          #{studentBirthday},
                          #{classEntity.classID})
</insert>

insert可以使用数据库支持的自动生成主键策略，设置useGeneratedKeys=”true”，然后把keyProperty 设成对应的列，就搞定了。比如说上面的StudentEntity 使用auto-generated 为id 列生成主键.
还可以使用selectKey元素。下面例子，使用mysql数据库nextval(‘student’)为自定义函数，用来生成一个key。

<!-- 插入学生 自动主键-->
<insert id="insertStudentAutoKey" parameterType="StudentEntity">
    <selectKey keyProperty="studentID" resultType="String" order="BEFORE">
            select nextval('student')
    </selectKey>
        INSERT INTO STUDENT_TBL (STUDENT_ID,
                                  STUDENT_NAME,
                                  STUDENT_SEX,
                                  STUDENT_BIRTHDAY,
                                  CLASS_ID)
              VALUES   (#{studentID},
                        #{studentName},
                        #{studentSex},
                        #{studentBirthday},
                        #{classEntity.classID})    
</insert>

insert语句属性配置细节：

属性	描述	取值	默认
id	在这个模式下唯一的标识符，可被其它语句引用
parameterType	传给此语句的参数的完整类名或别名
flushCache	如果设为true，则会在每次语句调用的时候就会清空缓存。select 语句默认设为false	true\|false	false
useCache	如果设为true，则语句的结果集将被缓存。select 语句默认设为false true\|false false timeout 设置驱动器在抛出异常前等待回应的最长时间，默认为不设值，由驱动器自己决定	true\|false	false
timeout	设置驱动器在抛出异常前等待回应的最长时间，默认为不设值，由驱动器自己决定	正整数	未设置
fetchSize	设置一个值后，驱动器会在结果集数目达到此数值后，激发返回，默认为不设值，由驱动器自己决定	正整数	驱动器决定
statementType	statement，preparedstatement，callablestatement。预准备语句、可调用语句	STATEMENT PREPARED CALLABLE	PREPARED
useGeneratedKeys	告诉MyBatis 使用JDBC 的getGeneratedKeys 方法来获取数据库自己生成的主键（MySQL、SQLSERVER 等关系型数据库会有自动生成的字段）。默认：false	true\|false	false
keyProperty	标识一个将要被MyBatis 设置进getGeneratedKeys 的key 所返回的值，或者为insert 语句使用一个selectKey 子元素。

selectKey语句属性配置细节：

属性	描述	取值
keyProperty	selectKey 语句生成结果需要设置的属性。
resultType	生成结果类型，MyBatis 允许使用基本的数据类型，包括String 、int类型。
order	可以设成BEFORE 或者AFTER，如果设为BEFORE，那它会先选择主键，然后设置keyProperty，再执行insert语句；如果设为AFTER，它就先运行insert 语句再运行selectKey 语句，通常是insert 语句中内部调用数据库（像Oracle）内嵌的序列机制。	BEFORE AFTER
statementType	像上面的那样， MyBatis 支持STATEMENT，PREPARED和CALLABLE 的语句形式，对应Statement ，PreparedStatement 和CallableStatement 响应	STATEMENT PREPARED CALLABLE

4.3 update、delete

一个简单的update：

<!-- 更新学生信息 -->
<update id="updateStudent" parameterType="StudentEntity">
        UPDATE STUDENT_TBL
               SET STUDENT_TBL.STUDENT_NAME = #{studentName}, 
                   STUDENT_TBL.STUDENT_SEX = #{studentSex},
                   STUDENT_TBL.STUDENT_BIRTHDAY = #{studentBirthday},
                   STUDENT_TBL.CLASS_ID = #{classEntity.classID}
         WHERE STUDENT_TBL.STUDENT_ID = #{studentID};    
</update>

一个简单的delete：

<!-- 删除学生 -->
<delete id="deleteStudent" parameterType="StudentEntity">
        DELETE FROM STUDENT_TBL WHERE STUDENT_ID = #{studentID}
</delete>

update、delete语句属性配置细节：

属性	描述	取值	默认
id	在这个模式下唯一的标识符，可被其它语句引用
parameterType	传给此语句的参数的完整类名或别名
flushCache	如果设为true，则会在每次语句调用的时候就会清空缓存。select 语句默认设为false	true\|false	false
useCache	如果设为true，则语句的结果集将被缓存。select 语句默认设为false true\|false false timeout 设置驱动器在抛出异常前等待回应的最长时间，默认为不设值，由驱动器自己决定	true\|false	false
timeout	设置驱动器在抛出异常前等待回应的最长时间，默认为不设值，由驱动器自己决定	正整数	未设置
fetchSize	设置一个值后，驱动器会在结果集数目达到此数值后，激发返回，默认为不设值，由驱动器自己决定	正整数	驱动器决定
statementType	statement，preparedstatement，callablestatement。预准备语句、可调用语句	STATEMENT PREPARED CALLABLE	PREPARED

4.4 sql

Sql元素用来定义一个可以复用的SQL 语句段，供其它语句调用。比如：

<!-- 复用sql语句  查询student表所有字段 -->
<sql id="selectStudentAll">
        SELECT ST.STUDENT_ID,
                   ST.STUDENT_NAME,
                   ST.STUDENT_SEX,
                   ST.STUDENT_BIRTHDAY,
                   ST.CLASS_ID
              FROM STUDENT_TBL ST
</sql>

这样，在select的语句中就可以直接引用使用了，将上面select语句改成：

<!-- 查询学生，根据id -->
<select id="getStudent" parameterType="String" resultMap="studentResultMap">
    <include refid="selectStudentAll"/>
            WHERE ST.STUDENT_ID = #{studentID}
</select>