Mybatis最入门---ResultMaps高级用法（下）

[一步是咫尺，一步即天涯]

接上文，本文我们继续来叙述Mybatis中resultMap的高级用法，类似的，我们先给大家叙述基本的概念及用法，具体实例在后文中再做演示，敬请期待！

-------------------------------------------------------------------------------------------------------------------------------------

上文，我们说到了“has-many”这个问题，在Mybatis中提供给我们另外一个非常有用的元素：

1.<collection>集合

下面给出一个典型的<collection>元素的示例，如下：

<collection property="posts" ofType="domain.blog.Post">
  <id property="id" column="post_id"/>
  <result property="subject" column="post_subject"/>
  <result property="body" column="post_body"/>
</collection>

这里的<collection>集合元素的功能，几乎和<association>元素的几乎是相同的。实际上，在设计之初也是非常类似的，这里我们就不再关注它们的相同点，而重点看看，它们的差异在哪里？

我们先看看现实场景是什么？

a.一个博客只有一个作者。

b.一个作者有很多文章。

我们先回顾一下，基本增改删查中的select，如下：

 <select id="findUserById" parameterType="String" resultType="User">  
        select * from sysuser where id=#{id}  
 </select>  

此时，如果数据库中存在多条数据，那么我们的dao层接口就需要修改为如下的内容：

public List<User> users;

这里类似的，一个作者有很多文章，那么结果返回的接口写法如下：

private List<Post> posts;

类似于上面的，为了映射嵌套结果集合到List中，就像<association> element元素一样，我们可以使用嵌套查询，或者使用嵌套结果

2.集合的嵌套查询

首先，我们看看如何使用嵌套查询来加载blog上posts的文章

<resultMap id="blogResult" type="Blog">
  <collection property="posts" javaType="ArrayList" column="id" ofType="Post" select="selectPostsForBlog"/>
</resultMap>

<select id="selectBlog" resultMap="blogResult">
  SELECT * FROM BLOG WHERE ID = #{id}
</select>

<select id="selectPostsForBlog" resultType="Post">
  SELECT * FROM POST WHERE BLOG_ID = #{id}
</select>

特别的，这里有几件事情需要注意，尽管，看起来上面的这里和上面的<association>非常相似。
第一：明确我们使用的是<collection>元素

第二：这里有一个全新的属性："ofType"，这个属性是必须的。它用来区分JavaBean（或者字段）属性类型和集合包含的类型。

因此，请各位看官仔细阅读下面这条配置：

<collection property="posts" javaType="ArrayList" column="id" ofType="Post" select="selectPostsForBlog"/>

翻译过来就是：一个”posts“在一个“ArrayList”类型的“Post”中的集合（collection）

在上面的这句话中，javaType并不是必须要存在的，Mybatis能够在多数情况下自动的配置到对应的类型当中，因此，这句话也可以简化为：

<collection property="posts" column="id" ofType="Post" select="selectPostsForBlog"/>

3.集合的嵌套结果

对于这一点，各位看官大概已经能够猜到集合的嵌套结果是如何工作的了，因为，它确实和<association>一样，但同时也增加了一个相同的额外的“ofType”属性。

首先，我们先来看看SQL语句该怎么写：

<select id="selectBlog" resultMap="blogResult">
  select
  B.id as blog_id,
  B.title as blog_title,
  B.author_id as blog_author_id,
  P.id as post_id,
  P.subject as post_subject,
  P.body as post_body,
  from Blog B
  left outer join Post P on B.id = P.blog_id
  where B.id = #{id}
</select>

我们又一次关联Blog，Post两张表。重点关注简单映射之后的结果列的标签名。现在用“posts”的集合来映射“blog”就可以简写为：

<resultMap id="blogResult" type="Blog">
  <id property="id" column="blog_id" />
  <result property="title" column="blog_title"/>
  <collection property="posts" ofType="Post">
    <id property="id" column="post_id"/>
    <result property="subject" column="post_subject"/>
    <result property="body" column="post_body"/>
  </collection>
</resultMap>

同样的，请各位看官一定要记得id元素的重要性，否则的话，请查看前文中，我们对id的解释。

与此同时，如果我们选择了更长形式，来允许更加可以重用的结果集形式，我们可以参照下面的这种写法：

<resultMap id="blogResult" type="Blog">
  <id property="id" column="blog_id" />
  <result property="title" column="blog_title"/>
  <collection property="posts" ofType="Post" resultMap="blogPostResult" columnPrefix="post_"/>
</resultMap>

<resultMap id="blogPostResult" type="Post">
  <id property="id" column="id"/>
  <result property="subject" column="subject"/>
  <result property="body" column="body"/>
</resultMap>

4.集合的多结果集

正如我们在<association>中实现的那样，我们可以执行2句查询，从而返回两个结果集合，如下：

SELECT * FROM BLOG WHERE ID = #{id}

SELECT * FROM POST WHERE BLOG_ID = #{id}

在这里，我们也必须给定一个指定的名称给对应的结果集合，做法是：增加一个“resultSets”属性，并使用逗号作为间隔。如下：

<select id="selectBlog" resultSets="blogs,posts" resultMap="blogResult">
  {call getBlogsAndPosts(#{id,jdbcType=INTEGER,mode=IN})}
</select>

同样，我们也指定：数据填充的“posts”的集合包含在“posts”的结果集中

<resultMap id="blogResult" type="Blog">
  <id property="id" column="id" />
  <result property="title" column="title"/>
  <collection property="posts" ofType="Post" resultSet="posts" column="id" foreignColumn="blog_id">
    <id property="id" column="id"/>
    <result property="subject" column="subject"/>
    <result property="body" column="body"/>
  </collection>
</resultMap>

注意：

这里对于我们映射没有深度，广度，<association>与<collections>的关联，有任何的限制。我们最好能够记得这种用法的实际效果。最好的就是，我们持续不断的进行单元测试直到发现一个最好的实现途径。不过不必担心，Mybatis能够使得我们修改非常少的代码，就实现不同的效果。这是不是很赞呢？

关于映射，结合，关联是一个非常值得深入研究的方向，本文，我们就先说到这里，更多的内容还请各位看官在使用中不断发现吧！

5.<discriminator>鉴别器

先来回顾我们上文中给的示例代码，如下：

<discriminator javaType="int" column="draft">
  <case value="1" resultType="DraftPost"/>
</discriminator>

某些情况下，一个简单的数据库查询可能返回多个不同数据类型的，存在关联的结果集合。这个<discriminator>元素就是帮助我们来处理这种场景，或者是，包括类的继承层次结构。<discriminator>非常的容易理解，各位看官可以类比java中的switch语句。

定义一个<discriminator>需要指定“column”和“javaType”。“column”用来帮助Mybatis寻找比对结果中的值，“javaType”用来保证类型上的匹配。具体的例子，如下：

<resultMap id="vehicleResult" type="Vehicle">
  <id property="id" column="id" />
  <result property="vin" column="vin"/>
  <result property="year" column="year"/>
  <result property="make" column="make"/>
  <result property="model" column="model"/>
  <result property="color" column="color"/>
  <discriminator javaType="int" column="vehicle_type">
    <case value="1" resultMap="carResult"/>
    <case value="2" resultMap="truckResult"/>
    <case value="3" resultMap="vanResult"/>
    <case value="4" resultMap="suvResult"/>
  </discriminator>
</resultMap>

在这个例子中，Mybatis将会从结果集合中得到每一条记录。并且比较其”vehicle type“的值。如果正确的匹配到了某个case的值，它就会使用对应的”resultMap“。换句话说，这种机制完全的忽略了其他的”resultMap“（有特例，待会介绍）。但是，如果没有一个case被匹配到的话，Mybatis将会使用<discriminator>标签外部定义的”resultMap“，因此，如果”carResult“被声明为如下内容：

<resultMap id="carResult" type="Car">
  <result property="doorCount" column="door_count" />
</resultMap>

在这种情况下，只有”doorCount“将会被加载。加载之后，Mybatis就允许彻底孤立的<discriminator>的case，即使没有与其parent resultMap存在任何关系。在这种情况下，我们就会知道：”cars“与”vehicles“之间没有任何的关系。就算他们之间是”is-a“的关系。因此，我们想要其余的属性也能够被加载的话，一个最简单的变化就是如下的做法：

<resultMap id="carResult" type="Car" extends="vehicleResult">
  <result property="doorCount" column="door_count" />
</resultMap>

这样，”vehicleResult“和”carResult“的所有属性都会被加载。

曾经也许有人已经有人发现了外部映射的定义有点让人反感。所以，下面有一种比较简单写法，如下：

<resultMap id="vehicleResult" type="Vehicle">
  <id property="id" column="id" />
  <result property="vin" column="vin"/>
  <result property="year" column="year"/>
  <result property="make" column="make"/>
  <result property="model" column="model"/>
  <result property="color" column="color"/>
  <discriminator javaType="int" column="vehicle_type">
    <case value="1" resultType="carResult">
      <result property="doorCount" column="door_count" />
    </case>
    <case value="2" resultType="truckResult">
      <result property="boxSize" column="box_size" />
      <result property="extendedCab" column="extended_cab" />
    </case>
    <case value="3" resultType="vanResult">
      <result property="powerSlidingDoor" column="power_sliding_door" />
    </case>
    <case value="4" resultType="suvResult">
      <result property="allWheelDrive" column="all_wheel_drive" />
    </case>
  </discriminator>
</resultMap>

注意：在上面结果集合中，Mybatis能够自动的帮助我们映射对象的属性与列。因此，对于这些例子，大部分都是包含冗余的属性的，换句话说，实际开发中，适度的保持简洁，是一种推荐的做法。”强迫症“还是不要的好！

6.自动映射

细心的读者可能已经发现，我们上文中出现过集合类型的返回值，但是并没有定义<resultMap>。这其实就是Mybatis在简单的场景之下，直接帮助将结果结合自动转化为List结合的形式。现在，我们稍微深入的了解一下这个过程是如何运行的。

1.当自动映射查询结果时，MyBatis会获取sql返回的列名并在java类中查找相同名字的属性（忽略大小写）。 这意味着如果Mybatis发现了ID列和id属性，Mybatis会将ID的值赋给id。

2.通常数据库列使用大写单词命名，单词间用下划线分隔；而java属性一般遵循驼峰命名法。 为了在这两种命名方式之间启用自动映射，需要将mapUnderscoreToCamelCase设置为true。

自动映射的功能也能够在特殊的resultMap下继续工作。在这种情况下，对于每一个结果映射的集合，所有出现在结果集当中的列，如果没有被手动的设置映射，那么它都会被自动的映射。 在接下来的例子中， id 和 userName列将被自动映射， hashed_password 列将根据配置映射。

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

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

这里存在3个自动映射的级别：

• NONE -禁用自动映射，除非手动的映射对应的属性
• PARTIAL - 会自动的映射结果，除了那些定义在内部的已经存在嵌套的映射
• FULL - 完全的自动映射

在默认情况下，Mybatis设置为PARTIAL。这么做是有原因的：

当使用FULL级别来实现自动映射时，我们处理联系在一起的结果，和在同一行记录中查询几个不同的实体。由此，这里可能存在一些不期望中的结果。（这句话翻得不好）看看下面这个例子吧：

<select id="selectBlog" resultMap="blogResult">
  select
    B.id,
    B.title,
    A.username,
  from Blog B left outer join Author A on B.author_id = A.id
  where B.id = #{id}
</select>

<resultMap id="blogResult" type="Blog">
  <association property="author" resultMap="authorResult"/>
</resultMap>

<resultMap id="authorResult" type="Author">
  <result property="username" column="author_username"/>
</resultMap>

在”Blog“和”Author“的结果集同时使用自动映射这种情况下。注意到：”Author“拥有一个id属性，结果集合中也拥有一个id属性。因此，”Author's“的id将会填充”Blog's“的id。但这并不是我们所期望的，由此就会导致错误。

无论自动映射的界别设置为什么，我们都可以通过”autoMapping“属性来控制开启或者关闭自动映射的功能，具体做法如下：

<resultMap id="userResultMap" type="User" autoMapping="false">
  <result property="password" column="hashed_password"/>
</resultMap>

-------------------------------------------------------------------------------------------------------------------------------------

至此，Mybatis最入门---ResultMaps高级用法（下）结束

参考资料：

官方文档：http://www.mybatis.org/mybatis-3