mybaties基础教程之四：SQL语句映射文件(1)

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

    MyBatis SQL语句映射标签分类：

 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 语句默认设为falsetrue|falsefalseuseCache如果设为true，则语句的结果集将被缓存。select 语句默认设为false true|false false
timeout 设置驱动器在抛出异常前等待回应的最长时间，默认为不设值，由驱动器自己决定true|falsefalsetimeout 设置驱动器在抛出异常前等待回应的最长时间，默认为不设值，由驱动器自己决定正整数未设置fetchSize设置一个值后，驱动器会在结果集数目达到此数值后，激发返回，默认为不设值，由驱动器自己决定正整数驱动器决定statementTypestatement，preparedstatement，callablestatement。
预准备语句、可调用语句STATEMENT
PREPARED
CALLABLEPREPAREDresultSetTypeforward_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 语句默认设为falsetrue|falsefalseuseCache如果设为true，则语句的结果集将被缓存。select 语句默认设为false true|false false
timeout 设置驱动器在抛出异常前等待回应的最长时间，默认为不设值，由驱动器自己决定true|falsefalsetimeout 设置驱动器在抛出异常前等待回应的最长时间，默认为不设值，由驱动器自己决定正整数未设置fetchSize设置一个值后，驱动器会在结果集数目达到此数值后，激发返回，默认为不设值，由驱动器自己决定正整数驱动器决定statementTypestatement，preparedstatement，callablestatement。
预准备语句、可调用语句STATEMENT
PREPARED
CALLABLEPREPAREDuseGeneratedKeys

告诉MyBatis 使用JDBC 的getGeneratedKeys 方法来获取数据库自己生成的主键（MySQL、SQLSERVER 等

关系型数据库会有自动生成的字段）。默认：false

true|falsefalsekeyProperty

标识一个将要被MyBatis 设置进getGeneratedKeys 的key 所返回的值，或者为insert 语句使用一个selectKey

子元素。

  

 

 

selectKey语句属性配置细节：

 

属性描述取值keyPropertyselectKey 语句生成结果需要设置的属性。 resultType生成结果类型，MyBatis 允许使用基本的数据类型，包括String 、int类型。 order可以设成BEFORE 或者AFTER，如果设为BEFORE，那它会先选择主键，然后设置keyProperty，再执行insert语句；如果设为AFTER，它就先运行insert 语句再运行selectKey 语句，通常是insert 语句中内部调用数据库（像Oracle）内嵌的序列机制。 BEFORE
AFTERstatementType像上面的那样， 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 语句默认设为falsetrue|falsefalseuseCache如果设为true，则语句的结果集将被缓存。select 语句默认设为false true|false false
timeout 设置驱动器在抛出异常前等待回应的最长时间，默认为不设值，由驱动器自己决定true|falsefalsetimeout 设置驱动器在抛出异常前等待回应的最长时间，默认为不设值，由驱动器自己决定正整数未设置fetchSize设置一个值后，驱动器会在结果集数目达到此数值后，激发返回，默认为不设值，由驱动器自己决定正整数驱动器决定statementTypestatement，preparedstatement，callablestatement。
预准备语句、可调用语句STATEMENT
PREPARED
CALLABLEPREPARED

 

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>