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 语句默认设为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>