(八)MyBatis从入门到入土——自动映射的使用

时间  2021-02-20
标签 java sql 编程 mybatis app 测试 this code xml 对象 栏目 MyBatis 繁體版
原文   原文链接

这是mybatis系列第8篇。没看前文的建议先去【Java冢狐】公众号中查看前文，方便理解和掌握。在上一篇中咱们介绍了一些mybatis使用查询的一些方式，特别是一对一查询和一对多查询进行了重点介绍。没看的推荐去公众号进行查看。java

今天咱们介绍一下咱们一直在使用的可是没有来得及作过多介绍的自动映射。sql

什么是自动映射？

介绍自动映射以前先看一下手动映射，以下：编程

<resultMap id="orderModelMap1" type="com.zhonghu.chat08.demo7.model.OrderModel">
    <id column="id" property="id"/>
    <result column="userId" property="userId" />
    <result column="createTime" property="createTime" />
    <result column="upTime" property="upTime" />
</resultMap>
<select id="getById1" resultMap="orderModelMap1">
    <![CDATA[
    SELECT
        a.id,
        a.user_id userId,
        a.create_time createTime,
        a.up_time upTime
    FROM
        orders a
    WHERE
        a.id = #{value}
    ]]>
</select>

注意上面的resultMap元素中有4行配置，以下：mybatis

<id column="id" property="id"/>
<result column="userId" property="userId" />
<result column="createTime" property="createTime" />
<result column="upTime" property="upTime" />

这4行代码用于配置sql结果的列和OrderModel对象中字段的映射关系。app

你们有没有注意到，映射规则中column和property元素的值都是同样，mybatis中支持自动映射配置，当开启自动映射以后，当sql的列名和Model中的字段名称是同样的时候（不区分大小写），mybatis内部会进行自动映射，不须要咱们手动去写上面的4行映射规则。测试

下面咱们将上面的示例改为自动映射的方式，以下：this

<resultMap id="orderModelMap2" type="com.zhonghu.chat08.demo7.model.OrderModel" autoMapping="true">
</resultMap>
<select id="getById2" resultMap="orderModelMap2">
    <![CDATA[
    SELECT
        a.id,
        a.user_id userId,
        a.create_time createTime,
        a.up_time upTime
    FROM
        orders a
    WHERE
        a.id = #{value}
    ]]>
</select>

注意上面的resultMap中的autoMapping属性，是否开启自动映射，咱们设置为true，这样mybatis会自动按照列名和Model中同名的字段进行映射赋值。code

上面两个配置最后查询结果是同样的，都会将查询结果对应的4个字段的值自动赋值给OrderModel中同名的属性。xml

自动映射开关

mybatis中自动映射主要有2种配置，一种是全局的配置，对应用中全部的resultMap起效，这个是在mybatis配置文件中进行设置的；另一种是经过resultMap的autoMapping属性进行配置。对象

mybatis判断某个resultMap是否开启自动映射配置的时候，会先查找自身的autoMapping属性，若是这个属性设置值了，就直接用这个属性的值，若是resultMap元素的autoMapping属性没有配置，则走全局配置的自动映射规则。

下面咱们来详解介绍一下这款的内容。

mybatis自动映射全局配置

在mybatis全局配置文件中加入下面配置：

<settings>
    <setting name="autoMappingBehavior" value="自动映射规则"/>
</settings>

主要有一下几种：

  • NONE：关闭全局映射开关
  • PARTIAL：对除在内部定义了嵌套结果映射（也就是链接的属性）之外的属性进行映射，这个也是默认值。
  • FULL：自动映射全部属性。

NONE

当mybatis全局配置中将autoMappingBehavior的值置为了NONE,表示全局自动映射被关闭了，会致使sql实际上有返回结果，可是结果映射的时候不会自动映射因此返回的时候是空

PARTIAL

会进行自动映射，可是有些复杂的查询映射会在resultMap中嵌套一些映射（如：association，collection），当使用PARTIAL的时候，若是有嵌套映射，则这个嵌套映射不会进行自动映射了。

FULL

自动映射全部属性。

autoMapping使用

上面咱们有说过，当在resultMap中指定了autoMapping属性以后，这个resultMap的自动映射就受autoMapping属性的控制，和mybatis中全局映射配置（autoMappingBehavior）行为无关了。

案例1

这个核心配置主要在sqlmap中，以下：
<resultMap id="orderModelMap7" type="com.zhonghu.chat08.demo7.model.OrderModel" autoMapping="true">
    <association property="userModel" autoMapping="true">
        <id column="user_id" property="id"/>
    </association>
</resultMap>
<select id="getById7" resultMap="orderModelMap7">
    <![CDATA[
    SELECT
        a.id,
        a.user_id userId,
        a.create_time createTime,
        a.up_time upTime,
        b.id as user_id,
        b.name
    FROM
        orders a,user b
    WHERE
        a.user_id = b.id
        AND a.id = #{value}
    ]]>
</select>
对应测试用例
com.zhonghu.chat08.demo7.Demo7Test#getById7
@Test
public void getById7() throws IOException {
    this.before("demo7/mybatis-config1.xml");
    try (SqlSession sqlSession = this.sqlSessionFactory.openSession(true);) {
        OrderMapper mapper = sqlSession.getMapper(OrderMapper.class);
        OrderModel orderModel = mapper.getById7(2);
        log.info("{}", orderModel);
    }
}
运行输出
24:37.544 [main] DEBUG c.j.c.d.mapper.OrderMapper.getById7 - ==>  Preparing: SELECT a.id, a.user_id userId, a.create_time createTime, a.up_time upTime, b.id as user_id, b.name FROM orders a,user b WHERE a.user_id = b.id AND a.id = ? 
24:37.589 [main] DEBUG c.j.c.d.mapper.OrderMapper.getById7 - ==> Parameters: 2(Integer)
24:37.610 [main] DEBUG c.j.c.d.mapper.OrderMapper.getById7 - <==      Total: 1
24:37.610 [main] INFO  c.j.chat05.demo7.Demo7Test - OrderModel(id=2, userId=1, createTime=1610803573, upTime=1610803573, userModel=UserModel(id=1, name=冢狐))

OrderModel中全部属性都自动映射成功。

自动装配并非那么好玩，玩不转可能带来一些隐患，咱们看一个案例，见下面的示例2。

示例2

根据订单编号，查询出订单信息，顺便查询出订单明细列表。这个咱们使用mybatis中的一对多查询。

OrderDetaiMapper.xml加入
<select id="getListByOrderId1" resultType="com.zhonghu.chat08.demo7.model.OrderDetailModel">
    <![CDATA[
    SELECT
        a.id,
        a.order_id AS orderId,
        a.goods_id AS goodsId,
        a.num,
        a.total_price AS totalPrice
    FROM
        order_detail a
    WHERE
        a.order_id = #{value}
    ]]>
</select>

这个能够根据订单的id，查询出订单关联的明细列表。

OrderMapper.xml加入
<resultMap id="orderModelMap8" type="com.zhonghu.chat08.demo7.model.OrderModel" autoMapping="true">
    <collection property="orderDetailModelList" select="com.zhonghu.chat08.demo7.mapper.OrderDetailMapper.getListByOrderId1" column="id"/>
</resultMap>
<select id="getById8" resultMap="orderModelMap8">
    <![CDATA[
    SELECT
        a.id,
        a.user_id userId,
        a.create_time createTime,
        a.up_time upTime
    FROM
        orders a
    WHERE a.id = #{value}
    ]]>
</select>
测试用例
com.zhonghu.chat08.demo7.Demo7Test#getById8
@Test
public void getById8() throws IOException {
    this.before("demo7/mybatis-config.xml");
    try (SqlSession sqlSession = this.sqlSessionFactory.openSession(true);) {
        OrderMapper mapper = sqlSession.getMapper(OrderMapper.class);
        OrderModel orderModel = mapper.getById8(1);
        log.info("{}", orderModel);
    }
}
运行输出
11:06.193 [main] DEBUG c.j.c.d.mapper.OrderMapper.getById8 - ==>  Preparing: SELECT a.id, a.user_id userId, a.create_time createTime, a.up_time upTime FROM orders a WHERE a.id = ? 
11:06.229 [main] DEBUG c.j.c.d.mapper.OrderMapper.getById8 - ==> Parameters: 1(Integer)
11:06.250 [main] DEBUG c.j.c.d.m.O.getListByOrderId1 - ====>  Preparing: SELECT a.id, a.order_id AS orderId, a.goods_id AS goodsId, a.num, a.total_price AS totalPrice FROM t_order_detail a WHERE a.order_id = ? 
11:06.251 [main] DEBUG c.j.c.d.m.O.getListByOrderId1 - ====> Parameters: 1(Integer)
11:06.255 [main] DEBUG c.j.c.d.m.O.getListByOrderId1 - <====      Total: 2
11:06.256 [main] DEBUG c.j.c.d.mapper.OrderMapper.getById8 - <==      Total: 1
11:06.256 [main] INFO  c.j.chat05.demo7.Demo7Test - OrderModel(id=null, userId=2, createTime=1610803573, upTime=1610803573, userModel=null, orderDetailModelList=[OrderDetailModel(id=1, orderId=1, goodsId=1, num=2, totalPrice=16.00), OrderDetailModel(id=2, orderId=1, goodsId=1, num=1, totalPrice=16.00)])

注意输出中OrderModel的id属性，怎么是null值？主要是下面这行配置致使的

<collection property="orderDetailModelList" select="com.zhonghu.chat08.demo7.mapper.OrderDetailMapper.getListByOrderId1" column="id"/>

上面这个配置中有个column属性，指定的是id，此时mybatis认为你对id字段手动指定了映射关系，就跳过了对id字段到OrderModel.id属性的自动映射，因此致使OrderModel对象的id属性没有赋值，此时须要咱们在orderModelMap8手动指定id的映射规则，以下：

<resultMap id="orderModelMap8" type="com.zhonghu.chat08.demo7.model.OrderModel" autoMapping="true">
    <id column="id" property="id" />
    <collection property="orderDetailModelList" select="com.zhonghu.chat08.demo7.mapper.OrderDetailMapper.getListByOrderId1" column="id"/>
</resultMap>

再去运行测试用例就正常了。

总结一下

对于我们开发来讲，自动映射确实能够帮助咱们节省一些代码，不过也存在一些隐患，咱们但愿本身开发的系统是健壮的，建议你们写mapper xml的时候，仍是花点时间将映射的配置都给写上去，这样可以杜绝一些隐患，使咱们的系统更稳定。

最后

  • 若是以为看完有收获，但愿能关注一下，顺便给我点个赞，这将会是我更新的最大动力，感谢各位的支持
  • 欢迎各位关注个人公众号【java冢狐】，专一于java和计算机基础知识，保证让你看完有所收获，不信你打我
  • 求一键三连：点赞、转发、在看。
  • 若是看完有不一样的意见或者建议，欢迎多多评论一块儿交流。感谢各位的支持以及厚爱。

——我是冢狐，和你同样热爱编程。

欢迎关注公众号“Java冢狐”获取最新消息

相关文章
相关标签/搜索
每日一句
    每一个你不满意的现在，都有一个你没有努力的曾经。
本站公众号
   欢迎关注本站公众号,获取更多信息
联系我们 最近搜索 最新文章 沪ICP备13005482号-10 MyBatis教程 SQL 教程 MySQL教程 Java 教程 Thymeleaf 教程 Hibernate教程 Spring教程 Redis教程