mapper

Mapper映射文件是一个xml格式文件，必须遵循相应的dtd文件规范，如ibatis-3-mapper.dtd。我们先大体上看看支持哪些配置？如下所示，从Eclipse里截了个屏：

从上图可以看出，映射文件是以<mapper>作为根节点，在根节点中支持9个元素，分别为insert、update、delete、select（增删改查）;cache、cache-ref、resultMap、parameterMap、sql。

下文中，我们将首先对增删改进行描述，然后对查进行详细说明，最后对其他五个元素进行简单说明。

（1）insert、update、delete

我们先从配置文件看起：

[html]  ​​view plain​​​   ​​​copy​​

1. <span style="font-family:'KaiTi_GB2312';font-size:18px;"><?xml version="1.0" encoding="UTF-8" ?>
2. <!DOCTYPE mapper
3. PUBLIC "-//ibatis.apache.org//DTD Mapper 3.0//EN"
4. "http://ibatis.apache.org/dtd/ibatis-3-mapper.dtd">
5. 
   
6. <!-- mapper 为根元素节点， 一个namespace对应一个dao -->
7. <mapper namespace="com.dy.dao.UserDao">
8. 
   
9. <insert
10. <!-- 1. id （必须配置）
11. id是命名空间中的唯一标识符，可被用来代表这条语句。
12. 一个命名空间（namespace） 对应一个dao接口,
13. >
14. 
    
15. id="addUser"
16. 
    
17. <!-- 2. parameterType （可选配置, 默认为mybatis自动选择处理）
18. 将要传入语句的参数的完全限定类名或别名， 如果不配置，mybatis会通过ParameterHandler 根据参数类型默认选择合适的typeHandler进行处理
19. >
20. 
    
21. parameterType="user"
22. 
    
23. <!-- 3. flushCache （可选配置，默认配置为true）
24. >
25. 
    
26. flushCache="true"
27. 
    
28. <!-- 4. statementType （可选配置，默认配置为PREPARED）
29. >
30. 
    
31. statementType="PREPARED"
32. 
    
33. <!-- 5. keyProperty (可选配置， 默认为unset)
34. >
35. 
    
36. keyProperty=""
37. 
    
38. <!-- 6. keyColumn     (可选配置)
39. >
40. 
    
41. keyColumn=""
42. 
    
43. <!-- 7. useGeneratedKeys (可选配置， 默认为false)
44. >
45. 
    
46. useGeneratedKeys="false"
47. 
    
48. <!-- 8. timeout  (可选配置， 默认为unset, 依赖驱动)
49. >
50. timeout="20">
51. 
    
52. <update
53. id="updateUser"
54. parameterType="user"
55. flushCache="true"
56. statementType="PREPARED"
57. timeout="20">
58. 
    
59. <delete
60. id="deleteUser"
61. parameterType="user"
62. flushCache="true"
63. statementType="PREPARED"
64. timeout="20">
65. </mapper></span>

上面给出了一个比较全面的配置说明，但是在实际使用过程中并不需要都进行配置，可根据自己的需要删除部分配置项。

在这里，我列举出我自己的配置文件，精简之后是这样的：

[html]  ​​view plain​​​   ​​​copy​​

1. <span style="font-family:'KaiTi_GB2312';font-size:18px;"><?xml version="1.0" encoding="UTF-8" ?>
2. <!DOCTYPE mapper
3. PUBLIC "-//ibatis.apache.org//DTD Mapper 3.0//EN"
4. "http://ibatis.apache.org/dtd/ibatis-3-mapper.dtd">
5. <mapper namespace="com.majing.learning.mybatis.dao.UserDao">
6. 
   
7. <insert id="addUser" parameterType="user" useGeneratedKeys="true" keyProperty="id">
8. insert into user(name,password,age) values(#{name},#{password},#{age})
9. </insert>
10. 
    
11. <delete id="deleteUser" parameterType="int">
12. id
13. </delete>
14. 
    
15. <update id="updateUser" parameterType="user" >
16. name = #{name}, password = #{password}, age = #{age} where id
17. </update>
18. 
    
19. 
    
20. 
    
21. </mapper></span>

这里的parameterType设置成user是因为如果不设置的情况下，会自动将类名首字母小写后的名称，原来的类名为User。不过，建议大家还是使用typeAlias进行配置吧。唯一需要说明的就是<insert>元素里面的useGeneratedKeys和keyProperties属性，这两个属性是用来获取数据库中的主键的。

在数据库里面经常性的会给数据库表设置一个自增长的列作为主键，如果我们操作数据库后希望能够获取这个主键该怎么弄呢？正如上面所述，如果是支持自增长的数据库，如mysql数据库，那么只需要设置useGeneratedKeys和keyProperties属性便可以了，但是对于不支持自增长的数据库（如oracle）该怎么办呢？

mybatis里面在<insert>元素下面提供了<selectKey>子元素用于帮助解决这个问题。来看下配置：

[html]  ​​view plain​​​   ​​​copy​​

1. <span style="font-family:'KaiTi_GB2312';font-size:18px;"><selectKey
2. <!-- selectKey 语句结果应该被设置的目标属性。如果希望得到多个生成的列，也可以是逗号分隔的属性名称列表。 -->
3. keyProperty="id"
4. <!-- 结果的类型。MyBatis 通常可以推算出来，但是为了更加确定写上也不会有什么问题。MyBatis 允许任何简单类型用作主键的类型，包括字符串。如果希望作用于多个生成的列，则可以使用一个包含期望属性的 Object 或一个 Map。 -->
5. resultType="int"
6. <!-- 这可以被设置为 BEFORE 或 AFTER。如果设置为 BEFORE，那么它会首先选择主键，设置 keyProperty 然后执行插入语句。如果设置为 AFTER，那么先执行插入语句，然后是 selectKey 元素 - 这和像 Oracle 的数据库相似，在插入语句内部可能有嵌入索引调用。 -->
7. order="BEFORE"
8. <!-- 与前面相同，MyBatis 支持 STATEMENT，PREPARED 和 CALLABLE 语句的映射类型，分别代表 PreparedStatement 和 CallableStatement 类型。 -->
9. statementType="PREPARED">
10. </selectKey>
11. </span>

针对不能使用自增长特性的数据库，可以使用下面的配置来实现相同的功能：

[html]  ​​view plain​​​   ​​​copy​​

1. <span style="font-family:'KaiTi_GB2312';font-size:18px;"><insert id="insertUser" parameterType="com.dy.entity.User">
2. <!-- oracle等不支持id自增长的，可根据其id生成策略，先获取id -->
3. 
   
4. <selectKey resultType="int" order="BEFORE" keyProperty="id">
5. select seq_user_id.nextval as id from dual
6. </selectKey>
7. 
   
8. insert into user(id, name, password, age, deleteFlag)
9. values(#{id}, #{name}, #{password}, #{age}, #{deleteFlag})
10. </insert></span>

讲完了insert、update、delete，接下来我们看看用的比较多的select。

（2）select、resultType、resultMap

我们先来看看select元素都有哪些配置可以设置：

[html]  ​​view plain​​​   ​​​copy​​

1. <span style="font-family:'KaiTi_GB2312';font-size:18px;"><select
2. <!--  1. id （必须配置）
3. id是命名空间中的唯一标识符，可被用来代表这条语句。
4. 一个命名空间（namespace） 对应一个dao接口,
5. >
6. 
   
7. id="findUserById"
8. 
   
9. <!-- 2. parameterType （可选配置, 默认为mybatis自动选择处理）
10. 将要传入语句的参数的完全限定类名或别名， 如果不配置，mybatis会通过ParameterHandler 根据参数类型默认选择合适的typeHandler进行处理
11. >
12. parameterType="int"
13. 
    
14. <!-- 3. resultType (resultType 与 resultMap 二选一配置)
15. >
16. resultType="User"
17. 
    
18. <!-- 4. resultMap (resultType 与 resultMap 二选一配置)
19. >
20. resultMap="userResultMap"
21. 
    
22. <!-- 5. flushCache (可选配置)
23. >
24. flushCache="false"
25. 
    
26. <!-- 6. useCache (可选配置)
27. >
28. useCache="true"
29. 
    
30. <!-- 7. timeout (可选配置)
31. >
32. timeout="10000"
33. 
    
34. <!-- 8. fetchSize (可选配置)
35. >
36. fetchSize="256"
37. 
    
38. <!-- 9. statementType (可选配置)
39. >
40. statementType="PREPARED"
41. 
    
42. <!-- 10. resultSetType (可选配置)
43. >
44. resultSetType="FORWARD_ONLY"></span>

我们还是从具体的示例来看看，

[html]  ​​view plain​​​   ​​​copy​​

1. <span style="font-family:'KaiTi_GB2312';font-size:18px;"><select id="findUserById" resultType="User">
2. id
3. </select></span>

这里我们根据用户id去查询这个用户的信息，resultType=User是一个别名，如果我们接触到的是这种一对一的问题，那么可以简单的定义一个实体，这个实体代表数据库表中的一条记录即可。但是如果我们遇到一对多的问题呢，就拿这里的查询用户信息来说，如果每个用户有各种兴趣，需要维护每个用户的兴趣信息，那么我们可能就存在下面的数据表结构：

[javascript]  ​​view plain​​​   ​​​copy​​

1. <span style="font-family:'KaiTi_GB2312';font-size:18px;">CREATE TABLE `user` (
2. int(11) NOT NULL AUTO_INCREMENT,
3. `name` varchar(255) NOT NULL,
4. `password` varchar(255) NOT NULL,
5. int(3) DEFAULT NULL,
6. PRIMARY KEY (`id`)
7. ) ENGINE=InnoDB AUTO_INCREMENT=15 DEFAULT CHARSET=utf8;
8. 
   
9. CREATE TABLE `userinterests` (
10. int(11) DEFAULT NULL,
11. int(11) DEFAULT NULL
12. ) ENGINE=InnoDB DEFAULT CHARSET=utf8;
13. 
    
14. CREATE TABLE `interests` (
15. int(11) NOT NULL,
16. `interestname` varchar(255) DEFAULT NULL,
17. PRIMARY KEY (`interestid`)
18. ) ENGINE=InnoDB DEFAULT CHARSET=utf8;</span>

其中user表用于记录用户信息，interests表用于维护所有的兴趣标签，而userinterests用于维护每个用户的兴趣情况。

这时候，如果我们需要根据用户id去查询用户的信息和兴趣信息该怎么做呢？这时候我们就要用到<select>中的另一个重要属性了，那就是resultMap。

在配置查询的返回结果时，resultType和resultMap是二选一的操作。对于比较复杂的查询结果，一般都会设置成resultMap。

resultMap该怎么配置呢？又支持哪些配置呢？我们看看下面：

[html]  ​​view plain​​​   ​​​copy​​

1. <span style="font-family:'KaiTi_GB2312';font-size:18px;"><resultMap type="" id="">
2. 
   
3. <!-- id, 唯一性，注意啦，这个id用于标示这个javabean对象的唯一性， 不一定会是数据库的主键（不要把它理解为数据库对应表的主键）
4. property属性对应javabean的属性名，column对应数据库表的列名
5. （这样，当javabean的属性与数据库对应表的列名不一致的时候，就能通过指定这个保持正常映射了）
6. >
7. <id property="" column=""/>
8. 
   
9. <!-- result与id相比， 对应普通属性 -->
10. <result property="" column=""/>
11. 
    
12. <!--
13. constructor对应javabean中的构造方法
14. -->
15. <constructor>
16. <!-- idArg 对应构造方法中的id参数 -->
17. <idArg column=""/>
18. <!-- arg 对应构造方法中的普通参数 -->
19. <arg column=""/>
20. </constructor>
21. 
    
22. <!--
23. collection，对应javabean中容器类型, 是实现一对多的关键
24. property 为javabean中容器对应字段名
25. column 为体现在数据库中列名
26. ofType 就是指定javabean中容器指定的类型
27. >
28. <collection property="" column="" ofType=""></collection>
29. 
    
30. <!--
31. association 为关联关系，是实现N对一的关键。
32. property 为javabean中容器对应字段名
33. column 为体现在数据库中列名
34. javaType 指定关联的类型
35. >
36. <association property="" column="" javaType=""></association>
37. </resultMap></span>
38. 1  更新单条记录
    UPDATE course SET name = 'course1' WHEREid= 'id1';
    2  更新多条记录的同一个字段为同一个值
    UPDATEcourseSETname='course1'WHEREidin('id1','id2','id3);
    3  更新多条记录为多个字段为不同的值

比较普通的写法，是通过循环，依次执行update语句。

<updateid="updateBatch"parameterType="list">update course
            <trim prefix="set" suffixOverrides=",">
             <trim prefix="name=case" suffix="end,">
                 <foreach collection="list" item="item" index="index">
                         <if test="item.name!=null">
                          when id=#{item.id} then #{item.name}
                         </if>
                 </foreach>
              </trim>
              <trim prefix="title =case" suffix="end,">
                 <foreach collection="list" item="item" index="index">
                         <if test="item.title!=null">
                          when id=#{item.id} then #{item.title}
                         </if>
                 </foreach>
              </trim>
             </trim>
            where
            <foreach collection="list" separator="or" item="item" index="index">
              id=#{item.id}
          </foreach>
</update>

2. Mybatis写法如下：
   <update id="updateBatch" parameterType="java.util.List">
3. <foreach collection="list" item="item" index="index" open="" close="" separator=";"> update course <set> name=${ item.name} </set> where id = ${ item.id} </foreach> </update>
   一条记录update一次，性能比较差，容易造成阻塞。
   MySQL没有提供直接的方法来实现批量更新，但可以使用case when语法来实现这个功能。
   UPDATE course
4. SET name = CASE id WHEN 1 THEN 'name1' WHEN 2 THEN 'name2' WHEN 3 THEN 'name3' END, title = CASE id WHEN 1 THEN 'New Title 1' WHEN 2 THEN 'New Title 2' WHEN 3 THEN 'New Title 3' END WHERE id IN (1,2,3)
   这条sql的意思是，如果id为1，则name的值为name1，title的值为New Title1；依此类推。
   在Mybatis中的配置则如下：
   


<trim>属性说明

1. prefix,suffix  表示在 trim 标签包裹的部分的前面或者后面添加内容 
2.如果同时有 prefixOverrides,suffixOverrides  表示会用 prefix,suffix 覆盖 Overrides 中的内容。 
3.如果只有 prefixOverrides,suffixOverrides  表示删除开头的或结尾的 xxxOverides 指定的内容。

1. 2. < 
3.     update 
     
    id 
    = 
    "updateBatch" 
     
    parameterType 
    = 
    "java.util.List" 
    >
update mydata_table4.         <trim prefix="set" suffixOverrides=",">
            <trim prefix="status =case" suffix="end,">
                 <foreach collection="list" item="item" index="index">
                     <if test="item.status !=null and item.status != -1">
                         when id=#{item.id} then #{item.status}
                     </if>
                     <if test="item.status == null or item.status == -1">
                         when id=#{item.id} then mydata_table.status//原数据
                     </if>
                 </foreach>
            </trim>
        </trim>
        where id in
        <foreach collection="list" index="index" item="item" separator="," open="(" close=")">
            #{item.id,jdbcType=BIGINT}
        </foreach>
</update>

1. 2. 4  sql批量更新看另外一个示例：
3.     set  status=
    <foreach collection="list" item="item" index="index" 
        separator=" " open="case ID" close="end">
        when #{item.id} then #{item.status}
    </foreach>
    where id in
    <foreach collection="list" index="index" item="item" 
        separator="," open="(" close=")">
        #{item.id,jdbcType=BIGINT}
    </foreach>
 </update>其中 when...then... 是 sql 中的 "switch"  语法。这里借助 mybatis 的 <foreach> 语法来拼凑成了批量更新的 sql ，上面的意思就是批量更新 id 在 updateBatch 参数所传递 List 中的数据的status 字段。还可以使用 <trim> 实现同样的功能,代码如下:
<update id="updateBatch" parameterType="java.util.List">4.         update mydata_table
        <trim prefix="set" suffixOverrides=",">
            <trim prefix="status =case" suffix="end,">
                <foreach collection="list" item="item" index="index">
                     when id=#{item.id} then #{item.status}
                </foreach>
            </trim>
        </trim>
        where id in
        <foreach collection="list" index="index" item="item" separator="," open="(" close=")">
            #{item.id,jdbcType=BIGINT}
        </foreach>
</update>
其结构如下：
update mydata_table 5.     set status = 
    case
        when id = #{item.id} then #{item.status}//此处应该是<foreach>展开值
        ...
    end
    where id in (...);

如果对要更新的数据进行判断,只有符合条件的数据才能进行更新,这种情况可以这么做:
<trim prefix="status =case" suffix="end,">6.      <foreach collection="list" item="item" index="index">
         <if test="item.status !=null and item.status != -1">
             when id=#{item.id} then #{item.status}
         </if>
     </foreach>
</trim>


这样的话只有要更新的list中status != null && status != -1的数据才能进行status更新.其他的将使用默认值更新,而不会保持原数据不变.如果要保持原数据不变呢?即满足条件的更新,不满足条件的保持原数据不变,简单的来做就是再加一个<if>,因为mybatis中没有if...else...语法,但可以通过多个<if>实现同样的效果,如下:
<trim prefix="status =case" suffix="end,">7.      <foreach collection="list" item="item" index="index">
         <if test="item.status !=null and item.status != -1">
             when id=#{item.id} then #{item.status}
         </if>
         <if test="item.status == null or item.status == -1">
             when id=#{item.id} then mydata_table.status      //这里就是原数据
         </if>
     </foreach>
</trim>

2. 
   



整体批量更新的写法如下: