MyBatis标签之Select resultType和resultMap

前言

  Mybatis 中 select 标签有两个属性 resultType 和 resultMap，用于在mapper.xml文件中配置返回结果类型，工作中经常使用到它们。那么在日常开发中，应该如何正确的选择呢？下面我们对这两个属性分别进行讲解和演示。

结果类型resultType

  resultType直译就是结果的类型，可以设置为期望从select 语句中返回结果的类的全限定名或别名。resultType使用场景如下：

  如果查询结果只是返回一个值，比如返回String、map或int，那么可以使用resultType指定简单类型作为输出结果。

  我们先了解一个resultType的简单映射语句示例，它没有显式地指定 resultMap。比如：

<sql id="resultTypeColumn">
    id, username, hashedPassword
</sql>
<select id="selectUsers" resultType="map">
  select 
  	<include refid="resultTypeColumn"/>
  from some_table
  where id = #{id}
</select>

  上述语句只是简单地将所有的列映射到 HashMap 的键上，这由 resultType 属性指定。此处对查询字段用了一个 sql 标签进行封装，该sql 片段可复用。

  还有一种情况就是如果数据库表的字段名和实体bean对象的属性名一样。 虽然在大部分情况下都够用，但是 HashMap 并不是一个很好的领域模型；你的程序更可能会使用 JavaBean 或 POJO（普通老式 Java 对象）作为领域模型，MyBatis 对两者都提供了支持。看看下面这个 JavaBean：

package com.someapp.model;
public class User {
  private int id;
  private String username;
  private String hashedPassword;

 // omit getter,setter and toString
}

  基于 JavaBean 的规范，上面这个类有 3 个属性：id，username 和 hashedPassword，它们会对应到 select 语句中的列名。这样的一个 JavaBean 可以被映射到 ResultSet，就像映射到 HashMap 一样简单。

<select id="selectUsers" resultType="com.someapp.model.User">
  select 
  <include refid="resultTypeColumn"/>
  from some_table
  where id = #{id}
</select>

  类型别名是你的好帮手，关于如何设置类型别名，请移步《Spring Boot MyBatis使用type-aliases-package自定义类别名》。使用别名后就可以不用输入类的全限定名了。譬如：

<select id="selectUsers" resultType="User">
  select 
  <include refid="resultTypeColumn"/>
  from some_table
  where id = #{id}
</select>

  在此情况下，MyBatis 会在幕后自动创建一个 resultMap，再根据属性名来映射列到 JavaBean 的属性上。如果列名和属性名不能匹配上，可以在 SELECT 语句中设置列别名（这是一个基本的 SQL 特性）来完成匹配。例如：

<sql id="resultTypeColumn">
    user_id             as "id",
    user_name           as "userName",
    hashed_password     as "hashedPassword"
</sql>
<select id="selectUsers" resultType="map">
  select 
  	<include refid="resultTypeColumn"/>
  from some_table
  where id = #{id}
</select>

  注意，如果返回的是集合，那应该设置为集合包含的类型，而不是集合本身的类型。

结果映射resultMap

  resultMap 直译就是结果映射，该元素是 MyBatis 中最重要最强大的元素。与 resultType 相比，resultMap就要强大许多，它不仅能够用于简单查询，还能用于级联查询以及设置缓存，功能可谓是十分的强大。它可以让你从 90% 的 JDBC ResultSets 数据提取代码中解放出来，并在一些情形下允许你进行一些 JDBC 不支持的操作。实际上，在为一些比如连接的复杂语句编写映射代码的时候，一份 resultMap 能够代替实现同等功能的数千行代码。ResultMap 的设计思想是，对简单的语句做到零配置，对于复杂一点的语句，只需要描述语句之间的关系就行了。温馨提示：resultType 和 resultMap 之间只能同时使用一个。

resultMap标签属性

  resultMap 标签的属性值包括两个：

id 属性：唯一标识，此 id 值用于 select 标签 resultMap 属性的引用。

type 属性：表示该 resultMap 的映射结果类型，可以为类的全限定名或者别名。

  resultMap子标签包括如下几个 ：

  result标签的属性包括两个：

1. column：数据库字段名或别名。
2. property：实体类中的属性，和column属性一一对应。

resultMap使用示例

  下面使用一个简单的例子，来介绍 resultMap 的使用方法。虽然上一节中的例子不用显式配置 resultMap，但为了讲解，我们来看看如果显式使用外部的 resultMap 会怎样；这也是解决列名和bean名不匹配的另外一种方式。定义一个resultMap：

<resultMap id="userResultMap" type="User">
  <id property="id" column="user_id" />
  <result property="username" column="user_name"/>
  <result property="password" column="hashed_password"/>
</resultMap>

  然后在引用它的语句中设置 resultMap 属性就行了（注意我们去掉了 resultType 属性）。比如:

<select id="selectUsers" resultMap="userResultMap">
  select user_id, user_name, hashed_password
  from some_table
  where id = #{id}
</select>

resultType和resultMap的区别

  下面了解一下MyBatis中数据转换机制：在进行查询映射的时候，其实查询出来的每一个属性都是放在一个对应的Map里面，其中键是属性名，值则是其对应的值。当提供的返回类型属性是resultType的时候，MyBatis会将Map里面的键值对取出赋给resultType所指定的对象对应的属性。所以，其实MyBatis的每一个查询映射的返回类型都是ResultMap，只是当我们提供的返回类型属性是resultType的时候，MyBatis自动的把对应的值赋给resultType所指定对象的属性，而当提供的返回类型是resultMap的时候，因为Map不能很好表示领域模型，我们就需要自己把它转化为对应的对象，这常常在复杂查询中很有作用。

  言归正传，resultType和resultMap到底有什么区别呢？

  resultType不需要配置，但是resultMap要配置一下。resultType是直接指定返回类型的，而使用resultMap时，需要在外部ResultMap标签中，设置数据库表的字段名和实体bean对象类的属性的一一对应关系。设置后，就算数据库的字段名和实体类的属性名不一样也没有关系，mybatis依然会给映射出来，所以resultMap要更强大一些。

  就像上面说的那样，如果查询出来数据库字段名（包括字段别名）和要封装的实体bean对象属性值不相同时，只能使用resultMap来返回结果。

  还有一个区别是resultMap可以用在复杂联合查询上，而resultType不可以。关于这一点，大家可以去Mybatis官网了解一下，这里点到为止。

本站声明：
1. iCode9 技术分享网（下文简称本站）提供的所有内容，仅供技术学习、探讨和分享；

2. 关于本站的所有留言、评论、转载及引用，纯属内容发起人的个人观点，与本站观点和立场无关；

3. 关于本站的所有言论和文字，纯属内容发起人的个人观点，与本站观点和立场无关；

4. 本站文章均是网友提供，不完全保证技术分享内容的完整性、准确性、时效性、风险性和版权归属；如您发现该文章侵犯了您的权益，可联系我们第一时间进行删除；

5. 本站为非盈利性的个人网站，所有内容不会用来进行牟利，也不会利用任何形式的广告来间接获益，纯粹是为了广大技术爱好者提供技术内容和技术思想的分享性交流网站。