MyBatis的MapKey注解实例解析

目录
  • 使用
  • 一、数据准备
  • 二、Mapper配置
    • UserMapper接口
  • 三、实战
  • 实战2——注意事项
  • 原理
  • 总结

使用

mybatis中有很多实用的注解,但是平时想不起来使用。今天就来讲一下MapKey是如何使用的

说明:本文基于mybatis原生框架3.3.0-SNAPSHOT

一、数据准备

数据库准备一张user表,插入一点测试数据

CREATE TABLE `user` (
  `id` int(11) NOT NULL AUTO_INCREMENT,
  `username` varchar(20) DEFAULT NULL,
  `password` varchar(20) DEFAULT NULL,
  `age` int(11) DEFAULT NULL,
  `birthday` varchar(20) DEFAULT NULL,
  PRIMARY KEY (`id`)
) ENGINE=InnoDB AUTO_INCREMENT=1018 DEFAULT CHARSET=utf8mb4
select * from user;

二、Mapper配置

UserMapper接口

public interface UserMapper {
    @Select("select * from user limit 1")
    List<User> queryAll1();
    @MapKey("username")
    @Select("select * from user limit 1")
    Map<String, User> queryAll2();
}

这里我们的mapper接口只有两个方法queryAll1 queryAll2。这两个方法执行的SQL是一样的,SQL的含义也一样,就是从user表中取出一条数据。

不同的是

  • queryAll1 queryAll2的返回值不一样
  • queryAll1没有使用MapKey注解,返回值是User对象,符合SQL返回的只有一条记录的语义
  • queryAll2使用MapKey注解,但是返回值却是一个Map对象?这似乎不符合SQL返回的语义。SQLselect * from user limit 1只返回一条记录。怎么返回一个Map<String, User>对象呢?这就是MapKey这个注解的特别之处: 它能够将存放对象的List转化为 key值为对象的某一属性的Map。MapKey有一个属性value,该属性值填入的就是对象的属性名,作为Map的key值。看不懂这句话没关系,看完执行结果回头再来看就懂了!

三、实战

使用mybatis的SqlSession获取Mapper代理对象,分别执行

@org.junit.Test
public void testMapKey() throws IOException {
    InputStream is = Resources.getResourceAsStream("sqlMapConfig.xml");
    SqlSessionFactory factory = new SqlSessionFactoryBuilder().build(is);
    SqlSession sqlSession = factory.openSession();
    UserMapper userMapper = sqlSession.getMapper(UserMapper.class);
    User users1 = userMapper.queryAll1();
    Map<String, User> users2 = userMapper.queryAll2();
    System.out.println("不使用MapKey查询: " + users3);
    System.out.println("使用MapKey查询: " + users4);
}

输出结果

不使用MapKey查询: User{id=1, username='111', password='222', birthday='333'}
使用MapKey查询: {111=User{id=1, username='111', password='222', birthday='333'}}

可以看到,添加了MapKey注解的方法执行结果Map的key就是注解里value值对应的User对象的属性值。value就是SQL查询得到的结果User。

这就是MapKey这个注解的特别之处: 它能够将存放对象的List转化为 key值为对象的某一属性的Map。MapKey有一个属性value,该属性值填入的就是对象的属性名,作为Map的key值

现在再来看这句话,是不是就能理解了?

实战2——注意事项

Mapper接口中的方法标注了MapKey后,即使SQL返回多条结果,最终方法返回的结果只有一条。这是因为user表中的username字段全是一样的。如果把MapKey注解中的value值改为其他user表中不一样的字段,返回结果就会是多条记录啦

@MapKey("username")
@Select("select * from user limit 10")
Map<String, User> queryAll5();
@MapKey("id")
@Select("select * from user limit 10")
Map<String, User> queryAll6();

执行方法

Map<String, User> users5 = userMapper.queryAll5();
System.out.println("users5: " + users5);
Map<String, User> users6 = userMapper.queryAll6();
System.out.println("users6: " + users6);

输出结果

users5: {111=User{id=11, username='111', password='222', birthday='333'}}
users6: {1=User{id=1, username='111', password='222', birthday='333'}, 
        3=User{id=3, username='111', password='222', birthday='333'}, 
        4=User{id=4, username='111', password='222', birthday='333'}, 
        5=User{id=5, username='111', password='222', birthday='333'}, 
        6=User{id=6, username='111', password='222', birthday='333'}, 
        7=User{id=7, username='111', password='222', birthday='333'}, 
        8=User{id=8, username='111', password='222', birthday='333'}, 
        9=User{id=9, username='111', password='222', birthday='333'}, 
        10=User{id=10, username='111', password='222', birthday='333'}, 
        11=User{id=11, username='111', password='222', birthday='333'}}

如果标注了MapKey,则返回结果Map的value类型不可以是List,否则执行方法会报错。下面是错误示例。

@MapKey("username") // 执行会报错
@Select("select * from user limit 10")
Map<String, List<User>> queryAll5();

原理

@MapKey("username")
@Select("select * from user limit 10")
Map<String, User> queryAll5();

我们针对如上这个方法进行分析,在执行SQL时会调用SqlSession中的如下代码

public <K, V> Map<K, V> selectMap(String statement, Object parameter, String mapKey, RowBounds rowBounds) {
  //转而去调用selectList
  final List<?> list = selectList(statement, parameter, rowBounds);
  final DefaultMapResultHandler<K, V> mapResultHandler = new DefaultMapResultHandler<K, V>(mapKey,
      configuration.getObjectFactory(), configuration.getObjectWrapperFactory());
  final DefaultResultContext context = new DefaultResultContext();
  for (Object o : list) {
    //循环用DefaultMapResultHandler处理每条记录
    context.nextResultObject(o);
    mapResultHandler.handleResult(context);
  }
  //注意这个DefaultMapResultHandler里面存了所有已处理的记录(内部实现可能就是一个Map),最后再返回一个Map
  return mapResultHandler.getMappedResults();
}

来分析源码

  • 使用Executor查询结果,这里的SQL是select * from user limit 10,SQL执行的结果返回给List对象,List中确实有10条记录
  • 构造一个对象DefaultMapResultHandler mapResultHandler,它是用来处理结果集的映射的,
  • 遍历第一步中List得到的结果集对象

调用mapResultHandler.handleResult(context);方法将List结果集中每一条记录对应Mapkey中的属性值取出,作为Map的key加入到集合里。handleResult源码如下。其中主要关注这一行就可以了mappedResults.put(key, value);

@Override
public void handleResult(ResultContext context) {
  // TODO is that assignment always true?
  //得到一条记录
  //这边黄色警告没法去掉了?因为返回Object型
  final V value = (V) context.getResultObject();
  //MetaObject.forObject,包装一下记录
  //MetaObject是用反射来包装各种类型
  final MetaObject mo = MetaObject.forObject(value, objectFactory, objectWrapperFactory);
  final K key = (K) mo.getValue(mapKey);
  mappedResults.put(key, value);
  //这个类主要目的是把得到的List转为Map
}

通过handleResult方法源码可以看到,对于List结果集中的一条记录,取出属性username的值作为Map的key值添加到mappedResults集合中。那么如果key值相同就会被覆盖!这就是实战篇坑1的原理

最后是通过mapResultHandler.getMappedResults();方法返回第4步中的map最为最终方法的返回值。

总结

MapKey的作用:它能够将存放对象的List转化为 key值为对象的某一属性的Map。MapKey有一个属性value,该属性值填入的就是对象的属性名,作为Map的key值

使用场景:可以针对结果集中的某个属性去重,而不在乎其他字段是否重复

以上就是MyBatis的MapKey注解实例解析的详细内容,更多关于MyBatis MapKey注解的资料请关注我们其它相关文章!

(0)

相关推荐

  • 详解MyBatis ResultSetHandler 结果集的解析过程

    目录 正文 ResultSetHandler#handleResultSets 第一部分:ResultSetWrapper 第二部分:验证rsw对象 第三部分:遍历rsw中的结果集 第四部分:处理ResultSets标签 第五部分:collapseSingleResultList 总结 正文 mybatis版本:3.5.12 mybatis通过Executor查询出结果后,通常返回的是一个List结构,再根据用户调用的API把List结构转为指定结构. 比如用户调用SqlSession#sele

  • 更简单更高效的Mybatis Plus最新代码生成器AutoGenerator

    目录 正文 一.概述 二.使用AutoGenerator 1. 初始化数据库表结构(以User用户表为例) 2. 在 pom.xml 文件中添加 AutoGenerator 的依赖. 3. 添加模板引擎依赖 4. 全局配置 5. 自定义模板生成DTO.VO User用户类 总结 正文 MyBatis-Plus(简称 MP)是一个 MyBatis 的增强工具,在 MyBatis 的基础上只做增强不做改变,为简化开发.提高效率而生. 今天的主角是MP推出的一款代码生成器,本文主要来介绍一下它强大的代

  • Mybatis TypeHandler接口及继承关系示例解析

    目录 开篇 TypeHandler接口 TypeHandler继承体系 IntegerTypeHandler DateTypeHandler TypeHandlerRegistry TypeHandlerRegistry#register方法 总结 开篇 JDBC类型与Java类型并不是完全一一对应的.所以在PreparedStatement绑定参数的时候需要把Java类型转为JDBC类型.JDBC类型的枚举值在JdbcType枚举值中存储. MyBatis中提供了一个接口专用于JDBC类型与J

  • MyBatis SqlSource源码示例解析

    目录 正文 SqlNode SqlNode接口定义 BoundSql SqlSource SqlSource解析时机 SqlSource调用时机 总结 正文 MyBatis版本:3.5.12. 本篇讲从mybatis的角度分析SqlSource.在xml中sql可能是带?的预处理语句,也可能是带$或者动态标签的动态语句,也可能是这两者的混合语句. SqlSource设计的目标就是封装xml的crud节点,使得mybatis运行过程中可以直接通过SqlSource获取xml节点中解析后的SQL.

  • MyBatis的MapKey注解实例解析

    目录 使用 一.数据准备 二.Mapper配置 UserMapper接口 三.实战 实战2——注意事项 原理 总结 使用 mybatis中有很多实用的注解,但是平时想不起来使用.今天就来讲一下MapKey是如何使用的 说明:本文基于mybatis原生框架3.3.0-SNAPSHOT 一.数据准备 数据库准备一张user表,插入一点测试数据 CREATE TABLE `user` ( `id` int(11) NOT NULL AUTO_INCREMENT, `username` varchar(

  • JsonFormat与@DateTimeFormat注解实例解析

    这篇文章主要介绍了JsonFormat与@DateTimeFormat注解实例解析,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友可以参考下 背景:从数据库获取时间传到前端进行展示的时候,我们有时候可能无法得到一个满意的时间格式的时间日期,在数据库中显示的是正确的时间格式,获取出来却变成了很丑的时间戳,@JsonFormat注解很好的解决了这个问题,我们通过使用@JsonFormat可以很好的解决:后台到前台时间格式保持一致的问题,其次,另一个问题是,我们

  • MyBatis与Spring整合过程实例解析

    这篇文章主要介绍了MyBatis与Spring整合过程实例解析,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友可以参考下 从之前的代码中可以看出直接使用 MyBatis 框架的 SqlSession 访问数据库并不简便.MyBatis 框架的重点是 SQL 映射文件,为方便后续学习,本节讲解 MyBatis 与 Spring 的整合.教程的后续讲解中将使用整合后的框架进行演示. 导入相关JAR包 1)MyBatis 框架所需的 JAR 包 图 1MyBat

  • Spring MVC Mybatis多数据源的使用实例解析

    项目需要从其他网站获取数据,因为是临时加的需求,在开始项目时没想到需要多数据源 于是百度了一下,发现只需要改动一下Spring 的applicationContext.xml文件和编写三个工具类就可以完美实现 applicationContext.xml <!-- 多数据源配置 --> <bean id="ds1" class="org.apache.commons.dbcp.BasicDataSource"> <property na

  • 通过实例解析Spring组合注解与元注解

    这篇文章主要介绍了通过实例解析Spring组合注解与元注解,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友可以参考下 1.概述 1.1.Spring提供了大量的注解, 尤其是相同的注解用到各个类中,会相当的啰嗦: 1.2.元注解: 可以注解到别的注解上的注解: 组合注解: 被注解注解的注解称为 组合注解: 组合注解 具备 元注解 的功能,Spring的很多注解都可以作为元注解: 1.3.案例 package com.an.config; import co

  • MyBatis执行Sql的流程实例解析

    这篇文章主要介绍了MyBatis执行Sql的流程实例解析,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友可以参考下 本博客着重介绍MyBatis执行Sql的流程,关于在执行过程中缓存.动态SQl生成等细节不在本博客中体现,相应内容后面再单独写博客分析吧. 还是以之前的查询作为列子: public class UserDaoTest { private SqlSessionFactory sqlSessionFactory; @Before public v

  • 浅谈MyBatis中@MapKey的妙用

    目录 MyBatis @MapKey的妙用 背景 实现 源码分析 思考 Mybatis @MapKey分析 1. MapKey注解有啥功能 2. MapKey的源码分析 1. MapperMethod对MapKey的操作 2. DefaultMapResultHandler是什么 MyBatis @MapKey的妙用 背景 在实际开发中,有一些场景需要我们返回主键或者唯一键为Key.Entity为Value的Map集合,如Map<Long, User>,之后我们就可以直接通过map.get(k

  • 基于Spring + Spring MVC + Mybatis 高性能web构建实例详解

    一直想写这篇文章,前段时间痴迷于JavaScript.NodeJs.AngularJS,做了大量的研究,对前后端交互有了更深层次的认识. 今天抽个时间写这篇文章,我有预感,这将是一篇很详细的文章,详细的配置,详细的注释,看起来应该很容易懂. 用最合适的技术去实现,并不断追求最佳实践.这就是架构之道. 希望这篇文章能给你们带来一些帮助,同时希望你们可以为这个项目贡献你的想法. 源码地址:https://github.com/Eliteams/quick4j 点击打开 源码地址:https://gi

  • Spring jpa和mybatis整合遇到的问题解析

    前一阵子接手了一个使用SpringBoot 和spring-data-jpa开发的项目,后期新加入一个小伙伴,表示jpa相比mybatis太难用,多表联合的查询写起来也比较费劲,所以便加入了mybatis的支持 开始的时候 @Configuration @EnableJpaRepositories("com.xxx.xxx.repository") class JpaConfig 使用这种方式去配置的jpa,遇到一个问题,就是能select 但是不能save,所以就修改为配置文件的方式

  • Mybatis集成Spring的实例代码_动力节点Java 学院整理

    所需要用到的其他工具或技术: 项目管理工具 : Maven 前台WEB展示:JSP 其他框架:Spring, Spring MVC 数据库 : Derby 新建一个Maven的Web项目 Maven Dependencies: <!-- Spring --> <dependency> <groupId>org.springframework</groupId> <artifactId>spring-context</artifactId&g

随机推荐