MyBatis学习总结（二）：SQL语句映射文件之增删改查、参数、缓存（下）

一、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、flase false useCache 如果设为true，则语句的结果集将被缓存。select 语句默认设为false true false falsetimeout 设置驱动器在抛出异常前等待回应的最长时间，默认为不设值，由驱动器自己决定 true、flase false timeout 设置驱动器在抛出异常前等待回应的最长时间，默认为不设值，由驱动器自己决定 正整数 未设置 fetchSize 设置一个值后，驱动器会在结果集数目达到此数值后，激发返回，默认为不设值，由驱动器自己决定 正整数 驱动器决定 statementType statement，preparedstatement，callablestatement。预准备语句、可调用语句 STATEMENT PREPARED CALLABLE PREPARED resultSetType forward_only，scroll_sensitive，scroll_insensitive只转发，滚动敏感，不区分大小写的滚动 FORWARD_ONLY SCROLL_SENSITIVE SCROLL_INSENSITIVE 驱动器决定

二、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 falsetimeout 设置驱动器在抛出异常前等待回应的最长时间，默认为不设值，由驱动器自己决定 true、false false flushCache 如果设为true，则会在每次语句调用的时候就会清空缓存。select 语句默认设为false true、flase false useCache 如果设为true，则语句的结果集将被缓存。select 语句默认设为false true false falsetimeout 设置驱动器在抛出异常前等待回应的最长时间，默认为不设值，由驱动器自己决定 true、flase false timeout 设置驱动器在抛出异常前等待回应的最长时间，默认为不设值，由驱动器自己决定 正整数 未设置 fetchSize 设置一个值后，驱动器会在结果集数目达到此数值后，激发返回，默认为不设值，由驱动器自己决定 正整数 驱动器决定 statementType statement，preparedstatement，callablestatement。预准备语句、可调用语句 STATEMENT PREPARED CALLABLE PREPARED useGeneratedKeys 告诉MyBatis 使用JDBC 的getGeneratedKeys 方法来获取数据库自己生成的主键（MySQL、SQLSERVER等关系型数据库会有自动生成的字段）。默认：false true、flase 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

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

四、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>  

五、parameters

上面很多地方已经用到了参数，比如查询、修改、删除的条件，插入，修改的数据等，MyBatis可以使用的基本数据类型和Java的复杂数据类型。
基本数据类型，String，int，date等。
但是使用基本数据类型，只能提供一个参数，所以需要使用Java实体类，或Map类型做参数类型。通过#{}可以直接得到其属性。
5.1 基本类型参数
根据入学时间，检索学生列表：

    <!-- 查询学生list，根据入学时间  -->      <select id="getStudentListByDate"  parameterType="Date" resultMap="studentResultMap">          SELECT *            FROM STUDENT_TBL ST LEFT JOIN CLASS_TBL CT ON ST.CLASS_ID = CT.CLASS_ID           WHERE CT.CLASS_YEAR = #{classYear};          </select>  

List<StudentEntity> studentList = studentMapper.getStudentListByClassYear(StringUtil.parse("2007-9-1"));  for (StudentEntity entityTemp : studentList) {      System.out.print

5.2 Java实体类型参数
根据姓名和性别，检索学生列表。使用实体类做参数：

    <!-- 查询学生list，like姓名、=性别，参数entity类型 -->      <select id="getStudentListWhereEntity" parameterType="StudentEntity" resultMap="studentResultMap">          SELECT * from STUDENT_TBL ST              WHERE ST.STUDENT_NAME LIKE CONCAT(CONCAT('%', #{studentName}),'%')                AND ST.STUDENT_SEX = #{studentSex}      </select>  

    StudentEntity entity = new StudentEntity();      entity.setStudentName("钱");      entity.setStudentSex("男");      List<StudentEntity> studentList = studentMapper.getStudentListWhereEntity(entity);      for (StudentEntity entityTemp : studentList) {          System.out.println(entityTemp.toString());      }  

5.3 Map参数
根据姓名和性别，检索学生列表。使用Map做参数：

    <!-- 查询学生list，=性别，参数map类型 -->      <select id="getStudentListWhereMap" parameterType="Map" resultMap="studentResultMap">          SELECT * from STUDENT_TBL ST           WHERE ST.STUDENT_SEX = #{sex}                AND ST.STUDENT_SEX = #{sex}      </select>  

    Map<String, String> map = new HashMap<String, String>();      map.put("sex", "女");      map.put("name", "李");      List<StudentEntity> studentList = studentMapper.getStudentListWhereMap(map);      for (StudentEntity entityTemp : studentList) {          System.out.println(entityTemp.toString());      }  

5.4 多参数的实现
如果想传入多个参数，则需要在接口的参数上添加@Param注解。给出一个实例：
接口写法：

    public List<StudentEntity> getStudentListWhereParam(@Param(value = "name")     String name, @Param(value = "sex")     String sex, @Param(value = "birthday")     Date birthdar, @Param(value = "classEntity")     ClassEntity classEntity);  

SQL写法：

    <!-- 查询学生list，like姓名、=性别、=生日、=班级，多参数方式 -->      <select id="getStudentListWhereParam" resultMap="studentResultMap">          SELECT * from STUDENT_TBL ST          <where>              <if test="name!=null and name!='' ">                  ST.STUDENT_NAME LIKE CONCAT(CONCAT('%', #{name}),'%')              </if>              <if test="sex!= null and sex!= '' ">                  AND ST.STUDENT_SEX = #{sex}              </if>              <if test="birthday!=null">                  AND ST.STUDENT_BIRTHDAY = #{birthday}              </if>              <if test="classEntity!=null and classEntity.classID !=null and classEntity.classID!='' ">                  AND ST.CLASS_ID = #{classEntity.classID}              </if>          </where>      </select>  

进行查询：

    List<StudentEntity> studentList = studentMapper.getStudentListWhereParam("", "",StringUtil.parse("1985-05-28"), classMapper.getClassByID("20000002"));      for (StudentEntity entityTemp : studentList) {          System.out.println(entityTemp.toString());      }  

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

六、cache缓存

MyBatis 包含一个强在的、可配置、可定制的缓存机制。MyBatis 3 的缓存实现有了许多改进，既强劲也更容易配置。默认的情况，缓存是没有开启，除了会话缓存以外，它可以提高性能，且能解决全局依赖。开启二级缓存，你只需要在SQL 映射文件中加入简单的一行：<cache/>
这句简单的语句的作用如下：
（1）所有在映射文件里的select 语句都将被缓存。
（2）所有在映射文件里insert,update 和delete 语句会清空缓存。
（3）缓存使用“最近很少使用”算法来回收
（4）缓存不会被设定的时间所清空。
（5）每个缓存可以存储1024 个列表或对象的引用（不管查询出来的结果是什么）。
（6）缓存将作为“读/写”缓存，意味着获取的对象不是共享的且对调用者是安全的。不会有其它的调用
（7）者或线程潜在修改。
例如，创建一个FIFO 缓存让60 秒就清空一次，存储512 个对象结果或列表引用，并且返回的结果是只读。因为在不用的线程里的两个调用者修改它们可能会导致引用冲突。

    <cache eviction="FIFO" flushInterval="60000" size="512" readOnly="true">      </cache>  

还可以在不同的命名空间里共享同一个缓存配置或者实例。在这种情况下，你就可以使用cache-ref 来引用另外一个缓存。

    <cache-ref namespace="com.liming.manager.data.StudentMapper"/>  

Cache 语句属性配置细节：

属性 说明 取值 默认值 eviction 缓存策略：LRU - 最近最少使用法：移出最近较长周期内都没有被使用的对象。FIFI- 先进先出：移出队列里较早的对象；SOFT - 软引用：基于软引用规则，使用垃圾回收机制来移出对象；WEAK - 弱引用：基于弱引用规则，使用垃圾回收机制来强制性地移出对象 LRU、FIFI、SOFT、WEAK LRU flushInterval 代表一个合理的毫秒总计时间。默认是不设置，因此使用无间隔清空即只能调用语句来清空。 正整数 不设置 size 缓存的对象的大小 正整数 1024 readOnly 只读缓存将对所有调用者返回同一个实例。因此都不能被修改，这可以极大的提高性能。可写的缓存将通过序列化来返回一个缓存对象的拷贝。这会比较慢，但是比较安全。所以默认值是false。 true、false false