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

╰+哭是因爲堅強的太久メ 2023-10-16 19:46 8阅读 0赞

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

MyBatis SQL语句映射标签分类：

![Center][]

###  4.1 select ###

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

<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 语句属性配置细节：

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

### 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语句属性配置细节：

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

selectKey语句属性配置细节：

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

### 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语句属性配置细节：

### 4.4 sql ###

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

<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语句改成：

<select id="getStudent" parameterType="String" resultMap="studentResultMap">
    	<include refid="selectStudentAll"/>
    			WHERE ST.STUDENT_ID = #{studentID}

</select>

[Center]: https://img-blog.csdn.net/20140327122938859?watermark/2/text/aHR0cDovL2Jsb2cuY3Nkbi5uZXQvemhvdXpoaXdlbmdhbmc=/font/5a6L5L2T/fontsize/400/fill/I0JBQkFCMA==/dissolve/70/gravity/Center