mapper

刺骨的言语ヽ痛彻心扉 2023-09-29 06:03 7阅读 0赞

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

![Center][]

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

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

（1）insert、update、delete

我们先从配置文件看起：

\[html\] [view plain][] [copy][view plain]

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.  
7.  <mapper namespace="com.dy.dao.UserDao">
8.  
9.  <insert
10. 
14. 
15. id="addUser"
16. 
17. 
20. 
21. parameterType="user"
22. 
23. 
25. 
26. flushCache="true"
27. 
28. 
30. 
31. statementType="PREPARED"
32. 
33. 
35. 
36. keyProperty=""
37. 
38. 
40. 
41. keyColumn=""
42. 
43. 
45. 
46. useGeneratedKeys="false"
47. 
48. 
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][view plain]

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

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

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

\[html\] [view plain][] [copy][view plain]

1.  <span style="font-family:'KaiTi\_GB2312';font-size:18px;"><selectKey
2.  
3.  keyProperty="id"
4.  
5.  resultType="int"
6.  
7.  order="BEFORE"
8.  
9.  statementType="PREPARED">
10. </selectKey>
11. </span>

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

\[html\] [view plain][] [copy][view plain]

1.  <span style="font-family:'KaiTi\_GB2312';font-size:18px;"><insert id="insertUser" parameterType="com.dy.entity.User">
2.  
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][view plain]

1.  <span style="font-family:'KaiTi\_GB2312';font-size:18px;"><select
2.  
6.  
7.  id="findUserById"
8.  
9.  
12. parameterType="int"
13. 
14. 
16. resultType="User"
17. 
18. 
20. resultMap="userResultMap"
21. 
22. 
24. flushCache="false"
25. 
26. 
28. useCache="true"
29. 
30. 
32. timeout="10000"
33. 
34. 
36. fetchSize="256"
37. 
38. 
40. statementType="PREPARED"
41. 
42. 
44. resultSetType="FORWARD\_ONLY"></span>

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

\[html\] [view plain][] [copy][view plain]

1.  <span style="font-family:'KaiTi\_GB2312';font-size:18px;"><select id="findUserById" resultType="User">
2.  select \* from user where id = \#\{id\}
3.  </select></span>

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

\[javascript\] [view plain][] [copy][view plain]

1.  <span style="font-family:'KaiTi\_GB2312';font-size:18px;">CREATE TABLE \`user\` (
2.  \`id\` int(11) NOT NULL AUTO\_INCREMENT,
3.  \`name\` varchar(255) NOT NULL,
4.  \`password\` varchar(255) NOT NULL,
5.  \`age\` int(3) DEFAULT NULL,
6.  PRIMARY KEY (\`id\`)
7.  ) ENGINE=InnoDB AUTO\_INCREMENT=15 DEFAULT CHARSET=utf8;
8.  
9.  CREATE TABLE \`userinterests\` (
10. \`userid\` int(11) DEFAULT NULL,
11. \`interestid\` int(11) DEFAULT NULL
12. ) ENGINE=InnoDB DEFAULT CHARSET=utf8;
13. 
14. CREATE TABLE \`interests\` (
15. \`interestid\` 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][view plain]

1.  <span style="font-family:'KaiTi\_GB2312';font-size:18px;"><resultMap type="" id="">
2.  
3.  
7.  <id property="" column=""/>
8.  
9.  
10. <result property="" column=""/>
11. 
12. 
15. <constructor>
16. 
17. <idArg column=""/>
18. 
19. <arg column=""/>
20. </constructor>
21. 
22. 
28. <collection property="" column="" ofType=""></collection>
29. 
30. 
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语句。
    
    Mybatis写法如下：
    
        <update id="updateBatch"  parameterType="java.util.List">  
            <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
            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中的配置则如下：
    
    <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>
    
    <trim>属性说明  
    
    
    > 1. prefix,suffix 表示在 trim 标签包裹的部分的前面或者后面添加内容  
    > 2.如果同时有 prefixOverrides,suffixOverrides 表示会用 prefix,suffix 覆盖 Overrides 中的内容。  
    > 3.如果只有 prefixOverrides,suffixOverrides 表示删除开头的或结尾的 xxxOverides 指定的内容。
    
    4 sql批量更新
    
    看另外一个示例：
    
    < update id = "updateBatch" parameterType = "java.util.List" >
    
        update mydata_table 
            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">
                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 
            set status = 
            case
                when id = #{item.id} then #{item.status}//此处应该是<foreach>展开值
                ...
            end
            where id in (...);
    
    如果对要更新的数据进行判断,只有符合条件的数据才能进行更新,这种情况可以这么做:
    
        <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>
             </foreach>
        </trim>
    
    这样的话只有要更新的list中status != null && status != -1的数据才能进行status更新.其他的将使用默认值更新,而不会保持原数据不变.如果要保持原数据不变呢?即满足条件的更新,不满足条件的保持原数据不变,简单的来做就是再加一个<if>,因为mybatis中没有if...else...语法,但可以通过多个<if>实现同样的效果,如下:
    
        <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>
    
    整体批量更新的写法如下:
    
    < update id = "updateBatch" parameterType = "java.util.List" >
    
        update mydata_table
                <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>
    
    参考学习： [http://blog.csdn.net/xyjawq1/article/details/74129316][http_blog.csdn.net_xyjawq1_article_details_74129316]
    
    我的示例： [https://gitee.com/lzbgit/maven\_demo/blob/master/demo-maven/src.main.resources/mapper/LoginMapper.xml][https_gitee.com_lzbgit_maven_demo_blob_master_demo-maven_src.main.resources_mapper_LoginMapper.xml]

[Center]: https://img-blog.csdn.net/20170515103333891?watermark/2/text/aHR0cDovL2Jsb2cuY3Nkbi5uZXQvbWFqaW5nZ29nb2dv/font/5a6L5L2T/fontsize/400/fill/I0JBQkFCMA==/dissolve/70/gravity/Center
[view plain]: https://blog.csdn.net/majinggogogo/article/details/72123185#
[http_blog.csdn.net_xyjawq1_article_details_74129316]: http://blog.csdn.net/xyjawq1/article/details/74129316
[https_gitee.com_lzbgit_maven_demo_blob_master_demo-maven_src.main.resources_mapper_LoginMapper.xml]: https://gitee.com/lzbgit/maven_demo/blob/master/demo-maven/src.main.resources/mapper/LoginMapper.xml