二、SQL语句映射文件(2)

 2.2 select

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



Xml代码



  1. <!-- 查询学生,根据id -->
  2. <select id="getStudent" parameterType="String" resultMap="studentResultMap">
  3. <![CDATA[ 
  4.         SELECT ST.STUDENT_ID, 
  5.                ST.STUDENT_NAME, 
  6.                ST.STUDENT_SEX, 
  7.                ST.STUDENT_BIRTHDAY, 
  8.                ST.CLASS_ID 
  9.           FROM STUDENT_TBL ST 
  10.          WHERE ST.STUDENT_ID = #{studentID} 
  11.     ]]>
  12. </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

驱动器决定

 

 

 

2.3 insert

 一个简单的insert语句:



Xml代码



  1. <!-- 插入学生 -->
  2. <insert id="insertStudent" parameterType="StudentEntity">
  3. <![CDATA[ 
  4.         INSERT INTO STUDENT_TBL (STUDENT_ID, 
  5.                                           STUDENT_NAME, 
  6.                                           STUDENT_SEX, 
  7.                                           STUDENT_BIRTHDAY, 
  8.                                           CLASS_ID) 
  9.               VALUES   (#{studentID}, 
  10.                           #{studentName}, 
  11.                           #{studentSex}, 
  12.                           #{studentBirthday}, 
  13.                           #{classEntity.classID}) 
  14.     ]]>
  15. </insert>  



 

 

 

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



Xml代码



  1. <!-- 插入学生 自动主键-->
  2. <insert id="insertStudentAutoKey" parameterType="StudentEntity">
  3.     <selectKey keyProperty="studentID" resultType="String" order="BEFORE">
  4. <![CDATA[ 
  5.             select nextval('student') 
  6.         ]]>
  7.     </selectKey>  
  8. <![CDATA[ 
  9.         INSERT INTO STUDENT_TBL (STUDENT_ID, 
  10.                                  STUDENT_NAME, 
  11.                                  STUDENT_SEX, 
  12.                                  STUDENT_BIRTHDAY, 
  13.                                  CLASS_ID) 
  14.               VALUES   (#{studentID}, 
  15.                         #{studentName}, 
  16.                         #{studentSex}, 
  17.                         #{studentBirthday}, 
  18.                         #{classEntity.classID}) 
  19.     ]]>
  20. </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

 

 

 

2.4 update、delete

一个简单的update:



Xml代码



  1. <!-- 更新学生信息 -->
  2. <update id="updateStudent" parameterType="StudentEntity">
  3. <![CDATA[ 
  4.         UPDATE STUDENT_TBL 
  5.             SET STUDENT_TBL.STUDENT_NAME = #{studentName},  
  6.                 STUDENT_TBL.STUDENT_SEX = #{studentSex}, 
  7.                 STUDENT_TBL.STUDENT_BIRTHDAY = #{studentBirthday}, 
  8.                 STUDENT_TBL.CLASS_ID = #{classEntity.classID} 
  9.          WHERE STUDENT_TBL.STUDENT_ID = #{studentID};    
  10.     ]]>
  11. </update>  



 

一个简单的delete:



Xml代码



  1. <!-- 删除学生 -->
  2. <delete id="deleteStudent" parameterType="StudentEntity">
  3. <![CDATA[ 
  4.         DELETE FROM STUDENT_TBL WHERE STUDENT_ID = #{studentID} 
  5.     ]]>
  6. </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

 

 

2.5 sql

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



Xml代码



  1. <!-- 复用sql语句  查询student表所有字段 -->
  2. <sql id="selectStudentAll">
  3. <![CDATA[ 
  4.         SELECT ST.STUDENT_ID, 
  5.                    ST.STUDENT_NAME, 
  6.                    ST.STUDENT_SEX, 
  7.                    ST.STUDENT_BIRTHDAY, 
  8.                    ST.CLASS_ID 
  9.               FROM STUDENT_TBL ST 
  10.     ]]>
  11. </sql>  



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



Xml代码



  1. <!-- 查询学生,根据id -->
  2. <select id="getStudent" parameterType="String" resultMap="studentResultMap">
  3.     <include refid="selectStudentAll"/>
  4. <![CDATA[ 
  5.             WHERE ST.STUDENT_ID = #{studentID}  
  6.     ]]>
  7. </select>  



 
 

 2.6parameters

2.6.1变量参数

 上面很多地方已经用到了参数,比如查询、修改、删除的条件,插入,修改的数据等。
 基本数据类型,String,int,date。
 例如:



Xml代码



  1. <!-- 查询学生list,根据入学时间  -->
  2. <select id="getStudentListByDate"  parameterType="Date" resultMap="studentResultMap">
  3.     SELECT *   
  4. ST.CLASS_ID = CT.CLASS_ID   
  5. CT.CLASS_YEAR
  6. </select>  



 

 

 Java实体类型,通过#{}可以直接得到其属性。



Xml代码



  1. <!-- 更新学生信息 -->
  2. <update id="updateStudent" parameterType="StudentEntity">
  3.     UPDATE STUDENT_TBL   
  4. STUDENT_TBL.STUDENT_NAME
  5. STUDENT_TBL.STUDENT_SEX
  6. STUDENT_TBL.STUDENT_BIRTHDAY
  7. STUDENT_TBL.CLASS_ID
  8. STUDENT_TBL.STUDENT_ID
  9. </update>  



 
 

2.6.2字符串代入法

        默认的情况下,使用#{}语法会促使MyBatis 生成PreparedStatement 属性并且使用PreparedStatement 的参数(=?)来安全的设置值。尽量这些是快捷安全,也是经常使用的。但有时候你可能想直接未更改的字符串代入到SQL 语句中。比如说,对于ORDER BY,你可能会这样使用:ORDER BY ${columnName}但MyBatis 不会修改和规避掉这个字符串。
        注意:这样地接收和应用一个用户输入到未更改的语句中,是非常不安全的。这会让用户能植入破坏代码,所以,要么要求字段不要允许客户输入,要么你直接来检测他的合法性 。

 

 

2.7 cache缓存

        MyBatis 包含一个强在的、可配置、可定制的缓存机制。MyBatis 3 的缓存实现有了许多改进,既强劲也更容易配置。默认的情况,缓存是没有开启,除了会话缓存以外,它可以提高性能,且能解决全局依赖。开启二级缓存,你只需要在SQL 映射文件中加入简单的一行:<cache/>

这句简单的语句的作用如下:

1. 所有在映射文件里的select 语句都将被缓存。